Интерфейс GSSContext

Вызывается инициатором контекста для начала фазы создания контекста и обработки любых токенов, сгенерированных методом партнера acceptSecContext. Этот метод может вернуть токен вывода, который приложение должно отправить партнеру для обработки его методом acceptSecContext. Приложение может вызвать isEstablished для определения, завершена ли фаза установления контекста с этой стороны контекста. Значение возврата false от isEstablished указывает на то, что ожидается больше токенов, которые будут предоставлены initSecContext. После завершения установления контекста доступные параметры контекста можно запросить с помощью методов get.

Обратите внимание, что метод initSecContext может вернуть токен для партнера, и метод isEstablished также вернуть true. Это указывает на то, что токен необходимо отправить партнеру, но локальный конец контекста теперь полностью установлен.

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

Вызывается инициатором контекста для начала фазы создания контекста и обработки любых токенов, сгенерированных методом партнера acceptSecContext с использованием потоков. Этот метод может записать токен вывода в OutpuStream, который приложение должно отправить партнеру для обработки его вызовом acceptSecContext . Обычно приложение гарантирует это, вызывая метод flush на OutputStream, который инкапсулирует соединение между двумя партнерами. Приложение может определить, был ли токен записан в OutputStream по значению возврата этого метода. Значение возврата 0 указывает, что токен не был записан. Приложение может вызвать isEstablished для определения, завершена ли фаза установления контекста с этой стороны контекста. Значение возврата false от isEstablished указывает на то, что ожидается больше токенов, которые будут предоставлены initSecContext. После завершения установления контекста доступные параметры контекста можно запросить с помощью методов get.

Обратите внимание, что метод initSecContext может вернуть токен для партнера, и метод isEstablished также вернуть true. Это указывает на то, что токен необходимо отправить партнеру, но локальный конец контекста теперь полностью установлен.

Токены аутентификации GSS-API содержат определенный начальный и конечный маркер. Этот метод попытается прочитать один из этих маркеров при каждом вызове и может блокироваться на потоке, если доступна только часть токена. Во всех других отношениях этот метод эквивалентен методу на основе массива байтов initSecContext.

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

Следующий пример кода демонстрирует, как можно использовать этот метод:

InputStream is ...
     OutputStream os ...
     GSSContext context ...

     // Loop while there is still a token to be processed

     while (!context.isEstablished()) {

         context.initSecContext(is, os);

         // send output token if generated
         os.flush();
     }

Вызывается приемником контекста при получении токена от партнера. Этот метод может вернуть токен вывода, который приложение должно отправить партнеру для дальнейшей обработки его вызовом initSecContext.

Приложение может вызвать isEstablished для определения, завершена ли фаза установления контекста для данного партнера. Значение возврата false от isEstablished указывает на то, что ожидается больше токенов, которые будут предоставлены этому методу. После завершения установления контекста доступные параметры контекста можно запросить с помощью методов get.

Обратите внимание, что acceptSecContext может вернуть токен для партнера, а isEstablished также вернуть true. Это указывает, что токен необходимо отправить партнеру, но локальный конец контекста теперь полностью установлен.

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

Следующий пример кода демонстрирует, как можно использовать этот метод:

byte[] inToken;
     byte[] outToken;
     GSSContext context ...

     // Loop while there is still a token to be processed

     while (!context.isEstablished()) {
         inToken = readToken();
         outToken = context.acceptSecContext(inToken, 0,
                                             inToken.length);
         // send output token if generated
         if (outToken != null)
             sendToken(outToken);
     }

Вызывается приемником контекста для обработки маркера от соседа с использованием потоков. Он может записать маркер вывода в OutputStream, который приложение должно будет отправить соседу для обработки его методом initSecContext. Обычно приложение обеспечит это, вызвав метод flush для объекта OutputStream, который инкапсулирует соединение между двумя соседями. Приложение может вызвать isEstablished, чтобы определить, завершен ли фаза установления контекста на этой стороне. Значение false метода isEstablished указывает, что ожидается предоставление дополнительных маркеров методу acceptSecContext. После завершения установления контекста доступные опции контекста могут быть запрошены через методы получения.

