Cambios en el proveedor de credenciales - AWS SDK for Java 2.x

Cambios en el proveedor de credenciales

En esta sección se ofrece un esquema de los cambios de nombre de las clases y los métodos de proveedor de credenciales entre las versiones 1.x y 2.x del AWS SDK para Java.

Diferencias destacadas

  • En la versión 2.x, el proveedor de credenciales predeterminado carga las propiedades del sistema antes que las variables de entorno. Para obtener más información, consulte Uso de credenciales.

  • El método constructor se sustituye por los métodos create o builder.

    DefaultCredentialsProvider.create();
  • La actualización asíncrona ya no está configurada de forma predeterminada. Debe especificarla con el builder del proveedor de credenciales.

    ContainerCredentialsProvider provider = ContainerCredentialsProvider.builder() .asyncCredentialUpdateEnabled(true) .build();
  • Puede especificar una ruta a un archivo de perfil personalizado utilizando ProfileCredentialsProvider.builder().

    ProfileCredentialsProvider profile = ProfileCredentialsProvider.builder() .profileFile(ProfileFile.builder().content(Paths.get("myProfileFile.file")).build()) .build();
  • El formato del archivo de perfil ha cambiado para que coincida mejor con la AWS CLI. Para obtener más información, consulte Configurar la AWS CLI en la Guía del usuario de AWS Command Line Interface.

Cambios del proveedor de credenciales entre las versiones 1.x y 2.x

AWSCredentialsProvider

Categoría del cambio 1.x 2.x
Nombre del paquete/clase com.amazonaws.auth.AWSCredentialsProvider software.amazon.awssdk.auth.credentials.AwsCredentialsProvider
Nombre del método getCredentials resolveCredentials
Método no admitido refresh No admitido

DefaultAWSCredentialsProviderChain

Categoría del cambio 1.x 2.x
Nombre del paquete/clase com.amazonaws.auth.DefaultAWSCredentialsProviderChain software.amazon.awssdk.auth.credentials.DefaultCredentialsProvider
Creación new DefaultAWSCredentialsProviderChain DefaultCredentialsProvider.create
Método no admitido getInstance No admitido
Orden de prioridad de ajustes externos

Variables de entorno antes que propiedades del sistema

Propiedades del sistema antes que variables de entorno

AWSStaticCredentialsProvider

Categoría del cambio 1.x 2.x
Nombre del paquete/clase com.amazonaws.auth.AWSStaticCredentialsProvider software.amazon.awssdk.auth.credentials.StaticCredentialsProvider
Creación new AWSStaticCredentialsProvider StaticCredentialsProvider.create

EnvironmentVariableCredentialsProvider

Categoría del cambio 1.x 2.x
Nombre del paquete/clase com.amazonaws.auth.EnvironmentVariableCredentialsProvider software.amazon.awssdk.auth.credentials.EnvironmentVariableCredentialsProvider
Creación new EnvironmentVariableCredentialsProvider EnvironmentVariableCredentialsProvider.create
Nombre de la variable de entorno AWS_ACCESS_KEY AWS_ACCESS_KEY_ID
AWS_SECRET_KEY AWS_SECRET_ACCESS_KEY

SystemPropertiesCredentialsProvider

Categoría del cambio 1.x 2.x
Nombre del paquete/clase com.amazonaws.auth.SystemPropertiesCredentialsProvider software.amazon.awssdk.auth.credentials.SystemPropertyCredentialsProvider
Creación new SystemPropertiesCredentialsProvider SystemPropertiesCredentialsProvider.create
Nombre de la propiedad del sistema aws.secretKey aws.secretAccessKey

ProfileCredentialsProvider

Categoría del cambio 1.x 2.x
Nombre del paquete/clase com.amazonaws.auth.profile.ProfileCredentialsProvider software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider
Creación new ProfileCredentialsProvider ProfileCredentialsProvider.create
Ubicación del perfil personalizado
  • AWS_CREDENTIAL_PROFILES_FILE variable de entorno

  • new ProfileCredentialsProvider

  • AWS_SHARED_CREDENTIALS_FILE variable de entorno

  • ProfileCredentialsProvider.builder

ContainerCredentialsProvider

Categoría del cambio 1.x 2.x
Nombre del paquete/clase com.amazonaws.auth.ContainerCredentialsProvider software.amazon.awssdk.auth.credentials.ContainerCredentialsProvider
Creación new ContainerCredentialsProvider ContainerCredentialsProvider.create
Especificación de actualización asincrónica No admitido Comportamiento predeterminado

InstanceProfileCredentialsProvider

Categoría del cambio 1.x 2.x
Nombre del paquete/clase com.amazonaws.auth.InstanceProfileCredentialsProvider software.amazon.awssdk.auth.credentials.InstanceProfileCredentialsProvider
Creación new InstanceProfileCredentialsProvider InstanceProfileCredentialsProvider.create
Especificación de actualización asincrónica new InstanceProfileCredentialsProvider(true)

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

Nombre de la propiedad del sistema com.amazonaws.sdk.disableEc2Metadata aws.disableEc2Metadata
com.amazonaws.sdk.ec2MetadataServiceEndpointOverride aws.ec2MetadataServiceEndpoint

STSAssumeRoleSessionCredentialsProvider

Categoría del cambio 1.x 2.x
Nombre del paquete/clase com.amazonaws.auth.STSAssumeRoleSessionCredentialsProvider software.amazon.awssdk.services.sts.auth.StsAssumeRoleCredentialsProvider
Creación
  • new STSAssumeRoleSessionCredentialsProvider

  • new STSAssumeRoleSessionCredentialsProvider.Builder

StsAssumeRoleCredentialsProvider.builder
Actualización asincrónica Comportamiento predeterminado Comportamiento predeterminado
Configuración new STSAssumeRoleSessionCredentialsProvider.Builder Configuración de una solicitud StsClient y AssumeRoleRequest

STSSessionCredentialsProvider

Categoría del cambio 1.x 2.x
Nombre del paquete/clase com.amazonaws.auth.STSSessionCredentialsProvider software.amazon.awssdk.services.sts.auth.StsGetSessionTokenCredentialsProvider
Creación

new STSSessionCredentialsProvider

StsGetSessionTokenCredentialsProvider.builder
Actualización asincrónica Comportamiento predeterminado StsGetSessionTokenCredentialsProvider.builder
Configuración Parámetros del constructor Configuración de una solicitud StsClient y GetSessionTokenRequest en un compilador

WebIdentityFederationSessionCredentialsProvider

Categoría del cambio 1.x 2.x
Nombre del paquete/clase com.amazonaws.auth.WebIdentityFederationSessionCredentialsProvider software.amazon.awssdk.services.sts.auth.StsAssumeRoleWithWebIdentityCredentialsProvider
Creación

new WebIdentityFederationSessionCredentialsProvider

StsAssumeRoleWithWebIdentityCredentialsProvider.builder
Actualización asincrónica Comportamiento predeterminado StsAssumeRoleWithWebIdentityCredentialsProvider.builder
Configuración Parámetros del constructor Configuración de una solicitud StsClient y AssumeRoleWithWebIdentityRequest en un compilador

Clases reemplazadas

Clase 1.x Clases de reemplazo 2.x
com.amazonaws.auth.EC2ContainerCredentialsProviderWrapper software.amazon.awssdk.auth.credentials.ContainerCredentialsProvider y software.amazon.awssdk.auth.credentials.InstanceProfileCredentialsProvider
com.amazonaws.services.s3.S3CredentialsProviderChain software.amazon.awssdk.auth.credentials.DefaultCredentialsProvider y software.amazon.awssdk.auth.credentials.AnonymousCredentialsProvider

Clases eliminadas

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