Spec-Zone.ru › OpenJDK 24

Интерфейс 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);
С:
1.4
См. также:
  • export()
  • equals(GSSName)
  • GSSManager.createName(String, Oid)
  • GSSManager.createName(String, Oid, Oid)
  • GSSManager.createName(byte[], Oid)

Краткое описание полей

Модификатор и тип Поле Описание
static final Oid NT_ANONYMOUS
Тип имени для представления анонимной сущности.
static final Oid NT_EXPORT_NAME
Тип имени, используемый для обозначения экспортированного имени, созданного методом экспорта.
static final Oid NT_HOSTBASED_SERVICE
Oid, указывающий на форму имени службы на основе хоста.
static final Oid NT_MACHINE_UID_NAME
Тип имени, обозначающий числовой идентификатор пользователя, соответствующий пользователю в локальной системе.
static final Oid NT_STRING_UID_NAME
Тип имени, обозначающий строку цифр, представляющую числовой идентификатор пользователя пользователя в локальной системе.
static final Oid NT_USER_NAME
Тип имени, обозначающий пользователя с именем в локальной системе.

Краткое описание методов

Модификатор и тип Метод Описание
GSSName canonicalize(Oid mech)
Создаёт имя, канонизированное для некоторого механизма.
boolean equals(Object another)
Сравнивает этот объект GSSName с другим объектом, который может быть GSSName.
boolean equals(GSSName another)
Сравнивает два объекта GSSName, чтобы определить, ссылаются ли они на одну и ту же сущность.
byte[] export()
Возвращает каноническое непрерывное байтовое представление имени механизма (MN), подходящее для прямого, байтового по байту сравнения функциями авторизации.
Oid getStringNameType()
Возвращает тип имени печатного представления этого имени, которое можно получить из метода toString.
int hashCode()
Возвращает значение хэш-кода для этого GSSName.
boolean isAnonymous()
Проверяет, представляет ли этот объект имени анонимную сущность.
boolean isMN()
Проверяет, представляет ли этот объект имени имя механизма (MN).
String toString()
Возвращает текстовое представление объекта GSSName.
END_OF_DOCUMENT_MARKER

Подробное описание полей

NT_HOSTBASED_SERVICE

static final Oid NT_HOSTBASED_SERVICE
OID, указывающий на имя службы, основанной на хосте. Используется для представления служб, связанных с компьютерами-хостами. Это имя формируется с использованием двух элементов: "service" и "hostname", следующим образом: service@hostname.

Представляет следующее значение OID:
{ iso(1) member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) generic(1) service_name(4) }

NT_USER_NAME

static final Oid NT_USER_NAME
Тип имени для обозначения пользователя с именем на локальной системе.

Представляет следующее значение OID:
{ iso(1) member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) generic(1) user_name(1) }

NT_MACHINE_UID_NAME

static final Oid NT_MACHINE_UID_NAME
Тип имени, указывающий на числовой идентификатор пользователя, соответствующий пользователю в локальной системе. (например, Uid).

Представляет следующее значение OID:
{ iso(1) member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) generic(1) machine_uid_name(2) }

NT_STRING_UID_NAME

static final Oid NT_STRING_UID_NAME
Тип имени, указывающий на строку цифр, представляющую числовой идентификатор пользователя пользователя в локальной системе.

Представляет следующее значение OID:
{ iso(1) member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) generic(1) string_uid_name(3) }

NT_ANONYMOUS

static final Oid NT_ANONYMOUS
Тип имени для представления анонимного сущности.

Представляет следующее значение OID:
{ 1(iso), 3(org), 6(dod), 1(internet), 5(security), 6(nametypes), 3(gss-anonymous-name) }

NT_EXPORT_NAME

static final Oid NT_EXPORT_NAME
Тип имени, используемый для обозначения экспортированного имени, созданного методом экспорта.

Представляет следующее значение OID:
{ 1(iso), 3(org), 6(dod), 1(internet), 5(security), 6(nametypes), 4(gss-api-exported-name) }

Подробное описание методов

equals

