javax.security.sasl
인터페이스 SaslServerFactory

public interface SaslServerFactory

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

일반적으로, 서버는,Sasl static 메소드를 사용합니다. 따라서, 이 인터페이스를 직접 액세스 할 것은 없습니다. 다만, 새로운, 또는 다른 SaslServerFactory 를 제공해, 인스톨 하는 환경도 있습니다.

도입된 버젼:

1.5

관련 항목:

SaslServer , Sasl

메소드의 개요

SaslServer	createSaslServer (String mechanism, String protocol, String serverName, Map <String ,? > props, CallbackHandler cbh) 지정의 파라미터를 사용해 SaslServer 를 작성합니다.
String []	getMechanismNames (Map <String ,? > props) 지정된 기구 선택 정책에 일치하는 기구명의 배열을 돌려줍니다.

메소드의 상세

createSaslServer

SaslServer  createSaslServer(String  mechanism,
                            String  protocol,
                            String  serverName,
                            Map <String ,? > props,
                            CallbackHandler  cbh)
                            throws SaslException 

지정의 파라미터를 사용해 SaslServer 를 작성합니다. 지정의 파라미터로 SaslServer 를 작성할 수 없는 경우는 null 를 돌려줍니다. 에러이기 때문에 SaslServer 를 작성할 수 없는 경우는 SaslException 를 throw 합니다.

파라미터:

mechanism - IANA 에 등록을 마친 SASL 기구명. null 이외. GSSAPI 나 CRAM-MD5 등이 있는

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

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

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

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

반환값:

지정된 파라미터를 사용하는 SaslServer. null 의 경우도 있다. null 의 경우, 이 팩토리는, 지정된 파라미터를 사용해 SaslServer 를 작성할 수 없다

예외:

에러이기 때문에 - SaslServer 를 작성할 수 없는 경우, SaslException 를 throw 한다

SaslException

getMechanismNames

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

지정된 기구 선택 정책에 일치하는 기구명의 배열을 돌려줍니다.

파라미터:

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

반환값:

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