Utilizzo dei ruoli di servizio per AWS IoT SiteWise Monitor - AWS IoT SiteWise
Autorizzazioni del ruolo di servizio per Monitor SiteWise Gestione del ruolo del servizio (console)Gestione del ruolo del servizio (CLI)Aggiornamenti dei ruoli

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

Utilizzo dei ruoli di servizio per AWS IoT SiteWise Monitor

Un ruolo di servizio è un ruolo IAM che un servizio assume per eseguire operazioni per tuo conto. Un amministratore IAM può creare, modificare ed eliminare un ruolo di servizio dall'interno di IAM. Per ulteriori informazioni, consulta la sezione Creazione di un ruolo per delegare le autorizzazioni a un Servizio AWSnella Guida per l'utente IAM.

Per consentire agli utenti federati del portale SiteWise Monitor di accedere AWS IoT SiteWisealle AWS IAM Identity Center proprie risorse, è necessario assegnare un ruolo di servizio a ciascun portale creato. Il ruolo di servizio deve specificare SiteWise Monitor come entità attendibile e includere la policy AWSIoTSiteWiseMonitorPortalAccessgestita o definire autorizzazioni equivalenti. Questa policy è gestita AWS e definisce il set di autorizzazioni che SiteWise Monitor utilizza per accedere alle tue risorse AWS IoT SiteWise e a quelle di IAM Identity Center.

Quando crei un portale SiteWise Monitor, devi scegliere un ruolo che consenta agli utenti di quel portale di accedere alle tue risorse AWS IoT SiteWisee a quelle di IAM Identity Center. La AWS IoT SiteWise console può creare e configurare il ruolo per te. Puoi modificare il ruolo in IAM in un secondo momento. Gli utenti del portale avranno problemi a utilizzare i loro portali SiteWise Monitor se rimuovi le autorizzazioni richieste dal ruolo o elimini il ruolo.

Nota

I portali creati prima del 29 aprile 2020 non richiedevano ruoli del servizio. Se hai creato portali prima di tale data, devi collegare ruoli del servizio per continuare a utilizzarli. Per farlo, vai alla pagina Portali nella AWS IoT SiteWise console, quindi scegli Migra tutti i portali per utilizzare i ruoli IAM.

Le sezioni seguenti descrivono come creare e gestire il ruolo del servizio SiteWise Monitor in o in. AWS Management Console AWS Command Line Interface

Autorizzazioni del ruolo di servizio per Monitor SiteWise

Quando si crea un portale, AWS IoT SiteWise consente di creare un ruolo il cui nome inizia con AWSIoTSiteWiseMonitorServiceRole. Questo ruolo consente agli utenti federati di SiteWise Monitor di accedere alla configurazione del portale, agli asset, ai dati degli asset e ai dati di configurazione di IAM Identity Center.

Ai fini dell'assunzione del ruolo, il ruolo considera attendibile il seguente servizio:

  • monitor.iotsitewise.amazonaws.com

