org.apache.hadoop.security.token

Class DtFileOperations

java.lang.Object

org.apache.hadoop.security.token.DtFileOperations

public final class DtFileOperations
extends Object

DtFileOperations is a collection of delegation token file operations.

Field Summary

Fields

Modifier and Type	Field and Description
static String	FORMAT_JAVA Use FORMAT_* as arguments to format parameters.
static String	FORMAT_PB Use FORMAT_* as arguments to format parameters.

Method Summary

Modifier and Type	Method and Description
static void	aliasTokenFile(File tokenFile, String fileFormat, Text alias, Text service, Configuration conf) Alias a token from a file and save back to file in the local filesystem.
static void	appendTokenFiles(ArrayList<File> tokenFiles, String fileFormat, Configuration conf) Append tokens from list of files in local filesystem, saving to last file.
static void	doFormattedWrite(File f, String format, Credentials creds, Configuration conf) Write out a Credentials object as a local file.
static void	getTokenFile(File tokenFile, String fileFormat, Text alias, Text service, String url, String renewer, Configuration conf) Fetch a token from a service and save to file in the local filesystem.
static void	printCredentials(Credentials creds, Text alias, PrintStream out) Print out a Credentials object.
static void	printTokenFile(File tokenFile, Text alias, Configuration conf, PrintStream out) Print out a Credentials file from the local filesystem.
static void	removeTokenFromFile(boolean cancel, File tokenFile, String fileFormat, Text alias, Configuration conf) Remove a token from a file in the local filesystem, matching alias.
static void	renewTokenFile(File tokenFile, String fileFormat, Text alias, Configuration conf) Renew a token from a file in the local filesystem, matching alias.

Methods inherited from class java.lang.Object

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

Field Detail

FORMAT_PB

public static final String FORMAT_PB

Use FORMAT_* as arguments to format parameters. FORMAT_PB is for protobuf output.

See Also:

Constant Field Values

FORMAT_JAVA

public static final String FORMAT_JAVA

Use FORMAT_* as arguments to format parameters. FORMAT_JAVA is a legacy option for java serialization output.

See Also:

Constant Field Values

Method Detail

doFormattedWrite

public static void doFormattedWrite(File f,
                                    String format,
                                    Credentials creds,
                                    Configuration conf)
                             throws IOException

Write out a Credentials object as a local file.

Parameters:

f - a local File object.

format - a string equal to FORMAT_PB or FORMAT_JAVA.

creds - the Credentials object to be written out.

conf - a Configuration object passed along.

Throws:

IOException

printTokenFile

public static void printTokenFile(File tokenFile,
                                  Text alias,
                                  Configuration conf,
                                  PrintStream out)
                           throws IOException

Print out a Credentials file from the local filesystem.

Parameters:

tokenFile - a local File object.

alias - print only tokens matching alias (null matches all).

conf - Configuration object passed along.

out - print to this stream.

Throws:

IOException

printCredentials

public static void printCredentials(Credentials creds,
                                    Text alias,
                                    PrintStream out)
                             throws IOException

Print out a Credentials object.

Parameters:

creds - the Credentials object to be printed out.

alias - print only tokens matching alias (null matches all).

out - print to this stream.

Throws:

IOException - failure to unmarshall a token identifier.

getTokenFile

public static void getTokenFile(File tokenFile,
                                String fileFormat,
                                Text alias,
                                Text service,
                                String url,
                                String renewer,
                                Configuration conf)
                         throws Exception

Fetch a token from a service and save to file in the local filesystem.

Parameters:

tokenFile - a local File object to hold the output.

fileFormat - a string equal to FORMAT_PB or FORMAT_JAVA, for output

alias - overwrite service field of fetched token with this text.

service - use a DtFetcher implementation matching this service text.

url - pass this URL to fetcher after stripping any http/s prefix.

renewer - pass this renewer to the fetcher.

conf - Configuration object passed along.

Throws:

IOException

Exception

aliasTokenFile

public static void aliasTokenFile(File tokenFile,
                                  String fileFormat,
                                  Text alias,
                                  Text service,
                                  Configuration conf)
                           throws Exception

Alias a token from a file and save back to file in the local filesystem.

Parameters:

tokenFile - a local File object to hold the input and output.

fileFormat - a string equal to FORMAT_PB or FORMAT_JAVA, for output

alias - overwrite service field of fetched token with this text.

service - only apply alias to tokens matching this service text.

conf - Configuration object passed along.

Throws:

IOException

Exception

appendTokenFiles

public static void appendTokenFiles(ArrayList<File> tokenFiles,
                                    String fileFormat,
                                    Configuration conf)
                             throws IOException

Append tokens from list of files in local filesystem, saving to last file.

Parameters:

tokenFiles - list of local File objects. Last file holds the output.

fileFormat - a string equal to FORMAT_PB or FORMAT_JAVA, for output

conf - Configuration object passed along.

Throws:

IOException

removeTokenFromFile

public static void removeTokenFromFile(boolean cancel,
                                       File tokenFile,
                                       String fileFormat,
                                       Text alias,
                                       Configuration conf)
                                throws IOException,
                                       InterruptedException

Remove a token from a file in the local filesystem, matching alias.

Parameters:

cancel - cancel token as well as remove from file.

tokenFile - a local File object.

fileFormat - a string equal to FORMAT_PB or FORMAT_JAVA, for output

alias - remove only tokens matching alias; null matches all.

conf - Configuration object passed along.

Throws:

IOException

InterruptedException

renewTokenFile

public static void renewTokenFile(File tokenFile,
                                  String fileFormat,
                                  Text alias,
                                  Configuration conf)
                           throws IOException,
                                  InterruptedException

Renew a token from a file in the local filesystem, matching alias.

Parameters:

tokenFile - a local File object.

fileFormat - a string equal to FORMAT_PB or FORMAT_JAVA, for output

alias - renew only tokens matching alias; null matches all.

conf - Configuration object passed along.

Throws:

IOException

InterruptedException