Аутентификация и защита канала

establishSChannelBegin

Поддерживаемые типы токенов	GOST PRO

establishSChannelBegin(int certHandle)

Начать установку защищенного канала в соответствии с RFC 4346. После успешного выполнения состояние аутентификации переходит в STATE_SECURE_CHANNEL_CONNECTION_IN_PROGRESS (2). Работает при состоянии аутентификации STATE_TOKEN_BINDED (1). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• certHandle – идентификатор сертификата. Получается при создании контейнера createContainer()/createContainerAsync() или при помощи методов поиска getCertificateList()/getCertificateListEx().

Результат:

array – данные для сервера в соответствии с алгоритмом установления соединения TLS.

establishSChannelContinue

Поддерживаемые типы токенов	GOST PRO

establishSChannelContinue(array infoFromServer, int connectionID)

Продолжить установку защищенного канала канала в соответствии с RFC 4346. После успешного выполнения нескольких вызовов состояние аутентификации переходит в STATE_SECURE_CHANNEL_ESTABLISHED (3). Работает при состоянии аутентификации STATE_SECURE_CHANNEL_CONNECTION_IN_PROGRESS (2). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• infoFromServer – данные от сервера, полученные в ответ на отправку ему выходных данных метода establishSChannelBegin().
• connectionID – идентификатор подключения. Формируется сервером.

Результат:

array – данные для сервера в соответствии с алгоритмом установления соединения TLS.

unilateralAuthenticationBegin

Поддерживаемые типы токенов	GOST PRO

unilateralAuthenticationBegin(int certHandle)

Начать одностороннюю аутентификацию. После успешного выполнения состояние аутентификации переходит в UNILATERAL_AUTHENTICATION_IN_PROGRESS (4). Работает при состоянии аутентификации STATE_TOKEN_BINDED (1). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• certHandle – идентификатор сертификата. Получается при создании контейнера createContainer()/createContainerAsync() или при помощи методов поиска getCertificateList()/getCertificateListEx().

Результат:

array – данные для сервера в соответствии с алгоритмом установления соединения TLS.

unilateralAuthenticationContinue

Поддерживаемые типы токенов	GOST PRO

unilateralAuthenticationContinue(array infoFromServer, int connectionID)

Продолжить одностороннюю аутентификацию. После успешного выполнения нескольких вызовов состояние аутентификации переходит в UNILATERAL_AUTHENTICATION_COMPLETE (5). Работает при состоянии аутентификации UNILATERAL_AUTHENTICATION_IN_PROGRESS (4). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• infoFromServer – данные от сервера, полученные в ответ на отправку ему выходных данных метода unilateralAuthenticationBegin().
• connectionID – идентификатор подключения. Формируется сервером.

Результат:

array – данные для сервера в соответствии с алгоритмом установления соединения TLS.

encode

Поддерживаемые типы токенов	GOST PRO

encode(array dataIn)

Перевести открытые данные в данные защищенного канала. Работает при состоянии аутентификации STATE_SECURE_CHANNEL_ESTABLISHED (3). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• dataIn – открытые данные в виде массива байт.

Результат:

array – данные для передачи на сервер (данные, зашифрованные выработанным в процессе установления защищенного соединения симметричным ключом).

decode

Поддерживаемые типы токенов	GOST PRO

decode(array dataIn)

Перевести данные защищенного канала в открытые данные. Работает при состоянии аутентификации STATE_SECURE_CHANNEL_ESTABLISHED (3). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• dataIn – данные защищенного канала (данные, зашифрованные выработанным в процессе установления защищенного соединения симметричным ключом).

Результат:

array – открытые данные в виде массива байт.