

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

# Provisioning di dispositivi che non dispongono di certificati dispositivo mediante il provisioning del parco istanze dispositivi

Utilizzando il AWS IoT fleet provisioning, AWS IoT puoi generare e fornire in modo sicuro certificati di dispositivo e chiavi private ai tuoi dispositivi quando si connettono AWS IoT per la prima volta. AWS IoT fornisce certificati client firmati dall'autorità di certificazione (CA) Amazon Root.

Esistono due modi per utilizzare il provisioning del parco istanze dispositivi:
+ [Provisioning tramite attestazione](#claim-based)
+ [Provisioning tramite utente attendibile](#trusted-user)

## Provisioning tramite attestazione
<a name="claim-based"></a>

I dispositivi possono essere fabbricati con un certificato di attestazione di provisioning e una chiave privata (che sono credenziali per scopi speciali) incorporati in essi. Se questi certificati sono registrati con AWS IoT, il servizio può scambiarli con certificati di dispositivo univoci che il dispositivo può utilizzare per le normali operazioni. Il processo include le seguenti fasi:

**Prima di distribuire il dispositivo**

1. Chiamare [`CreateProvisioningTemplate`](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateProvisioningTemplate.html) per creare un modello di provisioning. Questa API restituisce un ARN del modello. Per ulteriori informazioni, consulta [API MQTT di provisioning del dispositivo](fleet-provision-api.md).

   È inoltre possibile creare un modello di provisioning del parco veicoli nella AWS IoT console. 

   1. Dal pannello di navigazione, scegli il menu a ** discesa ** Connetti molti dispositivi. Quindi, scegli ** Connetti molti dispositivi. **

   1. Scegli ** Crea modello ** di provisioning.

   1. Scegli lo scenario di ** provisioning più ** adatto ai tuoi processi di installazione. Quindi, seleziona **Successivo**.

   1. Completa il flusso di lavoro del modello.

1. Creazione di certificati e chiavi private associate da utilizzare come certificati delle attestazioni di provisioning.

1. Registra questi certificati AWS IoT e associa una policy IoT che limita l'uso dei certificati. La policy di esempio IoT seguente limita l'uso del certificato associato a questa policy ai dispositivi di provisioning.  
****  

   ```json
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "iot:Connect"
               ],
               "Resource": "*"
           },
           {
               "Effect": "Allow",
               "Action": [
                   "iot:Publish",
                   "iot:Receive"
               ],
               "Resource": [
               "arn:aws:iot:{{us-east-1}}:{{123456789012}}:topic/$aws/certificates/create/*",
       "arn:aws:iot:{{us-east-1}}:{{123456789012}}:topic/$aws/provisioning-templates/{{templateName}}/provision/*"
               ]
           },
           {
               "Effect": "Allow",
               "Action": "iot:Subscribe",
               "Resource": [
               "arn:aws:iot:{{us-east-1}}:{{123456789012}}:topicfilter/$aws/certificates/create/*",
       "arn:aws:iot:{{us-east-1}}:{{123456789012}}:topicfilter/$aws/provisioning-templates/{{templateName}}/provision/*"
               ]
           }
       ]
   }
   ```

1. Concedi al AWS IoT servizio l'autorizzazione a creare o aggiornare risorse IoT come oggetti e certificati nel tuo account durante il provisioning dei dispositivi. A tale scopo, associa la policy `AWSIoTThingsRegistration` gestita a un ruolo IAM (chiamato ruolo di provisioning) che si fida del responsabile del servizio. AWS IoT 

1. Il dispositivo viene prodotto con il certificato di attestazione di provisioning integrato in modo sicuro.

Il dispositivo è ora pronto per essere distribuito dove verrà installato per l'uso.

**Importante**  
Le chiavi private dell'attestazione di provisioning devono essere protette in ogni momento, anche sul dispositivo. Ti consigliamo di utilizzare AWS IoT CloudWatch metriche e registri per monitorare le indicazioni di un uso improprio. Se si rileva un uso improprio, disattivare il certificato di attestazione del provisioning in modo che non possa essere utilizzato per il provisioning del dispositivo.

**Inizializzazione del dispositivo per l'utilizzo**

1. Il dispositivo utilizza [AWS IoT SDK per dispositivi, SDK per dispositivi mobili e AWS IoT Client per dispositivi](iot-sdks.md) per connettersi e autenticarsi AWS IoT utilizzando il certificato di attestazione di provisioning installato sul dispositivo.
**Nota**  
Per sicurezza, il valore `certificateOwnershipToken` restituito da `CreateCertificateFromCsr` e da `CreateKeysAndCertificate` scade dopo un'ora. `RegisterThing` deve essere chiamato prima della scadenza di `certificateOwnershipToken`. Se il certificato creato da `CreateCertificateFromCsr` o `CreateKeysAndCertificate` non è stato attivato e non è stato collegato a una policy o a un oggetto entro la scadenza del token, il certificato viene eliminato. Se il token scade, il dispositivo può chiamare nuovamente `CreateCertificateFromCsr` o `CreateKeysAndCertificate` per generare un nuovo certificato.

1. Il dispositivo ottiene un certificato permanente e una chiave privata utilizzando una di queste opzioni. Il dispositivo utilizzerà il certificato e la chiave per tutte le autenticazioni future con. AWS IoT

   1. Chiama [`CreateKeysAndCertificate`](fleet-provision-api.md#create-keys-cert) per creare un nuovo certificato e una nuova chiave privata utilizzando l'autorità di AWS certificazione.

      Or

   1. Chiama [`CreateCertificateFromCsr`](fleet-provision-api.md#create-cert-csr) per generare un certificato da una richiesta di firma del certificato che mantenga la propria chiave privata protetta.

1. Dal dispositivo, richiamare [`RegisterThing`](fleet-provision-api.md#register-thing) per registrare il dispositivo con AWS IoT e creare risorse cloud.

   Il servizio di provisioning del parco istanze utilizza un modello di provisioning per definire e creare risorse cloud, come oggetti IoT. Il modello può specificare gli attributi e i gruppi a cui appartiene l'oggetto. I gruppi di oggetti devono esistere prima di poter aggiungere il nuovo oggetto.

1. Dopo aver salvato il certificato permanente sul dispositivo, il dispositivo deve disconnettersi dalla sessione avviata con il certificato di attestazione di provisioning e riconnettersi utilizzando il certificato permanente. 

Il dispositivo è ora pronto per comunicare normalmente con AWS IoT.

## Provisioning tramite utente attendibile
<a name="trusted-user"></a>

In molti casi, un dispositivo si connette AWS IoT per la prima volta quando un utente affidabile, ad esempio un utente finale o un tecnico installatore, utilizza un'app mobile per configurare il dispositivo nella posizione in cui è installato.

**Importante**  
Per eseguire questa procedura, è necessario gestire l'accesso e l'autorizzazione dell'utente attendibile. Un modo per eseguire questa operazione consiste nel fornire e gestire un account per l'utente attendibile che lo autentichi e conceda l'accesso alle funzionalità e alle API AWS IoT necessarie per eseguire questa procedura. 

**Prima di distribuire il dispositivo**

1. Chiama [`CreateProvisioningTemplate`](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateProvisioningTemplate.html) per creare un modello di provisioning e restituirlo. {{templateArn}} {{templateName}}

1. Creare un ruolo IAM utilizzato da un utente attendibile per avviare il processo di provisioning. Il modello di provisioning consente solo all'utente di eseguire il provisioning di un dispositivo. Ad esempio:

   ```json
   {
       "Effect": "Allow",
       "Action": [
           "iot:CreateProvisioningClaim"
       ],
       "Resource": [
           "arn:aws:iot:{{aws-region}}:{{aws-account-id}}:provisioningtemplate/{{templateName}}"
       ]
   }
   ```

1. Concedi al AWS IoT servizio l'autorizzazione a creare o aggiornare risorse IoT, ad esempio oggetti e certificati, nel tuo account durante il provisioning dei dispositivi. Puoi farlo collegando la policy `AWSIoTThingsRegistration` gestita a un ruolo IAM (chiamato ruolo di * provisioning*) che si fida del responsabile del servizio. AWS IoT 

1. Fornisci i mezzi per identificare i tuoi utenti fidati, ad esempio fornendo loro un account in grado di autenticarli e autorizzare le loro interazioni con le operazioni AWS API necessarie per registrare i loro dispositivi.

**Inizializzazione del dispositivo per l'utilizzo**

1. Un utente attendibile accede all'app per dispositivi mobili o al servizio Web di provisioning.

1. L'applicazione per dispositivi mobili o l'applicazione Web utilizza il ruolo IAM e chiama [`CreateProvisioningClaim`](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateProvisioningClaim.html) per ottenere un certificato di attestazione di provisioning temporaneo da AWS IoT.
**Nota**  
Per motivi di sicurezza, il certificato di attestazione di provisioning temporaneo restituito da `CreateProvisioningClaim` è valido solo per cinque minuti. Le fasi seguenti devono restituire un certificato valido prima della scadenza del certificato di attestazione di provisioning temporaneo. I certificati di attestazione di provisioning temporaneo non vengono visualizzati nell'elenco dei certificati dell'account.

1. L'app mobile o l'applicazione web fornisce al dispositivo il certificato di richiesta di provisioning temporaneo insieme a tutte le informazioni di configurazione richieste, come le credenziali. Wi-Fi 

1. Il dispositivo utilizza il certificato di attestazione di provisioning temporaneo per connettersi a AWS IoT , utilizzando [AWS IoT SDK per dispositivi, SDK per dispositivi mobili e AWS IoT Client per dispositivi](iot-sdks.md).

1. Il dispositivo ottiene un certificato permanente e una chiave privata utilizzando una di queste opzioni entro cinque minuti dalla connessione al AWS IoT certificato di richiesta di provisioning temporaneo. Il dispositivo utilizzerà il certificato e la chiave restituiti da queste opzioni per tutte le autenticazioni future. AWS IoT

   1. Chiama [`CreateKeysAndCertificate`](fleet-provision-api.md#create-keys-cert) per creare un nuovo certificato e una nuova chiave privata utilizzando l'autorità di AWS certificazione.

      Or

   1. Chiama [`CreateCertificateFromCsr`](fleet-provision-api.md#create-cert-csr) per generare un certificato da una richiesta di firma del certificato che mantenga la propria chiave privata protetta.
**Nota**  
Ricorda [`CreateKeysAndCertificate`](fleet-provision-api.md#create-keys-cert) o [`CreateCertificateFromCsr`](fleet-provision-api.md#create-cert-csr) devi restituire un certificato valido entro cinque minuti dalla connessione al AWS IoT certificato di richiesta di approvvigionamento temporaneo.

1. Il dispositivo chiama [`RegisterThing`](fleet-provision-api.md#register-thing) per registrare il dispositivo AWS IoT e creare risorse cloud. 

   Il servizio di provisioning del parco istanze utilizza un modello di provisioning per definire e creare risorse cloud, come oggetti IoT. Il modello può specificare gli attributi e i gruppi a cui appartiene l'oggetto. I gruppi di oggetti devono esistere prima di poter aggiungere il nuovo oggetto.

1. Dopo aver salvato il certificato permanente sul dispositivo, il dispositivo deve disconnettersi dalla sessione avviata con il certificato di attestazione di provisioning temporaneo e riconnettersi utilizzando il certificato permanente. 

Il dispositivo è ora pronto per comunicare normalmente con AWS IoT.

## Utilizzando ganci di pre-provisioning con AWS CLI
<a name="hooks-cli-instruc"></a>

La procedura seguente crea un modello di provisioning con hook di pre-provisioning. La funzione Lambda utilizzata qui è un esempio che può essere modificato. 

**Per creare e applicare un hook di pre-provisioning a un modello di provisioning**

1. Creare una funzione Lambda con input e output definiti. Le funzioni Lambda sono altamente personalizzabili. `allowProvisioning` e `parameterOverrides` sono necessari per la creazione di hook pre-provisioning. Per ulteriori informazioni sulla creazione di funzioni Lambda, vedere [ Utilizzo AWS Lambda con l'interfaccia a riga di comando. AWS](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-awscli.html)

   Di seguito è riportato un esempio di output di una funzione Lambda:

   ```json
   {
     "allowProvisioning": True,
     "parameterOverrides": {
       "{{incomingKey0}}": "{{incomingValue0}}",
       "{{incomingKey1}}": "{{incomingValue1}}"
     }
   }
   ```

1. AWS IoT utilizza politiche basate sulle risorse per chiamare Lambda, quindi devi dare l' AWS IoT autorizzazione per chiamare la tua funzione Lambda.
**Importante**  
Assicurati di includere il valore `source-arn` o `source-account` nelle chiavi del contesto delle condizioni globali delle policy associate all'operazione Lambda per impedire la manipolazione delle autorizzazioni. Per ulteriori informazioni, consulta [Cross-service prevenzione sostitutiva confusa](cross-service-confused-deputy-prevention.md).

   Di seguito è riportato un esempio che utilizza [add-permission](https://docs.aws.amazon.com/cli/latest/reference/lambda/add-permission.html) per concedere l'autorizzazione IoT all'utente Lambda.

   ```bash
   aws lambda add-permission \
       --function-name {{myLambdaFunction}} \
       --statement-id iot-permission \
       --action lambda:InvokeFunction \
       --principal iot.amazonaws.com
   ```

1. Aggiungere un hook di pre-provisioning a un modello utilizzando il comando [create-provisioning-template](https://docs.aws.amazon.com/cli/latest/reference/iot/create-provisioning-template.html) o [update-provisioning-template](https://docs.aws.amazon.com/cli/latest/reference/iot/update-provisioning-template.html).

   Nell'esempio dell'interfaccia a riga di comando seguente viene utilizzato [create-provisioning-template](https://docs.aws.amazon.com/cli/latest/reference/iot/create-provisioning-template.html) per creare un modello di provisioning con hook di pre-provisioning:

   ```bash
   aws iot create-provisioning-template \
       --template-name {{myTemplate}} \
       --provisioning-role-arn {{arn:aws:iam:us-east-1:1234564789012:role/myRole}} \
       --template-body {{file://template.json}} \
       --pre-provisioning-hook {{file://hooks.json}}
   ```

   L’output di questo comando è simile al seguente:

   ```json
   {
       "templateArn": "{{arn:aws:iot:us-east-1:1234564789012:provisioningtemplate/myTemplate}}",
       "defaultVersionId": 1,
       "templateName": {{myTemplate}}
   }
   ```

   È in oltre possibile caricare un parametro da un file invece di digitarlo per intero come valore di parametro della riga di comando per risparmiare tempo. Per ulteriori informazioni, consulta [Caricamento dei parametri da un file AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-file.html). Di seguito è riportato illustrato il parametro `template` in formato JSON espanso:

   ```json
   {
       "Parameters" : {
           "DeviceLocation": {
               "Type": "String"
           }
       },
       "Mappings": {
           "LocationTable": {
               "Seattle": {
                   "LocationUrl": "https://example.aws"
               }
           }
       },
       "Resources" : {
           "thing" : {
               "Type" : "AWS::IoT::Thing",
               "Properties" : {
                   "AttributePayload" : {
                       "version" : "v1",
                       "serialNumber" : "serialNumber"
                   },
                   "ThingName" : {"Fn::Join":["",["ThingPrefix_",{"Ref":"SerialNumber"}]]},
                   "ThingTypeName" : {"Fn::Join":["",["ThingTypePrefix_",{"Ref":"SerialNumber"}]]},
                   "ThingGroups" : ["widgets", "WA"],
                   "BillingGroup": "BillingGroup"
               },
               "OverrideSettings" : {
                   "AttributePayload" : "MERGE",
                   "ThingTypeName" : "REPLACE",
                   "ThingGroups" : "DO_NOTHING"
               }
           },
           "certificate" : {
               "Type" : "AWS::IoT::Certificate",
               "Properties" : {
                   "CertificateId": {"Ref": "AWS::IoT::Certificate::Id"},
                   "Status" : "Active",
                   "ThingPrincipalType" : "EXCLUSIVE_THING"
               }
           },
           "policy" : {
               "Type" : "AWS::IoT::Policy",
               "Properties" : {
                   "PolicyDocument" : {
                       "Version": "2012-10-17",		 	 	 
                       "Statement": [{
                           "Effect": "Allow",
                           "Action":["iot:Publish"],
                           "Resource": ["arn:aws:iot:us-east-1:504350838278:topic/foo/bar"]
                       }]
                   }
               }
           }
       },
       "DeviceConfiguration": {
           "FallbackUrl": "https://www.example.com/test-site",
           "LocationUrl": {
               "Fn::FindInMap": ["LocationTable",{"Ref": "DeviceLocation"}, "LocationUrl"]}
       }
   }
   ```

   Di seguito è riportato illustrato il parametro `pre-provisioning-hook` in formato JSON espanso:

   ```json
   {
        "targetArn" : "{{arn:aws:lambda:us-east-1:765219403047:function:pre_provisioning_test}}",
        "payloadVersion" : "{{2020-04-01}}"
   }
   ```