javax.net.ssl
클래스 SSLServerSocket

java.lang.Object 
  |
  +--java.net.ServerSocket 
        |
        +--javax.net.ssl.SSLServerSocket

public abstract class SSLServerSocket

extends ServerSocket

이 클래스는 ServerSocket 를 확장해, Secure Sockets Layer (SSL)나 Transport Layer Security (TLS)등의 프로토콜을 사용하는 시큐어 서버 소켓을 제공합니다.

이 클래스의 인스턴스를 작성할 때는 통상,SSLServerSocketFactory 를 사용합니다. SSLServerSocket 는 접속을 accept 해 SSLSocket 를 작성합니다.

SSLServerSocket 의 일부 상태 데이터는 작성되는 SSLSocket 에 계승됩니다. 예를 들어, 유효하게 되어 있는 encode 방식과 프로토콜, 클라이언트 인증이 필요한가 어떤가 이 소켓이 핸드 쉐이크를 개시할 때의 모드 (클라이언트 모드 또는 서버 모드), 등의 정보가 계승됩니다. 작성된 SSLSocket 에 계승된 상태는 대응하는 메소드를 호출해 오버라이드(override) 할 수 있습니다.

도입된 버젼:

1.4

관련 항목:

ServerSocket , SSLSocket

생성자의 개요

protected	SSLServerSocket () 서브 클래스에서만 사용됩니다.
protected	SSLServerSocket (int port) 서브 클래스에서만 사용됩니다.
protected	SSLServerSocket (int port, int backlog) 서브 클래스에서만 사용됩니다.
protected	SSLServerSocket (int port, int backlog, InetAddress address) 서브 클래스에서만 사용됩니다.

메소드의 개요

abstract String []	getEnabledCipherSuites () 새롭게 받아들인 접속으로 현재 사용 가능하게 되어 있는 encode 방식의 리스트를 돌려줍니다.
abstract String []	getEnabledProtocols () 새롭게 받아들인 접속으로 현재 사용 가능하게 되어 있는 프로토콜명을 돌려줍니다.
abstract boolean	getEnableSessionCreation () 이 서버 소켓으로부터 작성된 소켓으로, 새로운 SSL 세션을 확립하는 경우는 true 를 돌려줍니다.
abstract boolean	getNeedClientAuth () 새롭게 받아들인 접속이 클라이언트 인증을 필요로 하는 경우는 true 를 돌려줍니다.
abstract String []	getSupportedCipherSuites () SSL 접속으로 사용 가능하게 할 수 있는 encode 방식의 이름을 돌려줍니다.
abstract String []	getSupportedProtocols () 사용 가능하게 할 수 있는 프로토콜의 이름을 돌려줍니다.
abstract boolean	getUseClientMode () 받아들인 접속이 SSL 클라이언트 모드가 되는 경우는 true 를 돌려줍니다.
abstract boolean	getWantClientAuth () 새롭게 받아들인 접속이 클라이언트 인증을 요구하는 경우는 true 를 돌려줍니다.
abstract void	setEnabledCipherSuites (String [] suites) 받아들인 접속에 대해서 사용 가능하게 하는 SSL encode 방식을 제어합니다.
abstract void	setEnabledProtocols (String [] protocols) 받아들인 접속으로 사용 가능하게 하는 프로토콜을 제어합니다.
abstract void	setEnableSessionCreation (boolean flag) 이 서버 소켓으로부터 작성된 소켓으로, 새로운 SSL 세션을 확립화도인지를 제어합니다.
abstract void	setNeedClientAuth (boolean flag) 받아들인 접속이 클라이언트 인증을 요구할지 어떨지를 제어합니다.
abstract void	setUseClientMode (boolean flag) 받아들여진 접속이 (디폴트의) SSL 서버 모드와 SSL 클라이언트 모드의 어디에서 있는지를 제어합니다.
abstract void	setWantClientAuth (boolean flag) 받아들인 접속이, SSL 네고시에이션을 실시할 때, 클라이언트 인증을 요구할 필요가 있을지 어떨지를 제어합니다.

