Création ou configuration d'une cible de règle de notification - Console Outils pour développeur

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.

Création ou configuration d'une cible de règle de notification

Les cibles des règles de notification sont les sujets Amazon SNS ou les clients AWS Chatbot configurés pour les canaux Slack ou Microsoft Teams.

Un client AWS Chatbot doit être créé pour que vous puissiez sélectionner un client comme cible. Lorsque vous choisissez un client AWS Chatbot comme cible pour une règle de notification, une rubrique Amazon SNS est configurée pour ce client AWS Chatbot avec toutes les politiques requises pour l'envoi de notifications au canal Slack ou Microsoft Teams. Vous n'avez pas à configurer les rubriques Amazon SNS existantes pour le client AWS Chatbot.

Vous pouvez créer des cibles de règle de notification Amazon SNS dans la console Outils pour développeurs lorsque vous créez une règle de notification. La stratégie qui permet d'envoyer des notifications à cette rubrique est appliquée automatiquement. C'est le moyen le plus simple de créer une cible pour une règle de notification. Pour plus d’informations, consultez Création d'une règle de notification.

Si vous utilisez une rubrique Amazon SNS existante, vous devez la configurer avec une stratégie d'accès qui permet à la ressource d'envoyer des notifications à cette rubrique. Pour obtenir un exemple, consultez Configurer une rubrique Amazon SNS pour les notifications.

Note

Si vous souhaitez utiliser une rubrique Amazon SNS existante au lieu d'en créer une nouvelle, dans Targets (Cibles), choisissez son ARN. Assurez-vous que la rubrique dispose de la stratégie d'accès appropriée et que la liste d'abonnés contient uniquement les utilisateurs autorisés à voir des informations sur le pipeline. Si la rubrique Amazon SNS a été utilisée pour les CodeCommit notifications avant le 5 novembre 2019, elle contiendra une politique autorisant CodeCommit la publication sur cette rubrique contenant des autorisations différentes de celles requises pour AWS CodeStar les notifications. L'utilisation de ces rubriques n'est pas recommandée. Si vous souhaitez en utiliser une créée pour cette expérience, vous devez ajouter la politique requise pour AWS CodeStar les notifications en plus de celle qui existe déjà. Pour plus d’informations, consultez Configurer une rubrique Amazon SNS pour les notifications et Présentation du contenu des notifications et de la sécurité.

Si vous souhaitez étendre la portée des notifications, vous pouvez configurer manuellement l'intégration entre les notifications et le AWS Chatbot afin que les notifications soient envoyées aux forums de discussion Amazon Chime. Pour plus d’informations, consultez Cibles et Pour intégrer les notifications avec AWS Chatbot et Amazon Chime.