Обратите внимание, что acceptSecContext может вернуть маркер для соседа, а isEstablished может вернуть true также. Это указывает, что маркер нужно отправить соседу, но локальная часть контекста теперь полностью установлена.

Маркеры аутентификации GSS-API содержат определенные начало и конец. Этот метод попытается прочитать один из этих маркеров за вызов и может заблокироваться на потоке, если доступна только часть маркера. Во всех других аспектах этот метод эквивалентен методу на основе массива байтов acceptSecContext.

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

Следующий пример кода демонстрирует, как можно использовать этот метод:

InputStream is ...
     OutputStream os ...
     GSSContext context ...

     // Loop while there is still a token to be processed

     while (!context.isEstablished()) {

         context.acceptSecContext(is, os);

         // send output token if generated
         os.flush();
     }

Используется для определения ограничений на размер сообщения, которое может быть передано методу wrap. Возвращает максимальный размер сообщения, который, если будет представлен методу wrap с теми же параметрами confReq и qop, приведет к маркерам вывода, содержащим не более maxTokenSize байт.

Этот вызов предназначен для использования приложениями, которые взаимодействуют через протоколы, накладывающие максимальный размер сообщения. Он позволяет приложению фрагментировать сообщения перед применением защиты.

Реализации GSS-API рекомендуются, но не требуются для обнаружения недопустимых значений QOP при вызове getWrapSizeLimit. Эта процедура гарантирует только максимальный размер сообщения, а не доступность определенных значений QOP для защиты сообщений.

Применяет защитные услуги по сообщению над установленным защищенным контекстом. Метод вернет маркер с предоставленными приложением данными и криптографическим MIC над ними. Данные могут быть зашифрованы, если была запрошена конфиденциальность (privacy).

Объект MessageProp создается приложением и используется для задания значения QOP, которое выбирает криптографические алгоритмы, и службы конфиденциальности для необязательного шифрования сообщения. Подлежащий механизм, используемый в вызове, может не быть в состоянии предоставить службу конфиденциальности. Он устанавливает фактическую службу конфиденциальности, которую он предоставляет, в этом объекте MessageProp, который вызывающая сторона должна запросить по возвращении. Если механизм не может предоставить запрошенный QOP, он выбросит GSSException с кодом BAD_QOP.

Поскольку некоторые протоколы на уровне приложения могут захотеть использовать маркеры, выпущенные wrap, для предоставления "безопасной рамочной структуры", реализации должны поддерживать обертывание сообщений нулевой длины.

Приложение будет отвечать за отправку маркера соседу.

Применяет защитные услуги по сообщению над установленным защищенным контекстом с использованием потоков. Метод вернет маркер с предоставленными приложением данными и криптографическим MIC над ними. Данные могут быть зашифрованы, если была запрошена конфиденциальность (privacy). Этот метод эквивалентен методу на основе массива байтов wrap.

Приложение будет отвечать за отправку маркера соседу. Обычно приложение обеспечит это, вызвав метод flush для объекта OutputStream, который инкапсулирует соединение между двумя соседями.

Объект MessageProp создается приложением и используется для задания значения QOP, которое выбирает криптографические алгоритмы, и службы конфиденциальности для необязательного шифрования сообщения. Подлежащий механизм, используемый в вызове, может не быть в состоянии предоставить службу конфиденциальности. Он устанавливает фактическую службу конфиденциальности, которую он предоставляет, в этом объекте MessageProp, который вызывающая сторона должна запросить по возвращении. Если механизм не может предоставить запрошенный QOP, он выбросит GSSException с кодом BAD_QOP.

Поскольку некоторые протоколы на уровне приложения могут захотеть использовать маркеры, выпущенные wrap, для предоставления "безопасной рамочной структуры", реализации должны поддерживать обертывание сообщений нулевой длины.

