javax.naming.ldap
클래스 StartTlsRequest

java.lang.Object 
  javax.naming.ldap.StartTlsRequest

모든 구현된 인터페이스:

Serializable, ExtendedRequest

public class StartTlsRequest
extends Object 
implements ExtendedRequest 

이 클래스는 Lightweight Directory Access Protocol (v3): Extension for Transport Layer Security에 정의되고 있는 LDAPv3 StartTLS 확장 요구를 구현합니다. StartTLS 객체 식별자는 1.3. 6.1. 4.1. 1466.20037 입니다. 확장 요구의 값은 정의되지 않습니다.

StartTlsRequest/StartTlsResponse는 TLS 접속을 확립할 경우에 사용합니다. TLS 접속은, extendedOperation()를 호출한 JNDI 컨텍스트에 관련된 기존의 LDAP 접속상에 확립됩니다. 보통, JNDI 프로그램에서는 이러한 클래스를 다음과 같이 사용합니다.

 import javax.naming.ldap. *;
// Open an LDAP association LdapContext ctx = new InitialLdapContext();
// Perform a StartTLS extended operation StartTlsResponse tls = (StartTlsResponse) ctx.extendedOperation(new StartTlsRequest());
// Open a TLS connection (over the existing LDAP association) and get details // of the negotiated TLS session: cipher suite, peer certificate, etc.  SSLSession session = tls.negotiate();
// ... use ctx to perform protected LDAP operations
// Close the TLS connection (revert back to the underlying LDAP association) tls.close();
// ... use ctx to perform unprotected LDAP operations
// Close the LDAP association ctx.close; 

도입된 버전 :

1.4

관련 항목:

StartTlsResponse, 직렬화 된 형식

필드 개요

static String

OID StartTLS 확장 요구에 할당할 수 있는 객체 식별자는 1.3. 6.1. 4.1. 1466.20037 입니다.

생성자 개요

StartTlsRequest ()
StartTLS 확장 요구를 구축합니다.

메서드 개요

ExtendedResponse	createExtendedResponse (String id, byte[] berValue, int offset, int length) LDAP StartTLS 확장 요구에 대응하는 확장 응답 객체를 작성합니다.
byte[]	getEncodedValue () StartTLS 요구의 ASN. 1 BER 로 encode 된 값을 취득합니다.
String	getID () StartTLS 요구의 객체 식별자의 캐릭터 라인을 취득합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

필드의 상세

OID

public static final String  OID

StartTLS 확장 요구에 할당할 수 있는 객체 식별자는 1.3. 6.1. 4.1. 1466.20037 입니다.

관련 항목:

정수 필드값

생성자 상세

StartTlsRequest

public StartTlsRequest()

StartTLS 확장 요구를 구축합니다.

메서드의 상세

getID

public String  getID()

StartTLS 요구의 객체 식별자의 캐릭터 라인을 취득합니다.

정의:

인터페이스 ExtendedRequest 내의 getID

반환값:

객체 식별자의 캐릭터 라인, 1.3. 6.1. 4.1. 1466.20037

getEncodedValue

public byte[] getEncodedValue()

StartTLS 요구의 ASN. 1 BER 로 encode 된 값을 취득합니다. StartTLS 요구에는 정의 끝난 값이 없기 때문에 항상 null이 리턴됩니다 .

정의:

인터페이스 ExtendedRequest 내의 getEncodedValue

반환값:

null 치

createExtendedResponse

public ExtendedResponse  createExtendedResponse(String  id,
                                               byte[] berValue,
                                               int offset,
                                               int length)
                                        throws NamingException 

LDAP StartTLS 확장 요구에 대응하는 확장 응답 객체를 작성합니다.

이 결과는 인수 없음의 public 생성자를 가지는 StartTlsResponse 구상 서브 클래스가 아니면 안됩니다.

이 메서드는 구현 클래스를 검색하기 위해서 다음의 이름의 설정 파일을 검색합니다.

META-INF/services/javax.naming.ldap.StartTlsResponse

설정 파일 및 대응하는 구현 클래스는 호출측 thread의 컨텍스트 클래스 로더로부터 액세스 할 수 없으면 안됩니다.

각각의 설정 파일에는 완전 지정 클래스명이 1 행에 1개 씩 가리키는 리스트가 포함되어 있을 필요가 있습니다. 각각의 이름을 둘러싸는 공백 문자와 탭 문자 및 공백행은 무시됩니다. 코멘트 문자는 「#」(0x23)로 행의 최초의 코멘트 문자에 계속되는 문자는 모두 무시됩니다. 파일은 UTF-8 로 encode 되고 있을 필요가 있습니다.

이 메서드는 설정 파일로부터 수집한 클래스명의 리스트로부터, 최초로 로드 및 인스턴스화할 수 있었던 구현 클래스의 인스턴스를 리턴합니다. 이 메서드는 호출측 thread의 컨텍스트 클래스 로더를 사용해 설정 파일을 검색해, 구현 클래스를 로드합니다.

상기의 방법으로 클래스가 발견되지 않았던 경우는 구현 고유의 방법으로 구현을 검색합니다. 구현이 발견되지 않았던 경우는 NamingException가 발생 됩니다.

정의:

인터페이스 ExtendedRequest 내의 createExtendedResponse

파라미터:

id - 확장 응답의 객체 식별자. 값은 「1.3. 6.1. 4.1. 1466.20037」또는 null이 아니면 안된다. 이 2개의 값은 등가인

berValue - 확장 응답의 ASN. 1 BER 로 encode 된 값. 값은 null인 경우도 있다. 이 값은 응답치의 태그와 길이를 포함한 raw BER 바이트이다. 다만, 응답 OID는 포함하지 않는다. StartTLS 응답은 응답치를 포함하지 않기 때문에 이 값은 무시되는

offset - 사용하는 바이트의 개시 위치 (berValue). StartTLS 응답은 응답치를 포함하지 않기 때문에 이 값은 무시되는

length - 사용하는 바이트수 (berValue). StartTLS 응답은 응답치를 포함하지 않기 때문에 이 값은 무시된다

반환값:

StartTLS 확장 응답 객체

예외:

NamingException - StartTLS 확장 응답 객체의 작성중에 네이밍 예외가 발생했을 경우

관련 항목:

ExtendedResponse