Utilisation de rôles liés à un service pour Amazon AppIntegrations - Amazon Connect

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation de rôles liés à un service pour Amazon AppIntegrations

Amazon AppIntegrations utilise des rôles AWS Identity and Access Management liés à un service (IAM). Un rôle lié à un service est un type unique de rôle IAM directement lié à Amazon. AppIntegrations Les rôles liés au service sont prédéfinis par Amazon AppIntegrations et incluent toutes les autorisations requises par le service pour appeler d'autres AWS services en votre nom.

Un rôle lié à un service facilite la configuration d'Amazon AppIntegrations , car vous n'avez pas à ajouter manuellement les autorisations nécessaires. Amazon AppIntegrations définit les autorisations associées à ses rôles liés aux services et, sauf indication contraire, seul Amazon AppIntegrations peut assumer ses rôles. Les autorisations définies comprennent la politique d’approbation et la politique d’autorisation. De plus, cette politique d’autorisation ne peut pas être attachée à une autre entité IAM.

Vous pouvez supprimer un rôle lié à un service uniquement après la suppression préalable de ses ressources connexes. Cela protège vos AppIntegrations ressources Amazon, car vous ne pouvez pas supprimer par inadvertance l'autorisation d'accès aux ressources.

Pour plus d'informations sur les autres services qui prennent en charge les rôles liés aux services, consultez la section AWS Services qui fonctionnent avec IAM et recherchez les services dont la valeur est Oui dans la colonne Rôles liés aux services. Sélectionnez un Oui ayant un lien pour consulter la documentation du rôle lié à un service, pour ce service.

Autorisations de rôle liées à un service pour Amazon AppIntegrations

Amazon AppIntegrations utilise le rôle lié à un service nommé AWSServiceRoleForAppIntegrationsqui permet d' AppIntegrations accéder aux services et ressources AWS en votre nom.

Le rôle AWSService RoleForAppIntegrations lié à un service fait confiance au service suivant pour assumer le rôle :

  • app-integrations.amazonaws.com

La politique d'autorisation des rôles nommée AppIntegrationsServiceLinkedRolePolicy permet AppIntegrations à Amazon d'effectuer les actions suivantes sur les ressources spécifiées :

