View a markdown version of this page

Utilizzo di ruoli collegati ai servizi per Amazon AppIntegrations - Cliente Amazon Connect

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 di ruoli collegati ai servizi per Amazon AppIntegrations

Amazon AppIntegrations utilizza ruoli collegati ai servizi AWS Identity and Access Management (IAM). Un ruolo collegato ai servizi è un tipo unico di ruolo IAM collegato direttamente ad Amazon. AppIntegrations Service-linked i ruoli sono predefiniti da Amazon AppIntegrations e includono tutte le autorizzazioni richieste dal servizio per chiamare altri AWS servizi per tuo conto.

Un ruolo collegato al servizio semplifica la configurazione di Amazon AppIntegrations perché non è necessario aggiungere manualmente le autorizzazioni necessarie. Amazon AppIntegrations definisce le autorizzazioni dei suoi ruoli collegati ai servizi e, se non diversamente definito, solo Amazon può assumerne i ruoli. AppIntegrations Le autorizzazioni definite includono la policy di attendibilità e la policy delle autorizzazioni che non può essere allegata a nessun’altra entità IAM.

È possibile eliminare un ruolo collegato al servizio solo dopo avere eliminato le risorse correlate. Questo protegge le tue AppIntegrations risorse Amazon perché non puoi rimuovere inavvertitamente l'autorizzazione di accesso alle risorse.

Per informazioni su altri servizi che supportano i ruoli collegati ai servizi, consulta AWS Servizi che funzionano con IAM e cerca i servizi che hanno nella colonna dei ruoli. Service-linked Scegliere in corrispondenza di un link per visualizzare la documentazione relativa al ruolo collegato al servizio per tale servizio.

Service-linked autorizzazioni di ruolo per Amazon AppIntegrations

Amazon AppIntegrations utilizza il ruolo collegato ai servizi denominato AWSServiceRoleForAppIntegrations che consente di accedere ai servizi e alle risorse AWS AppIntegrations per tuo conto.

Il ruolo AWSServiceRoleForAppIntegrations collegato ai servizi prevede che il seguente servizio assuma il ruolo:

  • app-integrations.amazonaws.com

La politica di autorizzazione dei ruoli denominata AppIntegrationsServiceLinkedRolePolicy consente AppIntegrations ad Amazon di completare le seguenti azioni sulle risorse specificate:

