Alterações no provedor de credenciais - AWS SDK for Java 2.x

Alterações no provedor de credenciais

Esta seção fornece um mapeamento das alterações de nomes de classes e métodos do provedor de credenciais entre as versões 1.x e 2.x do AWS SDK para Java.

Diferenças notáveis

  • O provedor de credenciais padrão carrega as propriedades do sistema antes das variáveis de ambiente na versão 2.x. Para obter mais informações, consulte Uso de credenciais.

  • O método construtor é substituído pelos métodos create ou builder.

    DefaultCredentialsProvider.create();
  • A atualização assíncrona não é mais definida por padrão. Você deve especificá-la com o builder do provedor de credenciais.

    ContainerCredentialsProvider provider = ContainerCredentialsProvider.builder() .asyncCredentialUpdateEnabled(true) .build();
  • Você pode especificar um caminho para um arquivo de perfil personalizado usando o ProfileCredentialsProvider.builder().

    ProfileCredentialsProvider profile = ProfileCredentialsProvider.builder() .profileFile(ProfileFile.builder().content(Paths.get("myProfileFile.file")).build()) .build();
  • O formato do arquivo de perfil foi alterado para melhor corresponder à AWS CLI. Para obter detalhes, consulte Configuração da AWS CLI no Guia do usuário da AWS Command Line Interface.

Alterações no provedor de credenciais mapeadas entre as versões 1.x e 2.x

AWSCredentialsProvider

Alterar categoria 1.x 2.x
Nome de classe/pacote com.amazonaws.auth.AWSCredentialsProvider software.amazon.awssdk.auth.credentials.AwsCredentialsProvider
Nome de método getCredentials resolveCredentials
Método incompatível refresh Não compatível

DefaultAWSCredentialsProviderChain

Alterar categoria 1.x 2.x
Nome de classe/pacote com.amazonaws.auth.DefaultAWSCredentialsProviderChain software.amazon.awssdk.auth.credentials.DefaultCredentialsProvider
Criação new DefaultAWSCredentialsProviderChain DefaultCredentialsProvider.create
Método incompatível getInstance Não compatível
Ordem de prioridade das configurações externas

Variáveis de ambiente têm prioridade sobre as propriedades do sistema

Propriedades do sistema têm prioridade sobre as variáveis de ambiente

AWSStaticCredentialsProvider

Alterar categoria 1.x 2.x
Nome de classe/pacote com.amazonaws.auth.AWSStaticCredentialsProvider software.amazon.awssdk.auth.credentials.StaticCredentialsProvider
Criação new AWSStaticCredentialsProvider StaticCredentialsProvider.create

EnvironmentVariableCredentialsProvider

Alterar categoria 1.x 2.x
Nome de classe/pacote com.amazonaws.auth.EnvironmentVariableCredentialsProvider software.amazon.awssdk.auth.credentials.EnvironmentVariableCredentialsProvider
Criação new EnvironmentVariableCredentialsProvider EnvironmentVariableCredentialsProvider.create
Nome de variáveis de ambiente AWS_ACCESS_KEY AWS_ACCESS_KEY_ID
AWS_SECRET_KEY AWS_SECRET_ACCESS_KEY

SystemPropertiesCredentialsProvider

Alterar categoria 1.x 2.x
Nome de classe/pacote com.amazonaws.auth.SystemPropertiesCredentialsProvider software.amazon.awssdk.auth.credentials.SystemPropertyCredentialsProvider
Criação new SystemPropertiesCredentialsProvider SystemPropertiesCredentialsProvider.create
Nome da propriedade do sistema aws.secretKey aws.secretAccessKey

ProfileCredentialsProvider

Alterar categoria 1.x 2.x
Nome de classe/pacote com.amazonaws.auth.profile.ProfileCredentialsProvider software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider
Criação new ProfileCredentialsProvider ProfileCredentialsProvider.create
Local do perfil personalizado
  • AWS_CREDENTIAL_PROFILES_FILE variável de ambiente

  • new ProfileCredentialsProvider

  • AWS_SHARED_CREDENTIALS_FILE variável de ambiente

  • ProfileCredentialsProvider.builder

