Интерфейс GSSName

public interface GSSName

Этот интерфейс инкапсулирует один GSS-API сущность принципала. Приложение получает реализацию этого интерфейса через один из createName методов, существующих в классе GSSManager. По сути, GSSName содержит множество представлений сущности или множество элементов примитивного имени, по одному для каждого поддерживаемого базового механизма. В терминологии GSS, GSSName, содержащий элемент только одного механизма, называется Именем Механизма (MN).

Поскольку различные механизмы аутентификации могут использовать различные пространства имён для идентификации своих принципалов, поддержка имён GSS-API неизбежно сложна в многомеханических средах (или даже в некоторых одномеханических средах, где базовый механизм поддерживает несколько пространств имён). Разные форматы имён и их определения идентифицируются с помощью Oid's, и в этом интерфейсе определены некоторые стандартные типы. Формат имён может быть выведен на основе уникального Oid типа имени.

Ниже приведены примеры кода, использующие интерфейс GSSName. Приведенный ниже код создаёт GSSName, преобразует его в MN, выполняет сравнение, получает удобочитаемое представление имени, экспортирует его в массив байтов и затем повторно импортирует, чтобы получить новое GSSName.

GSSManager manager = GSSManager.getInstance();

      // create a host based service name
      GSSName name = manager.createName("service@host",
                   GSSName.NT_HOSTBASED_SERVICE);

      Oid krb5 = new Oid("1.2.840.113554.1.2.2");

      GSSName mechName = name.canonicalize(krb5);

      // the above two steps are equivalent to the following
      GSSName mechName = manager.createName("service@host",
                      GSSName.NT_HOSTBASED_SERVICE, krb5);

      // perform name comparison
      if (name.equals(mechName))
              print("Names are equals.");

      // obtain textual representation of name and its printable
      // name type
      print(mechName.toString() +
                      mechName.getStringNameType().toString());

      // export and re-import the name
      byte [] exportName = mechName.export();

      // create a new name object from the exported buffer
      GSSName newName = manager.createName(exportName,
                      GSSName.NT_EXPORT_NAME);

Если установлен менеджер безопасности, для создания GSSName, содержащего элемент имени Kerberos без предоставления его домена, необходимо предоставить разрешение ServicePermission, и основной принцип службы разрешения должен находиться как минимум внутри домена элемента имени Kerberos. Например, если результат createName("user", NT_USER_NAME) содержит элемент имени Kerberos user@EXAMPLE.COM, то необходимо предоставить разрешение ServicePermission с основным принципалом службы host/www.example.com@EXAMPLE.COM (и любыми действиями). В противном случае, создание вызовет GSSException, содержащий код ошибки GSSException.FAILURE.