javax.net.ssl

Класс SSLServerSocket

java.lang. Объект

java.net. ServerSocket

javax.net.ssl. SSLServerSocket

Все Реализованные Интерфейсы:

Closeable, AutoCloseable

public abstract class SSLServerSocket
extends ServerSocket

Этот класс расширяется ServerSockets и обеспечивает сокеты защищенного сервера, используя протоколы, такие как Уровень защищенных сокетов (SSL) или Безопасность Транспортного уровня (TLS) протоколы.

Экземпляры этого класса обычно создаются, используя a SSLServerSocketFactory. Первичная функция SSLServerSockets должен создать SSLSockets acceptсоединения луга.

SSLServerSockets содержат несколько частей данных состояния, которые наследованы SSLSocket при создании сокета. Они включают включенные комплекты шифра и протоколы, необходима ли аутентификация клиента, и должны ли создаваемые сокеты начать квитировать в режиме сервера или клиенте. Состояние наследовалось создаваемым SSLSocket может быть overriden, вызывая соответствующие методы.

С тех пор:

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() Возвращает список комплектов шифра, которые в настоящий момент включаются для использования недавно принятыми соединениями.
abstract String[]	getEnabledProtocols() Возвращает имена протоколов, которые в настоящий момент включаются для использования недавно принятыми соединениями.
abstract boolean	getEnableSessionCreation() Возвращает true, если новые сеансы SSL могут быть установлены сокетами, которые создаются из этого сокета сервера.
abstract boolean	getNeedClientAuth() Возвращает true, если аутентификация клиента будет требоваться на недавно acceptрежим сервера редактора SSLSockets.
SSLParameters	getSSLParameters() Возвращает SSLParameters в действительности для недавно принятых соединений.
abstract String[]	getSupportedCipherSuites() Возвращает имена комплектов шифра, которые могли быть включены для использования на соединении SSL.
abstract String[]	getSupportedProtocols() Возвращает имена протоколов, которые могли быть включены для использования.
abstract boolean	getUseClientMode() Возвращает true, если принятые соединения будут в клиентском режиме SSL.
abstract boolean	getWantClientAuth() Возвращает true, если аутентификацию клиента будут требовать на недавно принятых соединениях режима сервера.
abstract void	setEnabledCipherSuites(String[] suites) Устанавливает комплекты шифра, включенные для использования принятыми соединениями.
abstract void	setEnabledProtocols(String[] protocols) Средства управления, какие определенные протоколы включаются для использования принятыми соединениями.
abstract void	setEnableSessionCreation(boolean flag) Средства управления, могут ли новые сеансы SSL быть установлены сокетами, которые создаются из этого сокета сервера.
abstract void	setNeedClientAuth(boolean need) Средства управления, ли acceptрежим сервера редактора SSLSockets будет первоначально сконфигурирован, чтобы потребовать аутентификации клиента.
void	setSSLParameters(SSLParameters params) Применяет SSLParameters к недавно принятым соединениям.
abstract void	setUseClientMode(boolean mode) Средства управления, являются ли принятые соединения в режиме сервера SSL (по умолчанию), или клиентском режиме SSL.
abstract void	setWantClientAuth(boolean want) Средства управления, ли acceptрежим сервера редактора SSLSockets будет первоначально сконфигурирован, чтобы запросить аутентификацию клиента.

Методы java.net унаследованный от класса. ServerSocket

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

Методы java.lang унаследованный от класса. Объект

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 на порту, используя контекст аутентификации по умолчанию. Неудовлетворенные значения по умолчанию соединения к пятидесяти соединениям стояли в очереди прежде, чем система начинает отклонять новые запросы соединения.

Номер порта 0 создает сокет на любом франко-порт.

Если есть менеджер безопасности, checkListen метод вызывают с port параметр как его параметр, чтобы гарантировать работу позволяется. Это могло привести к SecurityException.

Параметры:

port - порт, на котором можно слушать

Броски:

IOException - если ошибка ввода-вывода происходит, создавая сокет

