View a markdown version of this page

Usa ruoli collegati al servizio e autorizzazioni di ruolo per Connect Customer - Cliente Amazon Connect
Cosa sono i ruoli orientati ai servizi (SLR) e perché sono importanti?Service-linked autorizzazioni di ruoloCrea un ruolo collegato al servizio per Connect CustomerPer le istanze create prima di ottobre 2018Per i domini dei profili dei clienti creati prima del 31 gennaio 2025 e configurati con una chiave KMS del cliente per crittografare i datiModifica un ruolo collegato al servizio per Connect CustomerVerifica delle autorizzazioni per un ruolo orientato ai servizi per Amazon LexEliminare un ruolo collegato al servizio per Connect CustomerRegioni supportate per i ruoli collegati al servizio Connect Customer

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

Usa ruoli collegati al servizio e autorizzazioni di ruolo per Connect Customer

Cosa sono i ruoli orientati ai servizi (SLR) e perché sono importanti?

Connect Customer utilizza AWS Identity and Access Management ruoli collegati ai servizi (IAM). Un ruolo collegato al servizio è un tipo unico di ruolo IAM collegato direttamente a un'istanza Connect Customer.

Service-linked i ruoli sono predefiniti da Connect Customer e includono tutte le autorizzazioni richieste da Connect Customer per chiamare altri AWS servizi per tuo conto.

È necessario abilitare i ruoli collegati ai servizi in modo da poter utilizzare le nuove funzionalità in Connect Customer, come il supporto per i tag, la nuova interfaccia utente nei profili di gestione degli utenti e di routing e le code con supporto. CloudTrail

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

Service-linked autorizzazioni di ruolo per Connect Customer

Connect Customer utilizza il ruolo collegato al servizio con il prefisso AWSServiceRoleForAmazonConnect_ unique-id — Concede ad Amazon Connect l'autorizzazione ad AWS accedere alle risorse per tuo conto.

Il ruolo collegato al servizio AWSServiceRoleForAmazonConnect con prefisso prevede che i seguenti servizi assumano il ruolo:

  • connect.amazonaws.com