JSON
{ "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "cloudwatch:PutMetricData" ], "Resource": "*", "Condition": { "StringEquals": { "cloudwatch:namespace": "AWS/AppIntegrations" } } }, { "Effect": "Allow", "Action": [ "appflow:DescribeConnectorEntity", "appflow:ListConnectorEntities" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "appflow:DescribeConnectorProfiles", "appflow:UseConnectorProfile" ], "Resource": "arn:aws:appflow:*:*:connector-profile/*" }, { "Effect": "Allow", "Action": [ "appflow:DeleteFlow", "appflow:DescribeFlow", "appflow:DescribeFlowExecutionRecords", "appflow:StartFlow", "appflow:StopFlow", "appflow:UpdateFlow" ], "Condition": { "StringEquals": { "aws:ResourceTag/AppIntegrationsManaged": "true" } }, "Resource": "arn:aws:appflow:*:*:flow/FlowCreatedByAppIntegrations-*" }, { "Effect": "Allow", "Action": [ "appflow:TagResource" ], "Condition": { "ForAllValues:StringEquals": { "aws:TagKeys": [ "AppIntegrationsManaged" ] } }, "Resource": "arn:aws:appflow:*:*:flow/FlowCreatedByAppIntegrations-*" } ] }
  • Azione: cloudwatch:PutMetricData su "*" utilizzando la condizione StringEquals "cloudwatch:namespace": "AWS/AppIntegrations".

  • Azione: appflow:DescribeConnectorEntity e appflow:ListConnectorEntities su "*".

  • Azione: appflow:DescribeConnectorProfiles e appflow:UseConnectorProfile su arn:aws:appflow:*:*:connector-profile/*

  • Azione: appflow:DeleteFlow, appflow:DescribeFlow, appflow:DescribeFlowExecutionRecords, appflow:StartFlow, appflow:StopFlow e appflow:UpdateFlow su arn:aws:appflow:*:*:flow/FlowCreatedByAppIntegrations-* utilizzando la condizione StringEquals "aws:ResourceTag/AppIntegrationsManaged": "true".

  • Azione: appflow:TagResource su arn:aws:appflow:*:*:flow/FlowCreatedByAppIntegrations-* utilizzando la condizione ForAllValues:StringEquals aws:TagKeys AppIntegrationsManaged.

Per consentire a un'entità IAM (come un utente, un gruppo o un ruolo) di creare, modificare o eliminare un ruolo collegato al servizio è necessario configurare le relative autorizzazioni. Per ulteriori informazioni, consulta le autorizzazioni dei Service-linked ruoli nella IAM User Guide.

Creazione di un ruolo collegato al servizio per Amazon AppIntegrations

Non hai bisogno di creare manualmente un ruolo collegato ai servizi. Quando crei un'integrazione di dati o eventi utilizzando il widget agent assist, Customer Profiles o Tasks in Connect Customer nell' Console di gestione AWS API o nell' AWS API AWS CLI, Amazon AppIntegrations crea il ruolo collegato al servizio per te.

Importante

Questo ruolo collegato al servizio può apparire nell'account, se è stata completata un'operazione in un altro servizio che utilizza le caratteristiche supportate da questo ruolo. Inoltre, se hai creato nuove AppIntegrations risorse Amazon dopo il 30 settembre 2022, quando ha iniziato a supportare i ruoli collegati ai servizi, Amazon ha AppIntegrations creato il AWSServiceRoleForAppIntegrations ruolo nel tuo account. Per ulteriori informazioni, consulta Un nuovo ruolo è apparso nel mio account IAM.

Se elimini questo ruolo collegato al servizio, è possibile ricrearlo seguendo lo stesso processo utilizzato per ricreare il ruolo nell’account. Quando crei un'integrazione di dati o eventi utilizzando il widget agent assist, Customer Profiles o Tasks in Connect Customer, Amazon AppIntegrations crea nuovamente il ruolo collegato al servizio per te.

Puoi anche utilizzare la console IAM per creare un ruolo collegato al servizio con il caso d'uso. AppIntegrations Nell'API AWS CLI o nell' AWS API, crea un ruolo collegato al servizio con il nome del servizio. app-integrations.amazonaws.com Per ulteriori informazioni, consulta Creazione di un ruolo collegato ai servizi nella Guida per l’utente IAM. Se elimini il ruolo collegato ai servizi, è possibile utilizzare lo stesso processo per crearlo nuovamente.

Modifica di un ruolo collegato al servizio per Amazon AppIntegrations

Non puoi modificare il ruolo AWSServiceRoleForAppIntegrations collegato al servizio con Amazon. AppIntegrations Dopo avere creato un ruolo collegato al servizio, non sarà possibile modificarne il nome perché varie entità potrebbero farvi riferimento. È possibile tuttavia modificarne la descrizione utilizzando IAM. Per ulteriori informazioni, consulta Modifica di un ruolo collegato al servizio nella Guida per l’utente di IAM.

Eliminazione di un ruolo collegato al servizio per Amazon AppIntegrations

Se non è più necessario utilizzare una funzionalità o un servizio che richiede un ruolo collegato al servizio, ti consigliamo di eliminare il ruolo. In questo modo non sarà più presente un'entità non utilizzata che non viene monitorata e gestita attivamente. Tuttavia, è necessario effettuare la pulizia delle risorse associate al ruolo collegato al servizio prima di poterlo eliminare manualmente. Devi prima eliminare le associazioni di integrazione dei dati e degli eventi nella AWS Console, quindi eliminare le integrazioni di dati ed eventi utilizzando il. AWS CLI

Nota

Se il AppIntegrations servizio Amazon utilizza il ruolo quando provi a eliminare le risorse, l'eliminazione potrebbe non riuscire. In questo caso, attendi alcuni minuti e quindi ripeti l’operazione.

Per eliminare le associazioni di integrazione dei dati utilizzate da AWSServiceRoleForAppIntegrations nel AWS Console
  1. Vai alla sezione di assistenza per gli agenti della Connect Customer Console e scegli il nome dell'associazione di integrazione dei dati che desideri eliminare.

  2. Seleziona Elimina sul lato destro della sezione Dettagli integrazione.

  3. Nella finestra pop-up, inserisci il nome dell'integrazione, quindi scegli Elimina.

Per eliminare le integrazioni di dati utilizzate da AWSServiceRoleForAppIntegrations AWS CLI
  1. Elenca le tue integrazioni di dati per visualizzare i nomi delle integrazioni esistenti.

    aws appintegrations list-data-integrations

  2. Elimina ogni integrazione utilizzando il nome dell'integrazione dei dati.

    aws appintegrations delete-data-integration --data-integration-identifier DATA_INTEGRATION_NAME

Per eliminare le associazioni di integrazione degli eventi utilizzate da nel AWSServiceRoleForAppIntegrations AWS Console
  1. Vai alla sezione Profili cliente o Attività della Connect Customer Console e scegli il nome dell'associazione di integrazione degli eventi che desideri eliminare.

  2. Dopo aver scelto l'integrazione di un evento nella sezione Attività, verrà visualizzato un pop-up. Scegli il pulsante Rimuovi connessione e inserisci la parola rimuovi per eliminare l'associazione di integrazione degli eventi.

Per eliminare le integrazioni di eventi utilizzate da AWSServiceRoleForAppIntegrations AWS CLI
  1. Elenca le integrazioni degli eventi per visualizzare i nomi delle integrazioni esistenti.

    aws appintegrations list-event-integrations

  2. Elimina ogni integrazione utilizzando il nome dell'integrazione dei dati.

    aws appintegrations delete-event-integration --name EVENT_INTEGRATION_NAME

Per eliminare manualmente il ruolo collegato ai servizi mediante IAM

Usa la console IAM AWS CLI, l'API o l' AWS API per eliminare il ruolo AWSServiceRoleForAppIntegrations collegato al servizio. Per ulteriori informazioni, consulta Eliminazione del ruolo collegato ai servizi nella Guida per l'utente IAM.

Regioni supportate per i ruoli collegati ai servizi Amazon AppIntegrations

Amazon AppIntegrations supporta l'utilizzo di ruoli collegati ai servizi in tutte le regioni in cui il servizio è disponibile. Per ulteriori informazioni, consulta Regioni ed endpoint di AWS.

Puoi utilizzare il AWSServiceRoleForAppIntegrations ruolo nelle seguenti regioni.

Nome della Regione Identità della Regione Assistenza in Amazon AppIntegrations
Stati Uniti orientali (Virginia settentrionale) us-east-1
Stati Uniti occidentali (Oregon) us-west-2
Asia Pacifico (Mumbai) ap-south-1
Asia Pacifico (Seoul) ap-northeast-2
Asia Pacifico (Singapore) ap-southeast-1
Asia Pacifico (Sydney) ap-southeast-2
Asia Pacifico (Tokyo) ap-northeast-1
Canada (Centrale) ca-central-1
Europa (Francoforte) eu-central-1
Europa (Londra) eu-west-2
Africa (Città del Capo) af-south-1