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' Console di gestione AWS o l' AWS API. Ti consigliamo di utilizzare il 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 a Console di gestione AWS con un'identità IAM che dispone delle autorizzazioni per utilizzare la console Amazon Bedrock. Quindi, apri la console Amazon Bedrock in https://console.aws.amazon.com/bedrock.
-
Nel riquadro di navigazione a sinistra, seleziona Chiavi API.
-
Genera uno dei seguenti tipi di chiave:
-
Chiave API a breve termine: nella scheda Chiavi API a breve termine, 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 verso la piattaforma da Regione AWS cui l'hai generata. È possibile modificare la Regione direttamente nella chiave generata.
-
Chiave API a lungo termine: nella scheda Chiavi API a breve termine, 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 gestita, che garantisce l'accesso alle operazioni principali dell'API Amazon Bedrock, è allegata 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 CreateUserrichiesta con un endpoint IAM.
-
Collegalo AmazonBedrockLimitedAccessall'utente IAM inviando una AttachUserPolicyrichiesta con un endpoint 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 CreateServiceSpecificCredentialrichiesta 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 a esecuzione prolungata, la libreria aws-bedrock-token-generator
Prerequisiti
-
Verifica che il principale IAM utilizzato per generare la chiave sia configurato con le autorizzazioni appropriate per utilizzare Amazon Bedrock. Per la sperimentazione, puoi allegare la policy AWSAmazonBedrockLimitedAccess-managed 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 AWS credenziali. Il metodo predefinito con cui vengono recuperate le credenziali segue una gerarchia definita. Puoi visualizzare la gerarchia per un SDK o uno strumento specifico nei provider di credenziali standardizzati AWS SDKs and Tools.
-
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. Verifica innanzitutto di soddisfare il prerequisito in 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: