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à.
Generare una chiave API Amazon Bedrock
Puoi generare una chiave API Amazon Bedrock utilizzando l'API Console di gestione AWS o l' AWS API. Ti consigliamo di utilizzare l'API Amazon Bedrock Console di gestione AWS per generare facilmente una chiave API Amazon Bedrock in pochi passaggi.
avvertimento
Si consiglia di limitare l’uso delle chiavi API Amazon Bedrock per l’esplorazione di Amazon Bedrock. Quando è possibile integrare Amazon Bedrock in applicazioni con requisiti di sicurezza più elevati, è opportuno passare a credenziali a breve termine. Per ulteriori informazioni, consulta Alternative alle chiavi di accesso a lungo termine nella Guida per l’utente di IAM.
Argomenti
Generare una chiave API Amazon Bedrock con la console
Per generare una chiave API Amazon Bedrock con la console, esegui queste operazioni:
-
Accedi Console di gestione AWS con un'identità IAM con le autorizzazioni per utilizzare la console Amazon Bedrock. Quindi, apri la console Amazon Bedrock all'indirizzo. https://console.aws.amazon.com/bedrock
-
Nel riquadro di navigazione a sinistra, seleziona Chiavi API.
-
Genera uno dei seguenti tipi di chiave:
-
Short-term Chiave API: nella scheda Chiavi Short-term API, scegli Genera chiavi API a breve termine. La chiave scade quando scade la sessione della console (e non più di 12 ore) e ti consente di effettuare chiamate alla persona da Regione AWS cui l'hai generata. Per generare una chiave per una regione diversa, seleziona quella regione nella console prima di generare la chiave.
-
Long-term Chiave API: nella scheda Chiavi Long-term API, scegli Genera chiavi API a lungo termine.
-
Nella sezione Scadenza della chiave API, scegli l’ora di scadenza della chiave.
-
(Facoltativo) Per impostazione predefinita, la policy AmazonBedrockLimitedAccess AWS-managed, che concede l'accesso alle principali operazioni API di Amazon Bedrock, è associata all'utente IAM associato alla chiave. Per selezionare altre policy da collegare all’utente, espandi la sezione Autorizzazioni avanzate e seleziona le policy da aggiungere.
-
Scegliere Generate (Genera).
avvertimento
Si consiglia di limitare l’uso delle chiavi API Amazon Bedrock per l’esplorazione di Amazon Bedrock. Quando è possibile integrare Amazon Bedrock in applicazioni con requisiti di sicurezza più elevati, è opportuno passare a credenziali a breve termine. Per ulteriori informazioni, consulta Alternative alle chiavi di accesso a lungo termine nella Guida per l’utente di IAM.
-
-
Generare una chiave API Amazon Bedrock a lungo termine utilizzando l’API
I passaggi generali per la creazione di una chiave API Amazon Bedrock a lungo termine nell’API sono i seguenti:
-
Crea un utente IAM inviando una CreateUser richiesta con un endpoint IAM.
-
Collegalo AmazonBedrockLimitedAccess all'utente IAM inviando una AttachUserPolicy richiesta con un endpoint https://docs.aws.amazon.com/general/latest/gr/iam-service.html IAM. È possibile ripetere questo passaggio per collegare all’utente altre policy gestite o personalizzate in base alle esigenze.
Nota
Come best practice di sicurezza, consigliamo di collegare le policy IAM all’utente IAM per limitare l’uso delle chiavi API Amazon Bedrock. Per esempi di policy di limitazione temporale e di limitazione degli indirizzi IP che possono utilizzare la chiave, consulta Controllare l’uso delle chiavi di accesso collegando una policy in linea a un utente IAM.
-
Genera la chiave API Amazon Bedrock a lungo termine inviando una CreateServiceSpecificCredential richiesta con un endpoint IAM e specificando
bedrock.amazonaws.com.rproxy.goskope.comcome.ServiceName-
La risposta
ServiceApiKeyValuerestituita è la chiave API Amazon Bedrock a lungo termine. -
Il valore
ServiceSpecificCredentialIdrestituito nella risposta può essere utilizzato per eseguire operazioni API relative alla chiave.
-
Per informazioni su come generare una chiave API Amazon Bedrock, scegli la scheda relativa al metodo che preferisci, quindi segui la procedura:
Generare una chiave API Amazon Bedrock a breve termine utilizzando una libreria client
Le chiavi a breve termine hanno le proprietà indicate di seguito.
-
Validità per il minore dei seguenti valori:
-
12 ore
-
Durata della sessione generata dal principale IAM utilizzato per generare la chiave.
-
-
Eredita le autorizzazioni collegate al principale utilizzato per generare la chiave.
-
Può essere utilizzato solo nella AWS regione da cui è stato generato.
Per le applicazioni di lunga durata, la libreria client aws-bedrock-token-generator
Prerequisiti
-
Assicurati che l'entità IAM utilizzata per generare la chiave sia configurata con le autorizzazioni appropriate per utilizzare Amazon Bedrock. Per la sperimentazione, puoi allegare la AmazonBedrockLimitedAccess policy AWS gestita al principale. Per proteggere le credenziali, consulta Best practice per la sicurezza in IAM.
-
Assicurati che la tua configurazione consenta a Python di riconoscere automaticamente le tue credenziali. AWS Il metodo predefinito con cui vengono recuperate le credenziali segue una gerarchia definita. Per visualizzare la gerarchia per uno specifico SDK o strumento consulta Provider di credenziali di SDK AWS standardizzati e strumenti.
-
Installa il generatore di token Amazon Bedrock. Scegli la scheda relativa al metodo che preferisci, quindi segui la procedura:
Esempi
Per esempi di utilizzo del generatore di token per generare una chiave API Amazon Bedrock a breve termine con le credenziali predefinite in diverse lingue, scegli la scheda relativa al metodo che preferisci, quindi segui la procedura:
Per altri esempi di diversi casi d’uso per la generazione di token, consulta i seguenti link:
Configurare l’aggiornamento automatico delle chiavi API Amazon Bedrock a breve termine
È possibile creare uno script con l’aiuto del pacchetto aws-bedrock-token-generator per rigenerare a livello di codice una nuova chiave a breve termine ogni volta che quella attuale è scaduta. Innanzitutto, assicurati di aver soddisfatto i prerequisiti di. Generare una chiave API Amazon Bedrock a breve termine utilizzando una libreria client Per esempi di script che recuperano un token ed effettuano una richiesta Converse, scegli la scheda relativa al metodo che preferisci, quindi segui la procedura: