javax.net.ssl
인터페이스 SSLSession

public interface SSLSession

SSL 에서는 2개의 엔티티간에 진행중의 관계가 세션으로 불립니다. 1개의 SSL 접속에서는 한 번에 1개의 세션이 사용됩니다. 다만, 그 세션은 같은 엔티티간의 복수의 접속으로 동시에 또는 연속해 사용됩니다. 1개의 접속으로 사용되는 세션을 다른 세션으로 옮겨놓을 수도 있습니다. 세션의 작성 또는 참가는 SSL 핸드 쉐이크 때에 행해집니다. 세션을 무효로 하려면, 시큐러티 또는 자원 사용 상황에 관련된 정책를 사용하는지, 어플리케이션으로부터 명시적으로 invalidate를 호출합니다. 세션 관리 정책는 보통, 퍼포먼스를 조정할 경우에 사용합니다.

SSL 세션에는 표준 세션 속성 이외에 다음의 read 전용 속성이 있습니다.

• 「피어 식별 정보」. 세션은 특정의 클라이언트와 특정의 서버간에 생성된다. 피어 식별 정보는 세션이 설정될 때 확립된다. 일반적으로 X. 509 인증서 체인이 사용된다
• 「encode 방식명」. encode 방식은 특정의 세션의 접속으로 사용되는 암호화 보호의 종류를 나타낸다
• 「피어 호스트」. 세션내의 모든 접속은 같은 2 살의 호스트 사이에 확립된다. 접속처의 호스트의 주소를 사용할 수 있다

세션은 명시적으로 무효로 합니다. 특정의 종류의 에러가 발생했을 때는 암묵적으로 무효가 됩니다.

도입된 버전 :

1.4

메서드 개요

int	getApplicationBufferSize () 이 세션의 사용중에 발생할 가능성이 있는 어플리케이션 버퍼의 최대 사이즈를 취득합니다.
String	getCipherSuite () 이 세션의 모든 접속에 사용되는 SSL encode 방식의 이름을 리턴합니다.
long	getCreationTime () 이 세션이 작성되었을 때의 시간을 UTC 1970년 1 월 1 일 0 시부터의 밀리 세컨드 단위로 리턴합니다.
byte[]	getId () 이 세션에 할당할 수 있었던 식별자를 리턴합니다.
long	getLastAccessedTime () 이 세션이 세션 레벨의 인프라스트럭쳐에 의해 마지막에 액세스 되었을 때의 시간을 UTC 1970년 1 월 1 일 0 시부터의 밀리 세컨드 단위로 리턴합니다.
Certificate []	getLocalCertificates () 핸드 쉐이크중에 피어에 송신된 인증서를 리턴합니다.
Principal	getLocalPrincipal () 핸드 쉐이크중에 피어에 송신된 주체를 리턴합니다.
int	getPacketBufferSize () 이 세션의 사용중에 발생할 가능성이 있는 SSL/TLS 패킷의 최대 사이즈를 취득합니다.
X509Certificate []	getPeerCertificateChain () 세션을 정의할 경우에 식별된, 피어의 식별 정보를 리턴합니다.
Certificate []	getPeerCertificates () 세션을 정의할 경우에 설정된, 피어의 식별 정보를 리턴합니다.
String	getPeerHost () 이 세션의 피어 호스트명을 리턴합니다.
int	getPeerPort () 이 세션의 피어의 포트 번호를 리턴합니다.
Principal	getPeerPrincipal () 세션을 정의할 경우에 설정된, 피어의 식별 정보를 리턴합니다.
String	getProtocol () 이 세션의 모든 접속에 사용되는 프로토콜의 표준명을 리턴합니다.
SSLSessionContext	getSessionContext () 이 세션이 바인드 되고 있는 컨텍스트를 리턴합니다.
Object	getValue (String name) 이 세션의 응용 계층 데이터내에서 지정된 이름에 바인드 되고 있는 객체를 리턴합니다.
String []	getValueNames () 세션에 바인드 되고 있는 응용 계층 데이터 객체명의 배열을 리턴합니다.
void	invalidate () 세션을 무효로 합니다.
boolean	isValid () 재개나 참가가 가능한 유효한 세션인가 어떤가를 리턴합니다.
void	putValue (String name, Object value) 지정된 name를 사용해, 지정된 value 객체를 이 세션의 응용 계층 데이터에 바인드 합니다.
void	removeValue (String name) 세션의 응용 계층 데이터로 지정된 이름에 바인드 된 객체를 삭제합니다.

