View a markdown version of this page

Connectez-vous à un cache avec un point de terminaison public - Amazon ElastiCache

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Connectez-vous à un cache avec un point de terminaison public

Toutes les connexions aux points de terminaison publics nécessitent l'authentification IAM et le protocole TLS 1.3. Il existe trois méthodes pour générer le jeton d'authentification IAM :

  1. Client GLIDE : gère automatiquement la génération et l'actualisation des jetons. Aucun code d'authentification n'est requis.

  2. Boîte à outils pour les développeurs pour ElastiCache : Génère le jeton pour vous. Utilisez-le avec n'importe quelle bibliothèque cliente Valkey ou Redis OSS.

  3. Signature manuelle SigV4 : générez vous-même le jeton à l'aide du AWS SDK.

Politique IAM pour la connexion

Avant de vous connecter, votre utilisateur ou rôle IAM doit être autorisé à appelerelasticache:Connect. La politique AWS gérée AdministratorAccess inclut cette autorisation pour toutes les ressources.

Créez une politique IAM qui autorise l'elasticache:Connectaction sur le ElastiCache cache et sur l' ElastiCache utilisateur :

{ "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" ] } ] }

Option 1 : client GLIDE avec IAM intégré

GLIDE 2.2 et versions ultérieures incluent la prise en charge intégrée de l'authentification IAM. Vous configurez vos AWS informations d'identification et GLIDE gère automatiquement la génération, la mise en cache et l'actualisation des jetons. Pour les instructions d'installation, consultez la documentation GLIDE sur le site 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"

Option 2 : boîte à outils pour les développeurs pour ElastiCache

Le Developer Toolkit for ElastiCache (developer-toolkit-elasticache) est une bibliothèque Python autonome et une CLI qui génère des jetons d'authentification IAM. Utilisez-le avec une bibliothèque cliente Python Valkey ou Redis OSS, telle que valkey-py.

Installation

pip install developer-toolkit-elasticache

Python avec 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"

Le Developer Toolkit n'actualise pas automatiquement les jetons. Les jetons d'authentification IAM sont valides pendant 15 minutes. Votre application doit donc générer un nouveau jeton avant que le jeton actuel n'expire. Dans l'exemple précédent, le fournisseur d'informations d'identification appelle get_token() pour chaque nouvelle connexion.

CLI avec le kit d'outils pour développeurs

Pour vous connecter à valkey-cli ou redis-cli, utilisez la CLI du Developer Toolkit pour générer un jeton :

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_AUTHnécessite valkey-cli 9.0 ou version ultérieure. Pour redis-cli, utilisez REDISCLI_AUTH à la place de. VALKEYCLI_AUTH

Pour le code source et d'autres exemples, consultez le Developer Toolkit pour le ElastiCache référentiel sur GitHub.

Option 3 : signature manuelle du SigV4

Générez le jeton d'authentification IAM manuellement à l'aide du AWS SDK. Pour des exemples de code de signature, voirSe connecter avec un jeton comme mot de passe.

Expiration du jeton et de session

  • Expiration des jetons : les jetons d'authentification IAM sont valides pendant 15 minutes. GLIDE actualise automatiquement le jeton. Si vous utilisez le Developer Toolkit ou la signature manuelle, générez un nouveau jeton pour chaque nouvelle connexion. L'expiration du jeton n'affecte pas les connexions établies. Si vous signez le jeton avec des informations d'identification temporaires, le jeton expire lorsque ces informations expirent, si cela prend moins de 15 minutes.

  • Expiration de session : les connexions expirent au bout de 12 heures et se reconnectent automatiquement. La révocation de l'elasticache:Connectautorisation d'un directeur IAM ne déconnecte pas immédiatement les sessions actives. Pour déconnecter immédiatement un utilisateur, supprimez-le du groupe d'utilisateurs du cache.

Résolution des problèmes

Le tableau suivant répertorie les erreurs de connexion courantes, leurs causes et la manière de les résoudre.

Erreur Cause Résolution
WRONGPASSou échec de l'authentification Jeton IAM expiré, nom d'utilisateur incorrect, autorisations IAM manquantes, nom du cache non en minuscules ou informations d'identification temporaires expirées Vérifiez que le jeton est récent (moins de 15 minutes), que le nom d'utilisateur correspond à un utilisateur du groupe d'utilisateurs du cache, que le principal IAM est elasticache:Connect autorisé à la fois sur l'ARN du cache et sur l'ARN de l'utilisateur, que le nom du cache dans le code de signature de votre jeton est en minuscules et, si vous avez signé le jeton avec des informations d'identification temporaires, que ces informations d'identification n'étaient pas expirées.
NOAUTH Authentication required Le client a envoyé une commande avant de s'authentifier. Une connexion de point de terminaison public doit s'authentifier avec AUTH ou HELLO … AUTH en tant que première commande. Certaines bibliothèques clientes envoient une commande telle que CLIENT SETINFO ou PING lors de la connexion, avant que les informations d'identification ne soient appliquées. La connexion est fermée après plusieurs commandes non authentifiées. Configurez votre client de manière à ce que l'authentification soit intégrée à la configuration de la connexion : transmettez le jeton comme mot de passe de connexion ou par l'intermédiaire d'un fournisseur d'informations d'identification, plutôt que d'appeler AUTH après la connexion. GLIDE le fait automatiquement.
ERR service is not available Cette erreur est renvoyée pour toute nouvelle connexion qui échoue avant la fin de l'authentification. Pour éviter de divulguer l'état interne du moteur à un appelant non authentifié, ElastiCache envoyez ce même message générique pour plusieurs causes sous-jacentes distinctes : l'authentification IAM est temporairement indisponible, votre débit est limité en raison de la limitation de l'authentification IAM, ou le moteur est temporairement surchargé (, ou le nombre maximum de clients atteint). BUSY CLUSTERDOWN Sur une connexion déjà authentifiée qui s'exécute à nouveau AUTH ou HELLO ElastiCache renvoie une erreur spécifique à la place, telle que ou. ERR IAM Authentication service is not available ERR Exceeded limit of IAM Authentication requests Si vous avez récemment ouvert un taux élevé de nouvelles connexions ou de réauthentifications, réduisez ce taux et réessayez avec un retard exponentiel. Si votre taux de connexion et de réauthentification est normal, consultez le AWS Health Dashboard pour tout problème ElastiCache de service.
Délai de connexion Problème de connectivité réseau, point de terminaison incorrect ou TLS non activé Vérifiez que l'adresse du point de terminaison est correcte, que le protocole TLS est activé dans la configuration de votre client et que votre réseau autorise les connexions sortantes vers le port 6379.
TLS handshake failure Le client ne prend pas en charge le protocole TLS 1.3. Les caches dotés d'un point de terminaison public nécessitent le protocole TLS 1.3. Mettez à jour votre client ou votre environnement d'exécution vers une version compatible avec TLS 1.3.