Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Connect a una cache con un endpoint pubblico
Tutte le connessioni endpoint pubbliche richiedono l'autenticazione IAM e TLS 1.3. Esistono tre modi per generare il token di autenticazione IAM:
-
Client GLIDE: gestisce la generazione e l'aggiornamento dei token automaticamente. Non è richiesto alcun codice di autenticazione.
-
Developer Toolkit for ElastiCache: genera il token per te. Usalo con qualsiasi libreria client Valkey o Redis OSS.
-
Firma manuale SIGv4: genera tu stesso il token utilizzando l'SDK. AWS
Argomenti
Politica IAM per la connessione
Prima di connetterti, l'utente o il ruolo IAM necessita dell'autorizzazione per effettuare la chiamataelasticache:Connect. La policy AWS gestita AdministratorAccess include questa autorizzazione per tutte le risorse.
Crea una policy IAM che consenta l'elasticache:Connectazione sulla ElastiCache cache e sull' ElastiCache utente:
{ "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" ] } ] }
Opzione 1: client GLIDE con IAM integrato
GLIDE 2.2 e versioni successive includono il supporto di autenticazione IAM integrato. Tu configuri AWS
le tue credenziali e GLIDE gestisce automaticamente la generazione, la memorizzazione nella cache e l'aggiornamento dei token. Per le istruzioni di installazione, consulta la documentazione di GLIDE sul sito web 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"
Opzione 2: Developer Toolkit per ElastiCache
Il Developer Toolkit for ElastiCache (developer-toolkit-elasticache) è una libreria Python autonoma e una CLI che genera token di autenticazione IAM. Usalo con una libreria client Python Valkey o Redis OSS, come valkey-py.
Installa
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"
Il Developer Toolkit non aggiorna automaticamente i token. I token di autenticazione IAM sono validi per 15 minuti, quindi l'applicazione deve generare un nuovo token prima della scadenza del token corrente. Il provider di credenziali nell'esempio precedente richiede ogni nuova connessioneget_token().
CLI con Developer Toolkit
Per connetterti con valkey-cli o redis-cli, usa la CLI Developer Toolkit per generare 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_AUTHrichiede valkey-cli 9.0 o versione successiva. Per redis-cli, usa invece di. REDISCLI_AUTH VALKEYCLI_AUTH
Per il codice sorgente e altri esempi, consulta Developer Toolkit for
Opzione 3: firma manuale di SigV4
Genera manualmente il token di autenticazione IAM utilizzando l' AWS SDK. Per esempi di codice di firma, consultaConnetti con token come password.
Scadenza del token e della sessione
-
Scadenza del token: i token di autenticazione IAM sono validi per 15 minuti. GLIDE aggiorna automaticamente il token. Se utilizzi il Developer Toolkit o la firma manuale, genera un nuovo token per ogni nuova connessione. La scadenza del token non influisce sulle connessioni stabilite. Se si firma il token con credenziali temporanee, il token scade quando tali credenziali scadono, se ciò avviene prima di 15 minuti.
-
Scadenza della sessione: le connessioni scadono dopo 12 ore e si riconnettono automaticamente. La revoca dell'
elasticache:Connectautorizzazione di un principale IAM non disconnette immediatamente le sessioni attive. Per disconnettere immediatamente un utente, rimuovilo dal gruppo di utenti della cache.
Risoluzione dei problemi
La tabella seguente elenca gli errori di connessione più comuni, le relative cause e come risolverli.
| Errore | Causa | Risoluzione |
|---|---|---|
WRONGPASSo errore di autenticazione |
Token IAM scaduto, nome utente errato, autorizzazioni IAM mancanti, nome della cache non in minuscolo o credenziali temporanee scadute | Verifica che il token sia nuovo (meno di 15 minuti), che il nome utente corrisponda a un utente nel gruppo di utenti della cache, che il principale IAM disponga dell'elasticache:Connectautorizzazione sia per l'ARN della cache che per l'ARN dell'utente, che il nome della cache nel codice di firma del token sia minuscolo e, se hai firmato il token con credenziali temporanee, che tali credenziali non siano scadute. |
NOAUTH Authentication required |
Il client ha inviato un comando prima dell'autenticazione. Una connessione endpoint pubblica deve autenticarsi con AUTH o HELLO … AUTH come primo comando. Alcune librerie client inviano un comando come CLIENT SETINFO o PING on connect, prima che vengano applicate le credenziali. La connessione viene chiusa dopo ripetuti comandi non autenticati. |
Configura il client in modo che l'autenticazione avvenga come parte della configurazione della connessione: passa il token come password di connessione o tramite un provider di credenziali, anziché chiamare AUTH dopo la connessione. GLIDE lo fa automaticamente. |
ERR service is not available |
Questo errore viene restituito per ogni nuova connessione che fallisce prima del completamento dell'autenticazione. Per evitare di rivelare lo stato interno del motore a un chiamante non autenticato, ElastiCache riporta lo stesso messaggio generico per diverse cause sottostanti: l'autenticazione IAM non è temporaneamente disponibile, la frequenza è limitata a causa della limitazione dell'autenticazione IAM o il motore è temporaneamente sovraccarico (o è stato raggiunto il numero massimo di client). BUSY CLUSTERDOWN Su una connessione già autenticata che viene eseguita nuovamente o restituisce invece un errore specifico, ad esempio o. AUTH HELLO ElastiCache ERR IAM Authentication service is not available ERR Exceeded limit of IAM Authentication requests |
Se di recente hai aperto una frequenza elevata di nuove connessioni o riautenticazioni, riduci tale frequenza e riprova con il backoff esponenziale. Se la velocità di connessione e riautenticazione è normale, controlla AWS Health Dashboard |
| Timeout di connessione | Problema di connettività di rete, endpoint errato o TLS non abilitato | Verifica che l'indirizzo dell'endpoint sia corretto, che TLS sia abilitato nella configurazione del client e che la rete consenta le connessioni in uscita alla porta 6379. |
TLS handshake failure |
Il client non supporta TLS 1.3. Le cache con un endpoint pubblico richiedono TLS 1.3. | Aggiorna il client o il runtime a una versione che supporti TLS 1.3. |