메서드의 상세

getId

byte[] getId()

이 세션에 할당할 수 있었던 식별자를 리턴합니다.

반환값:

세션 식별자

getSessionContext

SSLSessionContext  getSessionContext()

이 세션이 바인드 되고 있는 컨텍스트를 리턴합니다.

컨텍스트은 일부의 환경에서는 취득할 수 없습니다. 그 경우는 null을 리턴합니다.

컨텍스트를 취득할 수 있는 환경에 시큐러티 매니저가 인스톨 되고 있는 경우는 호출할 때 컨텍스트에 대한 접근 권한이 필요하게 되는 일이 있습니다. 그 경우, 접근 권한이 없을 때는 시큐러티 예외가 발생 됩니다. Java 2 환경에서는 시큐러티 매니저의 checkPermission 메서드를 호출할 때는 SSLPermission("getSSLSessionContext") 접근 권한이 필요합니다.

반환값:

이 세션에 사용되고 있는 세션 컨텍스트. 컨텍스트를 취득할 수 없는 경우는 null

getCreationTime

long getCreationTime()

이 세션이 작성되었을 때의 시간을 UTC 1970년 1 월 1 일 0 시부터의 밀리 세컨드 단위로 리턴합니다.

반환값:

이 세션이 작성되었을 때 각

getLastAccessedTime

long getLastAccessedTime()

이 세션이 세션 레벨의 인프라스트럭쳐에 의해 마지막에 액세스 되었을 때의 시간을 UTC 1970년 1 월 1 일 0 시부터의 밀리 세컨드 단위로 리턴합니다.

액세스란 세션 데이터를 사용해 새로운 접속이 확립되는 것을 가리킵니다. 세션 관련의 값을 취득 또는 설정하는 등, 어플리케이션 레벨의 조작은 이 액세스 시간에 반영되지 않습니다.

이 정보는 특히 세션 관리 정책 로 사용합니다. 예를 들어 장시간 사용되어 있지 않은 컨텍스트 으로 세션 매니저 thread로부터 세션을 해방하거나 세션을 경과시간에 소트의해 태스크를 최적화하거나 합니다.

반환값:

이 세션이 마지막에 액세스 된 시간

invalidate

void invalidate()

세션을 무효로 합니다.

후속의 접속에서는 이 세션을 사용할 수 없습니다. 다만, 이 세션을 사용하고 있는 기존의 접속은 접속이 닫을 때까지 계속 사용할 수 있습니다.

관련 항목:

isValid()

isValid

boolean isValid()

재개나 참가가 가능한 유효한 세션인가 어떤가를 리턴합니다.

반환값:

이 세션에의 참가가 가능한 경우는 true

도입된 버전 :

1.5

관련 항목:

invalidate()

putValue

void putValue(String  name,
              Object  value)

지정된 name를 사용해, 지정된 value 객체를 이 세션의 응용 계층 데이터에 바인드 합니다.

같은 name를 사용하고 있는 기존의 바인딩은 옮겨놓을 수 있습니다. 새로운 (또는 기존의) value가 SSLSessionBindingListener인터페이스를 구현하고 있는 경우, value에 의해 나타내지는 객체에는 적절한 방법으로 통지됩니다.

보안상의 이유로 같은 이름의 값은 복수의 액세스 제어 컨텍스트에 걸쳐 표시할 수 없습니다.

파라미터:

name - 데이터 객체가 바인드 되는 이름. null은 불가

value - 바인드 되는 데이터 객체. null은 불가

예외:

IllegalArgumentException - 어느 쪽인가의 인수가 null인 경우

getValue

Object  getValue(String  name)

이 세션의 응용 계층 데이터내에서 지정된 이름에 바인드 되고 있는 객체를 리턴합니다. 바인딩이 존재하지 않는 경우는 null을 리턴합니다.

보안상의 이유로 같은 이름의 값은 복수의 액세스 제어 컨텍스트에 걸쳐 표시할 수 없습니다.

파라미터:

name - 검색하는 바인딩의 이름

반환값:

지정된 이름에 바인드 된 값. 바인딩이 존재하지 않는 경우는 null

예외:

IllegalArgumentException - 인수가 null인 경우

removeValue

void removeValue(String  name)