Используется для обработки маркеров, сгенерированных методом wrap на другой стороне контекста. Метод вернет сообщение, предоставленное приложением соседа в вызове wrap, одновременно проверяя встроенный MIC для этого сообщения.

Объект MessageProp создается приложением и используется базовым механизмом для возврата информации вызывающей стороне, такой как QOP, применялась ли конфиденциальность к сообщению и другая дополнительная информация о состоянии сообщения.

Поскольку некоторые протоколы на уровне приложения могут захотеть использовать маркеры, выпущенные wrap, для предоставления "безопасной рамочной структуры", реализации должны поддерживать обертывание и разворачивание сообщений нулевой длины.

Использует потоки для обработки токенов, сгенерированных методом wrap на другой стороне контекста. Метод вернёт сообщение, предоставленное приложением-партнёром в вызове wrap, одновременно проверив встроенный MIC для этого сообщения.

Объект MessageProp инициализируется приложением и используется внутренним механизмом для возвращения информации вызывающей стороне, такой как QOP, применялась ли конфиденциальность к сообщению, и другая дополнительная информация о состоянии сообщения.

Так как некоторые протоколы прикладного уровня могут использовать токены, сгенерированные wrap, для обеспечения "защищённой структуры", реализации должны поддерживать обёртывание и развёртывание сообщений нулевой длины.

Формат входного токена, который считывает этот метод, определён в спецификации для используемого внутреннего механизма. Этот метод попытается прочитать один из этих токенов на каждый вызов. Если токен механизма содержит чёткий старт и стоп, этот метод может блокироваться на InputStream если доступна только часть токена. Если старт и стоп токена не определены, метод попытается обработать все доступные байты как часть токена.

Помимо возможного блокирования, описанного выше, этот метод эквивалентен методу unwrap на основе массива байт.

Возвращает токен, содержащий криптографический код целостности сообщения (MIC) для предоставленного сообщения для передачи приложению-партнёру. В отличие от wrap, который инкапсулирует сообщение пользователя в возвращаемом токене, только MIC сообщения возвращается в выходном токене.

Обратите внимание, что конфиденциальность может быть применена только через вызов wrap.

Поскольку некоторые протоколы прикладного уровня могут использовать токены, выпущенные getMIC, для обеспечения «защищённой структуры», реализации должны поддерживать вычисление MIC для сообщений нулевой длины.

Использует потоки для создания токена, содержащего криптографический MIC для предоставленного сообщения, для передачи приложению-партнёру. В отличие от wrap, который инкапсулирует сообщение пользователя в возвращаемом токене, только MIC сообщения создаётся в выходном токене. Этот метод эквивалентен методу getMIC на основе массива байт. Обратите внимание, что конфиденциальность может быть применена только через вызов wrap.

Поскольку некоторые протоколы прикладного уровня могут использовать токены, выпущенные getMIC, для обеспечения «защищённой структуры», реализации должны поддерживать вычисление MIC для сообщений нулевой длины.

Проверяет криптографический MIC, содержащийся в параметре токена, для предоставленного сообщения.

Объект MessageProp инициализируется приложением и используется внутренним механизмом для возвращения информации вызывающей стороне, такой как QOP, указывающий уровень защиты, применённой к сообщению, и другая дополнительная информация о состоянии сообщения.

Поскольку некоторые протоколы прикладного уровня могут использовать токены, выпущенные getMIC, для обеспечения «защищённой структуры», реализации должны поддерживать вычисление и проверку MIC для сообщений нулевой длины.

Использует потоки для проверки криптографического MIC, содержащегося в параметре токена, для предоставленного сообщения. Этот метод эквивалентен методу verifyMIC на основе массива байт. Объект MessageProp инициализируется приложением и используется внутренним механизмом для возвращения информации вызывающей стороне, такой как QOP, указывающий уровень защиты, применённой к сообщению, и другая дополнительная информация о состоянии сообщения.

