com.google.auth.oauth2

Class AwsCredentials

java.lang.Object

com.google.auth.Credentials

com.google.auth.oauth2.OAuth2Credentials

com.google.auth.oauth2.GoogleCredentials

com.google.auth.oauth2.ExternalAccountCredentials

com.google.auth.oauth2.AwsCredentials

All Implemented Interfaces:

QuotaProjectIdProvider, Serializable

public class AwsCredentials
extends ExternalAccountCredentials

Credentials representing an AWS third-party identity for calling Google APIs. AWS security credentials are either sourced by calling EC2 metadata endpoints, environment variables, or a user provided supplier method.

By default, attempts to exchange the external credential for a GCP access token.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AwsCredentials.Builder

Nested classes/interfaces inherited from class com.google.auth.oauth2.ExternalAccountCredentials

ExternalAccountCredentials.SubjectTokenTypes

Nested classes/interfaces inherited from class com.google.auth.oauth2.OAuth2Credentials

OAuth2Credentials.CredentialsChangedListener

Field Summary

Fields inherited from class com.google.auth.oauth2.ExternalAccountCredentials

impersonatedCredentials, transportFactory

Fields inherited from class com.google.auth.oauth2.GoogleCredentials

quotaProjectId

Fields inherited from class com.google.auth.Credentials

GOOGLE_DEFAULT_UNIVERSE

Method Summary

Modifier and Type	Method and Description
GoogleCredentials	createScoped(Collection<String> newScopes) Clones the AwsCredentials with the specified scopes.
String	getRegionalCredentialVerificationUrlOverride()
static AwsCredentials.Builder	newBuilder()
static AwsCredentials.Builder	newBuilder(AwsCredentials awsCredentials)
AccessToken	refreshAccessToken() Method to refresh the access token according to the specific type of credentials.
String	retrieveSubjectToken() Retrieves the external subject token to be exchanged for a Google Cloud access token.
AwsCredentials.Builder	toBuilder()

Methods inherited from class com.google.auth.oauth2.ExternalAccountCredentials

exchangeExternalCredentialForAccessToken, fromStream, fromStream, getAudience, getClientId, getClientSecret, getCredentialSource, getRequestMetadata, getRequestMetadata, getScopes, getServiceAccountEmail, getServiceAccountImpersonationOptions, getServiceAccountImpersonationUrl, getSubjectTokenType, getTokenInfoUrl, getTokenUrl, getUniverseDomain, getWorkforcePoolUserProject, isWorkforcePoolConfiguration

Methods inherited from class com.google.auth.oauth2.GoogleCredentials

create, create, createDelegated, createScoped, createScoped, createScopedRequired, createWithCustomRetryStrategy, createWithQuotaProject, equals, getAdditionalHeaders, getApplicationDefault, getApplicationDefault, getCredentialInfo, getQuotaProjectId, hashCode, isExplicitUniverseDomain, toString, toStringHelper

Methods inherited from class com.google.auth.oauth2.OAuth2Credentials

addChangeListener, getAccessToken, getAuthenticationType, getFromServiceLoader, getRequestMetadataInternal, hasRequestMetadata, hasRequestMetadataOnly, newInstance, refresh, refreshIfExpired, removeChangeListener

Methods inherited from class com.google.auth.Credentials

blockingGetToCallback, getMetricsCredentialType, getRequestMetadata

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

refreshAccessToken

public AccessToken refreshAccessToken()
                               throws IOException

Description copied from class: OAuth2Credentials

Method to refresh the access token according to the specific type of credentials.

Throws IllegalStateException if not overridden since direct use of OAuth2Credentials is only for temporary or non-refreshing access tokens.

Overrides:

refreshAccessToken in class OAuth2Credentials

Returns:

never

Throws:

IOException

retrieveSubjectToken

public String retrieveSubjectToken()
                            throws IOException

Description copied from class: ExternalAccountCredentials

Retrieves the external subject token to be exchanged for a Google Cloud access token.

Must be implemented by subclasses as the retrieval method is dependent on the credential source.

Specified by:

retrieveSubjectToken in class ExternalAccountCredentials

Returns:

the external subject token

Throws:

IOException - if the subject token cannot be retrieved

createScoped

public GoogleCredentials createScoped(Collection<String> newScopes)

Clones the AwsCredentials with the specified scopes.

Overrides:

createScoped in class GoogleCredentials

Parameters:

newScopes - Collection of scopes to request.

Returns:

GoogleCredentials with requested scopes.

getRegionalCredentialVerificationUrlOverride

@Nullable
public String getRegionalCredentialVerificationUrlOverride()

newBuilder

public static AwsCredentials.Builder newBuilder()

newBuilder

public static AwsCredentials.Builder newBuilder(AwsCredentials awsCredentials)

toBuilder

public AwsCredentials.Builder toBuilder()

Overrides:

toBuilder in class GoogleCredentials