Il ruolo utilizza la seguente politica di autorizzazioni, il cui nome inizia con AWSIoTSiteWiseMonitorServicePortalPolicy, per consentire agli utenti di SiteWise Monitor di completare azioni sulle risorse del proprio account. La politica AWSIoTSiteWiseMonitorPortalAccessgestita definisce autorizzazioni equivalenti.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iotsitewise:DescribePortal",
                "iotsitewise:CreateProject",
                "iotsitewise:DescribeProject",
                "iotsitewise:UpdateProject",
                "iotsitewise:DeleteProject",
                "iotsitewise:ListProjects",
                "iotsitewise:BatchAssociateProjectAssets",
                "iotsitewise:BatchDisassociateProjectAssets",
                "iotsitewise:ListProjectAssets",
                "iotsitewise:CreateDashboard",
                "iotsitewise:DescribeDashboard",
                "iotsitewise:UpdateDashboard",
                "iotsitewise:DeleteDashboard",
                "iotsitewise:ListDashboards",
                "iotsitewise:CreateAccessPolicy",
                "iotsitewise:DescribeAccessPolicy",
                "iotsitewise:UpdateAccessPolicy",
                "iotsitewise:DeleteAccessPolicy",
                "iotsitewise:ListAccessPolicies",
                "iotsitewise:DescribeAsset",
                "iotsitewise:ListAssets",
                "iotsitewise:ListAssociatedAssets",
                "iotsitewise:DescribeAssetProperty",
                "iotsitewise:GetAssetPropertyValue",
                "iotsitewise:GetAssetPropertyValueHistory",
                "iotsitewise:GetAssetPropertyAggregates",
                "iotsitewise:BatchPutAssetPropertyValue",
                "iotsitewise:ListAssetRelationships",
                "iotsitewise:DescribeAssetModel",
                "iotsitewise:ListAssetModels",
                "iotsitewise:UpdateAssetModel",
                "iotsitewise:UpdateAssetModelPropertyRouting",
                "sso-directory:DescribeUsers",
                "sso-directory:DescribeUser",
                "iotevents:DescribeAlarmModel",
                "iotevents:ListTagsForResource"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "iotevents:BatchAcknowledgeAlarm",
                "iotevents:BatchSnoozeAlarm",
                "iotevents:BatchEnableAlarm",
                "iotevents:BatchDisableAlarm"
            ],
            "Resource": "*",
            "Condition": {
                "Null": {
                    "iotevents:keyValue": "false"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "iotevents:CreateAlarmModel",
                "iotevents:TagResource"
            ],
            "Resource": "*",
            "Condition": {
                "Null": {
                    "aws:RequestTag/iotsitewisemonitor": "false"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "iotevents:UpdateAlarmModel",
                "iotevents:DeleteAlarmModel"
            ],
            "Resource": "*",
            "Condition": {
                "Null": {
                    "aws:ResourceTag/iotsitewisemonitor": "false"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "iam:PassRole"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "iam:PassedToService": [
                        "iotevents.amazonaws.com"
                    ]
                }
            }
        }
    ]
}

Per ulteriori informazioni sulle autorizzazioni richieste per gli allarmi, consulta. Configurazione delle autorizzazioni per gli AWS IoT Events allarmi

Quando un utente del portale accede, SiteWise Monitor crea una politica di sessione basata sull'intersezione tra il ruolo del servizio e le politiche di accesso dell'utente. Le policy di accesso definiscono il livello di accesso delle identità ai portali e ai progetti. Per ulteriori informazioni sulle autorizzazioni del portale e sulle politiche di accesso, consulta Amministrazione dei portali SiteWise Monitor and CreateAccess Policy.

Gestione del ruolo del servizio SiteWise Monitor (console)

Console AWS IoT SiteWise Facilita la gestione del ruolo del servizio SiteWise Monitor per i portali. Al momento della creazione di un portale, la console verifica i ruoli esistenti adatti all'allegato. Se non ce ne sono disponibili, la console può creare e configurare automaticamente un ruolo di servizio. Per ulteriori informazioni, consulta Creazione di un portale.

Individuazione del ruolo del servizio di un portale (console)

Utilizza i passaggi seguenti per trovare il ruolo di servizio associato a un portale di SiteWise monitoraggio.

Per individuare il ruolo del servizio di un portale

  1. Passare alla console AWS IoT SiteWise.

  2. Nel riquadro di navigazione a sinistra scegliere Portals (Portali).

  3. Scegliere il portale per il quale si desidera individuare il ruolo del servizio.

    Il ruolo collegato al portale viene visualizzato in Permissions (Autorizzazioni), Service role (Ruolo del servizio).

Creazione di un ruolo del servizio SiteWise Monitor (AWS IoT SiteWise console)

Quando crei un portale SiteWise Monitor, puoi creare un ruolo di servizio per il tuo portale. Per ulteriori informazioni, consulta Creazione di un portale.