Поскольку некоторые протоколы прикладного уровня могут использовать токены, выпущенные getMIC, для обеспечения «защищённой структуры», реализации должны поддерживать вычисление и проверку MIC для сообщений нулевой длины.

Формат входного токена, который считывает этот метод, определён в спецификации для используемого внутреннего механизма. Этот метод попытается прочитать один из этих токенов на каждый вызов. Если токен механизма содержит чёткий старт и стоп, этот метод может блокироваться на InputStream если доступна только часть токена. Если старт и стоп токена не определены, метод попытается обработать все доступные байты как часть токена.

Помимо возможного блокирования, описанного выше, этот метод эквивалентен методу verifyMIC на основе массива байт.

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

Этот метод деактивирует контекст безопасности и создает межпроцессный токен, который, при передаче в GSSManager.createContext в другом процессе, повторно активирует контекст во втором процессе. Только одно экземпляр данного контекста может быть активным в любой момент времени; последующая попытка экспортера контекста получить доступ к экспортированному контексту безопасности завершится ошибкой.

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

Межпроцессный токен может содержать конфиденциальную информацию (например, криптографические ключи). Хотя механизмы должны избегать размещения такой конфиденциальной информации в межпроцессных токенах или шифровать токен перед его возвратом приложению, в типичной реализации GSS-API это может быть невозможно. Таким образом, приложение должно позаботиться о защите межпроцессного токена и убедиться, что любой процесс, которому передается токен, является надежным.

Реализации не обязаны поддерживать межпроцессную передачу контекстов безопасности. Вызов метода isTransferable укажет, может ли объект контекста передаваться.

Вызов этого метода для контекста, который не экспортируется, приведет к сбрасыванию исключения с кодом ошибки GSSException.UNAVAILABLE.

Запрашивает выполнение взаимной аутентификации во время создания контекста. Этот запрос может быть выполнен только со стороны инициатора контекста и должен быть выполнен до первого вызова initSecContext.

Не все механизмы поддерживают взаимную аутентификацию, и некоторые механизмы могут потребовать взаимной аутентификации даже если приложение этого не запрашивает. Поэтому приложение должно проверить, был ли запрос выполнен с помощью метода getMutualAuthState.

Запрашивает включение обнаружения повторных запросов для служб безопасности по сообщениям после создания контекста. Этот запрос может быть выполнен только со стороны инициатора контекста и должен быть выполнен до первого вызова initSecContext. Во время создания контекста обнаружение повторных запросов не является опцией и зависит от возможностей базового механизма.

Не все механизмы поддерживают обнаружение повторных запросов, и некоторые механизмы могут потребовать обнаружения повторных запросов, даже если приложение этого не запрашивает. Поэтому приложение должно проверить, был ли запрос выполнен с помощью метода getReplayDetState. Если обнаружение повторных запросов включено, то методы MessageProp.isDuplicateToken и MessageProp.isOldToken будут возвращать корректные результаты для объекта MessageProp, переданного в метод unwrap или метод verifyMIC.

Запрашивает включение проверки последовательности для служб безопасности по сообщениям после создания контекста. Этот запрос может быть выполнен только со стороны инициатора контекста и должен быть выполнен до первого вызова initSecContext. Во время создания контекста проверка последовательности не является опцией и зависит от возможностей базового механизма.

Не все механизмы поддерживают проверку последовательности, и некоторые механизмы могут потребовать проверки последовательности, даже если приложение этого не запрашивает. Поэтому приложение должно проверить, был ли запрос выполнен с помощью метода getSequenceDetState. Если проверка последовательности включена, то методы MessageProp.isDuplicateToken, MessageProp.isOldToken, MessageProp.isUnseqToken и MessageProp.isGapToken будут возвращать корректные результаты для объекта MessageProp, переданного в метод unwrap или метод verifyMIC.