La politica di autorizzazione dei AmazonConnectServiceLinkedRolePolicyruoli consente a Connect Customer di completare le seguenti azioni sulle risorse specificate:

  • Azione: tutte le azioni Connect Customerconnect:*, su tutte le risorse Connect Customer.

  • Azione: iam:DeleteRole IAM per consentire l'eliminazione del ruolo collegato ai servizi.

  • Azione: s3:GetObject, s3:DeleteObject, s3:GetBucketLocation, e GetBucketAcl Amazon S3 per il bucket S3 specificato per le conversazioni registrate.

    Inoltre, concede s3:PutObject, s3:PutObjectAcl e s3:GetObjectAcl al bucket specificato per i report esportati.

  • Azione: Amazon CloudWatch Logs logs:CreateLogStream e logs:PutLogEvents al gruppo CloudWatch Logs specificato per la registrazione del flusso. logs:DescribeLogStreams

  • Azione: lex:ListBots, lex:ListBotAliases Amazon Lex per tutti i bot creati nell'account tra tutte le regioni.

  • Azione: Connetti i profili dei clienti profile:* su tutte le risorse Connect Customer Profiles con il prefisso di amazon-connect- dominio e le risorse del modello associati alla tua istanza Connect Customer, ad eccezione delle seguenti azioni che sono esplicitamente negate:

    • profile:CreateDomain

    • profile:UpdateDomain

    • profile:DeleteDomain

    • profile:CreateEventStream

    • profile:DeleteEventStream

    • profile:DeleteWorkflow

    • profile:DeleteProfileKey

    • profile:UntagResource

    • profile:TagResource

    • profile:CreateIntegrationWorkflow

    Inoltre, le seguenti azioni sono consentite su tutte le risorse: profile:ListRecommenderRecipesprofile:ListAccountIntegrations, e. profile:ListDomains

    Nota

    Ogni istanza Connect Customer può essere associata a un solo dominio alla volta. Tuttavia, puoi collegare qualsiasi dominio a un'istanza Connect Customer. Cross-domain l'accesso all'interno dello stesso account AWS e della stessa regione viene abilitato automaticamente per tutti i domini che iniziano con il prefissoamazon-connect-. Per limitare l'accesso tra domini, puoi utilizzare istanze Connect Customer separate per partizionare logicamente i dati o utilizzare nomi di dominio Customer Profiles all'interno della stessa istanza che non iniziano con il amazon-connect- prefisso, impedendo così l'accesso tra domini.

  • Azione: collega gli agenti AI wisdom:* a tutte le risorse Connect Customer Connect AI agent con il tag di risorsa 'AmazonConnectEnabled':'True' associato alla tua istanza Connect Customer, ad eccezione delle seguenti azioni che vengono esplicitamente negate:

    • wisdom:DeleteAssistant

    • wisdom:DeleteKnowledgeBase

  • Azione: Amazon CloudWatch Metrics pubblicherà cloudwatch:PutMetricData i parametri di utilizzo di Connect Customer per un'istanza sul tuo account.

  • Azione: Amazon Pinpoint SMS e Voice sms-voice:DescribePhoneNumbers e consentire sms-voice:SendTextMessage a Connect Customer di inviare SMS.

  • Azione: Amazon Pinpoint mobiletargeting:SendMessages per consentire a Connect Customer di inviare notifiche push.

  • Azione: pool di utenti Amazon Cognito cognito-idp:DescribeUserPool e consentire cognito-idp:ListUserPoolClients a Connect Customer di accedere a determinate operazioni di lettura sui pool di utenti Amazon Cognito, risorse che dispongono AmazonConnectEnabled di un tag di risorsa.

  • Azione: Amazon Chime SDK Voice Connector per consentire l'accesso chime:GetVoiceConnector in lettura per Connect Customer su tutte le risorse Amazon Chime SDK Voice Connector che dispongono di un tag di risorsa. 'AmazonConnectEnabled':'True'

  • Azione: chime:ListVoiceConnectors del connettore vocale dell’SDK di Amazon Chime per tutti i connettori vocali dell’SDK di Amazon Chime creati nell’account in tutte le Regioni.

  • Azione: WhatsApp integrazione Connect Customer Messaging. Concede a Connect Customer le autorizzazioni per le seguenti API social di messaggistica con l'utente AWS finale:

    • social-messaging:SendWhatsAppMessage

    • social-messaging:PostWhatsAppMessageMedia

    • social-messaging:GetWhatsAppMessageMedia

    • social-messaging:GetLinkedWhatsAppBusinessAccountPhoneNumber

    Le API Social sono limitate alle risorse relative ai numeri di telefono abilitate per Connect Customer. Un numero di telefono viene contrassegnato con AmazonConnectEnabled : True quando viene importato in un'istanza Connect Customer.

  • Azione: integrazione del modello di WhatsApp messaggio Connect Customer Messaging. Concede a Connect Customer l'autorizzazione a chiamare le AWS End User Messaging Social API. È possibile che vengano elencati gli account WhatsApp aziendali di un account. AWS Inoltre, possono essere elencati i modelli di un account WhatsApp aziendale e i dettagli di un modello possono essere recuperati purché l'account WhatsApp aziendale sia taggatoAmazonConnectEnabled: True.

    • social-messaging:ListLinkedWhatsAppBusinessAccounts

    • social-messaging:GetWhatsAppMessageTemplate

    • social-messaging:ListWhatsAppMessageTemplates

  • Azione: Amazon SES

    • ses:DescribeReceiptRule

    • ses:UpdateReceiptRule

    su tutte le regole di ricezione di Amazon SES. Utilizzato per inviare e ricevere e-mail.

    • ses:DeleteEmailIdentityper l'identità del dominio SES {instance-alias} .email.connect.aws. Utilizzato per la gestione dei domini e-mail fornita da Connect Customer.

    • ses:SendRawEmailper l'invio di e-mail con un set di configurazione SES fornito da Connect Customer (configuration-set-for-connect-). DO-NOT-DELETE

    • iam:PassRole per il ruolo di servizio di AmazonConnectEmailSESAccessRole utilizzato da Amazon SES. Per la gestione delle regole di ricezione Amazon SES, Amazon SES richiede l’assegnazione di un ruolo, che viene presupposto.

  • Azione: Amazon Polly

    • polly:ListLexicons

    • polly:DescribeVoices

    • polly:SynthesizeSpeech

Quando si abilitano funzionalità aggiuntive in Connect Customer, vengono aggiunte le seguenti autorizzazioni per il ruolo collegato al servizio per accedere alle risorse associate a tali funzionalità utilizzando politiche in linea:

  • Azione: firehose:DescribeDeliveryStream e firehose:PutRecord di Amazon Data Firehose e firehose:PutRecordBatch per il flusso di distribuzione definito per i flussi di eventi degli agenti e i record dei contatti.

  • Azione: kinesis:PutRecord, kinesis:PutRecords e kinesis:DescribeStream del flusso di dati Amazon Kinesis per il flusso specificato per i flussi di eventi degli agenti e i record dei contatti.

  • Azione: lex:PostContent Amazon Lex per i bot aggiunti all'istanza.

  • Azione: Connect Customer Voice-ID voiceid:* per i domini Voice ID associati alla tua istanza.

  • Azione: EventBridge events:PutRule e events:PutTargets per la EventBridge regola gestita da Connect Customer per la pubblicazione dei record CTR per i domini Voice ID associati.

  • Azione: campagne in uscita

    • connect-campaigns:CreateCampaign

    • connect-campaigns:DeleteCampaign

    • connect-campaigns:DescribeCampaign

    • connect-campaigns:UpdateCampaignName

    • connect-campaigns:GetCampaignState

    • connect-campaigns:GetCampaignStateBatch

    • connect-campaigns:ListCampaigns

    • connect-campaigns:UpdateOutboundCallConfig

    • connect-campaigns:UpdateDialerConfig

    • connect-campaigns:PauseCampaign

    • connect-campaigns:ResumeCampaign

    • connect-campaigns:StopCampaign

    per tutte le operazioni relative alle campagne in uscita.

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 Guida per l'utente IAM.

Crea un ruolo collegato al servizio per Connect Customer

Non hai bisogno di creare manualmente un ruolo collegato ai servizi. Quando crei una nuova istanza in Amazon Connect nel Console di gestione AWS, Connect Customer crea il ruolo collegato al servizio per te.

Se elimini questo ruolo collegato al servizio, è possibile ricrearlo seguendo lo stesso processo utilizzato per ricreare il ruolo nell’account. Quando crei una nuova istanza in Amazon Connect, Connect Customer crea nuovamente il ruolo collegato al servizio per te.

È possibile utilizzare la console IAM anche per creare un ruolo orientato ai servizi con il caso di utilizzo Amazon Connect – Accesso completo. Nella CLI IAM o nell’API IAM, crea un ruolo collegato al servizio con il nome servizio connect.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.

Per le istanze create prima di ottobre 2018

Suggerimento

Hai problemi ad accedere per gestire il tuo AWS account? Non sai chi gestisce il tuo account AWS ? Per ricevere aiuto, consulta Risoluzione dei problemi relativi all’accesso all’account AWS.

Se la tua istanza Connect Customer è stata creata prima di ottobre 2018, non hai configurato ruoli collegati al servizio. Per creare un ruolo orientato ai servizi, nella pagina Panoramica dell'account, scegli Crea ruolo orientato ai servizi, come mostrato nell'immagine seguente.

Pagina Panoramica dell'account, pulsante Crea ruolo orientato ai servizi.

Per un elenco delle autorizzazioni IAM richieste per creare il ruolo orientato ai servizi, consulta Pagina di panoramica nell'argomento Autorizzazioni richieste per l'utilizzo di policy IAM personalizzate per gestire l'accesso alla console Connect Customer.

Per i domini dei Profili dei clienti creati prima del 31 gennaio 2025 e configurati con una chiave KMS del cliente per crittografare i dati, devi concedere le autorizzazioni KMS aggiuntive alla tua istanza Amazon Connect.

Se il dominio del profilo cliente associato è stato creato prima del 31 gennaio 2025 e il dominio utilizza una chiave Customer-Managed KMS (CMK) per la crittografia, per abilitare l'applicazione CMK da parte dell'istanza Connect, intraprendi le seguenti azioni:

  1. Fornisci l'autorizzazione Service-Linked Role (SLR) di un' Connect Customer istanza per utilizzare AWS KMS le chiavi del tuo dominio Customer Profiles accedendo alla pagina Customer Profiles nella Console di gestione Connect Customer AWS e scegliendo l'autorizzazione Update KMS.

    Scegli il pulsante Aggiorna autorizzazione KMS per concedere le autorizzazioni KMS per il ruolo collegato al servizio dell'istanza Connect Customer.

  2. Crea un ticket di assistenza con il team Connect Customer Profiles per richiedere l'applicazione delle autorizzazioni CMK per il tuo account.

Per un elenco delle autorizzazioni IAM ad aggiornare la tua Connect Customer istanza, consulta l'autorizzazione richiesta per le politiche IAM personalizzate per. Pagina di Profili cliente

Modifica un ruolo collegato al servizio per Connect Customer

Connect Customer non consente di modificare il ruolo collegato al servizio con AWSServiceRoleForAmazonConnect prefisso. 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.

Verifica delle autorizzazioni per un ruolo orientato ai servizi per Amazon Lex

  1. Nel pannello di navigazione della console IAM, seleziona Ruoli.

  2. Scegliere il nome del ruolo da modificare.

Eliminare un ruolo collegato al servizio per Connect Customer

Non è necessario eliminare manualmente il ruolo con AWSServiceRoleForAmazonConnect prefisso. Quando elimini la tua istanza Amazon Connect in Console di gestione AWS, Connect Customer pulisce le risorse ed elimina il ruolo collegato al servizio per te.

Regioni supportate per i ruoli collegati al servizio Connect Customer

Connect Customer supporta l'utilizzo di ruoli collegati al servizio in tutte le regioni in cui il servizio è disponibile. Per ulteriori informazioni, consulta AWS Regioni ed endpoint.