Класс GSSManager

public abstract class GSSManager
extends Object

Этот класс служит фабрикой для других важных классов GSS-API и также предоставляет информацию о поддерживаемых механизмах. Он может создавать экземпляры классов, реализующих следующие три интерфейса GSS-API: GSSName, GSSCredential и GSSContext. Он также имеет методы для запроса списка доступных механизмов и типов имен, которые поддерживает каждый механизм.

Экземпляр по умолчанию GSSManager подкласса может быть получен через статический метод getInstance, но приложения могут свободно создавать другие подклассы GSSManager. Экземпляр по умолчанию GSSManager будет поддерживать механизм Kerberos v5 GSS-API, а также любые другие. Этот механизм идентифицируется Oid "1.2.840.113554.1.2.2" и определен в RFC 1964.

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

Предполагается, что будет три наиболее распространённых способа использования провайдеров:

1. Приложение не заботится о том, какой провайдер используется (случай по умолчанию).
2. Приложение хочет, чтобы определённый провайдер использовался в приоритете, либо для определённого механизма, либо всегда, независимо от механизма.
3. Приложение хочет использовать локально настроенные провайдеры по возможности, но если отсутствует поддержка одного или нескольких механизмов, то оно хочет перейти к собственному провайдеру.

Класс GSSManager имеет два метода, которые позволяют использовать эти режимы: addProviderAtFront и addProviderAtEnd. Эти методы создают упорядоченный список пар <провайдер, oid>, где каждая пара указывает предпочтение провайдера для данного oid.

Важно отметить, что существуют определенные взаимодействия между различными объектами GSS-API, созданными GSSManager, где провайдер, используемый для определенного механизма, должен быть согласован во всех объектах. Например, если GSSCredential содержит элементы из провайдера p для механизма m, то его следует передавать в GSSContext, который будет использовать провайдер p для механизма m. Простым правилом, которое максимизирует портативность, является то, что объекты, созданные из разных GSSManager, не должны смешиваться, и, если возможно, должен быть создан другой экземпляр GSSManager, если приложение хочет вызвать метод addProviderAtFront на GSSManager, который уже создал объект.

Вот пример кода, показывающий, как может быть использован GSSManager:

GSSManager manager = GSSManager.getInstance();

     Oid krb5Mechanism = new Oid("1.2.840.113554.1.2.2");
     Oid krb5PrincipalNameType = new Oid("1.2.840.113554.1.2.2.1");

     // Identify who the client wishes to be
     GSSName userName = manager.createName("duke", GSSName.NT_USER_NAME);

     // Identify the name of the server. This uses a Kerberos specific
     // name format.
     GSSName serverName = manager.createName("nfs/foo.sun.com",
                                             krb5PrincipalNameType);

     // Acquire credentials for the user
     GSSCredential userCreds = manager.createCredential(userName,
                                             GSSCredential.DEFAULT_LIFETIME,
                                             krb5Mechanism,
                                             GSSCredential.INITIATE_ONLY);

     // Instantiate and initialize a security context that will be
     // established with the server
     GSSContext context = manager.createContext(serverName,
                                                krb5Mechanism,
                                                userCreds,
                                                GSSContext.DEFAULT_LIFETIME);

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

// Acquire credentials for the server
     GSSCredential serverCreds = manager.createCredential(serverName,
                                             GSSCredential.DEFAULT_LIFETIME,
                                             krb5Mechanism,
                                             GSSCredential.ACCEPT_ONLY);

     // Instantiate and initialize a security context that will
     // wait for an establishment request token from the client
     GSSContext context = manager.createContext(serverCreds);

Конструкторы

GSSManager

public GSSManager()