SecurityException - если менеджер безопасности существует и checkListen метод не позволяет работу.

IllegalArgumentException - если параметр порта вне указанного диапазона допустимых значений порта, который является между 0 и 65535, включительно.

См. Также:

SecurityManager.checkListen(int)

SSLServerSocket

protected SSLServerSocket(int port,
               int backlog)
                   throws IOException

Используемый только подклассами.

Создайте сокет сервера TCP на порту, используя контекст аутентификации по умолчанию и указанное отставание соединений.

Номер порта 0 создает сокет на любом франко-порт.

backlog параметром является требуемое максимальное количество соединений на ожидании на сокете. Его точная семантика является определенной реализацией. В частности реализация может наложить максимальную длину или может хотеть игнорировать параметр altogther. Обеспеченное значение должно быть больше чем 0. Если это меньше чем или равно 0, тогда реализация определенное значение по умолчанию будет использоваться.

Если есть менеджер безопасности, checkListen метод вызывают с port параметр как его параметр, чтобы гарантировать работу позволяется. Это могло привести к SecurityException.

Параметры:

port - порт, на котором можно слушать

backlog - требуемая максимальная длина очереди входящих соединений.

Броски:

IOException - если ошибка ввода-вывода происходит, создавая сокет

SecurityException - если менеджер безопасности существует и checkListen метод не позволяет работу.

IllegalArgumentException - если параметр порта вне указанного диапазона допустимых значений порта, который является между 0 и 65535, включительно.

См. Также:

SecurityManager.checkListen(int)

SSLServerSocket

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

Используемый только подклассами.

Создайте сокет сервера TCP на порту, используя контекст аутентификации по умолчанию и указанное отставание соединений так же как определенный указанный сетевой интерфейс. Этот конструктор используется на многосетевых узлах, таких как используемые для брандмауэров или как маршрутизаторы, чтобы управлять, через который интерфейс предоставляют сетевой службе.

Если есть менеджер безопасности, checkListen метод вызывают с port параметр как его параметр, чтобы гарантировать работу позволяется. Это могло привести к SecurityException.

Номер порта 0 создает сокет на любом франко-порт.

backlog параметром является требуемое максимальное количество соединений на ожидании на сокете. Его точная семантика является определенной реализацией. В частности реализация может наложить максимальную длину или может хотеть игнорировать параметр altogther. Обеспеченное значение должно быть больше чем 0. Если это меньше чем или равно 0, тогда реализация определенное значение по умолчанию будет использоваться.

Если адрес будет нулем, то он примет значение по умолчанию, принимая соединения на любых/всех локальных адресах.

Параметры:

port - порт, на котором можно слушать

backlog - требуемая максимальная длина очереди входящих соединений.

address - адрес сетевого интерфейса, через который будут приняты соединения

Броски:

IOException - если ошибка ввода-вывода происходит, создавая сокет

SecurityException - если менеджер безопасности существует и checkListen метод не позволяет работу.

IllegalArgumentException - если параметр порта вне указанного диапазона допустимых значений порта, который является между 0 и 65535, включительно.

См. Также:

SecurityManager.checkListen(int)

Деталь метода

getEnabledCipherSuites

public abstract String[] getEnabledCipherSuites()

Возвращает список комплектов шифра, которые в настоящий момент включаются для использования недавно принятыми соединениями.

Если этот список не был явно изменен, обеспеченное системой значение по умолчанию гарантирует минимальное качество службы во всех включенных комплектах шифра.

Есть несколько причин, почему включенный комплект шифра не мог бы фактически использоваться. Например: сокет сервера не мог бы иметь соответствующие закрытые ключи в наличии для этого, или комплект шифра мог бы быть анонимным, устраняя использование аутентификации клиента, в то время как сокету сервера сказали потребовать такой аутентификации.

Возвраты:

массив комплектов шифра включается

См. Также:

getSupportedCipherSuites(), setEnabledCipherSuites(String [])

setEnabledCipherSuites

