Criar ou configurar um destino de regra de notificação - Console do Developer Tools

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Criar ou configurar um destino de regra de notificação

Os alvos das regras de notificação são tópicos do Amazon SNS ou clientes do Chatbot configurados para os AWS canais do Slack ou do Microsoft Teams.

Um cliente AWS Chatbot deve ser criado antes que você possa selecionar um cliente como alvo. Quando você escolhe um cliente AWS Chatbot como alvo para uma regra de notificação, um tópico do Amazon SNS é configurado para esse cliente AWS Chatbot com todas as políticas necessárias para que as notificações sejam enviadas para o canal do Slack ou do Microsoft Teams. Não é necessário configurar nenhum tópico do Amazon SNS existente para o cliente do AWS Chatbot.

Você pode criar destinos de regra de notificação do Amazon SNS no console do Developer Tools ao criar uma regra de notificação. A política que permite que as notificações sejam enviadas para esse tópico é aplicada a você. Esta é a maneira mais fácil de criar um destino para uma regra de notificação. Para ter mais informações, consulte Criar uma regra de notificação.

Se você usar um tópico do Amazon SNS existente, deverá configurá-lo com uma política de acesso que permita que o recurso envie notificações para esse tópico. Para ver um exemplo, consulte Configurar tópicos do Amazon SNS para notificações.

nota

Se desejar usar um tópico do Amazon SNS existente em vez de criar um novo, em Targets (Destinos), escolha o ARN. Certifique-se de que o tópico tenha a política de acesso adequada e que a lista de assinantes contenha apenas os usuários que têm permissão para ver informações sobre o recurso. Se o tópico do Amazon SNS for usado para CodeCommit notificações antes de 5 de novembro de 2019, ele conterá uma política que permite CodeCommit a publicação nele com permissões diferentes das exigidas para AWS CodeStar notificações. Não é recomendado usar esses tópicos. Se quiser usar uma criada para essa experiência, você deve adicionar a política necessária para AWS CodeStar Notificações, além da que já existe. Para obter mais informações, consulte Configurar tópicos do Amazon SNS para notificações e Noções básicas do conteúdo e da segurança das notificações.

Se quiser ampliar o alcance das notificações, você pode configurar manualmente a integração entre as notificações e o AWS Chatbot para que as notificações sejam enviadas às salas de bate-papo do Amazon Chime. Para obter mais informações, consulte Destinos e Como integrar notificações com o AWS Chatbot e o Amazon Chime.

Para configurar um tópico do Amazon SNS existente para usar como um destino de regra de notificação (console)

  1. Faça login no AWS Management Console e abra o console do Amazon SNS em https://console.aws.amazon.com/sns/v3/home.

  2. Na barra de navegação, escolha Tópicos. Escolha o tópico e Edit (Editar).

  3. Expanda Access policy (Política de acesso) e, em seguida, escolha Advanced (Avançado).

  4. No editor de JSON, adicione a declaração a seguir à política. Inclua o ARN Região da AWS, Conta da AWS ID e nome do tópico.

    	{
      "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"
    }

    A declaração da política deve ser semelhante ao seguinte.

    {
  "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. Escolha Salvar alterações.

  6. Em Subscriptions (Assinaturas), revise a lista de assinantes do tópico. Adicione, edite ou exclua assinantes conforme apropriado para esse destino de regra de notificação. Verifique se a lista de assinantes contém apenas os usuários que têm permissão para ver informações sobre o recurso. Para ter mais informações, consulte Noções básicas do conteúdo e da segurança das notificações.

Para criar um cliente AWS Chatbot com o Slack para usar como alvo

  1. Siga as instruções em Configurar o AWS Chatbot com o Slack no Guia do administrador do AWS Chatbot. Ao fazê-lo, considere as seguintes opções para uma integração ideal com notificações:

    • Ao criar uma função do IAM, considere escolher um nome de função que facilite a identificação da finalidade dessa função (por exemplo, AWSCodeStarNotifications-Chatbot-Slack-Role). Isso pode ajudar a identificar a finalidade da função no futuro.

    • Nos tópicos do SNS, você não precisa escolher um tópico ou uma AWS região. Quando você escolhe o cliente do AWS Chatbot como destino, um tópico do Amazon SNS com todas as permissões necessárias é criado e configurado para o cliente do AWS Chatbot como parte do processo de criação da regra de notificação.

  2. Conclua o processo de criação do cliente. Esse cliente estará disponível para ser escolhido como destino durante a criação de regras de notificação. Para ter mais informações, consulte Criar uma regra de notificação.

    nota

    Não remova o tópico do Amazon SNS do cliente do Chatbot AWS depois que ele tiver sido configurado para você. Isso impedirá que notificações sejam enviadas para o Slack.

Para criar um cliente AWS Chatbot com o Microsoft Teams para usar como alvo

  1. Siga as instruções em Configurar o AWS Chatbot com o Microsoft Teams no Guia do administrador do AWS Chatbot. Ao fazê-lo, considere as seguintes opções para uma integração ideal com notificações:

    • Ao criar uma função do IAM, considere escolher um nome de função que facilite a identificação da finalidade dessa função (por exemplo, AWSCodeStarNotifications-Chatbot-Microsoft-Teams-Role). Isso pode ajudar a identificar a finalidade da função no futuro.

    • Nos tópicos do SNS, você não precisa escolher um tópico ou uma AWS região. Quando você escolhe o cliente do AWS Chatbot como destino, um tópico do Amazon SNS com todas as permissões necessárias é criado e configurado para o cliente do AWS Chatbot como parte do processo de criação da regra de notificação.

  2. Conclua o processo de criação do cliente. Esse cliente estará disponível para ser escolhido como destino durante a criação de regras de notificação. Para ter mais informações, consulte Criar uma regra de notificação.

    nota

    Não remova o tópico do Amazon SNS do cliente do Chatbot AWS depois que ele tiver sido configurado para você. Isso impedirá que notificações sejam enviadas para o Microsoft Teams.