클래스 java.net. ServerSocket 에서 상속받은 메소드

accept , bind , bind , close , getChannel , getInetAddress , getLocalPort , getLocalSocketAddress , getReceiveBufferSize , getReuseAddress , getSoTimeout , implAccept , isBound , isClosed , setReceiveBufferSize , setReuseAddress , setSocketFactory , setSoTimeout , toString

클래스 java.lang. Object 에서 상속받은 메소드

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

생성자의 상세

SSLServerSocket

protected SSLServerSocket()
                   throws IOException 

서브 클래스에서만 사용됩니다. 디폴트의 인증 문맥을 사용해, 바인드되어 있지 않은 TCP 서버 소켓을 작성합니다.

예외:

IOException - 소켓의 생성중에 입출력 에러가 발생했을 경우

SSLServerSocket

protected SSLServerSocket(int port)
                   throws IOException 

서브 클래스에서만 사용됩니다. 디폴트의 인증 문맥을 사용해, 포토상에 TCP 서버 소켓을 작성합니다. 큐에 저장되는 접속 백 로그의 최대수는 디폴트로 50 으로 설정되어 있습니다. 큐내의 접속 요구가 최대수를 넘으면(자), 새로운 접속 요구는 거부됩니다.

파라미터:

port - 대기하는 포토

예외:

IOException - 소켓의 생성중에 입출력 에러가 발생했을 경우

SSLServerSocket

protected SSLServerSocket(int port,
                          int backlog)
                   throws IOException 

서브 클래스에서만 사용됩니다. 디폴트의 인증 문맥과 지정된 접속 백 로그를 사용해, 포토상에 TCP 서버 소켓을 작성합니다.

파라미터:

port - 대기하는 포토

backlog - 최대 보류 접속수. 이 접속수를 넘으면(자), 새로운 요구가 거부된다

예외:

IOException - 소켓의 생성중에 입출력 에러가 발생했을 경우

SSLServerSocket

protected SSLServerSocket(int port,
                          int backlog,
                          InetAddress  address)
                   throws IOException 

서브 클래스에서만 사용됩니다. 디폴트의 인증 문맥, 지정된 접속 백 로그, 및 지정된 네트워크 인터페이스를 사용해, 포토상에 TCP 서버 소켓을 작성합니다. 이 constructor 은 파이어 월(fire wall)나 라우터로서 사용되는 multi-homed host상에서 사용되어 네트워크 서비스를 제공하는 인터페이스를 제어합니다.

파라미터:

port - 대기하는 포토

backlog - 최대 보류 접속수. 이 접속수를 넘으면(자), 새로운 요구가 거부되는

address - 접속을 받아들이는 네트워크 인터페이스의 주소

예외:

IOException - 소켓의 생성중에 입출력 에러가 발생했을 경우

메소드의 상세

getEnabledCipherSuites

public abstract String [] getEnabledCipherSuites()

새롭게 받아들인 접속으로 현재 사용 가능하게 되어 있는 encode 방식의 리스트를 돌려줍니다. 이 리스트를 명시적으로 변경하지 않는 한, 시스템의 디폴트 설정에 의해, 모든 사용 가능한 encode 방식에서 최소한의 서비스 품질이 프로텍션됩니다.

실제로 사용하는 encode 방식은 요건에 응해 적절히 선택해 주세요. 예를 들어, 서버 소켓이 하등의 인증을 요구하도록(듯이) 설정되어 있을 때, encode 방식에서 사용할 수 있는 비공개열쇠가 서버 소켓에 할당할 수 있지 않은 경우, 또는 encode 방식이 익명이기 (위해)때문에 클라이언트 인증을 사용할 수 없는 경우, 그러한 encode 방식은 실제로는 사용할 수 없습니다.

반환값:

사용 가능한 encode 방식의 배열

관련 항목:

getSupportedCipherSuites() , setEnabledCipherSuites(String [])

setEnabledCipherSuites

public abstract void setEnabledCipherSuites(String [] suites)

