Utilizza i 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)Gestisci il ruolo di servizio () CLIAggiornamenti 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à.

Utilizza i ruoli di servizio per AWS IoT SiteWise Monitor

Un ruolo di servizio è un IAMruolo che un servizio assume per eseguire azioni per conto dell'utente. Un IAM amministratore può creare, modificare ed eliminare un ruolo di servizio dall'internoIAM. Per ulteriori informazioni, vedere Creazione di un ruolo per delegare le autorizzazioni a un utente Servizio AWS nella Guida per l'IAMutente.

Per consentire agli utenti del portale Federated SiteWise Monitor di accedere alle tue AWS IAM Identity Center risorse AWS IoT SiteWisee alle tue risorse, devi 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 politica è gestita AWS e definisce il set di autorizzazioni che SiteWise Monitor utilizza per accedere alle risorse dell'utente AWS IoT SiteWise e IAM dell'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 IAM dell'Identity Center. La AWS IoT SiteWise console può creare e configurare il ruolo per te. Puoi modificare il ruolo in un IAM secondo momento. Gli utenti del portale avranno problemi a utilizzare i loro portali di SiteWise monitoraggio 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. A tale scopo, 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, alle risorse, ai dati degli asset e alla 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. Imposta le 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 Amministra i tuoi portali SiteWise Monitor e. CreateAccessPolicy

Gestire il 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 Crea un portale.

Trova il ruolo di servizio di un portale (console)

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

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

Crea un ruolo SiteWise del servizio 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 Crea 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. Seleziona Salva.

Crea un ruolo SiteWise del servizio Monitor (IAMconsole)

È possibile creare un ruolo di servizio dal modello di ruolo di servizio nella IAM console. Questo modello di ruolo include la politica 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 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. Scegliere Crea ruolo.

Modificare il ruolo di 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. Seleziona Salva.

Gestire il ruolo del servizio di SiteWise monitoraggio () CLI

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

Trova il ruolo di 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.

Crea il 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. Questo esempio crea un ruolo denominato in base MySiteWiseMonitorPortalRole a una politica di attendibilità memorizzata in una JSON stringa.

    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. Copia il ruolo ARN dai metadati del ruolo nell'output. Quando crei un portale, lo usi ARN per associare il ruolo al tuo portale. Per ulteriori informazioni sulla creazione di un portale, vedere CreatePortalnella Guida AWS IoT SiteWise APIdi riferimento.

  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. Replace (Sostituisci) 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. Replace (Sostituisci) role-arn con il ruolo ARN di servizio e sostituisce 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 di 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 RSS feed 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