org.apache.hadoop.security.authentication.util

Class KerberosName

java.lang.Object

org.apache.hadoop.security.authentication.util.KerberosName

@InterfaceAudience.LimitedPrivate(value={"HDFS","MapReduce"})
@InterfaceStability.Evolving
public class KerberosName
extends Object

This class implements parsing and handling of Kerberos principal names. In particular, it splits them apart and translates them down into local operating system names.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	KerberosName.BadFormatString
static class	KerberosName.NoMatchingRule

Constructor Summary

Constructors

Constructor and Description
KerberosName(String name) Create a name from the full Kerberos principal name.

Method Summary

Methods

Modifier and Type	Method and Description
String	getDefaultRealm() Get the configured default realm.
String	getHostName() Get the second component of the name.
String	getRealm() Get the realm of the name.
static String	getRules() Get the rules.
String	getServiceName() Get the first component of the name.
String	getShortName() Get the translation of the principal name into an operating system user name.
static boolean	hasRulesBeenSet() Indicates if the name rules have been set.
static void	resetDefaultRealm()
static void	setRules(String ruleString) Set the rules.
String	toString() Put the name back together from the parts.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

KerberosName

public KerberosName(String name)

Create a name from the full Kerberos principal name.

Parameters:

name - full Kerberos principal name.

Method Detail

resetDefaultRealm

public static void resetDefaultRealm()

getDefaultRealm

public String getDefaultRealm()

Get the configured default realm.

Returns:

the default realm from the krb5.conf

toString

public String toString()

Put the name back together from the parts.

Overrides:

toString in class Object

getServiceName

public String getServiceName()

Get the first component of the name.

Returns:

the first section of the Kerberos principal name

getHostName

public String getHostName()

Get the second component of the name.

Returns:

the second section of the Kerberos principal name, and may be null

getRealm

public String getRealm()

Get the realm of the name.

Returns:

the realm of the name, may be null

getShortName

public String getShortName()
                    throws IOException

Get the translation of the principal name into an operating system user name.

Returns:

the short name

Throws:

IOException - throws if something is wrong with the rules

setRules

public static void setRules(String ruleString)

Set the rules.

Parameters:

ruleString - the rules string.

getRules

public static String getRules()

Get the rules.

Returns:

String of configured rules, or null if not yet configured

hasRulesBeenSet

public static boolean hasRulesBeenSet()

Indicates if the name rules have been set.

Returns:

if the name rules have been set.