세션의 응용 계층 데이터로 지정된 이름에 바인드 된 객체를 삭제합니다. 지정된 이름에 바인드 된 객체가 존재하지 않는 경우는 적용되지 않습니다. 바인드 된 기존의 객체가 SessionBindingListener인터페이스를 구현하고 있는 경우는 그 인터페이스에 적절한 방법으로 통지됩니다.

보안상의 이유로 같은 이름의 값은 복수의 액세스 제어 컨텍스트에 걸쳐 표시할 수 없습니다.

파라미터:

name - 삭제하는 객체의 이름. 복수의 액세스 제어 컨텍스트에 걸쳐 표시할 수 있다

예외:

IllegalArgumentException - 인수가 null인 경우

getValueNames

String [] getValueNames()

세션에 바인드 되고 있는 응용 계층 데이터 객체명의 배열을 리턴합니다.

보안상의 이유로 같은 이름의 값은 복수의 액세스 제어 컨텍스트에 걸쳐 표시할 수 없습니다.

반환값:

이 세션에 바인드 되고 있는 객체명의, null (비어있는 경우도 있다)가 아닌 배열

getPeerCertificates

Certificate [] getPeerCertificates()
                                  throws SSLPeerUnverifiedException 

세션을 정의할 경우에 설정된, 피어의 식별 정보를 리턴합니다.

주: 이 메서드를 사용할 수 있는 것은 인증서 베이스의 encode 방식을 사용하고 있는 경우만입니다. Kerberos 등의 인증서 베이스가 아닌 encode 방식으로 이 메서드를 사용하면, SSLPeerUnverifiedException가 발생 됩니다.

반환값:

피어 인증서 의 배열. 피어 자신의 인증서, 인증서 발행국의 순서에 줄지어 있다

예외:

SSLPeerUnverifiedException - 피어의 식별 정보를 확인할 수 없었던 경우

관련 항목:

getPeerPrincipal()

getLocalCertificates

Certificate [] getLocalCertificates()

핸드 쉐이크중에 피어에 송신된 인증서를 리턴합니다.

주: 이 메서드가 도움이 되는 것은 인증서 베이스의 encode 방식을 사용하고 있는 경우만입니다.

핸드 쉐이크를 실시할 때 복수의 인증서를 사용할 수 있는 경우는 최적인 인증서 체인이 선택되어 피어에 송신됩니다. 호출측은 이 메서드를 사용해, 실제로 사용된 인증서 체인을 파악할 수 있습니다 .

반환값:

인증서 의 배열. 로컬 인증서, 인증서 발행국의 순서에 줄지어 있다. 인증서가 송신되지 않았던 경우는 null이 리턴된

관련 항목:

getLocalPrincipal()

getPeerCertificateChain

X509Certificate [] getPeerCertificateChain()
                                          throws SSLPeerUnverifiedException 

세션을 정의할 경우에 식별된, 피어의 식별 정보를 리턴합니다.

주: 이 메서드를 사용할 수 있는 것은 인증서 베이스의 encode 방식을 사용하고 있는 경우만입니다. Kerberos 등의 인증서 베이스가 아닌 encode 방식으로 이 메서드를 사용하면, SSLPeerUnverifiedException가 발생 됩니다.

주: 이 메서드는 이전의 릴리즈와 의 호환성을 확보하기 위해서 삽입되어 있습니다. 새로운 어플리케이션에서는 getPeerCertificates()를 사용해 주세요.

반환값:

피어의 X. 509 인증서 의 배열. 피어 자신의 인증서, 인증서 발행국의 순서로 나란해지고 있다. 인증서 의 형식은 원의 JSSE 인증서 X509Certificate 형식이다

예외:

SSLPeerUnverifiedException - 피어의 식별 정보를 확인할 수 없었던 경우

관련 항목:

getPeerPrincipal()

getPeerPrincipal

Principal  getPeerPrincipal()
                           throws SSLPeerUnverifiedException 

세션을 정의할 경우에 설정된, 피어의 식별 정보를 리턴합니다.

반환값:

피어의 주체. X509 베이스의 encode 방식의 경우는 엔드엔티티 인증서 의 X500Principal를 돌려주고, Kerberos encode 방식의 경우는 KerberosPrincipal를 돌려준다

예외:

SSLPeerUnverifiedException - 피어의 식별 정보를 확인할 수 없었던 경우

