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
Per generare una chiave API Amazon Bedrock, utilizzare la Console di gestione AWS o l’API AWS. Si consiglia di utilizzare la 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 alla Console di gestione AWS con un’identità IAM che disponga delle 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:
-
Chiave API a breve termine: nella scheda Chiavi API a breve termine, scegli Genera chiavi API a breve termine. La chiave scade alla scadenza della sessione della console (e non dura più di 12 ore) e consente di effettuare chiamate alla Regione AWS da cui è stata 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 gestita da AWS, che consente l’accesso alle operazioni principali dell’API Amazon Bedrock, è collegata 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 richiesta CreateUser con un endpoint IAM.
-
Collega AmazonBedrockLimitedAccess all’utente IAM inviando una richiesta AttachUserPolicy 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 richiesta CreateServiceSpecificCredential con un endpoint IAM e specificando
bedrock.amazonaws.com.rproxy.govskope.cacomeServiceName.-
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 utilizzata solo nella Regione AWS da cui è stata generata.
Per le applicazioni di lunga durata, la libreria client 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 provare, collega la policy AmazonBedrockLimitedAccess gestita da AWS al principale. Per proteggere le credenziali, consulta Best practice per la sicurezza in IAM.
-
Verifica che la configurazione consenta a Python di riconoscere automaticamente le 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. 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: