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à.
# Come AWS IoT SiteWise funziona con IAM
Prima di utilizzare AWS Identity and Access Management (IAM) per gestire l'accesso a AWS IoT SiteWise, è necessario comprendere con quali funzionalità IAM è possibile utilizzare AWS IoT SiteWise.
| Funzionalità IAM | Supportato da AWS IoT SiteWise? |
| --- | --- |
| [Policy basate sull'identità con autorizzazioni a livello di risorse](security_iam_service-with-iam-id-based-policies.md) | Sì |
| [Operazioni di policy](security_iam_service-with-iam-id-based-policies.md#security_iam_service-with-iam-id-based-policies-actions) | Sì |
| [Risorse relative alle policy](security_iam_service-with-iam-id-based-policies.md#security_iam_service-with-iam-id-based-policies-resources) | Sì |
| [Chiavi di condizione delle policy](security_iam_service-with-iam-id-based-policies.md#security_iam_service-with-iam-id-based-policies-conditionkeys) | Sì |
| Policy basate sulle risorse | No |
| Elenchi di controllo degli accessi (ACLs) | No |
| [Autorizzazione basata su tag (ABAC)](security_iam_service-with-iam-tags.md) | Sì |
| [Credenziali temporanee](security_iam_service-with-iam-roles.md#security_iam_service-with-iam-roles-tempcreds) | Sì |
| [Sessioni di accesso diretto (FAS)](security_iam_service-with-iam-roles.md#security_iam_service-with-iam-principal-permissions) | Sì |
| [Ruoli collegati al servizio](security_iam_service-with-iam-roles.md#security_iam_service-with-iam-roles-service-linked) | Sì |
| [Ruoli di servizio](security_iam_service-with-iam-roles.md#security_iam_service-with-iam-roles-service-linked) | Sì |
Per avere una visione di alto livello di come AWS IoT SiteWise e altri AWS servizi funzionano con IAM, consulta [AWS i servizi che funzionano con IAM nella IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) *User Guide*.
**Contents**
+ [AWS IoT SiteWise Ruoli IAM](security_iam_service-with-iam-roles.md)
+ [Usa credenziali temporanee con AWS IoT SiteWise](security_iam_service-with-iam-roles.md#security_iam_service-with-iam-roles-tempcreds)
+ [Sessioni di accesso diretto (FAS) per AWS IoT SiteWise](security_iam_service-with-iam-roles.md#security_iam_service-with-iam-principal-permissions)
+ [Ruoli collegati ai servizi](security_iam_service-with-iam-roles.md#security_iam_service-with-iam-roles-service-linked)
+ [Ruoli dei servizi](security_iam_service-with-iam-roles.md#security_iam_service-with-iam-roles-service)
+ [Scegli un ruolo IAM in AWS IoT SiteWise](security_iam_service-with-iam-roles.md#security_iam_service-with-iam-roles-choose)
+ [Autorizzazione basata su AWS IoT SiteWise tag](security_iam_service-with-iam-tags.md)
+ [AWS IoT SiteWise politiche basate sull'identità](security_iam_service-with-iam-id-based-policies.md)
+ [Operazioni di policy](security_iam_service-with-iam-id-based-policies.md#security_iam_service-with-iam-id-based-policies-actions)
+ [BatchPutAssetPropertyValue autorizzazione](security_iam_service-with-iam-id-based-policies.md#security_iam_service-with-iam-id-based-policies-batchputassetpropertyvalue-action)
+ [Risorse relative alle policy](security_iam_service-with-iam-id-based-policies.md#security_iam_service-with-iam-id-based-policies-resources)
+ [Chiavi di condizione delle policy](security_iam_service-with-iam-id-based-policies.md#security_iam_service-with-iam-id-based-policies-conditionkeys)
+ [Esempi](security_iam_service-with-iam-id-based-policies.md#security_iam_service-with-iam-id-based-policies-examples)
+ [AWS IoT SiteWise esempi di politiche basate sull'identità](security_iam_id-based-policy-examples.md)
+ [Best practice delle policy](security_iam_id-based-policy-examples.md#security_iam_service-with-iam-policy-best-practices)
+ [Usa la console AWS IoT SiteWise](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-console)
+ [Consentire agli utenti di visualizzare le loro autorizzazioni](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-view-own-permissions)
+ [Consenti agli utenti di inserire dati nelle risorse in un'unica gerarchia](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-ingest-to-one-asset-hierarchy)
+ [Visualizza le AWS IoT SiteWise risorse in base ai tag](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-view-asset-tags)
+ [Gestisci l'accesso utilizzando le politiche in AWS IoT SiteWise](security_iam_access-manage.md)
+ [Policy basate sull’identità](security_iam_access-manage.md#security_iam_access-manage-id-based-policies)
+ [Policy basate sulle risorse](security_iam_access-manage.md#security_iam_access-manage-resource-based-policies)
+ [Elenchi di controllo degli accessi () ACLs](security_iam_access-manage.md#security_iam_access-manage-acl)
+ [Altri tipi di policy](security_iam_access-manage.md#security_iam_access-manage-other-policies)
+ [Più tipi di policy](security_iam_access-manage.md#security_iam_access-manage-multiple-policies)
# AWS IoT SiteWise Ruoli IAM
Un [ruolo IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) è un'entità all'interno dell'account AWS che dispone di autorizzazioni specifiche.
## Usa credenziali temporanee con AWS IoT SiteWise
È possibile utilizzare credenziali temporanee per effettuare l'accesso con la federazione, assumere un ruolo IAM o un ruolo multi-account. È possibile ottenere credenziali di sicurezza temporanee chiamando operazioni AWS STS API come [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)o. [GetFederationToken](https://docs.aws.amazon.com/STS/latest/APIReference/API_GetFederationToken.html)
AWS IoT SiteWise supporta l'utilizzo di credenziali temporanee.
SiteWise Monitor supporta gli utenti federati per accedere ai portali. Gli utenti del portale si autenticano con le proprie credenziali IAM Identity Center o IAM.
**Importante**
Gli utenti o i ruoli devono disporre dell'`iotsitewise:DescribePortal`autorizzazione per accedere al portale.
Quando un utente accede a un portale, SiteWise Monitor genera una politica di sessione che fornisce le seguenti autorizzazioni:
+ Accesso in sola lettura alle risorse e ai dati delle risorse presenti AWS IoT SiteWise nel tuo account a cui il ruolo del portale fornisce l'accesso.
+ Accesso ai progetti in tale portale per il quale l'utente dispone dell'accesso amministratore (proprietario del progetto) o di sola lettura (visualizzatore progetto).
Per ulteriori informazioni sulle autorizzazioni utente del portale federato, consulta [Utilizza i ruoli di servizio per AWS IoT SiteWise Monitor](monitor-service-role.md).
## Sessioni di accesso diretto (FAS) per AWS IoT SiteWise
**Supporta l’inoltro delle sessioni di accesso (FAS):** sì
Le sessioni di accesso inoltrato (FAS) utilizzano le autorizzazioni del principale chiamante an Servizio AWS, combinate con la richiesta di effettuare richieste Servizio AWS ai servizi downstream. Per i dettagli delle policy relative alle richieste FAS, consulta [Forward access sessions](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_forward_access_sessions.html).
## Ruoli collegati ai servizi
[I ruoli collegati](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html#id_roles_terms-and-concepts) ai AWS servizi consentono ai servizi di accedere alle risorse di altri servizi per completare un'azione per conto dell'utente. I ruoli collegati ai servizi vengono visualizzati nell'account AWS dell'utente e sono di proprietà del servizio. Un amministratore IAM può visualizzare le autorizzazioni per i ruoli collegati ai servizi, ma non può modificarle.
AWS IoT SiteWise supporta ruoli collegati ai servizi. Per ulteriori informazioni su come creare e gestire i ruoli collegati ai servizi AWS IoT SiteWise , consulta [Usa ruoli collegati ai servizi per AWS IoT SiteWise](using-service-linked-roles.md).
## Ruoli dei servizi
Questa funzionalità consente a un servizio di assumere un [ruolo di servizio](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html#id_roles_terms-and-concepts) per conto dell'utente. Questo ruolo consente al servizio di accedere alle risorse in altri servizi per completare un'azione per conto dell'utente. I ruoli di servizio vengono visualizzati nell' AWS account e sono di proprietà dell'account. Ciò significa che un amministratore IAM può modificare le autorizzazioni per questo ruolo. Tuttavia, questo potrebbe pregiudicare la funzionalità del servizio.
AWS IoT SiteWise utilizza un ruolo di servizio per consentire agli utenti del portale SiteWise Monitor di accedere ad alcune AWS IoT SiteWise risorse per conto dell'utente. Per ulteriori informazioni, consulta [Utilizza i ruoli di servizio per AWS IoT SiteWise Monitor](monitor-service-role.md).
È necessario disporre delle autorizzazioni necessarie prima di poter creare modelli di AWS IoT Events allarme in AWS IoT SiteWise. Per ulteriori informazioni, consulta [Imposta le autorizzazioni per gli allarmi relativi agli eventi in AWS IoT SiteWise](alarms-iam-permissions.md).
## Scegli un ruolo IAM in AWS IoT SiteWise
Quando crei una `portal` risorsa in AWS IoT SiteWise, devi scegliere un ruolo per consentire agli utenti federati del tuo portale SiteWise Monitor di accedere per tuo AWS IoT SiteWise conto. Se in precedenza hai creato un ruolo di servizio, ti AWS IoT SiteWise fornisce un elenco di ruoli tra cui scegliere. In caso contrario, puoi creare un ruolo con le autorizzazioni richieste quando crei un portale. È importante scegliere un ruolo che consenta l'accesso alle risorse e ai dati degli asset. Per ulteriori informazioni, consulta [Utilizza i ruoli di servizio per AWS IoT SiteWise Monitor](monitor-service-role.md).
# Autorizzazione basata su AWS IoT SiteWise tag
È possibile allegare tag alle AWS IoT SiteWise risorse o passare tag in una richiesta a AWS IoT SiteWise. Per controllare l’accesso basato su tag, fornire informazioni sui tag nell’[elemento condizione](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html) di una policy utilizzando le chiavi di condizione `aws:ResourceTag/key-name`, `aws:RequestTag/key-name` o `aws:TagKeys`. Per ulteriori informazioni sul tagging delle risorse di AWS IoT SiteWise , consulta [Tagga le tue AWS IoT SiteWise risorse](tag-resources.md).
Per visualizzare una policy basata sulle identità di esempio per limitare l'accesso a una risorsa basata su tag su tale risorsa, consulta [Visualizza le AWS IoT SiteWise risorse in base ai tag](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-view-asset-tags).
# AWS IoT SiteWise politiche basate sull'identità
Le policy IAM ti consentono di controllare chi può fare cosa AWS IoT SiteWise. Puoi decidere quali azioni sono consentite o meno e impostare condizioni specifiche per tali azioni. Ad esempio, puoi stabilire delle regole su chi può visualizzare o modificare le informazioni AWS IoT SiteWise. AWS IoT SiteWise supporta azioni, risorse e chiavi di condizione specifiche. Per informazioni su tutti gli elementi utilizzati in una policy JSON, consulta [Documentazione di riferimento agli elementi delle policy JSON IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html) nella *Guida per l'utente IAM*.
## Operazioni di policy
Gli amministratori possono utilizzare le policy AWS JSON per specificare chi ha accesso a cosa. In altre parole, quale **entità principale** può eseguire **operazioni** su quali **risorse** e in quali **condizioni**.
L'elemento `Action` di una policy JSON descrive le operazioni che è possibile utilizzare per consentire o negare l'accesso in una policy. Includere le operazioni in una policy per concedere le autorizzazioni a eseguire l’operazione associata.
Le azioni politiche AWS IoT SiteWise utilizzano il seguente prefisso prima dell'azione:. `iotsitewise:` Ad esempio, per concedere a qualcuno il permesso di caricare i dati delle proprietà degli asset AWS IoT SiteWise con l'operazione `BatchPutAssetPropertyValue` API, includi l'`iotsitewise:BatchPutAssetPropertyValue`azione nella sua politica. Le dichiarazioni politiche devono includere un `NotAction` elemento `Action` or. AWS IoT SiteWise definisce il proprio set di azioni che descrivono le attività che è possibile eseguire con questo servizio.
Per specificare più operazioni in una singola istruzione, separarle con una virgola come mostrato di seguito.
```
"Action": [
"iotsitewise:action1",
"iotsitewise:action2"
]
```
Puoi specificare più operazioni tramite caratteri jolly (\$1). Ad esempio, per specificare tutte le operazioni che iniziano con la parola `Describe`, includi la seguente operazione.
```
"Action": "iotsitewise:Describe*"
```
Per visualizzare un elenco di AWS IoT SiteWise azioni, consulta [Actions defined by AWS IoT SiteWise](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotsitewise.html#awsiotsitewise-actions-as-permissions) nella *IAM User Guide*.
### BatchPutAssetPropertyValue autorizzazione
AWS IoT SiteWise autorizza l'accesso all'[BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)azione in un modo insolito. Per la maggior parte delle azioni, quando consenti o neghi l'accesso, tale azione restituisce un errore se le autorizzazioni non vengono concesse. Con`BatchPutAssetPropertyValue`, puoi inviare più immissioni di dati a diverse risorse e proprietà delle risorse in un'unica richiesta API. AWS IoT SiteWise autorizza ogni immissione di dati in modo indipendente. Per ogni singola immissione non autorizzata nella richiesta, AWS IoT SiteWise include un errore `AccessDeniedException` nell'elenco restituito. AWS IoT SiteWise riceve i dati relativi a qualsiasi immissione autorizzata e che ha esito positivo, anche se un'altra immissione nella stessa richiesta ha esito negativo.
**Importante**
Prima di inserire dati in un flusso di dati, procedi come segue:
Autorizzate la `time-series` risorsa se utilizzate un alias di proprietà per identificare il flusso di dati.
Autorizzate la `asset` risorsa se utilizzate un ID di risorsa per identificare la risorsa che contiene la proprietà della risorsa associata.
## Risorse relative alle policy
Gli amministratori possono utilizzare le policy AWS JSON per specificare chi ha accesso a cosa. In altre parole, quale **entità principale** può eseguire **operazioni** su quali **risorse** e in quali **condizioni**.
L’elemento JSON `Resource` della policy specifica l’oggetto o gli oggetti ai quali si applica l’operazione. Come best practice, specifica una risorsa utilizzando il suo [nome della risorsa Amazon (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html). Per le azioni che non supportano le autorizzazioni a livello di risorsa, si utilizza un carattere jolly (\$1) per indicare che l’istruzione si applica a tutte le risorse.
```
"Resource": "*"
```
Ogni dichiarazione di policy IAM si applica alle risorse specificate utilizzando le loro. ARNs Di seguito è riportata la sintassi generale di un ARN.
```
arn:${Partition}:${Service}:${Region}:${Account}:${ResourceType}/${ResourcePath}
```
Per ulteriori informazioni sul formato di ARNs, consulta [Identificare AWS le risorse con Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html).
Ad esempio, per specificare l'asset con ID `a1b2c3d4-5678-90ab-cdef-22222EXAMPLE` nell'istruzione, utilizza il seguente ARN.
```
"Resource": "arn:aws:iotsitewise:region:123456789012:asset/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE"
```
Per specificare tutti i flussi di dati che appartengono a un account specifico, usa il carattere jolly (\$1):
```
"Resource": "arn:aws:iotsitewise:region:123456789012:time-series/*"
```
Per specificare tutti gli asset che appartengono a un account specifico, utilizza il carattere jolly (\$1):
```
"Resource": "arn:aws:iotsitewise:region:123456789012:asset/*"
```
Alcune AWS IoT SiteWise azioni, come quelle per la creazione di risorse, non possono essere eseguite su una risorsa specifica. In questi casi, è necessario utilizzare il carattere jolly (\$1).
```
"Resource": "*"
```
Per specificare più risorse in un'unica istruzione, separale ARNs con virgole.
```
"Resource": [
"resource1",
"resource2"
]
```
Per visualizzare un elenco dei tipi di AWS IoT SiteWise risorse e relativi ARNs, consulta [Tipi di risorse definiti da AWS IoT SiteWise](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotsitewise.html#awsiotsitewise-resources-for-iam-policies) nella *Guida per l'utente IAM*. Per informazioni sulle operazioni con cui è possibile specificare l'ARN di ogni risorsa, consulta la sezione [Operazioni definite da AWS IoT SiteWise](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotsitewise.html#awsiotsitewise-actions-as-permissions).
## Chiavi di condizione delle policy
Gli amministratori possono utilizzare le policy AWS JSON per specificare chi ha accesso a cosa. In altre parole, quale **entità principale** può eseguire **operazioni** su quali **risorse** e in quali **condizioni**.
L’elemento `Condition` specifica quando le istruzioni vengono eseguite in base a criteri definiti. È possibile compilare espressioni condizionali che utilizzano [operatori di condizione](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html), ad esempio uguale a o minore di, per soddisfare la condizione nella policy con i valori nella richiesta. Per visualizzare tutte le chiavi di condizione AWS globali, consulta le chiavi di [contesto delle condizioni AWS globali nella Guida](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) per l'*utente IAM*.
**Importante**
Molte chiavi di condizione sono specifiche di una risorsa e alcune operazioni API utilizzano più risorse. Se scrivi una dichiarazione di policy con una chiave di condizione, utilizza l'elemento `Resource` della dichiarazione per specificare la risorsa a cui viene applicata la chiave di condizione. In caso contrario, la policy potrebbe impedire agli utenti di eseguire operazioni perché il controllo della condizione ha esito negativo per le risorse alle quali non viene applicata la chiave di condizione. Se non desideri specificare una risorsa oppure se hai scritto l'elemento `Action` della policy in modo da includere più operazioni API, devi utilizzare il tipo di condizione `...IfExists` per assicurarti che la chiave di condizione venga ignorata per le risorse che non la utilizzano. Per ulteriori informazioni, consulta[... IfExists ](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html#Conditions_IfExists)condizioni nella *Guida per l'utente IAM*.
AWS IoT SiteWise definisce il proprio set di chiavi di condizione e supporta anche l'utilizzo di alcune chiavi di condizione globali. Per visualizzare tutte le chiavi di condizione AWS globali, consulta le [chiavi di contesto delle condizioni AWS globali](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) nella *Guida per l'utente IAM*.
**AWS IoT SiteWise chiavi di condizione**
| Chiave di condizione | Description | Tipi |
| --- | --- | --- |
| iotsitewise:isAssociatedWithAssetProperty | Se i flussi di dati sono associati a una proprietà dell'asset. Utilizzate questa chiave di condizione per definire le autorizzazioni in base all'esistenza di una proprietà di asset associata per i flussi di dati. Valore di esempio: `true` | Stringa |
| iotsitewise:assetHierarchyPath | Il percorso gerarchico della risorsa, che è una stringa di risorse separate IDs ciascuna da una barra. Utilizzare questa chiave di condizione per definire le autorizzazioni in base a un sottoinsieme della gerarchia di tutti gli asset nell'account. Valore di esempio: `/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/a1b2c3d4-5678-90ab-cdef-66666EXAMPLE` | Stringa |
| iotsitewise:propertyId | L'ID di una proprietà di asset. Utilizza questa chiave di condizione per definire le autorizzazioni in base a una proprietà specificata di un modello di asset. Questa chiave di condizione si applica a tutti gli asset di tale modello. Valore di esempio: `a1b2c3d4-5678-90ab-cdef-33333EXAMPLE` | Stringa |
| iotsitewise:childAssetId | L'ID di un asset associato come un figlio a un altro asset. Utilizza questa chiave di condizione per definire le autorizzazioni in base agli asset figlio. Per definire le autorizzazioni in base agli asset padre, utilizza la sezione delle risorse di un'istruzione policy. Valore di esempio: `a1b2c3d4-5678-90ab-cdef-66666EXAMPLE` | Stringa |
| iotsitewise:iam | L'ARN di un'identità IAM quando si elencano le politiche di accesso. Utilizza questa chiave di condizione per definire le autorizzazioni delle politiche di accesso per un'identità IAM. Valore di esempio: `arn:aws:iam::123456789012:user/JohnDoe` | Stringa, Null |
| iotsitewise:propertyAlias | L'alias che identifica una proprietà o un flusso di dati di una risorsa. Utilizzate questa chiave di condizione per definire le autorizzazioni in base all'alias. | Stringa |
| iotsitewise:user | L'ID di un utente di IAM Identity Center quando elenca le politiche di accesso. Utilizza questa chiave di condizione per definire le autorizzazioni delle policy di accesso per un utente IAM Identity Center. Valore di esempio: `a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE` | Stringa, Null |
| iotsitewise:group | L'ID di un gruppo IAM Identity Center quando si elencano le politiche di accesso. Utilizza questa chiave di condizione per definire le autorizzazioni delle policy di accesso per un gruppo IAM Identity Center. Valore di esempio: `a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-bbbbbEXAMPLE` | Stringa, Null |
| iotsitewise:portal | ID di un portale in una policy di accesso. Utilizza questa chiave di condizione per definire le autorizzazioni delle policy di accesso in base a un portale. Valore di esempio: `a1b2c3d4-5678-90ab-cdef-77777EXAMPLE` | Stringa, Null |
| iotsitewise:project | L'ID di un progetto in una policy di accesso o l'ID di un progetto per un pannello di controllo. Utilizza questa chiave di condizione per definire il pannello di controllo o le autorizzazioni delle policy di accesso in base a un progetto. Valore di esempio: `a1b2c3d4-5678-90ab-cdef-88888EXAMPLE` | Stringa, Null |
Per sapere con quali azioni e risorse puoi utilizzare una chiave di condizione, consulta [Azioni definite da AWS IoT SiteWise](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotsitewise.html#awsiotsitewise-actions-as-permissions).
## Esempi
Per visualizzare esempi di politiche AWS IoT SiteWise basate sull'identità, vedere. [AWS IoT SiteWise esempi di politiche basate sull'identità](security_iam_id-based-policy-examples.md)
# AWS IoT SiteWise esempi di politiche basate sull'identità
Per impostazione predefinita, le entità (utenti e ruoli) non sono autorizzate a creare o modificare AWS IoT SiteWise risorse. Inoltre, non possono eseguire attività utilizzando Console di gestione AWS, AWS Command Line Interface (AWS CLI) o AWS l'API. Per modificare le autorizzazioni, un amministratore AWS Identity and Access Management (IAM) deve effettuare le seguenti operazioni:
1. Crea policy IAM che concedano a utenti e ruoli il permesso di eseguire operazioni API specifiche sulle risorse di cui hanno bisogno.
1. Allega tali policy agli utenti o ai gruppi che richiedono tali autorizzazioni.
Per informazioni su come creare una policy basata su identità IAM utilizzando questi documenti di policy JSON di esempio, consultare [Creazione di policy nella scheda JSON](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-json-editor) nella *Guida per l'utente di IAM*.
**Topics**
+ [Best practice delle policy](#security_iam_service-with-iam-policy-best-practices)
+ [Usa la console AWS IoT SiteWise](#security_iam_id-based-policy-examples-console)
+ [Consentire agli utenti di visualizzare le loro autorizzazioni](#security_iam_id-based-policy-examples-view-own-permissions)
+ [Consenti agli utenti di inserire dati nelle risorse in un'unica gerarchia](#security_iam_id-based-policy-examples-ingest-to-one-asset-hierarchy)
+ [Visualizza le AWS IoT SiteWise risorse in base ai tag](#security_iam_id-based-policy-examples-view-asset-tags)
## Best practice delle policy
Le politiche basate sull'identità determinano se qualcuno può creare, accedere o eliminare AWS IoT SiteWise risorse nel tuo account. Queste azioni possono comportare costi aggiuntivi per l’ Account AWS. Quando si creano o modificano policy basate sull’identità, seguire queste linee guida e raccomandazioni:
+ **Inizia con le policy AWS gestite e passa alle autorizzazioni con privilegi minimi: per iniziare a concedere autorizzazioni** *a utenti e carichi di lavoro, utilizza le politiche gestite che concedono le autorizzazioni per molti casi d'uso comuni.AWS * Sono disponibili nel tuo. Account AWS Ti consigliamo di ridurre ulteriormente le autorizzazioni definendo politiche gestite dai AWS clienti specifiche per i tuoi casi d'uso. Per maggiori informazioni, consulta [Policy gestite da AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies) o [Policy gestite da AWS per le funzioni dei processi](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_job-functions.html) nella *Guida per l’utente di IAM*.
+ **Applicazione delle autorizzazioni con privilegio minimo** - Quando si impostano le autorizzazioni con le policy IAM, concedere solo le autorizzazioni richieste per eseguire un’attività. È possibile farlo definendo le azioni che possono essere intraprese su risorse specifiche in condizioni specifiche, note anche come *autorizzazioni con privilegio minimo*. Per maggiori informazioni sull’utilizzo di IAM per applicare le autorizzazioni, consulta [Policy e autorizzazioni in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) nella *Guida per l’utente di IAM*.
+ **Condizioni d’uso nelle policy IAM per limitare ulteriormente l’accesso** - Per limitare l’accesso ad azioni e risorse è possibile aggiungere una condizione alle policy. Ad esempio, è possibile scrivere una condizione di policy per specificare che tutte le richieste devono essere inviate utilizzando SSL. Puoi anche utilizzare le condizioni per concedere l'accesso alle azioni del servizio se vengono utilizzate tramite uno specifico Servizio AWS, ad esempio CloudFormation. Per maggiori informazioni, consultare la sezione [Elementi delle policy JSON di IAM: condizione](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html) nella *Guida per l’utente di IAM*.
+ **Utilizzo dello strumento di analisi degli accessi IAM per convalidare le policy IAM e garantire autorizzazioni sicure e funzionali** - Lo strumento di analisi degli accessi IAM convalida le policy nuove ed esistenti in modo che aderiscano al linguaggio (JSON) della policy IAM e alle best practice di IAM. Lo strumento di analisi degli accessi IAM offre oltre 100 controlli delle policy e consigli utili per creare policy sicure e funzionali. Per maggiori informazioni, consultare [Convalida delle policy per il Sistema di analisi degli accessi IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-policy-validation.html) nella *Guida per l’utente di IAM*.
+ **Richiedi l'autenticazione a più fattori (MFA**): se hai uno scenario che richiede utenti IAM o un utente root nel Account AWS tuo, attiva l'MFA per una maggiore sicurezza. Per richiedere la MFA quando vengono chiamate le operazioni API, aggiungere le condizioni MFA alle policy. Per maggiori informazioni, consultare [Protezione dell’accesso API con MFA](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa_configure-api-require.html) nella *Guida per l’utente di IAM*.
Per maggiori informazioni sulle best practice in IAM, consulta [Best practice di sicurezza in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) nella *Guida per l’utente di IAM*.
## Usa la console AWS IoT SiteWise
Per accedere alla AWS IoT SiteWise console, è necessario un set di autorizzazioni di base. Queste autorizzazioni ti consentono di visualizzare e gestire i dettagli sulle AWS IoT SiteWise risorse del tuo AWS account.
Se stabilisci una politica troppo restrittiva, la console potrebbe non funzionare come previsto per gli utenti o i ruoli (entità) che prevedono tale politica. Per garantire che tali entità possano ancora utilizzare la AWS IoT SiteWise console, allega loro la policy [AWSIoTSiteWiseConsoleFullAccess](https://console.aws.amazon.com/iam/home#/policies/policies/arn:aws:iam::aws:policy/AWSIoTSiteWiseConsoleFullAccess)gestita o definisci autorizzazioni equivalenti per tali entità. Per maggiori informazioni, consulta [Aggiunta di autorizzazioni a un utente](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console) nella *Guida per l’utente di IAM*.
Se le entità utilizzano solo la AWS Command Line Interface (CLI) o l' AWS IoT SiteWise API e non la console, non necessitano di queste autorizzazioni minime. In tal caso, è sufficiente consentire loro di accedere alle azioni specifiche di cui hanno bisogno per le loro attività API.
## Consentire agli utenti di visualizzare le loro autorizzazioni
Questo esempio mostra in che modo è possibile creare una policy che consente agli utenti IAM di visualizzare le policy inline e gestite che sono collegate alla relativa identità utente. Questa politica include le autorizzazioni per completare questa azione sulla console o utilizzando l'API o a livello di codice. AWS CLI AWS
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "ViewOwnUserInfo",
"Effect": "Allow",
"Action": [
"iam:GetUserPolicy",
"iam:ListGroupsForUser",
"iam:ListAttachedUserPolicies",
"iam:ListUserPolicies",
"iam:GetUser"
],
"Resource": ["arn:aws:iam::*:user/${aws:username}"]
},
{
"Sid": "NavigateInConsole",
"Effect": "Allow",
"Action": [
"iam:GetGroupPolicy",
"iam:GetPolicyVersion",
"iam:GetPolicy",
"iam:ListAttachedGroupPolicies",
"iam:ListGroupPolicies",
"iam:ListPolicyVersions",
"iam:ListPolicies",
"iam:ListUsers"
],
"Resource": "*"
}
]
}
```
## Consenti agli utenti di inserire dati nelle risorse in un'unica gerarchia
In questo esempio, volete concedere a un utente del vostro AWS account l'accesso per scrivere dati su tutte le proprietà delle risorse in una gerarchia specifica di risorse, a partire dalla risorsa principale. `a1b2c3d4-5678-90ab-cdef-22222EXAMPLE` La policy concede l'autorizzazione `iotsitewise:BatchPutAssetPropertyValue` all'utente. Questa policy utilizza la chiave di condizione `iotsitewise:assetHierarchyPath` per limitare l'accesso agli asset il cui percorso della gerarchia corrisponde all'asset o ai relativi discendenti.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "PutAssetPropertyValuesForHierarchy",
"Effect": "Allow",
"Action": "iotsitewise:BatchPutAssetPropertyValue",
"Resource": "arn:aws:iotsitewise:*:*:asset/*",
"Condition": {
"StringLike": {
"iotsitewise:assetHierarchyPath": [
"/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/*"
]
}
}
}
]
}
```
------
## Visualizza le AWS IoT SiteWise risorse in base ai tag
Utilizza le condizioni della tua politica basata sull'identità per controllare l'accesso alle AWS IoT SiteWise risorse in base ai tag. Questo esempio mostra come creare una politica che consenta la visualizzazione delle risorse. Tuttavia, l'autorizzazione viene concessa solo se il valore del tag di asset `Owner` corrisponde al nome utente dell'utente. Questo criterio concede inoltre l'autorizzazione a completare questa azione sulla console.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "ListAllAssets",
"Effect": "Allow",
"Action": [
"iotsitewise:ListAssets",
"iotsitewise:ListAssociatedAssets"
],
"Resource": "*"
},
{
"Sid": "DescribeAssetIfOwner",
"Effect": "Allow",
"Action": "iotsitewise:DescribeAsset",
"Resource": "arn:aws:iotsitewise:*:*:asset/*",
"Condition": {
"StringEquals": {
"aws:ResourceTag/Owner": "${aws:username}"
}
}
}
]
}
```
------
Allega questa politica agli utenti del tuo account. Se un utente denominato `richard-roe` tenta di visualizzare una AWS IoT SiteWise risorsa, la risorsa deve essere contrassegnata con `Owner=richard-roe` o`owner=richard-roe`. Altrimenti, a Richard viene negato l'accesso. I nomi delle chiavi dei tag di condizione non fanno distinzione tra maiuscole e minuscole. Quindi, `Owner` corrisponde a entrambi `Owner` e. `owner` Per ulteriori informazioni, consulta la sezione [Elementi delle policy JSON di IAM: condizione](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html) nella *Guida per l'utente di IAM*.
# Gestisci l'accesso utilizzando le politiche in AWS IoT SiteWise
Puoi controllare l'accesso AWS creando policy e associandole a AWS identità o risorse. Una policy definisce le autorizzazioni quando è associata a un'identità o a una risorsa. AWS valuta queste politiche quando un preside effettua una richiesta. La maggior parte delle politiche viene archiviata AWS come documenti JSON. Per maggiori informazioni sui documenti delle policy JSON, consulta [Panoramica delle policy JSON](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#access_policies-json) nella *Guida per l’utente IAM*.
Utilizzando le policy, gli amministratori specificano chi ha accesso a cosa definendo quale **principale** può eseguire **azioni** su quali **risorse** e in quali **condizioni**.
Per impostazione predefinita, utenti e ruoli non dispongono di autorizzazioni. Un amministratore IAM crea le policy IAM e le aggiunge ai ruoli, che gli utenti possono quindi assumere. Le policy IAM definiscono le autorizzazioni indipendentemente dal metodo utilizzato per eseguirle.
## Policy basate sull’identità
Le policy basate su identità sono documenti di policy di autorizzazione JSON che è possibile collegare a un’identità (utente, gruppo o ruolo). Tali policy controllano le operazioni autorizzate per l’identità, nonché le risorse e le condizioni in cui possono essere eseguite. Per informazioni su come creare una policy basata su identità, consultare [Definizione di autorizzazioni personalizzate IAM con policy gestite dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) nella *Guida per l’utente IAM*.
Le policy basate su identità possono essere *policy in linea* (con embedding direttamente in una singola identità) o *policy gestite* (policy autonome collegate a più identità). Per informazioni su come scegliere tra una policy gestita o una policy inline, consulta [Scegliere tra policy gestite e policy in linea](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-choosing-managed-or-inline.html) nella *Guida per l’utente di IAM*.
## Policy basate sulle risorse
Le policy basate su risorse sono documenti di policy JSON che è possibile collegare a una risorsa. Gli esempi includono le *policy di trust dei ruoli* IAM e le *policy dei bucket* di Amazon S3. Nei servizi che supportano policy basate sulle risorse, gli amministratori dei servizi possono utilizzarli per controllare l’accesso a una risorsa specifica. In una policy basata sulle risorse è obbligatorio [specificare un’entità principale](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html).
Le policy basate sulle risorse sono policy inline che si trovano in tale servizio. Non è possibile utilizzare le policy AWS gestite di IAM in una policy basata sulle risorse.
## Elenchi di controllo degli accessi () ACLs
Le liste di controllo degli accessi (ACLs) controllano quali principali (membri dell'account, utenti o ruoli) dispongono delle autorizzazioni per accedere a una risorsa. ACLs sono simili alle politiche basate sulle risorse, sebbene non utilizzino il formato del documento di policy JSON.
Amazon S3 e Amazon VPC sono esempi di servizi che supportano. AWS WAF ACLs Per ulteriori informazioni ACLs, consulta la [panoramica della lista di controllo degli accessi (ACL)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html) nella *Amazon Simple Storage Service Developer Guide*.
## Altri tipi di policy
AWS supporta tipi di policy aggiuntivi che possono impostare le autorizzazioni massime concesse dai tipi di policy più comuni:
+ **Limiti delle autorizzazioni**: imposta il numero massimo di autorizzazioni che una policy basata su identità ha la possibilità di concedere a un’entità IAM. Per ulteriori informazioni, consulta [Limiti delle autorizzazioni per le entità IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html) nella *Guida per l’utente di IAM*.
+ **Politiche di controllo del servizio (SCPs)**: specificano le autorizzazioni massime per un'organizzazione o un'unità organizzativa in. AWS Organizations Per ulteriori informazioni, consultare [Policy di controllo dei servizi](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scps.html) nella *Guida per l’utente di AWS Organizations *.
+ **Politiche di controllo delle risorse (RCPs)**: imposta le autorizzazioni massime disponibili per le risorse nei tuoi account. Per ulteriori informazioni, consulta [Politiche di controllo delle risorse (RCPs)](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_rcps.html) nella *Guida per l'AWS Organizations utente*.
+ **Policy di sessione**: policy avanzate passate come parametro quando si crea una sessione temporanea per un ruolo o un utente federato. Per maggiori informazioni, consultare [Policy di sessione](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session) nella *Guida per l’utente IAM*.
## Più tipi di policy
Quando a una richiesta si applicano più tipi di policy, le autorizzazioni risultanti sono più complicate da comprendere. Per scoprire come si AWS determina se consentire o meno una richiesta quando sono coinvolti più tipi di policy, consulta [Logica di valutazione delle policy](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_evaluation-logic.html) nella *IAM User Guide*.