View a markdown version of this page

Conectarse a una caché con un punto final público - Amazon ElastiCache

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Conectarse a una caché con un punto final público

Todas las conexiones de puntos finales públicos requieren la autenticación de IAM y el protocolo TLS 1.3. Hay tres formas de generar el token de autenticación de IAM:

  1. Cliente GLIDE: gestiona la generación y la actualización del token automáticamente. No se requiere código de autenticación.

  2. Kit de herramientas para desarrolladores ElastiCache: genera el token automáticamente. Úselo con cualquier biblioteca cliente de Valkey o Redis OSS.

  3. Firma manual de SigV4: genere el token usted mismo con el SDK. AWS

Política de IAM para conectarse

Antes de conectarse, su usuario o rol de IAM necesita permiso para llamar. elasticache:Connect La política AWS gestionada AdministratorAccess incluye este permiso para todos los recursos.

Cree una política de IAM que permita realizar elasticache:Connect acciones en la ElastiCache memoria caché y en el ElastiCache usuario:

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "elasticache:Connect", "Resource": [ "arn:aws:elasticache:us-east-1:123456789012:serverlesscache:my-public-cache", "arn:aws:elasticache:us-east-1:123456789012:user:default.iam-user" ] } ] }

Opción 1: cliente GLIDE con IAM integrado

GLIDE 2.2 y las versiones posteriores incluyen soporte de autenticación de IAM integrado. Usted configura sus AWS credenciales y GLIDE gestiona automáticamente la generación, el almacenamiento en caché y la actualización de los tokens. Para obtener instrucciones de instalación, consulte la documentación de GLIDE en el sitio web de GLIDE.

Python

from glide import ( GlideClusterClient, GlideClusterClientConfiguration, NodeAddress, ServerCredentials, IamAuthConfig, ServiceType, ) config = GlideClusterClientConfiguration( addresses=[NodeAddress("my-public-cache-x2e9hv.public.serverless.use1.cache.amazonaws.com", 6379)], credentials=ServerCredentials( username="default.iam-user", iam_config=IamAuthConfig( cluster_name="my-public-cache", service=ServiceType.ELASTICACHE, region="us-east-1", ), ), use_tls=True, ) client = await GlideClusterClient.create(config) await client.set("key", "value") result = await client.get("key") print(result) # b"value"

Java

import glide.api.GlideClusterClient; import glide.api.models.configuration.IamAuthConfig; import glide.api.models.configuration.ServiceType; import glide.api.models.configuration.ServerCredentials; import glide.api.models.configuration.GlideClusterClientConfiguration; import glide.api.models.configuration.NodeAddress; import java.util.List; import java.util.Collections; List<NodeAddress> nodes = Collections.singletonList( NodeAddress.builder() .host("my-public-cache-x2e9hv.public.serverless.use1.cache.amazonaws.com") .port(6379) .build() ); IamAuthConfig iamConfig = IamAuthConfig.builder() .clusterName("my-public-cache") .service(ServiceType.ELASTICACHE) .region("us-east-1") .build(); GlideClusterClientConfiguration config = GlideClusterClientConfiguration.builder() .addresses(nodes) .credentials(ServerCredentials.builder() .username("default.iam-user") .iamConfig(iamConfig) .build()) .useTLS(true) .build(); GlideClusterClient client = GlideClusterClient.createClient(config).get(); client.set("key", "value").get(); String result = client.get("key").get(); System.out.println(result); // "value"

Opción 2: kit de herramientas para desarrolladores para ElastiCache

El kit de herramientas para desarrolladores para ElastiCache (developer-toolkit-elasticache) es una biblioteca de Python independiente y una CLI que genera tokens de autenticación de IAM. Úselo con una biblioteca cliente Python Valkey o Redis OSS, como valkey-py.

Instalación

pip install developer-toolkit-elasticache

Python con valkey-py

import valkey from valkey.credentials import CredentialProvider from developer_toolkit_elasticache import ElastiCacheIAMAuthTokenProvider class ElastiCacheCredentialProvider(CredentialProvider): def __init__(self, auth): self._auth = auth def get_credentials(self): return self._auth.user_id, self._auth.get_token() auth = ElastiCacheIAMAuthTokenProvider( serverless_cache_name="my-public-cache", user_id="default.iam-user", region="us-east-1", ) client = valkey.ValkeyCluster( host="my-public-cache-x2e9hv.public.serverless.use1.cache.amazonaws.com", port=6379, ssl=True, credential_provider=ElastiCacheCredentialProvider(auth), ) client.set("key", "value") result = client.get("key") print(result) # b"value"

El kit de herramientas para desarrolladores no actualiza automáticamente los tokens. Los tokens de autenticación de IAM son válidos durante 15 minutos, por lo que su aplicación debe generar un nuevo token antes de que caduque el token actual. El proveedor de credenciales del ejemplo anterior get_token() solicita cada nueva conexión.