Pour configurer une rubrique Amazon SNS existante à utiliser comme cible de règle de notification (console)

  1. Connectez-vous à la console Amazon SNS AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/sns/v3/home.

  2. Dans la barre de navigation, sélectionnez Topics (Rubriques). Choisissez la rubrique, puis choisissez Edit (Modifier).

  3. Développer Access policy (Stratégie d'accès), puis choisissez Advanced (Avancé).

  4. Dans l'éditeur JSON, ajoutez la déclaration suivante à la stratégie. Incluez l'ARN Région AWS, l' Compte AWS ID et le nom de la rubrique.

    	{
      "Sid": "AWSCodeStarNotifications_publish",
      "Effect": "Allow",
      "Principal": {
        "Service": [
          "codestar-notifications.amazonaws.com"
        ]
      },
      "Action": "SNS:Publish",
      "Resource": "arn:aws:sns:us-east-2:123456789012:codestar-notifications-MyTopicForNotificationRules"
    }

    Cette déclaration de stratégie doit ressembler à l'exemple suivant.

    {
  "Version": "2008-10-17",
  "Id": "__default_policy_ID",
  "Statement": [
    {
      "Sid": "__default_statement_ID",
      "Effect": "Allow",
      "Principal": {
        "AWS": "*"
      },
      "Action": [
        "SNS:GetTopicAttributes",
        "SNS:SetTopicAttributes",
        "SNS:AddPermission",
        "SNS:RemovePermission",
        "SNS:DeleteTopic",
        "SNS:Subscribe",
        "SNS:ListSubscriptionsByTopic",
        "SNS:Publish"
      ],
      "Resource": "arn:aws:sns:us-east-2:123456789012:codestar-notifications-MyTopicForNotificationRules",
      "Condition": {
        "StringEquals": {
          "AWS:SourceOwner": "123456789012"
        }
      }
    },
	{
      "Sid": "AWSCodeStarNotifications_publish",
      "Effect": "Allow",
      "Principal": {
        "Service": [
          "codestar-notifications.amazonaws.com"
        ]
      },
      "Action": "SNS:Publish",
      "Resource": "arn:aws:sns:us-east-2:123456789012:codestar-notifications-MyTopicForNotificationRules"
    }
  ]
}

  5. Sélectionnez Enregistrer les modifications.

  6. Dans Subscriptions (Abonnements), consultez la liste des abonnés à la rubrique. Ajoutez, modifiez ou supprimez des abonnés en fonction des besoins pour cette cible de règle de notification. Assurez-vous que la liste d'abonnés contient uniquement les utilisateurs autorisés à afficher des informations sur la ressource. Pour plus d’informations, consultez Présentation du contenu des notifications et de la sécurité.

Pour créer un client AWS Chatbot avec Slack à utiliser comme cible

  1. Suivez les instructions de Configuration d' AWS Chatbot avec Slack dans le Guide de l'administrateur AWS Chatbot. Dans cette situation, vous devez envisager les options suivantes pour une intégration optimale avec les notifications :

    • Lors de la création d'un rôle IAM, vous pouvez choisir un nom de rôle qui facilite l'identification de l'objet de ce rôle (par exemple, AWSCodeStarNotifications-Chatbot-Slack-Role). Cela peut vous aider à identifier l'objet du rôle à l'avenir.

    • Dans les rubriques SNS, il n'est pas nécessaire de choisir un sujet ou une AWS région. Lorsque vous choisissez le client AWS Chatbot comme cible, une rubrique Amazon SNS dotée de toutes les autorisations requises est créée et configurée pour le client AWS Chatbot dans le cadre du processus de création des règles de notification.

  2. Terminez le processus de création du client. Vous pouvez alors choisir ce client comme cible lors de la création de règles de notification. Pour plus d’informations, consultez Création d'une règle de notification.

    Note

    Ne supprimez pas la rubrique Amazon SNS du client AWS Chatbot une fois qu'elle a été configurée pour vous. Cela empêchera l'envoi de notifications à Slack.

Pour créer un client AWS Chatbot avec Microsoft Teams à utiliser comme cible

  1. Suivez les instructions de Configuration de AWS Chatbot avec Microsoft Teams dans le Guide de l'administrateur AWS Chatbot. Dans cette situation, vous devez envisager les options suivantes pour une intégration optimale avec les notifications :

    • Lors de la création d'un rôle IAM, vous pouvez choisir un nom de rôle qui facilite l'identification de l'objet de ce rôle (par exemple, AWSCodeStarNotifications-Chatbot-Microsoft-Teams-Role). Cela peut vous aider à identifier l'objet du rôle à l'avenir.

    • Dans les rubriques SNS, il n'est pas nécessaire de choisir un sujet ou une AWS région. Lorsque vous choisissez le client AWS Chatbot comme cible, une rubrique Amazon SNS dotée de toutes les autorisations requises est créée et configurée pour le client AWS Chatbot dans le cadre du processus de création des règles de notification.

  2. Terminez le processus de création du client. Vous pouvez alors choisir ce client comme cible lors de la création de règles de notification. Pour plus d’informations, consultez Création d'une règle de notification.

    Note

    Ne supprimez pas la rubrique Amazon SNS du client AWS Chatbot une fois qu'elle a été configurée pour vous. Cela empêchera l'envoi de notifications à Microsoft Teams.