- java.lang.Object
-
- javax.security.auth.kerberos.KerberosPrincipal
-
- All Implemented Interfaces:
- Serializable, Principal
public final class KerberosPrincipal extends Object implements Principal, Serializable
This class encapsulates a Kerberos principal.- Since:
- 1.4
- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field and Description static int
KRB_NT_PRINCIPAL
user principal name type.static int
KRB_NT_SRV_HST
service with host name as instance (telnet, rcommands) name type.static int
KRB_NT_SRV_INST
service and other unique instance (krbtgt) name type.static int
KRB_NT_SRV_XHST
service with host as remaining components name type.static int
KRB_NT_UID
unique ID name type.static int
KRB_NT_UNKNOWN
unknown name type.
-
Constructor Summary
Constructors Constructor and Description KerberosPrincipal(String name)
Constructs a KerberosPrincipal from the provided string input.KerberosPrincipal(String name, int nameType)
Constructs a KerberosPrincipal from the provided string and name type input.
-
Method Summary
Methods Modifier and Type Method and Description boolean
equals(Object other)
Compares the specified Object with this Principal for equality.String
getName()
The returned string corresponds to the single-string representation of a Kerberos Principal name as specified in Section 2.1 of RFC 1964.int
getNameType()
Returns the name type of the KerberosPrincipal.String
getRealm()
Returns the realm component of this Kerberos principal.int
hashCode()
Returns a hashcode for this principal.String
toString()
Returns a string representation of the object.
-
-
-
Field Detail
-
KRB_NT_UNKNOWN
public static final int KRB_NT_UNKNOWN
unknown name type.- See Also:
- Constant Field Values
-
KRB_NT_PRINCIPAL
public static final int KRB_NT_PRINCIPAL
user principal name type.- See Also:
- Constant Field Values
-
KRB_NT_SRV_INST
public static final int KRB_NT_SRV_INST
service and other unique instance (krbtgt) name type.- See Also:
- Constant Field Values
-
KRB_NT_SRV_HST
public static final int KRB_NT_SRV_HST
service with host name as instance (telnet, rcommands) name type.- See Also:
- Constant Field Values
-
KRB_NT_SRV_XHST
public static final int KRB_NT_SRV_XHST
service with host as remaining components name type.- See Also:
- Constant Field Values
-
KRB_NT_UID
public static final int KRB_NT_UID
unique ID name type.- See Also:
- Constant Field Values
-
-
Constructor Detail
-
KerberosPrincipal
public KerberosPrincipal(String name)
Constructs a KerberosPrincipal from the provided string input. The name type for this principal defaults toKRB_NT_PRINCIPAL
This string is assumed to contain a name in the format that is specified in Section 2.1.1. (Kerberos Principal Name Form) of RFC 1964 (for example, duke@FOO.COM, where duke represents a principal, and FOO.COM represents a realm).If the input name does not contain a realm, the default realm is used. The default realm can be specified either in a Kerberos configuration file or via the java.security.krb5.realm system property. For more information, Kerberos Requirements
- Parameters:
name
- the principal name- Throws:
IllegalArgumentException
- if name is improperly formatted, if name is null, or if name does not contain the realm to use and the default realm is not specified in either a Kerberos configuration file or via the java.security.krb5.realm system property.
-
KerberosPrincipal
public KerberosPrincipal(String name, int nameType)
Constructs a KerberosPrincipal from the provided string and name type input. The string is assumed to contain a name in the format that is specified in Section 2.1 (Mandatory Name Forms) of RFC 1964. Valid name types are specified in Section 6.2 (Principal Names) of RFC 4120. The input name must be consistent with the provided name type. (for example, duke@FOO.COM, is a valid input string for the name type, KRB_NT_PRINCIPAL where duke represents a principal, and FOO.COM represents a realm).If the input name does not contain a realm, the default realm is used. The default realm can be specified either in a Kerberos configuration file or via the java.security.krb5.realm system property. For more information, see Kerberos Requirements.
- Parameters:
name
- the principal namenameType
- the name type of the principal- Throws:
IllegalArgumentException
- if name is improperly formatted, if name is null, if the nameType is not supported, or if name does not contain the realm to use and the default realm is not specified in either a Kerberos configuration file or via the java.security.krb5.realm system property.
-
-
Method Detail
-
getRealm
public String getRealm()
Returns the realm component of this Kerberos principal.- Returns:
- the realm component of this Kerberos principal.
-
hashCode
public int hashCode()
Returns a hashcode for this principal. The hash code is defined to be the result of the following calculation:hashCode = getName().hashCode();
- Specified by:
hashCode
in interfacePrincipal
- Overrides:
hashCode
in classObject
- Returns:
- a hashCode() for the
KerberosPrincipal
- See Also:
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
-
equals
public boolean equals(Object other)
Compares the specified Object with this Principal for equality. Returns true if the given object is also aKerberosPrincipal
and the twoKerberosPrincipal
instances are equivalent. More formally twoKerberosPrincipal
instances are equal if the values returned bygetName()
are equal and the values returned bygetNameType()
are equal.
-
getName
public String getName()
The returned string corresponds to the single-string representation of a Kerberos Principal name as specified in Section 2.1 of RFC 1964.
-
getNameType
public int getNameType()
Returns the name type of the KerberosPrincipal. Valid name types are specified in Section 6.2 of RFC4120.- Returns:
- the name type.
-
toString
public String toString()
Description copied from class:Object
Returns a string representation of the object. In general, thetoString
method returns a string that "textually represents" this object. The result should be a concise but informative representation that is easy for a person to read. It is recommended that all subclasses override this method.The
toString
method for classObject
returns a string consisting of the name of the class of which the object is an instance, the at-sign character `@
', and the unsigned hexadecimal representation of the hash code of the object. In other words, this method returns a string equal to the value of:getClass().getName() + '@' + Integer.toHexString(hashCode())
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-javax/security/auth/kerberos/KerberosPrincipal.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.