com.ibm.cos.v2.auth.credentials

Class DefaultCredentialsProvider

java.lang.Object

com.ibm.cos.v2.auth.credentials.DefaultCredentialsProvider

All Implemented Interfaces:

AwsCredentialsProvider, IdentityProvider<AwsCredentialsIdentity>, ToCopyableBuilder<DefaultCredentialsProvider.Builder,DefaultCredentialsProvider>, SdkAutoCloseable, AutoCloseable

public final class DefaultCredentialsProvider
extends Object
implements AwsCredentialsProvider, SdkAutoCloseable, ToCopyableBuilder<DefaultCredentialsProvider.Builder,DefaultCredentialsProvider>

AWS credentials provider chain that looks for credentials in this order:

1. Java System Properties - aws.accessKeyId and aws.secretAccessKey
2. Environment Variables - AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY
3. Web Identity Token credentials from system properties or environment variables
4. Credential profiles file at the default location (~/.aws/credentials) shared by all AWS SDKs and the AWS CLI

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DefaultCredentialsProvider.Builder Configuration that defines the DefaultCredentialsProvider's behavior.

Method Summary

Modifier and Type	Method and Description
static DefaultCredentialsProvider.Builder	builder() Get a builder for defining a DefaultCredentialsProvider with custom configuration.
void	close()
static DefaultCredentialsProvider	create() Returns the singleton instance of the DefaultCredentialsProvider using the default configuration.
AwsCredentials	resolveCredentials() Returns AwsCredentials that can be used to authorize an AWS request.
DefaultCredentialsProvider.Builder	toBuilder() Take this object and create a builder that contains all of the current property values of this object.
String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.ibm.cos.v2.auth.credentials.AwsCredentialsProvider

identityType, resolveIdentity

Methods inherited from interface com.ibm.cos.v2.identity.spi.IdentityProvider

resolveIdentity, resolveIdentity

Methods inherited from interface com.ibm.cos.v2.utils.builder.ToCopyableBuilder

copy

Method Detail

create

public static DefaultCredentialsProvider create()

Returns the singleton instance of the DefaultCredentialsProvider using the default configuration. Configuration can be specified by creating an instance using the builder(). If you want to create a new instance, use builder() instead.

builder

public static DefaultCredentialsProvider.Builder builder()

Get a builder for defining a DefaultCredentialsProvider with custom configuration.

resolveCredentials

public AwsCredentials resolveCredentials()

Description copied from interface: AwsCredentialsProvider

Returns AwsCredentials that can be used to authorize an AWS request. Each implementation of AWSCredentialsProvider can choose its own strategy for loading credentials. For example, an implementation might load credentials from an existing key management system, or load new credentials when credentials are rotated.

If an error occurs during the loading of credentials or credentials could not be found, a runtime exception will be raised.

Specified by:

resolveCredentials in interface AwsCredentialsProvider

Returns:

AwsCredentials which the caller can use to authorize an AWS request.

close

public void close()

Description copied from interface: SdkAutoCloseable

Specified by:

close in interface SdkAutoCloseable

Specified by:

close in interface AutoCloseable

toString

public String toString()

Overrides:

toString in class Object

toBuilder

public DefaultCredentialsProvider.Builder toBuilder()

Description copied from interface: ToCopyableBuilder

Take this object and create a builder that contains all of the current property values of this object.

Specified by:

toBuilder in interface ToCopyableBuilder<DefaultCredentialsProvider.Builder,DefaultCredentialsProvider>

Returns:

a builder for type T