Package software.amazon.awssdk.auth

Class AwsCredentialsProviderChain

java.lang.Object

software.amazon.awssdk.auth.AwsCredentialsProviderChain

All Implemented Interfaces:

AutoCloseable, AwsCredentialsProvider

public final class AwsCredentialsProviderChain
extends Object
implements AwsCredentialsProvider, AutoCloseable

AwsCredentialsProvider implementation that chains together multiple credentials providers.

When a caller first requests credentials from this provider, it calls all the providers in the chain, in the original order specified, until one can provide credentials, and then returns those credentials. If all of the credential providers in the chain have been called, and none of them can provide credentials, then this class will throw an exception indicated that no credentials are available.

By default, this class will remember the first credentials provider in the chain that was able to provide credentials, and will continue to use that provider when credentials are requested in the future, instead of traversing the chain each time. This behavior can be controlled through the AwsCredentialsProviderChain.Builder.reuseLastProviderEnabled(Boolean) method.

This chain implements AutoCloseable. When closed, it will call the AutoCloseable.close() on any credential providers in the chain that need to be closed.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	AwsCredentialsProviderChain.Builder	A builder for a AwsCredentialsProviderChain that allows controlling its behavior.

Method Summary

Modifier and Type	Method	Description
static AwsCredentialsProviderChain.Builder	builder()	Get a new builder for creating a AwsCredentialsProviderChain.
void	close()
AwsCredentials	getCredentials()	Returns AwsCredentials that can be used to authorize an AWS request.
static AwsCredentialsProviderChain	of(AwsCredentialsProvider... awsCredentialsProviders)	Create an AWS credentials provider chain with default configuration that checks the given credential providers.
String	toString()

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

builder

public static AwsCredentialsProviderChain.Builder builder()

Get a new builder for creating a AwsCredentialsProviderChain.

of

public static AwsCredentialsProviderChain of(AwsCredentialsProvider... awsCredentialsProviders)

Create an AWS credentials provider chain with default configuration that checks the given credential providers.

Parameters:

awsCredentialsProviders - The credentials providers that should be checked for credentials, in the order they should be checked.

Returns:

A credential provider chain that checks the provided credential providers in order.

getCredentials

public AwsCredentials getCredentials()

Description copied from interface: AwsCredentialsProvider

Returns AwsCredentials that can be used to authorize an AWS request. Each implementation of AWSCredentialsProvider can chose 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:

getCredentials in interface AwsCredentialsProvider

Returns:

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

close

public void close()

Specified by:

close in interface AutoCloseable

toString

public String toString()

Overrides:

toString in class Object