Spec-Zone.ru › OpenJDK 17

Класс KerberosPrincipal

java.lang.Object
javax.security.auth.kerberos.KerberosPrincipal
Все реализованные интерфейсы:
Serializable, Principal
public final class KerberosPrincipal extends Object implements Principal, Serializable
Этот класс инкапсулирует Kerberos-принципал.
С:
1.4
См. также:
  • Сериализованная форма

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

Модификатор и тип Поле Описание
static final int KRB_NT_ENTERPRISE
Имя предприятия (псевдоним)
static final int KRB_NT_PRINCIPAL
Тип имени пользователя-принципала.
static final int KRB_NT_SRV_HST
Тип имени сервиса с именем хоста в качестве экземпляра (telnet, rcommands).
static final int KRB_NT_SRV_INST
Тип имени сервиса и другого уникального экземпляра (krbtgt).
static final int KRB_NT_SRV_XHST
Тип имени сервиса с хостом как оставшимися компонентами.
static final int KRB_NT_UID
Тип имени уникального идентификатора.
static final int KRB_NT_UNKNOWN
Тип имени неизвестного типа.

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

Конструктор Описание
KerberosPrincipal(String name)
Создаёт KerberosPrincipal из предоставленного строкового ввода.
KerberosPrincipal(String name, int nameType)
Создаёт KerberosPrincipal из предоставленной строки и типа имени.

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

Модификатор и тип Метод Описание
boolean equals(Object other)
Сравнивает указанный объект с этим принципалом на равенство.
String getName()
Возвращаемая строка соответствует строковому представлению имени Kerberos-принципала, как указано в разделе 2.1 RFC 1964.
int getNameType()
Возвращает тип имени KerberosPrincipal.
String getRealm()
Возвращает компонент домена этого Kerberos-принципала.
int hashCode()
Возвращает хеш-код для этого KerberosPrincipal.
String toString()
Возвращает информативное текстовое представление этого KerberosPrincipal.

Методы, объявленные в классе java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Методы, объявленные в интерфейсе java.security.Principal

implies

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

KRB_NT_UNKNOWN

public static final int KRB_NT_UNKNOWN
тип неизвестного имени.
См. также:
  • Значения константных полей

KRB_NT_PRINCIPAL

public static final int KRB_NT_PRINCIPAL
тип имени пользователя.
См. также:
  • Значения константных полей

KRB_NT_SRV_INST

public static final int KRB_NT_SRV_INST
тип имени службы и других уникальных экземпляров (krbtgt).
См. также:
  • Значения константных полей

KRB_NT_SRV_HST

public static final int KRB_NT_SRV_HST
тип имени службы с именем хоста в качестве экземпляра (telnet, rcommands).
См. также:
  • Значения константных полей

KRB_NT_SRV_XHST

public static final int KRB_NT_SRV_XHST
тип имени службы с хостом в качестве оставшихся компонентов.
См. также:
  • Значения константных полей

KRB_NT_UID

public static final int KRB_NT_UID
тип имени уникального идентификатора.
См. также:
  • Значения константных полей

KRB_NT_ENTERPRISE

public static final int KRB_NT_ENTERPRISE
Название предприятия (псевдоним)
С тех пор:
13
См. также:
  • Значения константных полей

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

KerberosPrincipal

public KerberosPrincipal(String name)
Создаёт KerberosPrincipal из предоставленного строкового ввода. Тип имени для этого принципала по умолчанию KRB_NT_PRINCIPAL. Предполагается, что эта строка содержит имя в формате, указанном в разделе 2.1.1 (Форма имени принципала Kerberos) из RFC 1964 (например, duke@FOO.COM, где duke представляет принципала, а FOO.COM — область).

Если имя ввода не содержит область, используется область по умолчанию. Область по умолчанию может быть указана в файле конфигурации Kerberos или через системную переменную java.security.krb5.realm. Дополнительную информацию см. в Требования к Kerberos.

Обратите внимание, что при первоначальной загрузке и инициализации этого класса или любого другого класса, связанного с Kerberos, может быть прочитана и кэширована область по умолчанию из файла конфигурации Kerberos или через системную переменную java.security.krb5.realm (значение будет пустым, если область по умолчанию не указана), поэтому любые последующие попытки установить или изменить область по умолчанию путём установки системной переменной java.security.krb5.realm могут быть проигнорированы.

Кроме того, если установлен менеджер безопасности, необходимо предоставить ServicePermission, и имя службы разрешения должно находиться в области KerberosPrincipal. Например, если результатом new KerberosPrincipal("user") является user@EXAMPLE.COM, то необходимо предоставить ServicePermission с именем службы host/www.example.com@EXAMPLE.COM (и любыми действиями).