Запрашивает делегирование учетных данных инициатора акцептору во время создания контекста. Этот запрос может быть выполнен только со стороны инициатора контекста и должен быть выполнен до первого вызова initSecContext. Не все механизмы поддерживают делегирование учетных данных. Поэтому приложение, которое хочет использовать делегирование, должно проверить, был ли запрос выполнен с помощью метода getCredDelegState. Если приложение указывает, что делегирование не должно использоваться, то механизм выполнит запрос, и делегирование не произойдет. Это исключение из общего правила, что механизм может включить услугу, даже если она не запрошена.

Запрашивает, чтобы идентификатор инициатора не раскрывался акцептору. Этот запрос может быть выполнен только со стороны инициатора контекста и должен быть выполнен до первого вызова initSecContext. Не все механизмы поддерживают анонимность инициатора. Поэтому приложение должно проверить, был ли запрос выполнен с помощью метода getAnonymityState.

Запрашивает включение конфиденциальности данных для метода wrap. Этот запрос может быть выполнен только со стороны инициатора контекста и должен быть выполнен до первого вызова initSecContext. Не все механизмы поддерживают конфиденциальность, и другие механизмы могут включить ее, даже если приложение этого не запрашивает. Приложение может проверить, был ли запрос выполнен с помощью метода getConfState. Если конфиденциальность включена, только тогда механизм выполнит запрос на конфиденциальность в объекте MessageProp, переданном в метод wrap.

Включение конфиденциальности также автоматически включает целостность.

Запрашивает включение целостности данных для методов wrap и getMIC. Этот запрос может быть выполнен только со стороны инициатора контекста и должен быть выполнен до первого вызова initSecContext. Не все механизмы поддерживают целостность, и другие механизмы могут включить ее, даже если приложение этого не запрашивает. Приложение может проверить, был ли запрос выполнен с помощью метода getIntegState.

Отключение целостности также автоматически отключит конфиденциальность.

Запрашивает время жизни контекста в секундах. Этот метод можно вызывать только со стороны инициатора контекста и до первого вызова initSecContext.

Фактическое время жизни контекста будет зависеть от возможностей базового механизма, и приложение должно вызвать метод getLifetime, чтобы определить его.

Определяет, включена ли делегация учётных данных в этом контексте. Его могут вызывать как инициатор, так и акцептор контекста. Для получения определенного ответа этот метод необходимо вызывать только после завершения создания контекста. Обратите внимание, что если инициатор запрашивает, чтобы делегация не разрешалась, метод requestCredDeleg учтёт этот запрос, и этот метод вернёт false со стороны инициатора с этого момента.

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

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

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

Определяет, аутентифицирован ли инициатор контекста анонимно для акцептора контекста. Его могут вызывать как инициатор, так и акцептор контекста в любое время. Со стороны инициатора вызов этого метода определяет, была ли раскрыта личность инициатора в каком-либо из маркеров установления контекста, которые могли быть сгенерированы до сих пор initSecContext. Инициатор, который абсолютно должен быть анонимно аутентифицирован, должен вызвать этот метод после каждого вызова initSecContext чтобы определить, должен ли он отправлять сгенерированный маркер партнеру или прервать контекст. Со стороны акцептора вызов этого метода определяет, раскрыла ли какая-либо из обработанных маркеров, полученных acceptSecContext, личность инициатора.

Определяет, доступна ли конфиденциальность данных по контексту. Этот метод может быть вызван как инициатором, так и акцептором контекста, но только после того, как один из методов isProtReady или isEstablished вернёт true. Если этот метод возвращает true, то и getIntegState вернёт true.

Определяет, доступна ли целостность данных по контексту. Этот метод может быть вызван как инициатором, так и акцептором контекста, но только после того, как один из методов isProtReady или isEstablished вернёт true. Этот метод всегда вернёт true, если getConfState вернёт true.

Определяет оставшееся время жизни этого контекста. Его могут вызывать как инициатор, так и акцептор контекста, но для получения определённого ответа его следует вызывать только после того, как isEstablished вернёт true.