È inoltre possibile creare un ruolo di servizio per un portale esistente nella AWS IoT SiteWise console. Questo sostituisce il ruolo di servizio esistente del portale.

Per creare un ruolo del servizio per un portale esistente

  1. Passare alla console AWS IoT SiteWise.

  2. Nel riquadro di navigazione scegli Portali.

  3. Scegliere il portale per il quale si desidera creare un nuovo ruolo del servizio.

  4. In Portal details (Dettagli portale), scegliere Edit (Modifica).

  5. In Permissions (Autorizzazioni), scegliere Create and use a new service role (Crea e utilizza un nuovo ruolo del servizio) dall'elenco.

  6. Immettere un nome per il nuovo ruolo.

  7. Selezionare Salva.

Creazione di un ruolo del servizio SiteWise Monitor (console IAM)

Puoi creare un ruolo di servizio dal modello di ruolo di servizio nella console IAM. Questo modello di ruolo include la policy AWSIoTSiteWiseMonitorPortalAccessgestita e specifica SiteWise Monitor come entità affidabile.

Per creare un ruolo di servizio dal modello di ruolo di servizio del portale

  1. Passare alla IAM console (Console IAM).

  2. Nel pannello di navigazione, seleziona Roles (Ruoli).

  3. Selezionare Create role (Crea ruolo).

  4. In Scegli un caso d'uso, scegli IoT SiteWise.

  5. In Seleziona il tuo caso d'uso, scegli IoT SiteWise Monitor - Portal.

  6. Scegliere Next: Permissions (Successivo: Autorizzazioni).

  7. Scegliere Next: Tags (Successivo: Tag).

  8. Scegliere Next:Review (Successivo: Rivedi).

  9. Immettete un nome di ruolo per il nuovo ruolo di servizio.

  10. Scegli Crea ruolo.

Modifica del ruolo del servizio di un portale (console)

Utilizzare la procedura seguente per scegliere un ruolo del servizio di SiteWise monitoraggio diverso per un portale.

Per modificare il ruolo del servizio di un portale

  1. Passare alla console AWS IoT SiteWise.

  2. Nel riquadro di navigazione scegli Portali.

  3. Scegliere il portale per il quale si desidera modificare il ruolo del servizio.

  4. In Portal details (Dettagli portale), scegliere Edit (Modifica).

  5. In Permissions (Autorizzazioni), scegliere Use an existing role (Utilizza un ruolo esistente).

  6. Scegliere un ruolo esistente da collegare al portale.

  7. Selezionare Salva.

Gestione del ruolo del servizio SiteWise Monitor (CLI)

È possibile utilizzare il AWS CLI per le seguenti attività di gestione dei ruoli del servizio del portale:

Individuazione del ruolo del servizio di un portale (CLI)

Per trovare il ruolo di servizio associato a un portale di SiteWise monitoraggio, esegui il comando seguente per elencare tutti i portali nella regione corrente.

aws iotsitewise list-portals

L'operazione restituisce una risposta contenente i riepiloghi del portale nel formato seguente.

{
  "portalSummaries": [
    {
      "id": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE",
      "name": "WindFarmPortal",
      "description": "A portal that contains wind farm projects for Example Corp.",
      "roleArn": "arn:aws:iam::123456789012:role/service-role/role-name",
      "startUrl": "https://a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE.app.iotsitewise.aws",
      "creationDate": "2020-02-04T23:01:52.90248068Z",
      "lastUpdateDate": "2020-02-04T23:01:52.90248078Z"
    }
  ]
}

Puoi anche utilizzare l'DescribePortaloperazione per trovare il ruolo del tuo portale se conosci l'ID del tuo portale.

Creazione del ruolo del servizio SiteWise Monitor (CLI)

Utilizza la procedura seguente per creare un nuovo ruolo del servizio SiteWise Monitor.