받아들인 접속에 대해서 사용 가능하게 하는 SSL encode 방식을 제어합니다. 사용하는 encode 방식은 getSupportedCipherSuites()로부터 돌려주어지는 encode 방식의 리스트로 사용 가능하게 되지 않으면 안됩니다. 사용 가능하게 되어 있는 경우에서도, 이 ServerSocket 의 인증 문맥으로 사용할 수 없는 인증 정보를 필요로 하는 경우는 그 encode 방식은 사용할 수 없습니다.

accept() 로부터 돌려주어지는 SSLSocket 는 이 설정을 계승합니다.

파라미터:

suites - 사용 가능하게 하는 모든 encode 방식의 이름

예외:

IllegalArgumentException - 파라미터로 지정된 encode 방식의 일부가 서포트되지 않는 경우, 또는 파라미터가 null 의 경우

관련 항목:

getSupportedCipherSuites() , getEnabledCipherSuites()

getSupportedCipherSuites

public abstract String [] getSupportedCipherSuites()

SSL 접속으로 사용 가능하게 할 수 있는 encode 방식의 이름을 돌려줍니다. 통상은 그 일부만이 디폴트로 사용 가능하게 됩니다. 디폴트의 서비스 품질 요건을 채우지 않은 encode 방식은 사용 불가가 됩니다. 그러한 encode 방식은 특수한 어플리케이션으로 사용합니다.

반환값:

encode 방식명의 배열

관련 항목:

getEnabledCipherSuites() , setEnabledCipherSuites(String [])

getSupportedProtocols

public abstract String [] getSupportedProtocols()

사용 가능하게 할 수 있는 프로토콜의 이름을 돌려줍니다.

반환값:

서포트되고 있는 프로토콜명의 배열

관련 항목:

getEnabledProtocols() , setEnabledProtocols(String [])

getEnabledProtocols

public abstract String [] getEnabledProtocols()

새롭게 받아들인 접속으로 현재 사용 가능하게 되어 있는 프로토콜명을 돌려줍니다.

반환값:

프로토콜명의 배열

관련 항목:

getSupportedProtocols() , setEnabledProtocols(String [])

setEnabledProtocols

public abstract void setEnabledProtocols(String [] protocols)

받아들인 접속으로 사용 가능하게 하는 프로토콜을 제어합니다. 사용 가능하게 하는 프로토콜은 getSupportedProtocols()로부터 돌려주어지는 프로토콜의 리스트로 사용 가능하게 되지 않으면 안됩니다.

accept() 로부터 돌려주어지는 SSLSocket 는 이 설정을 계승합니다.

파라미터:

protocols - 사용 가능하게 하는 모든 프로토콜의 이름

예외:

IllegalArgumentException - 파라미터로 지정된 프로토콜의 일부가 서포트되지 않는 경우, 또는 파라미터가 null 의 경우

관련 항목:

getEnabledProtocols() , getSupportedProtocols()

setNeedClientAuth

public abstract void setNeedClientAuth(boolean flag)

받아들인 접속이 클라이언트 인증을 요구할지 어떨지를 제어합니다. 이 옵션은 서버 모드의 소켓만으로 사용합니다.

setWantClientAuth(boolean) 와 달리, 클라이언트 인증 정보를 제공하지 않는 경우는 네고시에이션이 정지해, 접속이 절단 됩니다.

accept() 로부터 돌려주어지는 SSLSocket 는 이 설정을 계승합니다.

파라미터:

flag - 클라이언트 인증이 필요한 경우는 true. 이 파라미터를 true 로 설정하면(자),setWantClientAuth(boolean) 의 현재의 설정이 오버라이드(override) 되는

관련 항목:

getNeedClientAuth() , setWantClientAuth(boolean) , getWantClientAuth() , setUseClientMode(boolean)

getNeedClientAuth

public abstract boolean getNeedClientAuth()

새롭게 받아들인 접속이 클라이언트 인증을 필요로 하는 경우는 true 를 돌려줍니다. 이 옵션은 서버 모드의 소켓만으로 사용할 수 있습니다.

