Class KerberosPrincipal

    • Field Summary

      Fields 
      Modifier and Type Field 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 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

      Modifier and Type Method 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 hash code for this KerberosPrincipal.
      String toString()
      Returns an informative textual representation of this KerberosPrincipal.
    • 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
    • Constructor Detail

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

      • getRealm

        public String getRealm()
        Returns the realm component of this Kerberos principal.
        Returns:
        the realm component of this Kerberos principal.
      • 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
      • 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.
      • 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()
        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.