com.oracle.bmc.auth

Class SessionTokenAuthenticationDetailsProvider

java.lang.Object

com.oracle.bmc.auth.SessionTokenAuthenticationDetailsProvider

All Implemented Interfaces:

AbstractAuthenticationDetailsProvider, AuthenticationDetailsProvider, BasicAuthenticationDetailsProvider, RefreshableOnNotAuthenticatedProvider<String>, RegionProvider

public class SessionTokenAuthenticationDetailsProvider
extends Object
implements AuthenticationDetailsProvider, RegionProvider, RefreshableOnNotAuthenticatedProvider<String>

Implementation of AuthenticationDetailsProvider that uses a session token for authentication.

Constructor Summary

Constructors

Constructor and Description
SessionTokenAuthenticationDetailsProvider() Creates a new instance using the config file at the default location and the default profile.
SessionTokenAuthenticationDetailsProvider(ConfigFileReader.ConfigFile configFile) Creates a new instance.
SessionTokenAuthenticationDetailsProvider(String profile) Creates a new instance using the config file at the default location, see ConfigFileReader.DEFAULT_FILE_PATH.
SessionTokenAuthenticationDetailsProvider(String configurationFilePath, String profile) Creates a new instance.

Method Summary

Modifier and Type	Method and Description
String	getFingerprint() Returns the fingerprint of the key being used.
String	getKeyId() Returns the keyId used to sign requests.
String	getPassPhrase() Deprecated.
char[]	getPassphraseCharacters() Returns the optional pass phrase for the (encrypted) private key, as a character array.
InputStream	getPrivateKey() Returns a new InputStream to the private key.
Region	getRegion() Returns the region.
String	getTenantId() Returns the tenant OCID.
String	getUserId() Returns the user OCID.
String	refresh() Refreshes the session token from the file defined in the OCI config file.
void	setSessionToken(String sessionToken) Sets the session token directly from a string.
void	setSessionTokenFromFilePath(String sessionTokenFilePath) Loads the session token from the file specified in the file path.

Methods inherited from class java.lang.Object

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

Constructor Detail

SessionTokenAuthenticationDetailsProvider

public SessionTokenAuthenticationDetailsProvider()
                                          throws IOException

Creates a new instance using the config file at the default location and the default profile. See ConfigFileReader.DEFAULT_FILE_PATH.

Throws:

IOException - if the configuration file could not be loaded

SessionTokenAuthenticationDetailsProvider

public SessionTokenAuthenticationDetailsProvider(String profile)
                                          throws IOException

Creates a new instance using the config file at the default location, see ConfigFileReader.DEFAULT_FILE_PATH.

Parameters:

profile - profile to load, optional

Throws:

IOException - if the configuration file could not be loaded

SessionTokenAuthenticationDetailsProvider

public SessionTokenAuthenticationDetailsProvider(String configurationFilePath,
                                                 String profile)
                                          throws IOException

Creates a new instance.

Parameters:

configurationFilePath - path to the OCI configuration file

profile - profile to load, optional

Throws:

IOException - if the configuration file could not be loaded

SessionTokenAuthenticationDetailsProvider

public SessionTokenAuthenticationDetailsProvider(ConfigFileReader.ConfigFile configFile)
                                          throws IOException

Creates a new instance.

Parameters:

configFile - The configuration file to use.

Throws:

IOException - if the configuration file could not be loaded

Method Detail

setSessionTokenFromFilePath

public void setSessionTokenFromFilePath(String sessionTokenFilePath)
                                 throws IOException

Loads the session token from the file specified in the file path.

Parameters:

sessionTokenFilePath - The file path to set the session token from.

Throws:

IOException

setSessionToken

public void setSessionToken(String sessionToken)

Sets the session token directly from a string.

Parameters:

sessionToken - The session token to use.

refresh

public String refresh()

Refreshes the session token from the file defined in the OCI config file.

Specified by:

refresh in interface RefreshableOnNotAuthenticatedProvider<String>

Returns:

the refreshed authentication data

getKeyId

public String getKeyId()

Description copied from interface: BasicAuthenticationDetailsProvider

Returns the keyId used to sign requests.

Specified by:

getKeyId in interface BasicAuthenticationDetailsProvider

Returns:

The keyId.

getPrivateKey

public InputStream getPrivateKey()

Description copied from interface: BasicAuthenticationDetailsProvider

Returns a new InputStream to the private key. This stream should be closed by the caller, implementations should return new streams each time.

Specified by:

getPrivateKey in interface BasicAuthenticationDetailsProvider

Returns:

A new InputStream.

getPassPhrase

@Deprecated
public String getPassPhrase()

Deprecated.

Description copied from interface: BasicAuthenticationDetailsProvider

Returns the optional pass phrase for the (encrypted) private key.

Specified by:

getPassPhrase in interface BasicAuthenticationDetailsProvider

Returns:

The pass phrase, or null if not applicable

getPassphraseCharacters

public char[] getPassphraseCharacters()

Description copied from interface: BasicAuthenticationDetailsProvider

Returns the optional pass phrase for the (encrypted) private key, as a character array.

Specified by:

getPassphraseCharacters in interface BasicAuthenticationDetailsProvider

Returns:

The pass phrase as character array, or null if not applicable

getFingerprint

public String getFingerprint()

Description copied from interface: AuthenticationDetailsProvider

Returns the fingerprint of the key being used.

Specified by:

getFingerprint in interface AuthenticationDetailsProvider

Returns:

The fingerprint.

getTenantId

public String getTenantId()

Description copied from interface: AuthenticationDetailsProvider

Returns the tenant OCID.

Specified by:

getTenantId in interface AuthenticationDetailsProvider

Returns:

The tenant OCID.

getUserId

public String getUserId()

Description copied from interface: AuthenticationDetailsProvider

Returns the user OCID.

Specified by:

getUserId in interface AuthenticationDetailsProvider

Returns:

The user OCID.

getRegion

public Region getRegion()

Description copied from interface: RegionProvider

Returns the region.

Specified by:

getRegion in interface RegionProvider

Returns:

Region object.