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à.
# Chiave KMS \$1 Condividi (è richiesta la revisione)
Consenti l'accesso a una chiave KMS da più account aggiungendo una dichiarazione alla politica della chiave con autorizzazioni di crittografia e decrittografia.
**Classificazione completa:** Gestione \$1 Componenti dello stack avanzati \$1 Chiave KMS \$1 Condividi (è richiesta la revisione)
## Dettagli del tipo di modifica
****
| | |
| --- |--- |
| Cambia tipo ID | ct-05yb337abq3x5 |
| Versione corrente | 1.0 |
| Durata di esecuzione prevista | 240 minuti |
| Approvazione AWS | Richiesto |
| Approvazione del cliente | Non richiesto se il mittente |
| Modalità di esecuzione | Manuale |
## Informazioni aggiuntive
### AWS KMS Chiave di condivisione
#### Condividi qualsiasi AWS KMS chiave con la console
Di seguito viene illustrato questo tipo di modifica nella console AMS.
![\[Share KMS Key interface showing ID, execution mode, version, and description for cross-account access.\]](http://docs.aws.amazon.com/it_it/managedservices/latest/ctref/images/guiShareKmsKeyCT.png)
Come funziona:
1. Vai alla pagina **Crea RFC**: nel riquadro di navigazione a sinistra della console AMS, fai clic **RFCs**per aprire la pagina dell' RFCs elenco, quindi fai clic su **Crea RFC**.
1. Scegli un tipo di modifica (CT) popolare nella visualizzazione predefinita **Sfoglia i tipi di modifica** o seleziona un CT nella visualizzazione **Scegli per categoria**.
+ **Naviga per tipo di modifica**: puoi fare clic su un CT popolare nell'area di **creazione rapida** per aprire immediatamente la pagina **Run RFC**. Nota che non puoi scegliere una versione CT precedente con creazione rapida.
Per ordinare CTs, utilizzate l'area **Tutti i tipi di modifica** nella vista a **scheda** o **tabella**. In entrambe le visualizzazioni, selezionate un CT, quindi fate clic su **Crea RFC** per aprire la pagina **Esegui RFC**. Se applicabile, accanto al **pulsante Crea **RFC viene visualizzata l'opzione Crea** con una versione precedente**.
+ **Scegli per categoria**: seleziona una categoria, sottocategoria, articolo e operazione e la casella dei dettagli CT si apre con l'opzione **Crea con una versione precedente, se applicabile**. Fai clic su **Crea RFC** per aprire la pagina **Esegui RFC**.
1. Nella pagina **Run RFC**, apri l'area del nome CT per visualizzare la casella dei dettagli CT. È richiesto un **Oggetto** (questo campo viene compilato automaticamente se si sceglie il CT nella vista **Sfoglia i tipi di modifica**). Apri l'area **di configurazione aggiuntiva** per aggiungere informazioni sull'RFC.
Nell'area di **configurazione dell'esecuzione**, utilizza gli elenchi a discesa disponibili o inserisci i valori per i parametri richiesti. Per configurare i parametri di esecuzione opzionali, aprite l'area di **configurazione aggiuntiva**.
1. Al termine, fate clic su **Esegui**. Se non sono presenti errori, viene visualizzata la pagina **RFC creata correttamente** con i dettagli RFC inviati e l'output iniziale di **Run**.
1. Apri l'area dei **parametri di esecuzione** per visualizzare le configurazioni inviate. Aggiorna la pagina per aggiornare lo stato di esecuzione RFC. Facoltativamente, annulla la RFC o creane una copia con le opzioni nella parte superiore della pagina.
#### Condividi una AWS KMS chiave con la CLI
Come funziona:
1. Usa Inline Create (esegui un `create-rfc` comando con tutti i parametri RFC e di esecuzione inclusi) o Template Create (crei due file JSON, uno per i parametri RFC e uno per i parametri di esecuzione) ed esegui il `create-rfc` comando con i due file come input. Entrambi i metodi sono descritti qui.
1. Invia il `aws amscm submit-rfc --rfc-id ID` comando RFC: con l'ID RFC restituito.
Monitora il comando RFC:. `aws amscm get-rfc --rfc-id ID`
Per verificare la versione del tipo di modifica, usa questo comando:
```
aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID
```
**Nota**
È possibile utilizzare qualsiasi `CreateRfc` parametro con qualsiasi RFC, indipendentemente dal fatto che faccia parte o meno dello schema per il tipo di modifica. Ad esempio, per ricevere notifiche quando lo stato RFC cambia, aggiungi questa riga `--notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}"` alla parte dei parametri RFC della richiesta (non ai parametri di esecuzione). Per un elenco di tutti i CreateRfc parametri, consulta l'[AMS Change Management API](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_CreateRfc.html) Reference.
*CREAZIONE IN LINEA*:
Esegui il comando create RFC con i parametri di esecuzione forniti in linea (evita le virgolette quando fornisci i parametri di esecuzione in linea), quindi invia l'ID RFC restituito. Ad esempio, puoi sostituire il contenuto con qualcosa del genere:
```
aws amscm create-rfc --title="Add Static Route" --description="Share KMS Key" --ct-id="ct-05yb337abq3x5" --ct-version="1.0" --input-params="{\"KMSKeyArn\":\"arn:aws:kms:us-east-1:111122223333:key/06506094-64e2-47f3-94bd-f919eefa22f5\",\"TargetAccountId\":\"000000000000\",\"IncludeKeyGrantOperations\":\"false\",\"IAMUserOrRole\":\"arn:aws:iam::000000000000:role/role-name\", \"Priority\":\"High\"}"
```
*CREAZIONE DEL MODELLO*:
1. Esporta lo schema JSON dei parametri di esecuzione per questo tipo di modifica in un file; questo esempio lo chiama ShareKmsKeyParams .json:
```
aws amscm get-change-type-version --change-type-id "ct-05yb337abq3x5" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > ShareKmsKeyParams.json
```
Modificate e salvate il file. ShareKmsKeyParams Ad esempio, puoi sostituire il contenuto con qualcosa del genere:
```
{
"Description": "Share KMS Key",
"Parameters": {
"KMSKeyArn": "arn:aws:kms:us-east-1:111122223333:key/06506094-64e2-47f3-94bd-f919eefa22f5",
"TargetAccountId": "000000000000",
"IncludeKeyGrantOperations": "false"
"IAMUserOrRole": "arn:aws:iam::000000000000:role/role-name"
}
}
```
1. Esporta il modello RFC in un file nella cartella corrente; questo esempio lo chiama ShareKmsKeyParamsRfc .json:
```
aws amscm create-rfc --generate-cli-skeleton > ShareKmsKeyParamsRfc.json
```
1. Modifica e salva il file.json. ShareKmsKeyParams Ad esempio, puoi sostituire il contenuto con qualcosa del genere:
```
{
"ChangeTypeId": {
"ChangeTypeVersion": "1.0",
"ChangeTypeId": "ct-05yb337abq3x5",
"Title": "Share KMS Key"
}
```
1. Crea la RFC, specificando il ShareKmsKeyParamsRfc file e il ShareKmsKeyParams file:
```
aws amscm create-rfc --cli-input-json file://ShareKmsKeyParamsRfc.json --execution-parameters file://ShareKmsKeyParams.json
```
Nella risposta ricevi l'ID della nuova RFC e puoi utilizzarlo per inviare e monitorare la RFC. Finché non la invii, la RFC rimane nello stato di modifica e non si avvia.
Per accedere all'istanza tramite un bastione, segui la procedura successiva, [Instance access examples](https://docs.aws.amazon.com/managedservices/latest/userguide/access-examples.html).
## Parametri di input di esecuzione
Per informazioni dettagliate sui parametri di input di esecuzione, vedere[Schema per il tipo di modifica ct-05yb337abq3x5](schemas.md#ct-05yb337abq3x5-schema-section).
## Esempio: parametri obbligatori
```
{
"KMSKeyArn": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
"TargetAccountId": "123456789012"
}
```
## Esempio: tutti i parametri
```
{
"KMSKeyArn": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
"IncludeKeyGrantPermissions": true,
"TargetAccountId": "111122223333",
"IAMUserOrRoleARN": "arn:aws:iam::123456789012:role/my_role",
"Priority": "Medium"
}
```