Spec-Zone .ru спецификации, руководства, описания, API

javax.security.auth.message
Интерфейс ClientAuth

Все Известные Подынтерфейсы:

ClientAuthContext, ClientAuthModule

public interface ClientAuth

Реализация этого интерфейса используется, чтобы защитить сообщения запроса на обслуживание, и проверить полученных сообщений ответа службы.

Версия:

% %I, %G %

См. Также:

MessageInfo, Subject

Сводка метода

void	cleanSubject(MessageInfo messageInfo, javax.security.auth.Subject subject) Удалите реализацию определенные принципалы и учетные данные от предмета.
AuthStatus	secureRequest(MessageInfo messageInfo, javax.security.auth.Subject clientSubject) Защитите сообщение запроса на обслуживание прежде, чем отправить это службе.
AuthStatus	validateResponse(MessageInfo messageInfo, javax.security.auth.Subject clientSubject, javax.security.auth.Subject serviceSubject) Проверьте полученного ответа службы.

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

secureRequest

AuthStatus secureRequest(MessageInfo messageInfo,
                         javax.security.auth.Subject clientSubject)
                         throws AuthException

Защитите сообщение запроса на обслуживание прежде, чем отправить это службе.

Этот метод вызывают, чтобы преобразовать сообщение запроса, полученное, вызывая getRequestMessage (на messageInfo) в специфичную для механизма форму, которая будет отправлена временем выполнения.

Этот метод передает результат своего сообщения, обрабатывающего или возвращая значение AuthStatus или бросая AuthException.

Параметры:

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

clientSubject - Предмет, который представляет источник запроса на обслуживание, или нуль. Это может использоваться реализацией метода в качестве источника Принципалов или учетных данных, которые будут использоваться, чтобы защитить запрос. Если Предметом не является нуль, реализация метода может добавить дополнительные Принципалы или учетные данные (имеющий отношение к источнику запроса на обслуживание) к Предмету.

Возвраты:

Объект AuthStatus представление состояния завершения обработки выполняется методом. Значения AuthStatus, которые могут быть возвращены этим методом, определяются следующим образом:

• AuthStatus. УСПЕХ, когда сообщение запроса приложения было успешно защищено. Защищенное сообщение запроса может быть получено, вызывая getRequestMessage на messageInfo.
• AuthStatus. SEND_CONTINUE, чтобы указать, что сообщение запроса приложения (в пределах messageInfo) было заменено сообщением безопасности, которое должно выявить специфичный для безопасности ответ от равноправной системы обеспечения безопасности. Это значение состояния также указывает, что сообщение приложения еще не было защищено. Это значение состояния служит, чтобы сообщить времени выполнения вызова, что (чтобы успешно завершить обмен сообщениями) это должно будет быть способно к продолжению диалогового окна сообщения, проводя по крайней мере один дополнительный обмен запроса/ответа получив специфичный для безопасности ответ, выявляемый, отправляя сообщение безопасности. Когда это значение состояния возвращается, соответствующий вызов validateResponse должен быть в состоянии получить исходное сообщение запроса приложения.
• AuthStatus. ОТКАЗ указать, что отказ произошел, защищая сообщение запроса, и что соответствующее сообщение ответа отказа доступно, вызывая getResponseMessage на messageInfo.

Броски:

AuthException - Когда обработка сообщения, отказавшая, не устанавливая сообщение ответа отказа (в messageInfo).

validateResponse

AuthStatus validateResponse(MessageInfo messageInfo,
                            javax.security.auth.Subject clientSubject,
                            javax.security.auth.Subject serviceSubject)
                            throws AuthException

Проверьте полученного ответа службы.

Этот метод вызывают, чтобы преобразовать специфичное для механизма сообщение ответа, полученное, вызывая getResponseMessage (на messageInfo) в проверенное сообщение приложения, которое будет возвращено к сообщению, обрабатывающему время выполнения. Если сообщение ответа является (специфичным для механизма) метасообщением, реализация метода должна попытаться преобразовать метасообщение в следующее специфичное для механизма сообщение запроса, которое будет отправлено временем выполнения.

Этот метод передает результат своего сообщения, обрабатывающего или возвращая значение AuthStatus или бросая AuthException.

Параметры:

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

clientSubject - Предмет, который представляет получателя ответа службы, или нуль. Это может использоваться реализацией метода в качестве источника Принципалов или учетных данных, которые будут использоваться, чтобы проверить ответа. Если Предметом не является нуль, реализация метода может добавить дополнительные Принципалы или учетные данные (имеющий отношение к получателю запроса на обслуживание) к Предмету.

serviceSubject - Предмет, который представляет источник ответа службы, или нуль. Если Предметом не является нуль, реализация метода может добавить дополнительные Принципалы или учетные данные (имеющий отношение к источнику ответа службы) к Предмету.

Возвраты:

Объект AuthStatus представление состояния завершения обработки выполняется методом. Значения AuthStatus, которые могут быть возвращены этим методом, определяются следующим образом:

• AuthStatus. УСПЕХ, когда сообщение ответа приложения было успешно проверено. Проверенное сообщение доступно, вызывая getResponseMessage на messageInfo.
• AuthStatus. SEND_CONTINUE, чтобы указать, что проверка допустимости ответа является неполной, и что запрос продолжения был возвращен как сообщение запроса в пределах messageInfo. Это значение состояния служит, чтобы сообщить времени выполнения вызова, что (чтобы успешно завершить обмен сообщениями) это должно будет быть способно к продолжению диалогового окна сообщения, проводя по крайней мере один дополнительный обмен запроса/ответа.
• AuthStatus. ОТКАЗ указать, что проверка допустимости ответа, отказавшего, и что сообщение ответа отказа было установлено в messageInfo.

Броски:

AuthException - Когда обработка сообщения, отказавшая, не устанавливая сообщение ответа отказа (в messageInfo).

cleanSubject

void cleanSubject(MessageInfo messageInfo,
                  javax.security.auth.Subject subject)
                  throws AuthException

Удалите реализацию определенные принципалы и учетные данные от предмета.

Параметры:

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

subject - Подчиненный экземпляр, из которого должны быть удалены Принципалы и учетные данные.

Броски:

AuthException - Если ошибка происходит во время Подчиненной обработки.