Класс KerberosPrincipal
- java.lang.Object
-
- javax.security.auth.kerberos.KerberosPrincipal
- Все реализованные интерфейсы:
-
Serializable,Principal
public final class KerberosPrincipal extends Object implements Principal, Serializable
Этот класс инкапсулирует Kerberos-принципал.
- С тех пор:
- 1.4
- См. также:
- Сериализованная форма
Поля
| Модификатор и тип | Поле | Описание |
|---|---|---|
static int | KRB_NT_PRINCIPAL | Тип имени пользователя-принципала. |
static int | KRB_NT_SRV_HST | Тип имени службы с именем хоста в качестве экземпляра (telnet, rcommands). |
static int | KRB_NT_SRV_INST | Тип имени службы и других уникальных экземпляров (krbtgt). |
static int | KRB_NT_SRV_XHST | Тип имени службы с хостом как оставшимися компонентами. |
static int | KRB_NT_UID | Тип имени уникального идентификатора. |
static int | KRB_NT_UNKNOWN | Неизвестный тип имени. |
Конструкторы
| Конструктор | Описание |
|---|---|
KerberosPrincipal(String name) | Создаёт |
KerberosPrincipal(String name,
int nameType) | Создаёт |
Методы
| Модификатор и тип | Метод | Описание |
|---|---|---|
boolean | equals(Object other) | Сравнивает указанный объект с этим принципалом на равенство. |
String | getName() | Возвращаемая строка соответствует однострочному представлению имени принципала Kerberos, как указано в разделе 2.1 документа RFC 1964. |
int | getNameType() | Возвращает тип имени |
String | getRealm() | Возвращает компонент области этого принципала Kerberos. |
int | hashCode() | Возвращает хэш-код для этого |
String | toString() | Возвращает информативное текстовое представление этого |
Методы, объявленные в классе 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
тип имени с уникальным идентификатором.
- См. также:
- Значения константных полей
Конструкторы
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. Кроме того, если установлен менеджер безопасности, необходимо предоставить 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. Кроме того, если установлен менеджер безопасности, необходимо предоставить 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.
getNameType
public int getNameType()
Возвращает тип имени принципала. Допустимые типы имен указаны в разделе 6.2 из RFC4120.
- Возвращает:
- тип имени.
toString
public String toString()
Возвращает информативное текстовое представление этого KerberosPrincipal.
© 1993, 2020, 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/11/docs/api/java.security.jgss/javax/security/auth/kerberos/KerberosPrincipal.html