CLI con el kit de herramientas para desarrolladores

Para conectarse con valkey-cli o redis-cli, utilice la CLI del Developer Toolkit para generar un token:

export VALKEYCLI_AUTH=$(developer-toolkit-elasticache generate_iam_auth_token \ --serverless-cache-name my-public-cache \ --user-id default.iam-user \ --region us-east-1) valkey-cli -c -h my-public-cache-x2e9hv.public.serverless.use1.cache.amazonaws.com \ -p 6379 \ --tls \ --user default.iam-user

VALKEYCLI_AUTHrequiere valkey-cli 9.0 o posterior. Para redis-cli, utilice en lugar de. REDISCLI_AUTH VALKEYCLI_AUTH

Para ver el código fuente y otros ejemplos, consulta el repositorio correspondiente al kit de herramientas para desarrolladores. ElastiCache GitHub

Opción 3: Firma manual de SiGv4

Genere el token de autenticación de IAM manualmente mediante el AWS SDK. Para ver ejemplos de códigos de firma, consulteConectar con el token como contraseña.

Expiración del token y de la sesión

  • Caducidad del token: los tokens de autenticación de IAM son válidos durante 15 minutos. GLIDE actualiza el token automáticamente. Si utilizas el kit de herramientas para desarrolladores o la firma manual, genera un nuevo token para cada nueva conexión. La caducidad del token no afecta a las conexiones establecidas. Si firmas el token con credenciales temporales, el token caducará cuando esas credenciales caduquen, si es antes de 15 minutos.

  • Caducidad de la sesión: las conexiones caducan después de 12 horas y se vuelven a conectar automáticamente. La revocación del elasticache:Connect permiso de un director de IAM no desconecta inmediatamente las sesiones activas. Para desconectar a un usuario inmediatamente, elimínelo del grupo de usuarios de la memoria caché.

Resolución de problemas

En la siguiente tabla se enumeran los errores de conexión más comunes, sus causas y cómo resolverlos.

Error Causa Resolución
WRONGPASSo error de autenticación El token de IAM ha caducado, el nombre de usuario es incorrecto, faltan permisos de IAM, el nombre de la caché no está en minúsculas o las credenciales temporales han caducado Compruebe que el token esté actualizado (tenga menos de 15 minutos), que el nombre de usuario coincida con un usuario del grupo de usuarios de la caché, que el principal de IAM tenga elasticache:Connect permiso tanto en el ARN de la caché como en el ARN del usuario, que el nombre de la caché del código de firma del token esté en minúsculas y, si firmó el token con credenciales temporales, que esas credenciales no hayan caducado.
NOAUTH Authentication required El cliente envió un comando antes de autenticarse. Una conexión de punto final público debe autenticarse con AUTH o HELLO … AUTH como primer comando. Algunas bibliotecas cliente envían un comando, como CLIENT SETINFO o PING al conectarse, antes de aplicar las credenciales. La conexión se cierra tras repetir comandos no autenticados. Configure su cliente para que la autenticación se realice como parte de la configuración de la conexión: pase el token como contraseña de conexión o a través de un proveedor de credenciales, en lugar de llamar AUTH después de conectarse. GLIDE lo hace automáticamente.
ERR service is not available Este error se devuelve para cualquier conexión nueva que falle antes de que se complete la autenticación. Para evitar revelar el estado interno del motor a una persona que llama no autenticada, ElastiCache reporta este mismo mensaje genérico debido a varias causas subyacentes distintas: la autenticación de IAM no está disponible temporalmente, la velocidad está limitada debido a la limitación de la autenticación de IAM o el motor está temporalmente sobrecargado (,, o se ha alcanzado el número máximo de clientes). BUSY CLUSTERDOWN En una conexión ya autenticada que se vuelve a ejecutar o, en su lugar, devuelve un error específico, como o. AUTH HELLO ElastiCache ERR IAM Authentication service is not available ERR Exceeded limit of IAM Authentication requests Si ha abierto recientemente una alta tasa de nuevas conexiones o reautenticaciones, reduzca esa tasa y vuelva a intentarlo con un retraso exponencial. Si su velocidad de conexión y reautenticación es normal, consulte el AWS Health Dashboard para ver si hay problemas con el ElastiCache servicio.
Tiempo de espera de la conexión Problema de conectividad de red, terminal incorrecto o TLS no activado Compruebe que la dirección del punto final sea correcta, que el TLS esté habilitado en la configuración del cliente y que la red permita las conexiones salientes al puerto 6379.
TLS handshake failure El cliente no admite TLS 1.3. Las cachés con un punto final público requieren TLS 1.3. Actualice el cliente o el motor de ejecución a una versión compatible con TLS 1.3.