반환값:

클라이언트 인증이 필요한 경우는 true

관련 항목:

setNeedClientAuth(boolean) , setWantClientAuth(boolean) , getWantClientAuth() , setUseClientMode(boolean)

setWantClientAuth

public abstract void setWantClientAuth(boolean flag)

받아들인 접속이, SSL 네고시에이션을 실시할 때, 클라이언트 인증을 요구할 필요가 있을지 어떨지를 제어합니다. 이 옵션은 서버 모드의 소켓만으로 사용합니다.

setNeedClientAuth(boolean) 와 달리, 클라이언트 인증 정보를 제공하지 않는 경우에서도, 네고시에이션은 계속됩니다.

accept() 로부터 돌려주어지는 SSLSocket 는 이 설정을 계승합니다.

파라미터:

flag - 클라이언트 인증이 필요한 경우는 true. 이 파라미터를 true 로 설정하면(자), setNeedClientAuth(boolean) 의 현재의 설정이 오버라이드(override) 되는

관련 항목:

getWantClientAuth() , setNeedClientAuth(boolean) , getNeedClientAuth() , setUseClientMode(boolean)

getWantClientAuth

public abstract boolean getWantClientAuth()

새롭게 받아들인 접속이 클라이언트 인증을 요구하는 경우는 true 를 돌려줍니다. 이 옵션은 서버 모드의 소켓만으로 사용할 수 있습니다.

반환값:

클라이언트 인증이 필요한 경우는 true

관련 항목:

setWantClientAuth(boolean) , setNeedClientAuth(boolean) , getNeedClientAuth() , setUseClientMode(boolean)

setUseClientMode

public abstract void setUseClientMode(boolean flag)

받아들여진 접속이 (디폴트의) SSL 서버 모드와 SSL 클라이언트 모드의 어디에서 있는지를 제어합니다. 통상, 서버는 인증을 실시합니다만, 클라이언트는 인증할 필요가 없습니다.

새롭게 받아들인 접속이, SSL 클라이언트 모드의 TCP 서버를 요구하는 일이 있습니다. 예를 들어, FTP 클라이언트는 서버 소켓을 취득하면(자), 그 소켓상에서 서버로부터의 접속을 대기합니다. FTP 클라이언트는 서버로부터의 접속을 받아들일 때, 클라이언트 모드의 SSLServerSocket 를 사용합니다. FTP 서버는 접속을 개시할 경우에 클라이언트 모드를 무효로 한 SSLSocket 를 사용합니다. 이 경우, 핸드 쉐이크를 실시할 때는 기존의 SSL 세션이 재이용됩니다.

accept() 로부터 돌려주어지는 SSLSocket 는 이 설정을 계승합니다.

파라미터:

flag - 새롭게 받아들인 접속이 SSL 클라이언트 모드를 사용하는 경우는 true

관련 항목:

getUseClientMode()

getUseClientMode

public abstract boolean getUseClientMode()

받아들인 접속이 SSL 클라이언트 모드가 되는 경우는 true 를 돌려줍니다.

반환값:

접속이 SSL 클라이언트 모드를 사용하는 경우는 true

관련 항목:

setUseClientMode(boolean)

setEnableSessionCreation

public abstract void setEnableSessionCreation(boolean flag)

이 서버 소켓으로부터 작성된 소켓으로, 새로운 SSL 세션을 확립화도인지를 제어합니다.

accept() 로부터 돌려주어지는 SSLSocket 는 이 설정을 계승합니다.

파라미터:

flag - 세션을 작성하는 경우는 true (디폴트). 기존의 세션을 재개하는 경우는 false

관련 항목:

getEnableSessionCreation()

getEnableSessionCreation

public abstract boolean getEnableSessionCreation()

이 서버 소켓으로부터 작성된 소켓으로, 새로운 SSL 세션을 확립하는 경우는 true 를 돌려줍니다.

반환값:

세션을 작성하는 경우는 true (디폴트). 기존의 세션을 재개하는 경우는 false

관련 항목:

setEnableSessionCreation(boolean)