

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

# Autorizzazioni richieste per VM Import/Export

VM Import/Export richiede determinate autorizzazioni per utenti, gruppi e ruoli. Inoltre, è necessario un ruolo di servizio per eseguire determinate operazioni per conto tuo.

**Topics**
+ [Autorizzazioni richieste](#iam-permissions-image)
+ [Ruolo di servizio necessario](#vmimport-role)

## Autorizzazioni richieste
<a name="iam-permissions-image"></a>

Gli utenti, i gruppi e i ruoli necessitano delle seguenti autorizzazioni nella loro policy IAM per utilizzare la VM Import/Export:

**Importante**  
VM Import/Export convalida che hai `iam:PassRole` autorizzazione per il ruolo specificato nel `RoleName` parametro, o per impostazione predefinita `vmimport` ruolo se non ne viene specificato nessuno. Assicurati che la tua politica IAM conceda `iam:PassRole` sul ruolo ARN che intendi utilizzare. Per ulteriori informazioni, vedere [Concedi a un utente le autorizzazioni per passare un ruolo a un AWS servizio](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html) nel *Guida per l'utente IAM*.

**Importante**  
Alcune chiavi di condizione non funzioneranno con `iam:PassRole` per VM Import/Export. Perché VM Import/Export effettua la richiesta per tuo conto, alcune proprietà della richiesta iniziale non vengono conservate. Alcune chiavi, come `aws:SourceVpc`, `aws:SourceVpce`, e `aws:VpcSourceIp`, non sono disponibili e potrebbero causare il fallimento delle richieste. Per ulteriori informazioni, consultare [Chiavi di contesto delle condizioni globali AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) nella *Guida per l'utente IAM*.

**Nota**  
Alcune azioni richiedono l'uso di un bucket Amazon Simple Storage Service (Amazon S3). Questa policy di esempio non concede l'autorizzazione per creare bucket S3. L'utente o il ruolo che utilizzi dovrà specificare un bucket esistente o disporre delle autorizzazioni per creare un nuovo bucket con `s3:CreateBucket` azione.

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

****  

```json
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:GetBucketLocation",
        "s3:GetObject",
        "s3:PutObject"
      ],
      "Resource": [
        "arn:aws:s3:::{{amzn-s3-demo-import-bucket}}",
        "arn:aws:s3:::{{amzn-s3-demo-import-bucket}}/*",
        "arn:aws:s3:::{{amzn-s3-demo-export-bucket}}",
        "arn:aws:s3:::{{amzn-s3-demo-export-bucket}}/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "ec2:CancelConversionTask",
        "ec2:CancelExportTask",
        "ec2:CreateImage",
        "ec2:CreateInstanceExportTask",
        "ec2:CreateTags",
        "ec2:DescribeConversionTasks",
        "ec2:DescribeExportTasks",
        "ec2:DescribeExportImageTasks",
        "ec2:DescribeImages",
        "ec2:DescribeInstanceStatus",
        "ec2:DescribeInstances",
        "ec2:DescribeSnapshots",
        "ec2:DescribeTags",
        "ec2:ExportImage",
        "ec2:ImportInstance",
        "ec2:ImportVolume",
        "ec2:StartInstances",
        "ec2:StopInstances",
        "ec2:TerminateInstances",
        "ec2:ImportImage",
        "ec2:ImportSnapshot",
        "ec2:DescribeImportImageTasks",
        "ec2:DescribeImportSnapshotTasks",
        "ec2:CancelImportTask"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": "iam:PassRole",
      "Resource": "arn:aws:iam::{{111122223333}}:role/{{vmimport}}"
    }
  ]
}
```

------

## Ruolo di servizio necessario
<a name="vmimport-role"></a>

VM Import/Export richiede un ruolo per eseguire determinate operazioni per tuo conto. È necessario creare un ruolo di servizio denominato `vmimport` con un documento sulla politica delle relazioni di fiducia che consenta la gestione delle macchine virtuali Import/Export per assumere il ruolo e devi allegare una policy IAM al ruolo. Per ulteriori informazioni, consulta [Ruoli IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/roles-toplevel.html) nella *Guida per l'utente di IAM*.

**Prerequisito**  
È necessario abilitare Servizio di token di sicurezza AWS (AWS STS) in qualsiasi regione in cui prevedi di utilizzare la VM Import/Export. Per ulteriori informazioni, vedere [Attivazione e disattivazione AWS STS in un AWS Regione](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_enable-regions.html#sts-regions-activate-deactivate).

**Per creare il ruolo del servizio**

1. Sul tuo computer, crea un file denominato `trust-policy.json`. Aggiungere la seguente policy al file:

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

****  

   ```json
   {
      "Version":"2012-10-17",		 	 	 
      "Statement": [
         {
            "Effect": "Allow",
            "Principal": { "Service": "vmie.amazonaws.com" },
            "Action": "sts:AssumeRole",
            "Condition": {
               "StringEquals":{
                  "sts:Externalid": "vmimport"
               }
            }
         }
      ]
   }
   ```

------

1. Usa il [create-role](https://docs.aws.amazon.com/cli/latest/reference/iam/create-role.html) comando per creare un ruolo denominato `vmimport` e concedi VM Import/Export accedervi. Verificare di aver specificato il percorso completo per l'ubicazione del file `trust-policy.json` creato nella fase precedente e di includere il prefisso `file://` come mostrato nell'esempio seguente:

   ```
   aws iam create-role --role-name vmimport --assume-role-policy-document "file://{{C:\import\trust-policy.json}}"
   ```

1. Crea un file denominato `role-policy.json` con la seguente politica, dove {{amzn-s3-demo-import-bucket}} è il bucket per le immagini del disco importate e {{amzn-s3-demo-export-bucket}} è il bucket per le immagini del disco esportate:

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

****  

   ```json
   {
      "Version":"2012-10-17",		 	 	 
      "Statement":[
         {
            "Effect": "Allow",
            "Action": [
               "s3:GetBucketLocation",
               "s3:GetObject",
               "s3:ListBucket" 
            ],
            "Resource": [
               "arn:aws:s3:::{{amzn-s3-demo-import-bucket}}",
               "arn:aws:s3:::{{amzn-s3-demo-import-bucket}}/*"
            ]
         },
         {
            "Effect": "Allow",
            "Action": [
               "s3:GetBucketLocation",
               "s3:GetObject",
               "s3:ListBucket",
               "s3:PutObject",
               "s3:GetBucketAcl"
            ],
            "Resource": [
               "arn:aws:s3:::{{amzn-s3-demo-export-bucket}}",
               "arn:aws:s3:::{{amzn-s3-demo-export-bucket}}/*"
            ]
         },
         {
            "Effect": "Allow",
            "Action": [
               "ec2:ModifySnapshotAttribute",
               "ec2:CopySnapshot",
               "ec2:RegisterImage",
               "ec2:Describe*"
            ],
            "Resource": "*"
         }
      ]
   }
   ```

------

1. (Facoltativo) Per importare risorse crittografate utilizzando un AWS KMS chiave da AWS Key Management Service, aggiungi le seguenti autorizzazioni a `role-policy.json` file.

   ```json
   {
     "Effect": "Allow",
     "Action": [
       "kms:CreateGrant",
       "kms:Decrypt",
       "kms:DescribeKey",
       "kms:Encrypt",
       "kms:GenerateDataKey*",
       "kms:ReEncrypt*"
     ],
     "Resource": "*"
   }
   ```

   Se utilizzi una chiave KMS diversa da quella predefinita fornita da Amazon EBS, devi concedere VM Import/Export autorizzazione alla chiave KMS se abiliti la crittografia Amazon EBS per impostazione predefinita o abiliti la crittografia su un'operazione di importazione. Puoi specificare il nome della risorsa Amazon (ARN) della chiave KMS come risorsa anziché \*.

1. (Facoltativo) Per allegare configurazioni di licenze a una AMI, aggiungi le seguenti autorizzazioni License Manager al file `role-policy.json`.

   ```json
   {
     "Effect": "Allow",
     "Action": [
       "license-manager:GetLicenseConfiguration",
       "license-manager:UpdateLicenseSpecificationsForResource",
       "license-manager:ListLicenseSpecificationsForResource"
     ],
     "Resource": "*"
   }
   ```

1. Utilizza il seguente comando [put-role-policy](https://docs.aws.amazon.com/cli/latest/reference/iam/put-role-policy.html) per collegare la policy al ruolo creato in precedenza. Assicurarsi di specificare l'intero percorso della posizione del file `role-policy.json`.

   ```
   aws iam put-role-policy --role-name vmimport --policy-name vmimport --policy-document "file://{{C:\import\role-policy.json}}"
   ```

1. Per ulteriori controlli di sicurezza, puoi aggiungere le chiavi contestuali `aws:SourceAccount` e `aws:SourceArn` alla politica di attendibilità per questo ruolo appena creato. VM Import/Export pubblicherà il `SourceAccount` e `SourceArn` chiavi come specificato nell'esempio seguente per assumere questo ruolo:

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

****  

   ```json
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Principal": {
                   "Service": "vmie.amazonaws.com"
               },
               "Action": "sts:AssumeRole",
               "Condition": {
                   "StringEquals": {
                       "sts:Externalid": "vmimport",
                       "aws:SourceAccount": "{{111122223333}}"
                   },
                   "ArnLike": {
                       "aws:SourceArn": "arn:aws:vmie:*:{{111122223333}}:*"
                   }
               }
           }
       ]
   }
   ```

------