Package Summary  Overview Summary

class:KerberosPrincipal [NONE]

field:KRB_NT_UNKNOWN [NONE]

field:KRB_NT_PRINCIPAL [NONE]

  • KRB_NT_PRINCIPAL

    public static final int KRB_NT_PRINCIPAL
    user principal name type.
    See Also:
    Constant Field Values

field:KRB_NT_SRV_INST [NONE]

  • 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

field:KRB_NT_SRV_HST [NONE]

  • 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

field:KRB_NT_SRV_XHST [NONE]

  • 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

field:KRB_NT_UID [NONE]

constructor:<init>(java.lang.String) [NONE]

  • KerberosPrincipal

    public KerberosPrincipal​(String name)
    Constructs a KerberosPrincipal from the provided string input. The name type for this principal defaults to KRB_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, see the Kerberos Requirements . Additionally, if a security manager is installed, a ServicePermission must be granted and the service principal of the permission must minimally be inside the KerberosPrincipal's realm. For example, if the result of new KerberosPrincipal("user") is user@EXAMPLE.COM, then a ServicePermission with service principal host/www.example.com@EXAMPLE.COM (and any action) must be granted.

    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.
    SecurityException - if a security manager is installed and name does not contain the realm to use, and a proper ServicePermission as described above is not granted.

constructor:<init>(java.lang.String,int) [NONE]

  • 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 the Kerberos Requirements . Additionally, if a security manager is installed, a ServicePermission must be granted and the service principal of the permission must minimally be inside the KerberosPrincipal's realm. For example, if the result of new KerberosPrincipal("user") is user@EXAMPLE.COM, then a ServicePermission with service principal host/www.example.com@EXAMPLE.COM (and any action) must be granted.

    Parameters:
    name - the principal name
    nameType - 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.
    SecurityException - if a security manager is installed and name does not contain the realm to use, and a proper ServicePermission as described above is not granted.

method:getRealm() [NONE]

  • getRealm

    public String getRealm()
    Returns the realm component of this Kerberos principal.
    Returns:
    the realm component of this Kerberos principal.

method:hashCode() [NONE]

method:equals(java.lang.Object) [NONE]

  • equals

    public boolean equals​(Object other)
    Compares the specified object with this principal for equality. Returns true if the given object is also a KerberosPrincipal and the two KerberosPrincipal instances are equivalent. More formally two KerberosPrincipal instances are equal if the values returned by getName() are equal.
    Specified by:
    equals in interface Principal
    Overrides:
    equals in class Object
    Parameters:
    other - the object to compare to
    Returns:
    true if the object passed in represents the same principal as this one, false otherwise.
    See Also:
    Object.hashCode(), HashMap

method:getName() [NONE]

  • 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 .
    Specified by:
    getName in interface Principal
    Returns:
    the principal name.

method:getNameType() [NONE]

  • 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.

method:toString() [NONE]

  • toString

    public String toString()
    Returns an informative textual representation of this KerberosPrincipal.
    Specified by:
    toString in interface Principal
    Overrides:
    toString in class Object
    Returns:
    an informative textual representation of this KerberosPrincipal.

© 2019 Oracle Corporation and/or its affiliates