Package org.apache.hadoop.security.authentication.util

Class AuthToken

java.lang.Object

org.apache.hadoop.security.authentication.util.AuthToken

All Implemented Interfaces:

java.security.Principal

Direct Known Subclasses:

AuthenticationToken

public class AuthToken
extends java.lang.Object
implements java.security.Principal

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AuthToken()
	AuthToken(java.lang.String userName, java.lang.String principal, java.lang.String type)	Creates an authentication token.

Method Summary

Modifier and Type	Method	Description
protected static void	checkForIllegalArgument(java.lang.String value, java.lang.String name)	Check if the provided value is invalid.
long	getExpires()	Returns the expiration time of the token.
long	getJWTExpires()	Returns the expiration time of JWT.
long	getMaxInactives()	Returns the max inactive time of the token.
java.lang.String	getName()	Returns the principal name (this method name comes from the JDK Principal interface).
java.lang.String	getType()	Returns the authentication mechanism of the token.
java.lang.String	getUserName()	Returns the user name.
boolean	isExpired()	Returns true if the token has expired.
boolean	isJWTBasedToken()	Returns the is JWT generated token ot not .
static AuthToken	parse(java.lang.String tokenStr)
void	setExpires(long expires)	Sets the expiration of the token.
void	setJWTBasedToken(boolean isJWTBasedToken)	Sets flag that token was generated from JWT.
void	setJWTExpires(long expiresJWT)	Sets the expiration of JWT.
void	setMaxInactives(long interval)	Sets the max inactive interval of the token.
java.lang.String	toString()	Returns the string representation of the token.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.security.Principal

equals, hashCode, implies

Constructor Detail

AuthToken

protected AuthToken()

AuthToken

public AuthToken(java.lang.String userName,
                 java.lang.String principal,
                 java.lang.String type)

Creates an authentication token.

Parameters:

userName - user name.

principal - principal (commonly matches the user name, with Kerberos is the full/long principal name while the userName is the short name).

type - the authentication mechanism name. (System.currentTimeMillis() + validityPeriod).

Method Detail

checkForIllegalArgument

protected static void checkForIllegalArgument(java.lang.String value,
                                              java.lang.String name)

Check if the provided value is invalid. Throw an error if it is invalid, NOP otherwise.

Parameters:

value - the value to check.

name - the parameter name to use in an error message if the value is invalid.

setMaxInactives

public void setMaxInactives(long interval)

Sets the max inactive interval of the token.

Parameters:

interval - max inactive interval of the token in milliseconds since the epoch.

setExpires

public void setExpires(long expires)

Sets the expiration of the token.

Parameters:

expires - expiration time of the token in milliseconds since the epoch.

setJWTExpires

public void setJWTExpires(long expiresJWT)

Sets the expiration of JWT. This is internal time and don't add to HTTP token

Parameters:

expiresJWT - expiration time of JWT in milliseconds since the epoch.

setJWTBasedToken

public void setJWTBasedToken(boolean isJWTBasedToken)

Sets flag that token was generated from JWT. This is internal value and don't add to HTTP token

Parameters:

isJWTBasedToken - value for that check token was generated from JWT or not.

isExpired

public boolean isExpired()

Returns true if the token has expired.

Returns:

true if the token has expired.

getUserName

public java.lang.String getUserName()

Returns the user name.

Returns:

the user name.

getName

public java.lang.String getName()

Returns the principal name (this method name comes from the JDK Principal interface).

Specified by:

getName in interface java.security.Principal

Returns:

the principal name.

getType

public java.lang.String getType()

Returns the authentication mechanism of the token.

Returns:

the authentication mechanism of the token.

getMaxInactives

public long getMaxInactives()

Returns the max inactive time of the token.

Returns:

the max inactive time of the token, in milliseconds since Epoc.

getExpires

public long getExpires()

Returns the expiration time of the token.

Returns:

the expiration time of the token, in milliseconds since Epoc.

getJWTExpires

public long getJWTExpires()

Returns the expiration time of JWT.

Returns:

the expiration time of JWT, in milliseconds since Epoc.

isJWTBasedToken

public boolean isJWTBasedToken()

Returns the is JWT generated token ot not .

Returns:

boolean value for JWT token based.

toString

public java.lang.String toString()

Returns the string representation of the token.

This string representation is parseable by the parse(java.lang.String) method.

Specified by:

toString in interface java.security.Principal

Overrides:

toString in class java.lang.Object

Returns:

the string representation of the token.

parse

public static AuthToken parse(java.lang.String tokenStr)
                       throws AuthenticationException

Throws:

AuthenticationException