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.
Migration de l'authentification par mot de passe (AUTH) vers l'authentification IAM
Ce guide explique comment migrer votre Amazon ElastiCache cluster basé sur des nœuds ou cache sans serveur depuis l'authentification par mot de passe (AUTH) vers Gestion des identités et des accès AWS Authentification (IAM) sans interruption de service.
Nous vous recommandons de tester cette migration dans un environnement hors production avant d'appliquer des modifications à votre environnement de production.
Vue d’ensemble
L'authentification IAM renforce la sécurité en éliminant le besoin de mots de passe à longue durée de vie. Au lieu de cela, les applications génèrent des jetons d'authentification de courte durée (valables jusqu'à 15 minutes) à l'aide du AWS Processus de signature de Signature Version 4.
Conditions préalables
Avant de commencer, vérifiez les éléments suivants :
-
Votre cache exécute Redis OSS 7.0 ou version ultérieure, ou Valkey. L'authentification IAM n'est pas prise en charge sur les versions précédentes du moteur.
-
In-transit le chiffrement (TLS) est activé sur votre cache. L'authentification IAM nécessite le protocole TLS. Pour plus d’informations, consultez ElastiCache chiffrement en transit (TLS).
-
Vous disposez des autorisations IAM nécessaires pour créer des utilisateurs et modifier des groupes d'utilisateurs. Pour plus d’informations, consultez Comment Amazon ElastiCache travaille avec IAM.
-
Le rôle ou l'utilisateur IAM que votre application utilise possède une politique IAM qui permet
elasticache:Connectaction pour le cache cible et l'utilisateur IAM. Pour plus d’informations, consultez Authentification avec IAM dans ElastiCache. -
Aucune limite d'authentification IAM supplémentaire ne s'applique à votre application. Pour obtenir la liste complète des limitations, voir Authentification avec IAM dans ElastiCache.
Processus de migration
Le processus de migration implique la création à la fois d'un mot de passe et d'un IAM-authenticated utilisateur, en vérifiant la connectivité, puis en faisant passer vos applications à l'authentification IAM.
Étape 1 : Création d'utilisateurs
Créez deux ElastiCache utilisateurs afin que votre cache prenne en charge à la fois l'authentification par mot de passe et l'authentification IAM pendant la période de migration.
Création d'un utilisateur d'authentification par mot de passe
Si vous avez déjà configuré un utilisateur basé sur un mot de passe, vous pouvez ignorer la création d'un nouvel utilisateur et utiliser votre utilisateur existant.
Utilisez ce qui suit AWS CLI commande pour créer un utilisateur basé sur un mot de passe.
Pour Linux, macOS ou Unix :
aws elasticache create-user \ --user-id<user-id>\ --user-name default \ --engine<engine>\ --passwords "<your-existing-auth-password>" \ --access-string "on ~* +@all"
Pour Windows :
aws elasticache create-user ^ --user-id<user-id>^ --user-name default ^ --engine<engine>^ --passwords "<your-existing-auth-password>" ^ --access-string "on ~* +@all"
Remplacez :
<user-id>— Un identifiant unique pour cet utilisateur.<engine>— Le moteur utilisé par votre cache :valkeyouredis.<your-existing-auth-password>— Le jeton AUTH actuellement configuré sur votre cache.
Créez un IAM-authenticated utilisateur
Utilisez ce qui suit AWS CLI commande pour créer un IAM-authenticated utilisateur.
Pour Linux, macOS ou Unix :
aws elasticache create-user \ --user-id<iam-user-id>\ --user-name<iam-user-name>\ --authentication-mode Type=iam \ --engine<engine>\ --access-string "on ~* +@all"
Pour Windows :
aws elasticache create-user ^ --user-id<iam-user-id>^ --user-name<iam-user-name>^ --authentication-mode Type=iam ^ --engine<engine>^ --access-string "on ~* +@all"
Remplacez :
<iam-user-id>— Un identifiant unique pour l'utilisateur IAM.<iam-user-name>— Le nom d'utilisateur de l'utilisateur IAM.<engine>— Le moteur utilisé par votre cache :valkeyouredis.
Étape 2 : Création et attachement d'un groupe d'utilisateurs
Si vous avez déjà un groupe d'utilisateurs contenant votre utilisateur basé sur un mot de passe, ajoutez le IAM-authenticated utilisateur de ce groupe existant :
Pour Linux, macOS ou Unix :
aws elasticache modify-user-group \ --user-group-id<user-group-id>\ --user-ids-to-add<iam-user-id>
Pour Windows :
aws elasticache modify-user-group ^ --user-group-id<user-group-id>^ --user-ids-to-add<iam-user-id>
Remplacez :
<user-group-id>— L'identifiant de votre groupe d'utilisateurs existant.<iam-user-id>— L'identifiant utilisateur du IAM-authenticated utilisateur créé à l'étape 1.
Passez ensuite à Étape 3 : Vérifiez les deux méthodes d'authentification.
Sinon, créez un nouveau groupe d'utilisateurs, ajoutez les deux utilisateurs et attachez le groupe à votre cache.
Utilisez ce qui suit AWS CLI commandes pour créer un groupe d'utilisateurs avec les deux utilisateurs :
Pour Linux, macOS ou Unix :
aws elasticache create-user-group \ --user-group-id<user-group-id>\ --engine<engine>\ --user-ids<user-id><iam-user-id>
Pour Windows :
aws elasticache create-user-group ^ --user-group-id<user-group-id>^ --engine<engine>^ --user-ids<user-id><iam-user-id>
Remplacez :
<user-group-id>— Un identifiant unique pour le groupe d'utilisateurs.<engine>— Le moteur utilisé par votre cache :valkeyouredis.<user-id>,<iam-user-id>— Les identifiants utilisateur créés à l'étape 1.
Modifiez ensuite votre cache pour utiliser le nouveau groupe d'utilisateurs.
Pour les clusters basés sur des nœuds :
Pour Linux, macOS ou Unix :
aws elasticache modify-replication-group \ --replication-group-id<replication-group-id>\ --auth-token-update-strategy DELETE \ --user-group-ids-to-add<user-group-id>
Pour Windows :
aws elasticache modify-replication-group ^ --replication-group-id<replication-group-id>^ --auth-token-update-strategy DELETE ^ --user-group-ids-to-add<user-group-id>
Remplacez :
<replication-group-id>— L'ID de votre groupe de réplication.<user-group-id>— L'identifiant du groupe d'utilisateurs que vous avez créé ci-dessus.
Pour les caches sans serveur :
Pour Linux, macOS ou Unix :
aws elasticache modify-serverless-cache \ --serverless-cache-name<serverless-cache-name>\ --user-group-id<user-group-id>
Pour Windows :
aws elasticache modify-serverless-cache ^ --serverless-cache-name<serverless-cache-name>^ --user-group-id<user-group-id>
Remplacez :
<serverless-cache-name>— Le nom de votre cache sans serveur.<user-group-id>— L'identifiant du groupe d'utilisateurs que vous avez créé ci-dessus.
Étape 3 : Vérifiez les deux méthodes d'authentification
Une fois l'étape 2 terminée, votre cache prend en charge les deux méthodes d'authentification. Vérifiez que les applications peuvent se connecter en utilisant les deux méthodes avant de continuer.
-
Les applications utilisant l'authentification par mot de passe peuvent continuer à se connecter avec le mot de passe.
-
Les applications configurées pour l'authentification IAM peuvent se connecter à l'aide de jetons IAM.
Étape 4 : Connectez-vous à IAM
Générer un jeton d'authentification IAM
Générez un jeton d'authentification IAM de courte durée à l'aide d'un AWS Requête SigV4 pré-signée. L'exemple Python suivant illustre la génération de jetons.
import boto3 from botocore.auth import SigV4QueryAuth from botocore.awsrequest import AWSRequest cache_name = "<cache-name>" user = "<username>" region = "<region>" expires = 900 session = boto3.Session() credentials = session.get_credentials().get_frozen_credentials() req = AWSRequest( method="GET", url=f"http://{cache_name}/", params={"Action": "connect", "User": user} ) SigV4QueryAuth(credentials, "elasticache", region, expires=expires).add_auth(req) token = req.url.replace("http://", "") print(token)
Le jeton généré est valide pendant 15 minutes au maximum à compter de sa création.
Connectez-vous à l'aide de valkey-cli
Connectez-vous à votre ElastiCache cache à l'aide du jeton généré. Vous pouvez utiliser soit valkey-cli ou redis-cli pour vous connecter à Valkey clusters. Pour les clusters Redis OSS, utilisez redis-cli.
valkey-cli -h<host>-p 6379 --tls
Pour les clusters activés en mode cluster, ajoutez le --cluster drapeau :
valkey-cli -h<host>-p 6379 --tls --cluster
Authentifiez-vous ensuite à l'aide de la commande suivante :
AUTH<username><token>
Remplacez :
<host>— Point de terminaison de votre cache.<username>— Le nom d'utilisateur du IAM-authenticated utilisateur.<token>— Le jeton d'authentification IAM que vous avez généré.
Sortie attendue :
OK
Exécutez la commande suivante pour valider le nom d'utilisateur :
ACL WHOAMI
Étape 5 : Intégration des applications
Pour les applications Java, utilisez la valeur par défaut AWS Chaîne de fournisseurs d'informations d'identification pour générer des informations d'identification de sécurité temporaires. Pour plus d’informations, consultez Authentification avec IAM dans ElastiCache. Pour les autres langues, générez le jeton d'authentification IAM à l'aide du AWS Processus de signature de Signature Version 4 et transmettez-le comme mot de passe dans le dossier de votre client AUTH commande.
Finalisation de la migration
Une fois que vos applications peuvent se connecter à l'aide de l'authentification IAM, effectuez les étapes suivantes pour finaliser la migration.
Étape 1 : Configuration de l'authentification IAM avec repli
Avant de supprimer l'utilisateur basé sur un mot de passe, mettez à jour le code de votre application pour utiliser l'authentification IAM comme méthode principale tout en conservant l'utilisateur basé sur le mot de passe comme solution de secours.
Dans le code de votre application :
-
Configurez votre client pour qu'il s'authentifie à l'aide de IAM-generated les jetons comme méthode principale.
-
Ajoutez un mécanisme de secours afin que, si l'authentification IAM échoue (par exemple, en raison de l'expiration du jeton ou d'une erreur de génération), le client réessaie en utilisant les informations d'identification AUTH basées sur un mot de passe.
-
Enregistrez toutes les tentatives d'authentification, y compris les tentatives de repli et les nouvelles tentatives, afin de vérifier si des connexions reviennent à l'authentification par mot de passe.
Étape 2 : Surveiller et vérifier
Passez en revue vos journaux de candidature et les IamAuthenticationExpirations et IamAuthenticationThrottling Amazon CloudWatch des mesures sur au moins 24 à 48 heures pour confirmer que toutes les connexions passent par IAM.
Une valeur différente de zéro pour l'une ou l'autre des métriques justifie une enquête :
-
IamAuthenticationExpirations— Une connexion authentifiée IAM est automatiquement déconnectée au bout de 12 heures. La connexion peut être prolongée en envoyant unAUTHouHELLOcommande avec un nouveau jeton d'authentification IAM. -
IamAuthenticationThrottling— Indique un trop grand nombre de demandes d'authentification, ce qui peut signifier que votre application génère des jetons de manière trop agressive ou qu'elle rencontre des problèmes de regroupement de connexions.
Pour les clusters basés sur des nœuds, vous pouvez effectuer des vérifications supplémentaires au niveau du moteur :
-
ACL LOG— Vérifiez les tentatives d'authentification ayant échoué. Recherchez les entrées avecreason=auth. -
CLIENT LIST— Vérifiez les utilisateurs connectés. Vérifiez leuser=champ pour confirmer que les clients utilisent l'utilisateur IAM.
ACL LOG et CLIENT LIST sont disponibles uniquement sur les clusters basés sur des nœuds. Pour ElastiCache Déploiements sans serveur, s'appuient sur la journalisation côté application et Amazon CloudWatch métriques.
Étape 3 : Supprimer l'utilisateur basé sur un mot de passe
Une fois que vous avez confirmé que toutes les applications utilisent l'authentification IAM, supprimez l'utilisateur basé sur un mot de passe du groupe d'utilisateurs.
Valkey caches
Supprimez directement l'utilisateur basé sur le mot de passe :
Pour Linux, macOS ou Unix :
aws elasticache modify-user-group \ --user-group-id<user-group-id>\ --user-ids-to-remove<password-user-id>
Pour Windows :
aws elasticache modify-user-group ^ --user-group-id<user-group-id>^ --user-ids-to-remove<password-user-id>
Caches Redis OSS
Pour les caches Redis OSS, le groupe d'utilisateurs doit toujours contenir un utilisateur avec le nom d'utilisateur default. Si l'utilisateur basé sur un mot de passe que vous avez créé à l'étape 1 possède le nom d'utilisateur default, vous devez créer un utilisateur d'espace réservé désactivé pour le remplacer avant de le supprimer :
Pour Linux, macOS ou Unix :
aws elasticache create-user \ --user-id<disabled-default-id>\ --user-name default \ --engine redis \ --no-password-required \ --access-string "off ~* -@all"
Pour Windows :
aws elasticache create-user ^ --user-id<disabled-default-id>^ --user-name default ^ --engine redis ^ --no-password-required ^ --access-string "off ~* -@all"
Ajoutez ensuite l'utilisateur désactivé au groupe et supprimez l'utilisateur basé sur un mot de passe :
Pour Linux, macOS ou Unix :
aws elasticache modify-user-group \ --user-group-id<user-group-id>\ --user-ids-to-add<disabled-default-id>\ --user-ids-to-remove<password-user-id>
Pour Windows :
aws elasticache modify-user-group ^ --user-group-id<user-group-id>^ --user-ids-to-add<disabled-default-id>^ --user-ids-to-remove<password-user-id>
Si l'utilisateur par mot de passe que vous avez créé à l'étape 1 ne possède pas de nom d'utilisateur default, vous pouvez le supprimer directement à l'aide de la même commande que celle indiquée pour Valkey caches ci-dessus.
Remplacez :
<disabled-default-id>— Un identifiant unique pour l'utilisateur de l'espace réservé désactivé (Redis OSS uniquement).<user-group-id>— L'ID du groupe d'utilisateurs associé à votre cache.<password-user-id>— L'ID utilisateur de l'utilisateur basé sur le mot de passe à supprimer.
Ne supprimez pas l'utilisateur basé sur un mot de passe après l'avoir retiré du groupe d'utilisateurs. Gardez-le disponible au cas où vous auriez besoin de revenir à l'authentification par mot de passe.
Étape 4 : Confirmer après le retrait
Après avoir supprimé l'utilisateur basé sur un mot de passe du groupe d'utilisateurs, surveillez AuthenticationFailures Amazon CloudWatch métrique. Une valeur continue de zéro confirme qu'aucun échec d'authentification ne s'est produit, y compris toute tentative résiduelle basée sur un mot de passe. Définissez un CloudWatch alarme sur cette métrique pour détecter les tentatives inattendues.
Pour les clusters basés sur des nœuds, vous pouvez également vérifier à l'aide de ACL LOG et CLIENT LIST. Pour les caches sans serveur, utilisez la journalisation côté application et CloudWatch métriques.
Procédure de restauration
Re-add l'utilisateur basé sur un mot de passe vers le groupe d'utilisateurs, puis restaurez l'authentification par mot de passe dans votre application pendant que vous enquêtez.
Pour Valkey caches :
Pour Linux, macOS ou Unix :
aws elasticache modify-user-group \ --user-group-id<user-group-id>\ --user-ids-to-add<password-user-id>
Pour Windows :
aws elasticache modify-user-group ^ --user-group-id<user-group-id>^ --user-ids-to-add<password-user-id>
Pour les caches Redis OSS où l'utilisateur basé sur un mot de passe n'a pas de nom d'utilisateur default, utilisez la même commande ci-dessus.
Pour les caches Redis OSS dans lesquels vous avez créé un utilisateur d'espace réservé désactivé dans Étape 3 : Supprimer l'utilisateur basé sur un mot de passe, ajoutez l'utilisateur basé sur le mot de passe et supprimez l'utilisateur de l'espace réservé désactivé en une seule opération :
Pour Linux, macOS ou Unix :
aws elasticache modify-user-group \ --user-group-id<user-group-id>\ --user-ids-to-add<password-user-id>\ --user-ids-to-remove<disabled-default-id>
Pour Windows :
aws elasticache modify-user-group ^ --user-group-id<user-group-id>^ --user-ids-to-add<password-user-id>^ --user-ids-to-remove<disabled-default-id>
Remplacez :
<user-group-id>— L'ID du groupe d'utilisateurs associé à votre cache.<password-user-id>— L'ID utilisateur de l'utilisateur basé sur le mot de passe à ajouter à nouveau.<disabled-default-id>— L'identifiant utilisateur de l'espace réservé désactivé (Redis OSS uniquement).