boolean equals(GSSName another) throws GSSException
Сравнивает два объекта GSSName, чтобы определить, ссылаются ли они на ту же сущность.
Параметры:
another - GSSName для сравнения с этим именем
Возвращает:
true, если два имени содержат хотя бы один общий примитивный элемент. Если какое-либо из имен представляет анонимную сущность, метод вернёт false.
Исключение:
GSSException - когда имена нельзя сравнить, содержащие следующие основные коды ошибок: GSSException.BAD_NAMETYPE, GSSException.FAILURE

equals

boolean equals(Object another)
Сравнивает этот объект GSSName с другим объектом, который может быть GSSName. Поведение точно такое же, как в equals, за исключением того, что GSSException не выбрасывается; вместо этого возвращается false в ситуации, когда возникает ошибка.
Переопределяет:
equals в классе Object
Параметры:
another - объект для сравнения с этим именем
Возвращает:
true, если сравниваемый объект также является GSSName и два имени относятся к одной и той же сущности.
См. также:
  • equals(GSSName)

hashCode

int hashCode()
Возвращает значение хеш-кода для этого GSSName.
Переопределяет:
hashCode в классе Object
Возвращает:
значение хеш-кода для этого GSSName
См. также:
  • Object.equals(java.lang.Object)
  • System.identityHashCode(java.lang.Object)

canonicalize

GSSName canonicalize(Oid mech) throws GSSException
Создаёт имя, канонизированное для некоторого механизма.
Параметры:
mech - OID для механизма, для которого запрашивается каноническая форма имени.
Возвращает:
GSSName, содержащий только один примитивный элемент, представляющий это имя в канонизированной форме для требуемого механизма.
Исключение:
GSSException - содержащий следующие основные коды ошибок: GSSException.BAD_MECH, GSSException.BAD_NAMETYPE, GSSException.BAD_NAME, GSSException.FAILURE

export

byte[] export() throws GSSException
Возвращает каноническое непрерывное байтовое представление имени механизма (MN), пригодное для прямого байтового сравнения функциями авторизации. Если имя не является MN, реализации могут выбросить GSSException с кодом состояния NAME_NOT_MN. Если реализация выбирает не выбрасывать исключение, она должна использовать некоторый специфичный для системы механизм для канонизации имени и затем экспортировать его. Структурно, объект экспортированного имени состоит из заголовка, содержащего OID, идентифицирующего механизм, который аутентифицировал имя, и трейлера, содержащего само имя, где синтаксис трейлера определяется индивидуальной спецификацией механизма. Формат заголовка выходного буфера указан в RFC 2743.

Экспортированное имя полезно при использовании в больших списках управления доступом, где накладные расходы на создание объекта GSSName на каждом имени и вызов метода equals для каждого имени из списка управления доступом могут быть чрезмерными.

Экспортированные имена можно повторно импортировать, используя фабричный метод массива байтов GSSManager.createName и указание NT_EXPORT_NAME в качестве идентификатора объекта типа имени. Результирующее имя GSSName также будет MN.

Возвращает:
массив байтов byte[], содержащий экспортированное имя. RFC 2743 определяет «Формат механизма независимого экспортированного объекта имени» для этих байтов.
Исключение:
GSSException - содержащий следующие основные коды ошибок: GSSException.BAD_NAME, GSSException.BAD_NAMETYPE, GSSException.FAILURE

toString

String toString()
Возвращает текстовое представление объекта GSSName. Для получения печатного формата имени, который определяет синтаксис возвращаемой строки, используйте метод getStringNameType.
Переопределяет:
toString в классе Object
Возвращает:
строку String, представляющую это имя в печатном формате.

getStringNameType

Oid getStringNameType() throws GSSException
Возвращает тип имени печатного представления этого имени, которое можно получить из метода toString.
Возвращает:
OID, представляющий пространство имён имени, возвращённого методом toString.
Исключение:
GSSException - содержащий следующий основной код ошибки: GSSException.FAILURE

isAnonymous

boolean isAnonymous()
Проверяет, представляет ли этот объект имени анонимную сущность.
Возвращает:
true, если это анонимное имя, иначе false.

isMN

boolean isMN()
Проверяет, представляет ли этот объект имени Имя механизма (MN). MN — это GSSName, содержащий ровно один примитивный элемент имени механизма.
Возвращает:
true, если это MN, иначе false.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.security.jgss/org/ietf/jgss/GSSName.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API