{ "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-*" } ] }
  • Action : cloudwatch:PutMetricData sur "*" en utilisant la condition StringEquals "cloudwatch:namespace": "AWS/AppIntegrations".

  • Action : appflow:DescribeConnectorEntity et appflow:ListConnectorEntities sur "*".

  • Action : appflow:DescribeConnectorProfiles et appflow:UseConnectorProfile sur arn:aws:appflow:*:*:connector-profile/*

  • Action : appflow:DeleteFlow, appflow:DescribeFlow, appflow:DescribeFlowExecutionRecords, appflow:StartFlow, appflow:StopFlow et appflow:UpdateFlow sur arn:aws:appflow:*:*:flow/FlowCreatedByAppIntegrations-* en utilisant la condition StringEquals "aws:ResourceTag/AppIntegrationsManaged": "true".

  • Action : appflow:TagResource sur arn:aws:appflow:*:*:flow/FlowCreatedByAppIntegrations-* en utilisant la condition ForAllValues:StringEquals aws:TagKeys AppIntegrationsManaged.

Vous devez configurer les autorisations de manière à permettre à une entité IAM (comme un utilisateur, un groupe ou un rôle) de créer, modifier ou supprimer un rôle lié à un service. Pour plus d’informations, consultez Autorisations de rôles liés à un service dans le Guide de l’utilisateur IAM.

Création d'un rôle lié à un service pour Amazon AppIntegrations

Vous n’avez pas besoin de créer manuellement un rôle lié à un service. Lorsque vous créez une intégration de données ou d'événements à l'aide du widget Amazon Q in Connect, Customer Profiles ou Tasks d'Amazon Connect dans l' AWS Management Console AWS API, Amazon AppIntegrations crée le rôle lié au service pour vous. AWS CLI

Important

Ce rôle lié à un service peut apparaître dans votre compte si vous avez effectué une action dans un autre service qui utilise les fonctions prises en charge par ce rôle. En outre, si vous avez créé de nouvelles AppIntegrations ressources Amazon après le 30 septembre 2022, date à laquelle l'entreprise a commencé à prendre en charge les rôles liés aux services, Amazon AppIntegrations a créé le AWSService RoleForAppIntegrations rôle dans votre compte. Pour en savoir plus, consultez Un nouveau rôle est apparu dans mon compte IAM.

Si vous supprimez ce rôle lié à un service et que vous avez ensuite besoin de le recréer, vous pouvez utiliser la même procédure pour recréer le rôle dans votre compte. Lorsque vous créez une intégration de données ou d'événements à l'aide du widget Amazon Q in Connect, Customer Profiles ou Tasks d'Amazon Connect, Amazon AppIntegrations crée à nouveau le rôle lié au service pour vous.

Vous pouvez également utiliser la console IAM pour créer un rôle lié à un service avec le AppIntegrationscas d'utilisation. Dans l'API AWS CLI ou dans l' AWS API, créez un rôle lié à un service avec le nom du app-integrations.amazonaws.com service. Pour plus d’informations, consultez Création d’un rôle lié à un service dans le Guide de l’utilisateur IAM. Si vous supprimez ce rôle lié à un service, vous pouvez utiliser ce même processus pour créer le rôle à nouveau.

Modification d'un rôle lié à un service pour Amazon AppIntegrations

Amazon AppIntegrations ne vous autorise pas à modifier le rôle AWSService RoleForAppIntegrations lié au service. Une fois que vous avez créé un rôle lié à un service, vous ne pouvez pas changer le nom du rôle, car plusieurs entités peuvent faire référence à ce rôle. Néanmoins, vous pouvez modifier la description du rôle à l’aide d’IAM. Pour plus d’informations, consultez Modification d’un rôle lié à un service dans le IAM Guide de l’utilisateur.

Supprimer un rôle lié à un service pour Amazon AppIntegrations

Si vous n’avez plus besoin d’utiliser une fonctionnalité ou un service qui nécessite un rôle lié à un service, nous vous recommandons de supprimer ce rôle. De cette façon, vous n’avez aucune entité inutilisée qui n’est pas surveillée ou gérée activement. Cependant, vous devez nettoyer les ressources de votre rôle lié à un service avant de pouvoir les supprimer manuellement. Vous devez d'abord supprimer vos associations d'intégration de données et d'événements dans la AWS console, puis supprimer vos intégrations de données et d'événements à l'aide du AWS CLI.

Note

Si le AppIntegrations service Amazon utilise le rôle lorsque vous essayez de supprimer les ressources, la suppression risque d'échouer. Si cela se produit, patientez quelques minutes et réessayez.

Pour supprimer les associations d'intégration de données utilisées par le AWSService RoleForAppIntegrations dans la AWS console
  1. Accédez à la section Amazon Q in Connect de la console Amazon Connect et choisissez le nom de l’association d’intégration de données à supprimer.

  2. Choisissez Supprimer sur le côté droit de la section Détails de l'intégration.

  3. Dans la fenêtre contextuelle, saisissez le nom de l'intégration pour confirmation et choisissez Supprimer.

Pour supprimer les intégrations de données utilisées à l' AWSServiceRoleForAppIntegrations aide du AWS CLI
  1. Répertoriez vos intégrations de données afin d'afficher les noms de vos intégrations existantes.

    aws appintegrations list-data-integrations

  2. Supprimez chaque intégration en utilisant le nom de l'intégration de données.

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

Pour supprimer les associations d'intégration d'événements utilisées par le AWSService RoleForAppIntegrations dans la AWS console
  1. Accédez à la section Profils des clients ou Tâches de la console Amazon Connect et choisissez le nom de l'association d'intégration d'événements à supprimer.

  2. Une fois que vous avez choisi une intégration d'événements dans la section Tâches, une fenêtre contextuelle apparaît. Cliquez sur le bouton Supprimer la connexion et saisissez le mot remove pour supprimer votre association d'intégration d'événements.

Pour supprimer les intégrations d'événements utilisées à l' AWSServiceRoleForAppIntegrations aide du AWS CLI
  1. Répertoriez vos intégrations d'événements afin d'afficher les noms de vos intégrations existantes.

    aws appintegrations list-event-integrations

  2. Supprimez chaque intégration en utilisant le nom de l'intégration de données.

    aws appintegrations delete-event-integration --name EVENT_INTEGRATION_NAME

Pour supprimer manuellement le rôle lié à un service à l’aide d’IAM

Utilisez la console IAM, le AWS CLI, ou l' AWS API pour supprimer le rôle lié au AWSService RoleForAppIntegrations service. Pour plus d’informations, consultez Suppression d’un rôle lié à un service dans le Guide de l’utilisateur IAM.

Régions prises en charge pour les rôles AppIntegrations liés aux services Amazon

Amazon AppIntegrations prend en charge l'utilisation de rôles liés à un service dans toutes les régions où le service est disponible. Pour plus d'informations, consultez Régions et points de terminaison AWS.

Vous pouvez utiliser le AWSService RoleForAppIntegrations rôle dans les régions suivantes.

Nom de la région Identité de la région Support sur Amazon AppIntegrations
USA Est (Virginie du Nord) us-east-1 Oui
USA Ouest (Oregon) us-west-2 Oui
Asie-Pacifique (Mumbai) ap-south-1 Oui
Asie-Pacifique (Séoul) ap-northeast-2 Oui
Asie-Pacifique (Singapour) ap-southeast-1 Oui
Asie-Pacifique (Sydney) ap-southeast-2 Oui
Asie-Pacifique (Tokyo) ap-northeast-1 Oui
Canada (Centre) ca-central-1 Oui
Europe (Francfort) eu-central-1 Oui
Europe (Londres) eu-west-2 Oui
Afrique (Le Cap) af-south-1 Oui