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.
Stellen Sie eine Connect zu einem Cache mit einem öffentlichen Endpunkt her
Alle öffentlichen Endpunktverbindungen erfordern IAM-Authentifizierung und TLS 1.3. Es gibt drei Möglichkeiten, das IAM-Authentifizierungstoken zu generieren:
-
GLIDE-Client: Verarbeitet die Token-Generierung und Aktualisierung automatisch. Kein Authentifizierungscode erforderlich.
-
Entwickler-Toolkit für ElastiCache: Generiert das Token für Sie. Verwenden Sie es mit einer beliebigen Valkey- oder Redis OSS-Clientbibliothek.
-
Manuelles SigV4-Signaturen: Generieren Sie das Token mithilfe des SDK selbst. AWS
Themen
IAM-Richtlinie für die Verbindung
Bevor Sie eine Verbindung herstellen, benötigt Ihr IAM-Benutzer oder Ihre IAM-Rolle eine Anruferlaubnis. elasticache:Connect Die AWS verwaltete Richtlinie AdministratorAccess beinhaltet diese Berechtigung für alle Ressourcen.
Erstellen Sie eine IAM-Richtlinie, die die elasticache:Connect Aktion für den ElastiCache Cache und den ElastiCache Benutzer ermöglicht:
{ "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: GLIDE-Client mit integriertem IAM
GLIDE 2.2 und höher bieten integrierte IAM-Authentifizierungsunterstützung. Sie konfigurieren Ihre AWS
Anmeldeinformationen und GLIDE kümmert sich automatisch um die Token-Generierung, das Caching und die Aktualisierung. Installationsanweisungen finden Sie in der GLIDE-Dokumentation auf der GLIDE-Website
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: Entwickler-Toolkit für ElastiCache
Das Developer Toolkit for ElastiCache (developer-toolkit-elasticache) ist eine eigenständige Python-Bibliothek und CLI, die IAM-Authentifizierungstoken generiert. Verwenden Sie es mit einer Python Valkey- oder Redis OSS-Clientbibliothek wie valkey-py.
Installieren
pip install developer-toolkit-elasticache
Python mit 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"
Das Developer Toolkit aktualisiert Token nicht automatisch. IAM-Authentifizierungstoken sind 15 Minuten gültig, daher muss Ihre Anwendung ein neues Token generieren, bevor das aktuelle Token abläuft. Der Anbieter für Anmeldeinformationen im vorherigen get_token() Beispiel ruft jede neue Verbindung auf.
CLI mit dem Developer Toolkit
Um eine Verbindung mit valkey-cli oder redis-cli herzustellen, verwenden Sie die Developer Toolkit-CLI, um ein Token zu generieren:
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_AUTHbenötigt Valkey-Cli 9.0 oder höher. Verwenden Sie für Redis-Cli anstelle von. REDISCLI_AUTH VALKEYCLI_AUTH
Quellcode und weitere Beispiele finden Sie im Developer Toolkit
Option 3: Manuelles SigV4-Signaturen
Generieren Sie das IAM-Authentifizierungstoken manuell mithilfe des AWS SDK. Beispiele für Signierungscode finden Sie unterVerbinden mit Token als Passwort.
Ablauf des Tokens und der Sitzung
-
Ablauf des Tokens: IAM-Authentifizierungstoken sind 15 Minuten gültig. GLIDE aktualisiert das Token automatisch. Wenn Sie das Developer Toolkit oder das manuelle Signieren verwenden, generieren Sie für jede neue Verbindung ein neues Token. Der Ablauf des Tokens wirkt sich nicht auf bestehende Verbindungen aus. Wenn Sie das Token mit temporären Anmeldeinformationen signieren, läuft das Token ab, wenn diese Anmeldeinformationen ablaufen, wenn das früher als 15 Minuten ist.
-
Ablauf der Sitzung: Verbindungen laufen nach 12 Stunden ab und stellen automatisch wieder eine Verbindung her. Durch den Widerruf der
elasticache:ConnectErlaubnis eines IAM-Prinzipals werden aktive Sitzungen nicht sofort getrennt. Um die Verbindung eines Benutzers sofort zu trennen, entfernen Sie den Benutzer aus der Benutzergruppe des Caches.
Fehlerbehebung
In der folgenden Tabelle sind häufig auftretende Verbindungsfehler, ihre Ursachen und deren Behebung aufgeführt.
| Fehler | Ursache | Auflösung |
|---|---|---|
WRONGPASSoder Authentifizierungsfehler |
Abgelaufenes IAM-Token, falscher Benutzername, fehlende IAM-Berechtigungen, Cache-Name nicht in Kleinbuchstaben oder abgelaufene temporäre Anmeldeinformationen | Stellen Sie sicher, dass das Token aktuell ist (weniger als 15 Minuten alt), dass der Benutzername mit einem Benutzer in der Benutzergruppe des Caches übereinstimmt, dass der IAM-Prinzipal sowohl für den Cache-ARN als auch für den Benutzer-ARN elasticache:Connect berechtigt ist, dass der Cache-Name in Ihrem Token-Signaturcode in Kleinbuchstaben geschrieben ist und, falls Sie das Token mit temporären Anmeldeinformationen signiert haben, dass diese Anmeldeinformationen nicht abgelaufen sind. |
NOAUTH Authentication required |
Der Client hat vor der Authentifizierung einen Befehl gesendet. Eine öffentliche Endpunktverbindung muss sich mit AUTH oder HELLO … AUTH als erstem Befehl authentifizieren. Einige Clientbibliotheken senden einen Befehl wie CLIENT SETINFO oder PING bei der Verbindung, bevor die Anmeldeinformationen angewendet werden. Die Verbindung wird nach wiederholten, nicht authentifizierten Befehlen geschlossen. |
Konfigurieren Sie Ihren Client so, dass die Authentifizierung im Rahmen des Verbindungsaufbaus erfolgt. Geben Sie das Token als Verbindungskennwort oder über einen Anmeldeinformationsanbieter weiter, anstatt nach der Verbindung anzurufenAUTH. GLIDE macht das automatisch. |
ERR service is not available |
Dieser Fehler wird für jede neue Verbindung zurückgegeben, die fehlschlägt, bevor die Authentifizierung abgeschlossen ist. Um zu verhindern, dass einem nicht authentifizierten Anrufer der interne Status der Engine angezeigt wird, wird dieselbe generische Meldung aus verschiedenen Gründen ElastiCache gemeldet: Die IAM-Authentifizierung ist vorübergehend nicht verfügbar, Ihre Rate ist aufgrund der Drosselung der IAM-Authentifizierung begrenzt oder die Engine ist vorübergehend überlastet (,, oder die maximale Anzahl an Clients wurde erreicht). BUSY CLUSTERDOWN Bei einer bereits authentifizierten Verbindung, die erneut ausgeführt wird, wird stattdessen ein bestimmter Fehler zurückgegeben, z. B. oder. AUTH HELLO ElastiCache ERR IAM Authentication service is not available ERR Exceeded limit of IAM Authentication requests |
Wenn Sie in letzter Zeit eine hohe Anzahl neuer Verbindungen oder Neuauthentifizierungen geöffnet haben, reduzieren Sie diese Rate und versuchen Sie es erneut mit exponentiellem Backoff. Wenn Ihre Verbindungs- und Neuauthentifizierungsrate normal ist, überprüfen Sie das AWS Health Dashboard |
| Verbindungstimeout | Problem mit der Netzwerkverbindung, falscher Endpunkt oder TLS ist nicht aktiviert | Stellen Sie sicher, dass die Endpunktadresse korrekt ist, TLS in Ihrer Client-Konfiguration aktiviert ist und Ihr Netzwerk ausgehende Verbindungen zu Port 6379 zulässt. |
TLS handshake failure |
Der Client unterstützt TLS 1.3 nicht. Caches mit einem öffentlichen Endpunkt benötigen TLS 1.3. | Aktualisieren Sie Ihren Client oder Ihre Runtime auf eine Version, die TLS 1.3 unterstützt. |