ContainerCredentialsProvider

Alterar categoria 1.x 2.x
Nome de classe/pacote com.amazonaws.auth.ContainerCredentialsProvider software.amazon.awssdk.auth.credentials.ContainerCredentialsProvider
Criação new ContainerCredentialsProvider ContainerCredentialsProvider.create
Especificar a atualização assíncrona Não compatível Comportamento padrão

InstanceProfileCredentialsProvider

Alterar categoria 1.x 2.x
Nome de classe/pacote com.amazonaws.auth.InstanceProfileCredentialsProvider software.amazon.awssdk.auth.credentials.InstanceProfileCredentialsProvider
Criação new InstanceProfileCredentialsProvider InstanceProfileCredentialsProvider.create
Especificar a atualização assíncrona new InstanceProfileCredentialsProvider(true)

InstanceProfileCredentialProvider.builder().asyncCredentialUpdateEnabled(true).build()

Nome da propriedade do sistema com.amazonaws.sdk.disableEc2Metadata aws.disableEc2Metadata
com.amazonaws.sdk.ec2MetadataServiceEndpointOverride aws.ec2MetadataServiceEndpoint

STSAssumeRoleSessionCredentialsProvider

Alterar categoria 1.x 2.x
Nome de classe/pacote com.amazonaws.auth.STSAssumeRoleSessionCredentialsProvider software.amazon.awssdk.services.sts.auth.StsAssumeRoleCredentialsProvider
Criação
  • new STSAssumeRoleSessionCredentialsProvider

  • new STSAssumeRoleSessionCredentialsProvider.Builder

StsAssumeRoleCredentialsProvider.builder
Atualização assíncrona Comportamento padrão Comportamento padrão
Configuração new STSAssumeRoleSessionCredentialsProvider.Builder Configurar uma solicitação StsClient e AssumeRoleRequest

STSSessionCredentialsProvider

Alterar categoria 1.x 2.x
Nome de classe/pacote com.amazonaws.auth.STSSessionCredentialsProvider software.amazon.awssdk.services.sts.auth.StsGetSessionTokenCredentialsProvider
Criação

new STSSessionCredentialsProvider

StsGetSessionTokenCredentialsProvider.builder
Atualização assíncrona Comportamento padrão StsGetSessionTokenCredentialsProvider.builder
Configuração Parâmetros do construtor Configurar uma solicitação StsClient e GetSessionTokenRequest em um compilador

WebIdentityFederationSessionCredentialsProvider

Alterar categoria 1.x 2.x
Nome de classe/pacote com.amazonaws.auth.WebIdentityFederationSessionCredentialsProvider software.amazon.awssdk.services.sts.auth.StsAssumeRoleWithWebIdentityCredentialsProvider
Criação

new WebIdentityFederationSessionCredentialsProvider

StsAssumeRoleWithWebIdentityCredentialsProvider.builder
Atualização assíncrona Comportamento padrão StsAssumeRoleWithWebIdentityCredentialsProvider.builder
Configuração Parâmetros do construtor Configurar uma solicitação StsClient e AssumeRoleWithWebIdentityRequest em um compilador

Classes substituídas

Classe 1.x Classes de substituição 2.x
com.amazonaws.auth.EC2ContainerCredentialsProviderWrapper software.amazon.awssdk.auth.credentials.ContainerCredentialsProvider e software.amazon.awssdk.auth.credentials.InstanceProfileCredentialsProvider
com.amazonaws.services.s3.S3CredentialsProviderChain software.amazon.awssdk.auth.credentials.DefaultCredentialsProvider e software.amazon.awssdk.auth.credentials.AnonymousCredentialsProvider

Classes removidas

Classe 1.x
com.amazonaws.auth.ClasspathPropertiesFileCredentialsProvider
com.amazonaws.auth.PropertiesFileCredentialsProvider