javax.security.sasl
인터페이스 SaslClientFactory

public interface SaslClientFactory

SaslClient 인스턴스를 작성하기 위한 인터페이스입니다. 이 인터페이스는 thread 세이프로 복수의 요구를 동시에 처리할 수 있는 클래스에 의해 구현됩니다. 이 클래스는 인수를 취하지 않는 public 생성자를 가지고 있을 필요가 있습니다.

보통, 클라이언트는 Sasl static 메서드를 사용합니다. 따라서, 이 인터페이스를 직접 액세스 할 것은 없습니다. 다만, 새로운, 또는 다른 SaslClientFactory를 제공해, 인스톨 하는 환경도 있습니다.

도입된 버전 :

1.5

관련 항목:

SaslClient, Sasl

메서드 개요

SaslClient	createSaslClient (String [] mechanisms, String authorizationId, String protocol, String serverName, Map <String, ? > props, CallbackHandler cbh) 지정의 파라미터를 사용해 SaslClient를 작성합니다.
String []	getMechanismNames (Map <String, ? > props) 지정된 도구 선택 정책에 일치하는 도구 명의 배열을 리턴합니다.

메서드의 상세

createSaslClient

SaslClient  createSaslClient(String [] mechanisms,
                            String  authorizationId,
                            String  protocol,
                            String  serverName,
                            Map <String,
? > props,
                            CallbackHandler  cbh)
                            throws SaslException 

지정의 파라미터를 사용해 SaslClient를 작성합니다.

파라미터:

mechanisms - 테스트하는 도구 의 리스트로 null 이외. GSSAPI 나 CRAM-MD5 등, IANA에 등록을 마친 SASL 도구 명으로부터 완성되는

authorizationId - 인증에 사용되는 프로토콜 존의 식별 정보로 null 가능성도 있다. null 또는 비어있는 경우, 서버는 클라이언트의 인증 자격으로부터 승인 ID를 얻는다. SASL 인증에 성공하면, 지정된 엔트리에 액세스가 허가되는

protocol - 인증 대상의 프로토콜의 캐릭터 라인명. null 이외. ldap 등이 있는

serverName - 인증 정보를 요구하는 서버의 완전 수식 호스트명. null 이외

props - SASL 도구 의 선택과 선택된 SASL 도구 의 인증 교환의 설정을 실시하는 프로퍼티세트. null 가능성도 있다. 표준 프로퍼티의 리스트에 대해서는 Sasl 클래스의 설명을 참조. 도구 고유의 프로퍼티 등, 표준 이외의 프로퍼티도 포함할 수가 있다. 선택된 도구와 관련성이 없는 프로퍼티는 무시되는

cbh - SASL 도구가 인증을 완료하기 위해서 어플리케이션이나 라이브러리로부터 또한 자세한 정보를 취득할 때 사용하는 콜백 핸들러. null 가능성도 있다. 예를 들어 호출측의 인증 ID, 패스워드 및 레룸을 요구하는 것 같은 SASL 도구가 있다. 인증 ID 요구에는 NameCallback가 사용된다. 패스워드의 요구에는 PasswordCallback가 사용된다. 레룸의 요구에는 선택 가능한 레룸의 리스트가 존재하는 경우는 RealmChoiceCallback, 레룸을 지정할 필요가 있는 경우는 RealmCallback가 사용된다

반환값:

지정의 파라미터로 작성된 SaslClient로 null 가능성도 있다. null인 경우, 이 팩토리는 지정의 파라미터를 사용해 SaslClient를 작성할 수 없는 @exception SaslException 에러이기 때문에 SaslClient를 작성할 수 없는 경우

예외:

SaslException

getMechanismNames

String [] getMechanismNames(Map <String,
? > props)

지정된 도구 선택 정책에 일치하는 도구 명의 배열을 리턴합니다.

파라미터:

props - SASL 도구 의 시큐러티 정책 의 지정에 사용되는 프로퍼티세트. null 가능성도 있다. 예를 들어, props에 포함되는 Sasl.POLICY_NOPLAINTEXT 프로퍼티의 값이「true」의 경우, 팩토리는 단순한 수동적 공격을 받기 쉬운 SASL 도구를 돌려주고선 안 된다. 정책 프로퍼티의 완전한 리스트에 대해서는 Sasl 클래스의 설명을 참조. props에 포함되는 프로퍼티가 정책와는 관계가 없는 경우, 이러한 프로퍼티는 무시된다

반환값:

IANA에 등록을 마친 SASL 도구 명을 포함한 null 이외의 배열