Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Migration von der kennwortbasierten Authentifizierung (AUTH) zur IAM-Authentifizierung
In dieser Anleitung wird beschrieben, wie Sie Ihr Amazon migrieren ElastiCache knotenbasierter Cluster oder serverloser Cache von der kennwortbasierten Authentifizierung (AUTH) zu AWS Identity and Access Management (IAM) -Authentifizierung ohne Dienstunterbrechung.
Wir empfehlen, diese Migration in einer Nicht-Produktionsumgebung zu testen, bevor Sie Änderungen an Ihrer Produktionsumgebung vornehmen.
-Übersicht
Die IAM-Authentifizierung bietet erhöhte Sicherheit, da langlebige Passwörter überflüssig werden. Stattdessen generieren Anwendungen kurzlebige Authentifizierungstoken (gültig für bis zu 15 Minuten) mithilfe der AWS Signaturprozess für Version 4.
Voraussetzungen
Bevor Sie beginnen, prüfen Sie Folgendes:
-
In Ihrem Cache wird Redis OSS 7.0 oder höher ausgeführt, oder Valkey. Die IAM-Authentifizierung wird in früheren Engine-Versionen nicht unterstützt.
-
In-transit Die Verschlüsselung (TLS) ist in Ihrem Cache aktiviert. Für die IAM-Authentifizierung ist TLS erforderlich. Weitere Informationen finden Sie unter ElastiCache Verschlüsselung bei der Übertragung (TLS).
-
Sie verfügen über die erforderlichen IAM-Berechtigungen, um Benutzer zu erstellen und Benutzergruppen zu ändern. Weitere Informationen finden Sie unter So ElastiCache arbeitet Amazon mit IAM.
-
Die IAM-Rolle oder der IAM-Benutzer, die Ihre Anwendung verwendet, verfügt über eine IAM-Richtlinie, die Folgendes ermöglicht
elasticache:ConnectAktion für den Ziel-Cache und den IAM-Benutzer. Weitere Informationen finden Sie unter Authentifizierung mit IAM in ElastiCache. -
Für Ihre Anwendung gelten keine zusätzlichen Einschränkungen bei der IAM-Authentifizierung. Die vollständige Liste der Einschränkungen finden Sie unter Authentifizierung mit IAM in ElastiCache.
Migrationsprozess
Der Migrationsprozess beinhaltet die Erstellung sowohl einer passwortbasierten als auch einer IAM-authenticated Benutzer, Überprüfung der Konnektivität und anschließende Umstellung Ihrer Anwendungen auf IAM-Authentifizierung.
Schritt 1: Benutzer erstellen
Erstellen Sie zwei ElastiCache Benutzer, sodass Ihr Cache während des Migrationszeitraums sowohl die kennwortbasierte als auch die IAM-Authentifizierung unterstützt.
Erstellen Sie einen Benutzer mit kennwortbasierter Authentifizierung
Wenn Sie bereits einen kennwortbasierten Benutzer konfiguriert haben, können Sie die Erstellung eines neuen Benutzers überspringen und Ihren vorhandenen Benutzer verwenden.
Verwenden Sie Folgendes AWS CLI Befehl, um einen kennwortbasierten Benutzer zu erstellen.
Für Linux, macOS oder Unix:
aws elasticache create-user \ --user-id<user-id>\ --user-name default \ --engine<engine>\ --passwords "<your-existing-auth-password>" \ --access-string "on ~* +@all"
Für Windows:
aws elasticache create-user ^ --user-id<user-id>^ --user-name default ^ --engine<engine>^ --passwords "<your-existing-auth-password>" ^ --access-string "on ~* +@all"
Ersetzen Sie:
<user-id>— Eine eindeutige ID für diesen Benutzer.<engine>— Die Engine, die dein Cache verwendet:valkeyoderredis.<your-existing-auth-password>— Das aktuell in Ihrem Cache konfigurierte AUTH-Token.
Erstellen Sie ein IAM-authenticated Benutzer
Benutze das Folgende AWS CLI Befehl zum Erstellen eines IAM-authenticated Benutzer.
Für Linux, macOS oder 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"
Für 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"
Ersetzen Sie:
<iam-user-id>— Eine eindeutige ID für den IAM-Benutzer.<iam-user-name>— Der Benutzername für den IAM-Benutzer.<engine>— Die Engine, die Ihr Cache verwendet:valkeyoderredis.
Schritt 2: Benutzergruppe erstellen und anhängen
Wenn Sie bereits eine Benutzergruppe haben, die Ihren passwortbasierten Benutzer enthält, fügen Sie die IAM-authenticated Benutzer zu dieser vorhandenen Gruppe:
Für Linux, macOS oder Unix:
aws elasticache modify-user-group \ --user-group-id<user-group-id>\ --user-ids-to-add<iam-user-id>
Für Windows:
aws elasticache modify-user-group ^ --user-group-id<user-group-id>^ --user-ids-to-add<iam-user-id>
Ersetzen Sie:
<user-group-id>— Die ID Ihrer bestehenden Benutzergruppe.<iam-user-id>— Die Benutzer-ID des IAM-authenticated Benutzer, der in Schritt 1 erstellt wurde.
Fahren Sie anschließend fort mit der unter Schritt 3: Überprüfen Sie beide Authentifizierungsmethoden beschriebenen Anleitung.
Andernfalls erstellen Sie eine neue Benutzergruppe, fügen Sie beide Benutzer hinzu und hängen Sie die Gruppe an Ihren Cache an.
Verwenden Sie Folgendes AWS CLI Befehle, um eine Benutzergruppe mit beiden Benutzern zu erstellen:
Für Linux, macOS oder Unix:
aws elasticache create-user-group \ --user-group-id<user-group-id>\ --engine<engine>\ --user-ids<user-id><iam-user-id>
Für Windows:
aws elasticache create-user-group ^ --user-group-id<user-group-id>^ --engine<engine>^ --user-ids<user-id><iam-user-id>
Ersetzen Sie:
<user-group-id>— Eine eindeutige ID für die Benutzergruppe.<engine>— Die Engine, die dein Cache verwendet:valkeyoderredis.<user-id>,<iam-user-id>— Die in Schritt 1 erstellten Benutzer-IDs.
Ändern Sie dann Ihren Cache, um die neue Benutzergruppe zu verwenden.
Für knotenbasierte Cluster:
Für Linux, macOS oder 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>
Für 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>
Ersetzen Sie:
<replication-group-id>— Die ID Ihrer Replikationsgruppe.<user-group-id>— Die Benutzergruppen-ID, die Sie oben erstellt haben.
Für serverlose Caches:
Für Linux, macOS oder Unix:
aws elasticache modify-serverless-cache \ --serverless-cache-name<serverless-cache-name>\ --user-group-id<user-group-id>
Für Windows:
aws elasticache modify-serverless-cache ^ --serverless-cache-name<serverless-cache-name>^ --user-group-id<user-group-id>
Ersetzen Sie:
<serverless-cache-name>— Der Name Ihres serverlosen Caches.<user-group-id>— Die Benutzergruppen-ID, die Sie oben erstellt haben.
Schritt 3: Überprüfen Sie beide Authentifizierungsmethoden
Nach Abschluss von Schritt 2 unterstützt Ihr Cache beide Authentifizierungsmethoden. Stellen Sie sicher, dass Anwendungen mit beiden Methoden eine Verbindung herstellen können, bevor Sie fortfahren.
-
Anwendungen, die die kennwortbasierte Authentifizierung verwenden, können weiterhin eine Verbindung mit dem Passwort herstellen.
-
Anwendungen, die für die IAM-Authentifizierung konfiguriert sind, können mithilfe von IAM-Token eine Verbindung herstellen.
Schritt 4: Stellen Sie eine Verbindung mit IAM her
Generieren Sie ein IAM-Authentifizierungstoken
Generieren Sie ein kurzlebiges IAM-Authentifizierungstoken mit einem AWS Vorsignierte SigV4-Anfrage. Das folgende Python-Beispiel veranschaulicht die Token-Generierung.
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)
Das generierte Token ist ab der Erstellung bis zu 15 Minuten gültig.
Stellen Sie mithilfe von valkey-cli eine Verbindung her
Stellen Sie eine Verbindung zu Ihrem her ElastiCache Cache mit dem generierten Token. Sie können beides verwenden valkey-cli oder redis-cli um eine Verbindung herzustellen Valkey Cluster. Verwenden Sie für Redis OSS-Cluster redis-cli.
valkey-cli -h<host>-p 6379 --tls
Fügen Sie für Cluster mit aktiviertem Clustermodus den --cluster Flagge:
valkey-cli -h<host>-p 6379 --tls --cluster
Authentifizieren Sie sich dann mit dem folgenden Befehl:
AUTH<username><token>
Ersetzen Sie:
<host>— Der Endpunkt Ihres Caches.<username>— Der Nutzername des IAM-authenticated Benutzer.<token>— Das von Ihnen generierte IAM-Authentifizierungstoken.
Erwartete Ausgabe:
OK
Führen Sie den folgenden Befehl aus, um den Benutzernamen zu überprüfen:
ACL WHOAMI
Schritt 5: Anwendungsintegration
Verwenden Sie für Java-Anwendungen die Standardeinstellung AWS Anbieterkette für Anmeldeinformationen, um temporäre Sicherheitsanmeldeinformationen zu generieren. Weitere Informationen finden Sie unter Authentifizierung mit IAM in ElastiCache. Generieren Sie für andere Sprachen das IAM-Authentifizierungstoken mit dem AWS Signaturvorgang für Version 4 und geben Sie es als Passwort in das Passwort Ihres Kunden ein AUTH Befehl.
Abschluss der Migration
Nachdem Ihre Anwendungen mithilfe der IAM-Authentifizierung eine Verbindung herstellen können, führen Sie die folgenden Schritte aus, um die Migration abzuschließen.
Schritt 1: Konfigurieren Sie die IAM-Authentifizierung mit Fallback
Bevor Sie den kennwortbasierten Benutzer entfernen, aktualisieren Sie Ihren Anwendungscode, um die IAM-Authentifizierung als primäre Methode zu verwenden und den kennwortbasierten Benutzer als Fallback beizubehalten.
In Ihrem Anwendungscode:
-
Konfigurieren Sie Ihren Client für die Authentifizierung mit IAM-generated Tokens als primäre Methode.
-
Fügen Sie einen Fallback-Mechanismus hinzu, sodass der Client erneut versucht, die kennwortbasierten AUTH-Anmeldeinformationen zu verwenden, wenn die IAM-Authentifizierung fehlschlägt (z. B. aufgrund eines Ablaufs des Tokens oder eines Generierungsfehlers).
-
Protokollieren Sie alle Authentifizierungsversuche, einschließlich Fallbacks und Wiederholungsversuchen, sodass Sie überwachen können, ob Verbindungen auf die kennwortbasierte Authentifizierung zurückgreifen.
Schritt 2: Überwachen und verifizieren
Überprüfen Sie Ihre Anwendungsprotokolle und die IamAuthenticationExpirations und IamAuthenticationThrottling Amazon CloudWatch Messwerte über einen Zeitraum von mindestens 24—48 Stunden zur Bestätigung, dass alle Verbindungen über IAM hergestellt werden.
Ein Wert ungleich Null für eine der beiden Metriken rechtfertigt eine Untersuchung:
-
IamAuthenticationExpirations— Eine IAM-authentifizierte Verbindung wird nach 12 Stunden automatisch getrennt. Die Verbindung kann verlängert werden, indem Sie eineAUTHoderHELLOBefehl mit einem neuen IAM-Authentifizierungstoken. -
IamAuthenticationThrottling— Weist auf zu viele Authentifizierungsanfragen hin, was bedeuten kann, dass Ihre Anwendung Tokens zu aggressiv generiert oder Probleme mit dem Verbindungspooling hat.
Bei knotenbasierten Clustern können Sie zusätzliche Prüfungen auf Engine-Ebene durchführen:
-
ACL LOG— Suchen Sie nach fehlgeschlagenen Authentifizierungsversuchen. Suchen Sie nach Einträgen mitreason=auth. -
CLIENT LIST— Überprüfen Sie die verbundenen Benutzer. Prüfen Sie dasuser=Feld zur Bestätigung, dass die Clients den IAM-Benutzer verwenden.
ACL LOG und CLIENT LIST sind nur auf knotenbasierten Clustern verfügbar. Für ElastiCache Verlassen Sie sich bei serverlosen Bereitstellungen auf anwendungsseitige Protokollierung und Amazon CloudWatch Metriken.
Schritt 3: Den passwortbasierten Benutzer entfernen
Sobald Sie bestätigt haben, dass alle Anwendungen die IAM-Authentifizierung verwenden, entfernen Sie den kennwortbasierten Benutzer aus der Benutzergruppe.
Valkey Caches
Den passwortbasierten Benutzer direkt entfernen:
Für Linux, macOS oder Unix:
aws elasticache modify-user-group \ --user-group-id<user-group-id>\ --user-ids-to-remove<password-user-id>
Für Windows:
aws elasticache modify-user-group ^ --user-group-id<user-group-id>^ --user-ids-to-remove<password-user-id>
Redis OSS-Caches
Bei Redis OSS-Caches muss die Benutzergruppe immer einen Benutzer mit dem Benutzernamen enthalten default. Wenn der passwortbasierte Benutzer, den Sie in Schritt 1 erstellt haben, den Benutzernamen hat default, müssen Sie einen deaktivierten Platzhalterbenutzer erstellen, um ihn zu ersetzen, bevor Sie ihn entfernen:
Für Linux, macOS oder Unix:
aws elasticache create-user \ --user-id<disabled-default-id>\ --user-name default \ --engine redis \ --no-password-required \ --access-string "off ~* -@all"
Für Windows:
aws elasticache create-user ^ --user-id<disabled-default-id>^ --user-name default ^ --engine redis ^ --no-password-required ^ --access-string "off ~* -@all"
Fügen Sie dann den deaktivierten Benutzer zur Gruppe hinzu und entfernen Sie den kennwortbasierten Benutzer:
Für Linux, macOS oder 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>
Für 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>
Wenn der kennwortbasierte Benutzer, den Sie in Schritt 1 erstellt haben, den Benutzernamen nicht hat default, Sie können ihn direkt entfernen, indem Sie den gleichen Befehl wie für verwenden Valkey Caches oben.
Ersetzen Sie:
<disabled-default-id>— Eine eindeutige ID für den deaktivierten Platzhalterbenutzer (nur Redis OSS).<user-group-id>— Die ID der Benutzergruppe, die Ihrem Cache zugeordnet ist.<password-user-id>— Die Benutzer-ID des passwortbasierten Benutzers, der entfernt werden soll.
Löschen Sie den kennwortbasierten Benutzer nicht, nachdem Sie ihn aus der Benutzergruppe entfernt haben. Halten Sie ihn für den Fall bereit, dass Sie zur kennwortbasierten Authentifizierung zurückkehren müssen.
Schritt 4: Bestätigen Sie nach dem Entfernen
Nachdem Sie den kennwortbasierten Benutzer aus der Benutzergruppe entfernt haben, überwachen Sie AuthenticationFailures Amazon CloudWatch metrisch. Ein anhaltender Wert Null bestätigt, dass keine Authentifizierungsfehler aufgetreten sind, einschließlich aller verbleibenden kennwortbasierten Versuche. Stellen Sie einen ein CloudWatch Alarm für diese Metrik, um unerwartete Versuche zu erkennen.
Bei knotenbasierten Clustern können Sie dies auch mithilfe von überprüfen ACL LOG und CLIENT LIST. Verlassen Sie sich bei serverlosen Caches auf die anwendungsseitige Protokollierung und CloudWatch Metriken.
Rollback-Verfahren
Re-add Geben Sie den kennwortbasierten Benutzer in die Benutzergruppe ein und stellen Sie dann die kennwortbasierte Authentifizierung in Ihrer Anwendung wieder her, während Sie die Untersuchung durchführen.
Für Valkey caches:
Für Linux, macOS oder Unix:
aws elasticache modify-user-group \ --user-group-id<user-group-id>\ --user-ids-to-add<password-user-id>
Für Windows:
aws elasticache modify-user-group ^ --user-group-id<user-group-id>^ --user-ids-to-add<password-user-id>
Für Redis OSS-Caches, bei denen der passwortbasierte Benutzer den Benutzernamen nicht hat default, verwenden Sie den gleichen Befehl wie oben.
Für Redis OSS-Caches, in denen Sie einen deaktivierten Platzhalterbenutzer erstellt haben Schritt 3: Den passwortbasierten Benutzer entfernen, fügen Sie den kennwortbasierten Benutzer hinzu und entfernen Sie den deaktivierten Platzhalterbenutzer in einem einzigen Vorgang:
Für Linux, macOS oder 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>
Für 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>
Ersetzen Sie:
<user-group-id>— Die ID der Benutzergruppe, die Ihrem Cache zugeordnet ist.<password-user-id>— Die Benutzer-ID des kennwortbasierten Benutzers, der erneut hinzugefügt werden soll.<disabled-default-id>— Die Benutzer-ID des deaktivierten Platzhalterbenutzers (nur Redis OSS).