Параметры:
name - имя принципала
Исключения:
IllegalArgumentException - если имя имеет неправильный формат, если имя null, или если имя не содержит область для использования, а область по умолчанию не указана ни в файле конфигурации Kerberos, ни через системную переменную java.security.krb5.realm.
SecurityException - если установлен менеджер безопасности, и name не содержит область для использования, и соответствующее ServicePermission, как описано выше, не предоставлено.

KerberosPrincipal

public KerberosPrincipal(String name, int nameType)
Создаёт KerberosPrincipal из предоставленной строки и ввода типа имени. Строка предполагается содержащей имя в формате, указанном в разделе 2.1 (Обязательные формы имён) из RFC 1964. Допустимые типы имён указаны в разделе 6.2 (Имена принципалов) из RFC 4120. Введённое имя должно соответствовать предоставленному типу имени. (например, duke@FOO.COM - допустимая строка ввода для типа имени KRB_NT_PRINCIPAL, где duke представляет принципала, а FOO.COM - область).

Если имя ввода не содержит область, используется область по умолчанию. Область по умолчанию может быть указана в файле конфигурации Kerberos или через системную переменную java.security.krb5.realm . Дополнительную информацию см. в Требования к Kerberos.

Обратите внимание, что при первоначальной загрузке и инициализации этого класса или любого другого класса, связанного с Kerberos, может быть прочитана и кэширована область по умолчанию из файла конфигурации Kerberos или через системную переменную java.security.krb5.realm (значение будет пустым, если область по умолчанию не указана), поэтому любые последующие попытки установить или изменить область по умолчанию путём установки системной переменной java.security.krb5.realm могут быть проигнорированы.

Кроме того, если установлен менеджер безопасности, необходимо предоставить ServicePermission, и имя службы разрешения должно находиться в области KerberosPrincipal. Например, если результатом new KerberosPrincipal("user") является user@EXAMPLE.COM, то необходимо предоставить ServicePermission с именем службы host/www.example.com@EXAMPLE.COM (и любыми действиями).

Параметры:
name - имя принципала
nameType - тип имени принципала
Исключения:
IllegalArgumentException - если имя имеет неправильный формат, если имя null, если тип имени не поддерживается, или если имя не содержит область для использования, а область по умолчанию не указана ни в файле конфигурации Kerberos, ни через системную переменную java.security.krb5.realm.
SecurityException - если установлен менеджер безопасности, и name не содержит область для использования, и соответствующее ServicePermission, как описано выше, не предоставлено.

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

getRealm

public String getRealm()
Возвращает компонент области этого принципала Kerberos.
Возвращает:
компонент области этого принципала Kerberos.

hashCode

public int hashCode()
Возвращает хеш-код для этого KerberosPrincipal. Хеш-код определяется как результат следующего вычисления:

  hashCode = getName().hashCode();
 
Задано в:
hashCode в интерфейсе Principal
Переопределяет:
hashCode в классе Object
Возвращает:
хеш-код для этого KerberosPrincipal.
См. также:
  • Object.equals(java.lang.Object)
  • System.identityHashCode(java.lang.Object)

equals

public boolean equals(Object other)
Сравнивает указанный объект с этим принципалом на равенство. Возвращает true, если заданный объект также является KerberosPrincipal и два объекта KerberosPrincipal эквивалентны. Более формально, два объекта KerberosPrincipal равны, если значения, возвращаемые getName() , равны.
Задано в:
equals в интерфейсе Principal
Переопределяет:
equals в классе Object
Параметры:
other - объект для сравнения
Возвращает:
true, если переданный объект представляет тот же принципал, что и этот, в противном случае false.
См. также:
  • Object.hashCode()
  • HashMap

getName

public String getName()
Возвращаемая строка соответствует одностроковому представлению имени принципала Kerberos, как указано в разделе 2.1 из RFC 1964.
Задано в:
getName в интерфейсе Principal
Возвращает:
имя принципала.

getNameType

public int getNameType()
Возвращает тип имени KerberosPrincipal. Допустимые типы имён указаны в разделе 6.2 из RFC4120.
Возвращает:
тип имени.

toString

public String toString()
Возвращает информативное текстовое представление этого KerberosPrincipal.
Определено в:
toString в интерфейсе Principal
Переопределяет:
toString в классе Object
Возвращает:
информативное текстовое представление этого KerberosPrincipal.

© 1993, 2021, 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://docs.oracle.com/en/java/javase/17/docs/api/java.security.jgss/javax/security/auth/kerberos/KerberosPrincipal.html

Spec-Zone.ru

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