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:
-
Cliente GLIDE: gestiona la generación y la actualización del token automáticamente. No se requiere código de autenticación.
-
Kit de herramientas para desarrolladores ElastiCache: genera el token automáticamente. Úselo con cualquier biblioteca cliente de Valkey o Redis OSS.
-
Firma manual de SigV4: genere el token usted mismo con el SDK. AWS
Temas
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
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
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:Connectpermiso 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 |
| 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. |