Per creare un ruolo SiteWise del servizio Monitor

  1. Crea un ruolo con una politica di fiducia che consenta a SiteWise Monitor di assumere il ruolo. In questo esempio viene creato un ruolo denominato MySiteWiseMonitorPortalRole da una policy di attendibilità archiviata in una stringa JSON.

    Linux, macOS, or Unix
    aws iam create-role --role-name MySiteWiseMonitorPortalRole --assume-role-policy-document '{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "monitor.iotsitewise.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}'
    Windows command prompt
    aws iam create-role --role-name MySiteWiseMonitorPortalRole --assume-role-policy-document "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"Service\":\"monitor.iotsitewise.amazonaws.com\"},\"Action\":\"sts:AssumeRole\"}]}"

  2. Copiare il ruolo ARN dai metadati del ruolo nell'output. Quando si crea un portale, utilizzare questo ARN per associare il ruolo al portale. Per ulteriori informazioni sulla creazione di un portale, CreatePortalconsulta l'AWS IoT SiteWise API Reference.

  3. Allega la AWSIoTSiteWiseMonitorPortalAccess policy al ruolo o allega una policy che definisca autorizzazioni equivalenti.

    aws iam attach-role-policy --role-name MySiteWiseMonitorPortalRole --policy-arn arn:aws:iam::aws:policy/service-role/AWSIoTSiteWiseMonitorPortalAccess
Per collegare un ruolo del servizio a un portale esistente

  1. Per recuperare i dettagli esistenti del portale, eseguire il comando seguente. Sostituire portal-id con l'ID del portale.

    aws iotsitewise describe-portal --portal-id portal-id

    L'operazione restituisce una risposta contenente i dettagli del portale nel formato seguente.

    {
    "portalId": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE",
    "portalArn": "arn:aws:iotsitewise:region:account-id:portal/a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE",
    "portalName": "WindFarmPortal",
    "portalDescription": "A portal that contains wind farm projects for Example Corp.",
    "portalClientId": "E-1a2b3c4d5e6f_sn6tbqHVzLWVEXAMPLE",
    "portalStartUrl": "https://a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE.app.iotsitewise.aws",
    "portalContactEmail": "support@example.com",
    "portalStatus": {
        "state": "ACTIVE"
    },
    "portalCreationDate": "2020-04-29T23:01:52.90248068Z",
    "portalLastUpdateDate": "2020-04-29T00:28:26.103548287Z",
    "roleArn": "arn:aws:iam::123456789012:role/service-role/AWSIoTSiteWiseMonitorServiceRole_1aEXAMPLE"
}

  2. Per collegare un ruolo del servizio a un portale, eseguire il comando seguente. Sostituire il ruolo arn con l'ARN del ruolo del servizio e sostituire i parametri rimanenti con i valori esistenti del portale.

    aws iotsitewise update-portal \
  --portal-id portal-id \
  --role-arn role-arn \
  --portal-name portal-name \
  --portal-description portal-description \
  --portal-contact-email portal-contact-email

SiteWise Monitora gli aggiornamenti a AWSIoTSiteWiseMonitorServiceRole

È possibile visualizzare i dettagli sugli aggiornamenti di AWSIoTSiteWiseMonitorServiceRolefor SiteWise Monitor, a partire da quando questo servizio ha iniziato a tenere traccia delle modifiche. Per ricevere avvisi automatici sulle modifiche a questa pagina, iscriviti al feed RSS nella pagina della cronologia dei AWS IoT SiteWise documenti.

Modifica Descrizione Data

AWSIoTSiteWiseMonitorPortalAccess— Politica aggiornata

AWS IoT SiteWise ha aggiornato la politica di AWSIoTSiteWiseMonitorPortalAccessgestione per la funzionalità degli allarmi.

 27 maggio 2021

AWS IoT SiteWise ha iniziato a tenere traccia delle modifiche

AWS IoT SiteWise ha iniziato a tenere traccia delle modifiche relative al suo ruolo di servizio.

 15 dicembre 2020