public abstract void setEnabledCipherSuites(String[] suites)

Устанавливает комплекты шифра, включенные для использования принятыми соединениями.

Комплекты шифра, должно быть, были перечислены getSupportedCipherSuites () как поддерживаемый. После успешного вызова к этому методу, только комплекты, перечисленные в suites параметр включается для использования.

Комплекты, которые запрашивают информацию аутентификации, которая не доступна в контексте аутентификации этого ServerSocket, не будут использоваться в любом случае, даже если им включат.

SSLSockets возвратился из accept() наследуйте эту установку.

Параметры:

suites - Имена всех комплектов шифра, чтобы включить

Броски:

IllegalArgumentException - когда один или больше шифров, названных параметром, не поддерживается, или когда параметр является нулем.

См. Также:

getSupportedCipherSuites(), getEnabledCipherSuites()

getSupportedCipherSuites

public abstract String[] getSupportedCipherSuites()

Возвращает имена комплектов шифра, которые могли быть включены для использования на соединении SSL.

Обычно, только подмножество их будет фактически включено по умолчанию, так как этот список может включать комплекты шифра, которые не встречают качество требований службы для тех значений по умолчанию. Такие комплекты шифра полезны в специализированных приложениях.

Возвраты:

массив имен комплекта шифра

См. Также:

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 () как поддерживаемый. После успешного вызова к этому методу, только протоколы, перечисленные в protocols параметр включается для использования.

SSLSockets возвратился из accept() наследуйте эту установку.

Параметры:

protocols - Имена всех протоколов, чтобы включить.

Броски:

IllegalArgumentException - когда один или больше протоколов, названных параметром, не поддерживается или когда параметр протоколов является нулем.

См. Также:

getEnabledProtocols(), getSupportedProtocols()

setNeedClientAuth

public abstract void setNeedClientAuth(boolean need)

Средства управления, ли acceptрежим сервера редактора SSLSockets будет первоначально сконфигурирован, чтобы потребовать аутентификации клиента.

Установка аутентификации клиента сокета является одним из следующего:

• аутентификация клиента требуется
• аутентификацию клиента требуют
• никакая аутентификация клиента не требуется

В отличие от этого setWantClientAuth(boolean), если опция принятого сокета будет установлена, и клиент хочет не предоставлять информацию об аутентификации о себе, то согласования остановятся, и соединение будет отброшено.

Вызов этого метода переопределяет любую предыдущую установку, сделанную этим методом или setWantClientAuth(boolean).

Начальная буква наследовалась, установка может быть переопределена, вызывая SSLSocket.setNeedClientAuth(boolean) или SSLSocket.setWantClientAuth(boolean).

Параметры:

need - набор к истине, если аутентификация клиента требуется, или ложь, если никакая аутентификация клиента не требуется.

См. Также:

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

getNeedClientAuth

public abstract boolean getNeedClientAuth()

Возвращает true, если аутентификация клиента будет требоваться на недавно acceptрежим сервера редактора SSLSockets.

Начальная буква наследовалась, установка может быть переопределена, вызывая SSLSocket.setNeedClientAuth(boolean) или SSLSocket.setWantClientAuth(boolean).

Возвраты:

истина, если аутентификация клиента требуется, или ложь, если никакая аутентификация клиента не требуется.

См. Также:

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

setWantClientAuth

public abstract void setWantClientAuth(boolean want)

Средства управления, ли acceptрежим сервера редактора SSLSockets будет первоначально сконфигурирован, чтобы запросить аутентификацию клиента.

Установка аутентификации клиента сокета является одним из следующего:

• аутентификация клиента требуется
• аутентификацию клиента требуют
• никакая аутентификация клиента не требуется

В отличие от этого setNeedClientAuth(boolean), если опция принятого сокета будет установлена, и клиент хочет не предоставлять информацию об аутентификации о себе, то согласования будут продолжаться.

Вызов этого метода переопределяет любую предыдущую установку, сделанную этим методом или setNeedClientAuth(boolean).

