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à.
Generazione di una chiave API Amazon Bedrock
Puoi generare una chiave API Amazon Bedrock utilizzando l' AWS Management Console o l' AWS API. Ti consigliamo di utilizzare il AWS Management Console per generare facilmente una chiave API Amazon Bedrock in pochi passaggi.
Argomenti
Genera una chiave API Amazon Bedrock utilizzando la console
Per generare una chiave API Amazon Bedrock utilizzando la console, procedi come segue:
-
Accedi a AWS Management Console con un'identità IAM che dispone 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 chiavi:
-
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 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 lungo termine, scegli Genera chiavi API a lungo termine.
-
Nella sezione Scadenza della chiave API, scegli l'ora dopo la quale la chiave scadrà.
-
(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 politiche da allegare all'utente, espandi la sezione Autorizzazioni avanzate e seleziona le politiche che desideri aggiungere.
-
Scegliere Generate (Genera).
avvertimento
Consigliamo vivamente di limitare l'uso di chiavi a lungo termine per l'esplorazione di Amazon Bedrock. Quando sei pronto a incorporare Amazon Bedrock in applicazioni con requisiti di sicurezza più elevati, consulta la seguente documentazione:
-
Per conoscere le alternative preferibili alle chiavi a lungo termine, consulta Alternative alle chiavi di accesso a lungo termine nella Guida per l'utente IAM.
-
Per scoprire come monitorare le chiavi a lungo termine per prevenire violazioni della sicurezza, consulta Manage access keys for IAM users nella IAM User Guide.
-
-
Genera una chiave API Amazon Bedrock utilizzando l'API
Ti consigliamo di utilizzare il AWS Management Console per generare le chiavi API Amazon Bedrock per un'esperienza semplice. Tuttavia, puoi anche generare chiavi tramite l'API. Espandi la sezione corrispondente al tuo caso d'uso.
I passaggi generali per creare 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. Puoi ripetere questo passaggio per allegare all'utente altre policy gestite o personalizzate, se necessario.
Nota
Come best practice di sicurezza, consigliamo vivamente di allegare le policy IAM all'utente IAM per limitare l'uso delle chiavi API Amazon Bedrock. Per esempi di politiche di limitazione temporale e di limitazione degli indirizzi IP che possono utilizzare la chiave, consulta Controllare l'uso delle chiavi di accesso allegando 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
come.ServiceName
-
La risposta
ServiceApiKeyValue
restituita è la tua chiave API Amazon Bedrock a lungo termine. -
Il
ServiceSpecificCredentialId
valore restituito nella risposta può essere utilizzato per eseguire operazioni API relative alla chiave.
-
Per scoprire come generare una chiave API Amazon Bedrock a lungo termine, scegli la scheda relativa al tuo metodo preferito, quindi segui i passaggi:
Puoi generare una chiave API Amazon Bedrock a breve termine che duri quanto la sessione utilizzata per generarla (e non più di 12 ore).
Prerequisiti
-
Assicurati che la tua configurazione consenta a Python di riconoscere automaticamente le tue AWS credenziali. Per ulteriori informazioni, consulta Configurazione delle impostazioni per. AWS CLI
-
Apri un terminale e scarica il generatore di token Amazon Bedrock con il comando che corrisponde all'SDK che stai utilizzando:
-
Python
python3 -m pip install aws-bedrock-token-generator
-
Javascript
npm install @aws/bedrock-token-generator
-
-
Assicurati che l'identità IAM che stai utilizzando per effettuare chiamate API disponga almeno delle autorizzazioni per assumere un ruolo e creare una sessione di ruolo:
-
L'identità IAM deve disporre delle autorizzazioni per assumere il ruolo. Se l'identità ha autorizzazioni limitate, puoi allegare all'identità la seguente politica basata sull'identità (sostituirla con
${arn:aws:iam::111122223333:role/SessionRole}
l'ARN effettivo del ruolo per la sessione):{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "sts:AssumeRole", "Resource": "
${arn:aws:iam::111122223333:role/SessionRole}
" } ] }Per ulteriori informazioni sulla concessione a un'identità delle autorizzazioni per assumere un ruolo, consulta Concedere a un utente le autorizzazioni per cambiare ruolo.
-
Il ruolo IAM deve avere una policy di fiducia che consenta all'identità IAM di assumerlo. È possibile collegare la seguente policy di fiducia a un ruolo IAM per consentire al principale specificato nel
Principal
campo di assumere il ruolo di creare la chiave. Questo esempio specifica un utente IAM come principale. Sostituiscilo con l'ARN effettivo dell'utente.{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": "
${arn:aws:iam::111122223333:user/UserId}
" }, "Action": "sts:AssumeRole" } ] }Per ulteriori informazioni sui principali, consulta Elementi della policy AWS JSON: Principal. Per informazioni su come aggiornare una politica di fiducia per un ruolo, vedi Aggiornare una politica di attendibilità dei ruoli.
-
Scegli la scheda corrispondente all'SDK che stai utilizzando ed esegui lo script per generare una chiave API Amazon Bedrock a breve termine dalle credenziali della sessione:
Nota
Le autorizzazioni della chiave a breve termine saranno l'intersezione di quanto segue:
-
Le autorizzazioni allegate alla sessione utilizzate per generare la chiave.
-
Le autorizzazioni concesse da. AmazonBedrockLimitedAccess