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à.

# Gestire chiavi API Amazon Bedrock compromesse a lungo e breve termine
<a name="api-keys-revoke"></a>

Se la chiave API è compromessa, è necessario revocare le autorizzazioni per utilizzarla. Esistono vari metodi che consentono di revocare le autorizzazioni per una chiave API Amazon Bedrock:
+ Per le chiavi API Amazon Bedrock a lungo termine [UpdateServiceSpecificCredential[ResetServiceSpecificCredential](https://docs.aws.amazon.com/IAM/latest/APIReference/API_ResetServiceSpecificCredential.html.html)](https://docs.aws.amazon.com/IAM/latest/APIReference/API_UpdateServiceSpecificCredential.html.html), puoi utilizzare o [DeleteServiceSpecificCredential](https://docs.aws.amazon.com/IAM/latest/APIReference/API_DeleteServiceSpecificCredential.html.html)revocare le autorizzazioni nei seguenti modi:
  + Impostare lo stato della chiave su inattivo. La chiave può essere riattivata in seguito.
  + Ripristinare la chiave. Questa azione genera una nuova password per la chiave.
  + Eliminare la chiave in modo permanente.
**Nota**  
Per eseguire queste azioni tramite l'API, devi autenticarti con AWS credenziali e non con una chiave API Amazon Bedrock.
+ Per le chiavi API Amazon Bedrock sia a lungo che a breve termine, è possibile collegare policy IAM per revocare le autorizzazioni.

**Topics**
+ [Modificare lo stato di una chiave API Amazon Bedrock a lungo termine](#api-keys-change-status)
+ [Ripristinare una chiave API Amazon Bedrock a lungo termine](#api-keys-reset)
+ [Eliminare una chiave API Amazon Bedrock a lungo termine](#api-keys-delete)
+ [Collegare le policy IAM per rimuovere le autorizzazioni per l’utilizzo di una chiave API Amazon Bedrock](#api-keys-iam-policies)

## Modificare lo stato di una chiave API Amazon Bedrock a lungo termine
<a name="api-keys-change-status"></a>

Se si deve impedire che una chiave venga utilizzata temporaneamente, disattivarla. Quando è possibile riutilizzarla, riattivarla.

Scegli la scheda relativa al metodo che preferisci, quindi segui la procedura:

------
#### [ Console ]

**Come disattivare una chiave**

1. 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.](https://console.aws.amazon.com/bedrock)

1. Nel riquadro di navigazione a sinistra, seleziona **Chiavi API**.

1. Nella sezione **Chiavi API a lungo termine**, scegli una chiave per cui il campo **Stato** è **Inattivo**.

1. Scegli **Azioni**.

1. Seleziona **Deactivate** (Disattiva).

1. Per confermare, seleziona **Disattiva la chiave API**. Il valore del campo **Stato** della chiave diventa **Inattivo**.

**Come riattivare una chiave**

1. 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.](https://console.aws.amazon.com/bedrock)

1. Nel riquadro di navigazione a sinistra, seleziona **Chiavi API**.

1. Nella sezione **Chiavi API a lungo termine**, scegli una chiave per cui il campo **Stato** è **Inattivo**.

1. Scegli **Azioni**.

1. Seleziona **Attiva**.

1. Per confermare, seleziona **Attiva la chiave API**. Il valore del campo **Stato** della chiave diventa **Attivo**.

------
#### [ Python ]

Per disattivare una chiave utilizzando l'API, invia una [UpdateServiceSpecificCredential](https://docs.aws.amazon.com/IAM/latest/APIReference/API_UpdateServiceSpecificCredential.html.html)richiesta con un [endpoint IAM](https://docs.aws.amazon.com/general/latest/gr/iam-service.html) e specifica l'as. `Status` `Inactive` Puoi utilizzare il seguente frammento di codice per disattivare una chiave, sostituendolo *\$1\$1ServiceSpecificCredentialId\$1* con il valore restituito quando hai creato la chiave.

```
import boto3
                        
iam_client = boto3.client("iam")
                      
iam_client.update_service_specific_credential(
    service_specific_credential_id=${ServiceSpecificCredentialId},
    status="Inactive"
)
```

Per riattivare una chiave utilizzando l'API, invia una [UpdateServiceSpecificCredential](https://docs.aws.amazon.com/IAM/latest/APIReference/API_UpdateServiceSpecificCredential.html.html)richiesta con un [endpoint IAM](https://docs.aws.amazon.com/general/latest/gr/iam-service.html) e specifica as. `Status` `Active` Puoi utilizzare il seguente frammento di codice per riattivare una chiave, sostituendolo *\$1\$1ServiceSpecificCredentialId\$1* con il valore restituito quando hai creato la chiave.

```
import boto3
                        
iam_client = boto3.client("iam")
                      
iam_client.update_service_specific_credential(
    service_specific_credential_id=${ServiceSpecificCredentialId},
    status="Active"
)
```

------

## Ripristinare una chiave API Amazon Bedrock a lungo termine
<a name="api-keys-reset"></a>

Se il valore della chiave è stato compromesso o se non possiedi più la chiave, puoi ripristinarla. La chiave non deve essere ancora scaduta. Se è già scaduta, elimina la chiave e creane una nuova.

Scegli la scheda relativa al metodo che preferisci, quindi segui la procedura:

------
#### [ Console ]

**Come reimpostare una chiave**

1. 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.](https://console.aws.amazon.com/bedrock)

1. Nel riquadro di navigazione a sinistra, seleziona **Chiavi API**.

1. Nella sezione **Chiavi API a lungo termine**, scegli una chiave.

1. Scegli **Azioni**.

1. Seleziona **Ripristina chiave**.

1. Seleziona **Avanti**.

------
#### [ Python ]

[Per reimpostare una chiave utilizzando l'API, invia una [ResetServiceSpecificCredential](https://docs.aws.amazon.com/IAM/latest/APIReference/API_ResetServiceSpecificCredential.html.html)richiesta con un endpoint IAM.](https://docs.aws.amazon.com/general/latest/gr/iam-service.html) Puoi utilizzare il seguente frammento di codice per reimpostare una chiave, sostituendola *\$1\$1ServiceSpecificCredentialId\$1* con il valore restituito quando hai creato la chiave.

```
import boto3
            
iam_client = boto3.client("iam")
          
iam_client.reset_service_specific_credential(
    service_specific_credential_id=${ServiceSpecificCredentialId}
)
```

------

## Eliminare una chiave API Amazon Bedrock a lungo termine
<a name="api-keys-delete"></a>

Se non hai più bisogno di una chiave o se la chiave è scaduta, eliminala.

Scegli la scheda relativa al metodo che preferisci, quindi segui la procedura:

------
#### [ Console ]

**Come eliminare una chiave**

1. 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.](https://console.aws.amazon.com/bedrock)

1. Nel riquadro di navigazione a sinistra, seleziona **Chiavi API**.

1. Nella sezione **Chiavi API a lungo termine**, scegli una chiave.

1. Scegli **Azioni**.

1. Seleziona **Elimina**.

1. Conferma l’eliminazione.

**Una chiave API è collegata a un utente IAM**  
L'eliminazione di questa chiave API non elimina l'utente IAM che è stato creato con questa chiave come proprietario. Puoi eliminare l'utente IAM dalla console IAM nel passaggio successivo.

------
#### [ Python ]

Per eliminare una chiave utilizzando l'API, invia una [DeleteServiceSpecificCredential](https://docs.aws.amazon.com/IAM/latest/APIReference/API_DeleteServiceSpecificCredential.html.html)richiesta con un [endpoint IAM](https://docs.aws.amazon.com/general/latest/gr/iam-service.html). Puoi utilizzare il seguente frammento di codice per eliminare una chiave, sostituendola *\$1\$1ServiceSpecificCredentialId\$1* con il valore restituito quando hai creato la chiave.

```
import boto3
            
iam_client = boto3.client("iam")
          
iam_client.delete_service_specific_credential(
    service_specific_credential_id=${ServiceSpecificCredentialId}
)
```

------

## Collegare le policy IAM per rimuovere le autorizzazioni per l’utilizzo di una chiave API Amazon Bedrock
<a name="api-keys-iam-policies"></a>

In questa sezione vengono fornite alcune policy IAM che è possibile utilizzare per limitare l’accesso a una chiave API Amazon Bedrock.

### Negare a un’identità la possibilità di effettuare chiamate con una chiave API Amazon Bedrock
<a name="api-keys-iam-policies-deny-call-with-bearer-token"></a>

L’azione che consente a un’identità di effettuare chiamate con una chiave API Amazon Bedrock è `bedrock:CallWithBearerToken`. Per impedire a un’identità di effettuare chiamate con la chiave API Amazon Bedrock, collega una policy IAM a un’identità a seconda del tipo di chiave:
+ **Chiave a lungo termine**: collega la policy all’utente IAM associato alla chiave.
+ **Chiave a breve termine**: collega la policy al ruolo IAM utilizzato per generare la chiave.

La policy IAM che si può collegare all’identità IAM è la seguente:

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": {
    "Effect": "Deny",
    "Action": "bedrock:CallWithBearerToken",
    "Resource": "*"
  }
}
```

------

### Invalidare una sessione di ruolo IAM
<a name="api-keys-iam-policies-invalidate-session"></a>

Se una chiave a breve termine è compromessa, è possibile impedirne l’utilizzo invalidando la sessione di ruolo utilizzata per generare la chiave stessa. Per invalidare la sessione di ruolo, collega la seguente policy all’identità IAM che ha generato la chiave. Sostituisci *2014-05-07T23:47:00Z* con l'ora dopo la quale desideri che la sessione venga invalidata.

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": {
    "Effect": "Deny",
    "Action": "*",
    "Resource": "*",
    "Condition": {
      "DateLessThan": {"aws:TokenIssueTime": "2014-05-07T23:47:00Z"}
    }
  }
}
```

------