Начальная буква наследовалась, установка может быть переопределена, вызывая SSLSocket.setNeedClientAuth(boolean) или SSLSocket.setWantClientAuth(boolean).

Параметры:

want - набор к истине, если аутентификацию клиента требуют, или ложь, если никакая аутентификация клиента не требуется.

См. Также:

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

getWantClientAuth

public abstract boolean getWantClientAuth()

Возвращает true, если аутентификацию клиента будут требовать на недавно принятых соединениях режима сервера.

Начальная буква наследовалась, установка может быть переопределена, вызывая SSLSocket.setNeedClientAuth(boolean) или SSLSocket.setWantClientAuth(boolean).

Возвраты:

истина, если аутентификацию клиента требуют, или ложь, если никакая аутентификация клиента не требуется.

См. Также:

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

setUseClientMode

public abstract void setUseClientMode(boolean mode)

Средства управления, являются ли принятые соединения в режиме сервера SSL (по умолчанию), или клиентском режиме SSL.

Серверы обычно аутентифицируют себя, и клиенты не обязаны делать так.

В редких случаях серверы TCP должны действовать в клиентском режиме SSL на недавно принятые соединения. Например, клиенты FTP получают сокеты сервера и слушают там для обратных соединений от сервера. Клиент FTP использовал бы SSLServerSocket в "клиентском" режиме, чтобы принять обратное соединение, в то время как сервер FTP использует SSLSocket с "клиентским" режимом, отключенным, чтобы инициировать соединение. Во время получающегося квитирования могут быть снова использованы существующие сеансы SSL.

SSLSockets возвратился из accept() наследуйте эту установку.

Параметры:

mode - истина, если недавно принятые соединения должны использовать клиентский режим SSL.

См. Также:

getUseClientMode()

getUseClientMode

public abstract boolean getUseClientMode()

Возвращает true, если принятые соединения будут в клиентском режиме SSL.

Возвраты:

истина, если соединение должно использовать клиентский режим SSL.

См. Также:

setUseClientMode(boolean)

setEnableSessionCreation

public abstract void setEnableSessionCreation(boolean flag)

Средства управления, могут ли новые сеансы SSL быть установлены сокетами, которые создаются из этого сокета сервера.

SSLSockets возвратился из accept() наследуйте эту установку.

Параметры:

flag - истина указывает, что сеансы могут быть созданы; это - значение по умолчанию. ложь указывает, что должен быть возобновлен существующий сеанс.

См. Также:

getEnableSessionCreation()

getEnableSessionCreation

public abstract boolean getEnableSessionCreation()

Возвращает true, если новые сеансы SSL могут быть установлены сокетами, которые создаются из этого сокета сервера.

Возвраты:

истина указывает, что сеансы могут быть созданы; это - значение по умолчанию. ложь указывает, что должен быть возобновлен существующий сеанс

См. Также:

setEnableSessionCreation(boolean)

getSSLParameters

public SSLParameters getSSLParameters()

Возвращает SSLParameters в действительности для недавно принятых соединений. ciphersuites и протоколы возвращенного SSLParameters всегда являются ненулем.

Возвраты:

SSLParameters в действительности для недавно принятых соединений

С тех пор:

1.7

См. Также:

setSSLParameters(SSLParameters)

setSSLParameters

public void setSSLParameters(SSLParameters params)

Применяет SSLParameters к недавно принятым соединениям.

Это означает:

• если params.getCipherSuites() ненуль, setEnabledCipherSuites() вызывается с тем значением
• если params.getProtocols() ненуль, setEnabledProtocols() вызывается с тем значением
• если params.getNeedClientAuth() или params.getWantClientAuth() возвратиться true, setNeedClientAuth(true) и setWantClientAuth(true) вызываются, соответственно; иначе setWantClientAuth(false) вызывается.

Параметры:

params - параметры

Броски:

IllegalArgumentException - если setEnabledCipherSuites () или setEnabledProtocols () вызывают сбои

С тех пор:

1.7

См. Также:

getSSLParameters()