도입된 버전 :

1.5

관련 항목:

getPeerCertificates(), getLocalPrincipal()

getLocalPrincipal

Principal  getLocalPrincipal()

핸드 쉐이크중에 피어에 송신된 주체를 리턴합니다.

반환값:

피어에 송신된 주체. X509 베이스의 encode 방식의 경우는 엔드엔티티 인증서 의 X500Principal를 돌려주고, Kerberos encode 방식의 경우는 KerberosPrincipal를 돌려준다. 주체가 송신되지 않았던 경우는 null을 돌려주는

도입된 버전 :

1.5

관련 항목:

getLocalCertificates(), getPeerPrincipal()

getCipherSuite

String  getCipherSuite()

이 세션의 모든 접속에 사용되는 SSL encode 방식의 이름을 리턴합니다.

SSL encode 방식은 사용되는 암호의 종류나 인증 방법의 설정 등, 접속시에 송신되는 데이터에 적용되는 보호의 레벨을 결정합니다.

반환값:

세션의 encode 방식의 이름

getProtocol

String  getProtocol()

이 세션의 모든 접속에 사용되는 프로토콜의 표준명을 리턴합니다.

이 프로토콜에는 접속으로 사용되는 프로토콜을 정의합니다.

반환값:

이 세션의 모든 접속에 사용되는 프로토콜의 표준명

getPeerHost

String  getPeerHost()

이 세션의 피어 호스트명을 리턴합니다.

서버의 경우는 클라이언트의 호스트명이 됩니다. 클라이언트의 경우는 서버의 호스트명이 됩니다. 이 이름은 완전 지정의 호스트명이나 실제의 호스트명은 아니고, 피어 호스트의 네트워크 주소의 캐릭터 라인 인코딩입니다. 완전 지정의 호스트명이나 실제의 호스트명이 필요한 경우는 이 메서드로부터 리턴된 값에 근거해 네임 서비스를 사용하면 해결할 수 있습니다.

이 값은 인증되어 있지 않기 때문에 실제로 사용할 수 없습니다. 주로SSLSession 캐쉬 방법에 관한 힌트로서 사용됩니다.

반환값:

피어 호스트의 호스트명. 정보가 없는 경우는 null

getPeerPort

int getPeerPort()

이 세션의 피어의 포트 번호를 리턴합니다.

서버의 경우는 클라이언트의 포트 번호가 됩니다. 클라이언트의 경우는 서버의 포트 번호가 됩니다.

이 값은 인증되어 있지 않기 때문에 실제로 사용할 수 없습니다. 주로SSLSession 캐쉬 방법에 관한 힌트로서 사용됩니다.

반환값:

피어 호스트의 포트 번호. 정보가 없는 경우는 -1

도입된 버전 :

1.5

getPacketBufferSize

int getPacketBufferSize()

이 세션의 사용중에 발생할 가능성이 있는 SSL/TLS 패킷의 최대 사이즈를 취득합니다.

이 세션을 사용하고 있는 SSLEngine는 이 메서드로부터 리턴된 값이하로 임의의 사이즈의 SSL/TLS 패킷을 생성할 수 있습니다. wrap 나 unwrap 실행시에 용량 부족의 문제를 막기 위해서 SSLEngine 네트워크버퍼의 사이즈는 모두 이 값이상으로의해 주세요.

반환값:

네트워크 패킷의 최대 사이즈

도입된 버전 :

1.5

관련 항목:

SSLEngine.wrap(ByteBuffer, ByteBuffer), SSLEngine.unwrap(ByteBuffer, ByteBuffer)

getApplicationBufferSize

int getApplicationBufferSize()

이 세션의 사용중에 발생할 가능성이 있는 어플리케이션 버퍼의 최대 사이즈를 취득합니다.

SSLEngine 어플리케이션 데이터 버퍼에는 착신하는 어플리케이션 데이터 패킷에 포함되어 있는 어플리케이션 데이터를 보관 유지하기 위해서 충분한 사이즈가 필요합니다. 보통, 송신 어플리케이션 데이터 버퍼는 어떠한 사이즈에서도 괜찮습니다.

반환값:

어플리케이션 패킷의 최대 사이즈

도입된 버전 :

1.5

관련 항목:

SSLEngine.wrap(ByteBuffer, ByteBuffer), SSLEngine.unwrap(ByteBuffer, ByteBuffer)