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 les notifications AWS CodeStar

AWS CodeStar Les notifications utilisent des AWS Identity and Access Management rôles liés à un service (IAM). Un rôle lié à un service est un type unique de rôle IAM directement lié aux notifications. AWS CodeStar Les rôles liés au service sont prédéfinis par les AWS CodeStar notifications et incluent toutes les autorisations dont le service a besoin pour appeler d'autres AWS services en votre nom. Ce rôle est créé automatiquement la première fois que vous créez une règle de notification. Vous n'avez donc pas à créer le rôle.

Un rôle lié à un service facilite la configuration AWS CodeStar des notifications, car il n'est pas nécessaire d'ajouter des autorisations manuellement. AWS CodeStar Les notifications définissent les autorisations associées à ses rôles liés aux services et, sauf indication contraire, seules AWS CodeStar les notifications peuvent assumer ces 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.

Pour supprimer un rôle lié à un service, vous devez d'abord supprimer ses ressources associées. Cela protège vos ressources de AWS CodeStar notifications, car vous ne pouvez pas supprimer par inadvertance l'autorisation d'accès aux ressources.

Pour obtenir des informations sur les autres services qui prennent en charge les rôles liés à un service, consultez Services AWS qui fonctionnent avec IAM.

Autorisations de rôle liées au service pour les notifications AWS CodeStar

AWS CodeStar Les notifications utilisent le rôle AWSServiceRoleForCodeStarNotifications lié au service pour récupérer des informations sur les événements qui se produisent dans votre chaîne d'outils et envoyer des notifications aux cibles que vous spécifiez.

Le rôle AWSServiceRoleForCodeStarNotifications lié à un service fait confiance aux services suivants pour assumer le rôle :

La politique d'autorisation des rôles permet aux AWS CodeStar notifications d'effectuer les actions suivantes sur les ressources spécifiées :

Vous pouvez voir ces actions dans la déclaration de politique relative au rôle AWSServiceRoleForCodeStarNotifications lié à un service.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "events:PutTargets",
                "events:PutRule",
                "events:DescribeRule"
            ],
            "Resource": "arn:aws:events:*:*:rule/awscodestarnotifications-*",
            "Effect": "Allow"
        },
        {
            "Action": [
                "sns:CreateTopic"
            ],
            "Resource": "arn:aws:sns:*:*:CodeStarNotifications-*",
            "Effect": "Allow"
        },
        {
            "Action": [
                "codecommit:GetCommentsForPullRequest",
                "codecommit:GetCommentsForComparedCommit",
                "codecommit:GetDifferences",
                "chatbot:DescribeSlackChannelConfigurations",
                "chatbot:UpdateSlackChannelConfiguration",
                "codepipeline:ListActionExecutions"
            ],
            "Resource": "*",
            "Effect": "Allow"
        },
        {
            "Action": [
                "codecommit:GetFile"
            ],
            "Resource": "*",
            "Condition": {
                "StringNotEquals": {
                    "aws:ResourceTag/ExcludeFileContentFromNotifications": "true"
                }
            },
            "Effect": "Allow"
        }
    ]
}

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 Service-Linked Role Permissions (autorisations du rôle lié à un service) dans le IAM User Guide (guide de l'utilisateur IAM).

Création d'un rôle lié à un service pour les notifications AWS CodeStar

Vous n’avez pas besoin de créer manuellement un rôle lié à un service. Vous pouvez utiliser la console Developer Tools ou l' CreateNotificationRule API des AWS CLI SDK pour créer une règle de notification. Vous pouvez également appeler directement l'API. Quelle que soit la méthode que vous utilisez, le rôle lié au service est créé pour vous.

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. Vous pouvez utiliser la console Developer Tools ou l' CreateNotificationRule API des AWS CLI SDK pour créer une règle de notification. Vous pouvez également appeler directement l'API. Quelle que soit la méthode que vous utilisez, le rôle lié au service est créé pour vous.

Modification d'un rôle lié à un service pour les notifications AWS CodeStar

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

Supprimer un rôle lié à un service pour les notifications AWS CodeStar

Si vous n'avez plus besoin d'utiliser une fonction 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. Vous devez nettoyer les ressources de votre rôle lié à un service avant de pouvoir les supprimer manuellement. Pour AWS CodeStar les notifications, cela signifie supprimer toutes les règles de notification qui utilisent le rôle de service dans votre AWS compte.

Pour utiliser IAM et supprimer le rôle lié à un service

Utilisez la console IAM ou l' AWS CLI AWS Identity and Access Management API pour supprimer le rôle lié au AWSServiceRoleForCodeStarNotifications 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 AWS CodeStar liés au service Notifications

AWS CodeStar Les notifications permettent d'utiliser des rôles liés au service dans toutes les AWS régions où le service est disponible. Pour plus d'informations, consultez AWS Régions, points de terminaison et AWS CodeStar notifications.