Creación o configuración de un destino de regla de notificación - Consola de Developer Tools

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Creación o configuración de un destino de regla de notificación

Los objetivos de las reglas de notificación son temas de Amazon SNS o clientes de AWS Chatbot configurados para los canales de Slack o Microsoft Teams.

Se debe crear un cliente de AWS Chatbot antes de poder seleccionar un cliente como objetivo. Cuando eliges un cliente de AWS Chatbot como destino para una regla de notificación, se configura un tema de Amazon SNS para ese cliente de AWS Chatbot con todas las políticas necesarias para que las notificaciones se envíen a los canales de Slack o Microsoft Teams. No es necesario configurar ningún tema de Amazon SNS existente para el cliente de AWS  Chatbot.

Puede crear destinos de reglas de notificación de Amazon SNS en la consola de herramientas para desarrolladores cuando cree una regla de notificación. La política que permite enviar notificaciones a ese tema se aplica para usted. Esta es la forma más fácil de crear un destino para una regla de notificación. Para obtener más información, consulte Creación de una regla de notificación.

Si utiliza un tema de Amazon SNS ya existente, debe configurarlo con una política de acceso que permita que el recurso envíe notificaciones a ese tema. Para ver un ejemplo, consulte Configuración de los temas de Amazon SNS para las notificaciones.

nota

Si desea utilizar un tema de Amazon SNS existente en lugar de crear uno nuevo, en Targets (Destinos), elija su ARN. Asegúrese de que el tema tiene la política de acceso adecuada y de que la lista de suscriptores contiene solo aquellos usuarios que tienen permiso para ver información sobre el recurso. Si el tema Amazon SNS es un tema que se utilizó para CodeCommit las notificaciones antes del 5 de noviembre de 2019, contendrá una política que permite CodeCommit publicar en él y que contiene permisos diferentes a los necesarios para AWS CodeStar las notificaciones. No se recomienda usar estos temas. Si quieres usar uno creado para esa experiencia, debes añadir la política necesaria para AWS CodeStar las notificaciones además de la que ya existe. Para obtener más información, consulte Configuración de los temas de Amazon SNS para las notificaciones y Descripción del contenido y la seguridad de las notificaciones.

Si desea ampliar el alcance de las notificaciones, puede configurar manualmente la integración entre las notificaciones y el AWS Chatbot para que las notificaciones se envíen a las salas de chat de Amazon Chime. Para obtener más información, consulte implementación y Para integrar notificaciones en AWS Chatbot y Amazon Chime.

Para configurar un tema de Amazon SNS ya existente para utilizarlo como destino de regla de notificación (consola)

  1. Inicie sesión en la consola de Amazon SNS AWS Management Console y ábrala en https://console.aws.amazon.com/sns/v3/home.

  2. En la barra de navegación, elija Topics. Elija el tema y, a continuación, seleccione Edit (Editar).

  3. Amplíe Access policy (Política de acceso) y, a continuación, elija Advanced (Avanzado).

  4. En el editor JSON, agregue la siguiente instrucción a la política. Incluya el ARN Región de AWS, el Cuenta de AWS ID y el nombre del tema.

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

    Esta instrucción de política debería ser como esta.

    {
  "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. Elija Guardar cambios.

  6. En Subscriptions (Suscripciones), revise la lista de suscriptores de temas. Añada, edite o elimine suscriptores según corresponda para este destino de regla de notificación. Asegúrese de que la lista de suscriptores contiene sólo aquellos usuarios que tienen permiso para ver información sobre el recurso. Para obtener más información, consulte Descripción del contenido y la seguridad de las notificaciones.

Para crear un cliente de AWS Chatbot con Slack para usarlo como objetivo

  1. Siga las instrucciones que se muestran en Configuración de AWS Chatbot con Slack en la Guía del administrador de AWS Chatbot. Al hacerlo, estudie las siguientes opciones para realizar una integración óptima con las notificaciones:

    • Cuando se crea un rol de IAM, es conveniente elegir un nombre de rol que permita identificar fácilmente el propósito de este rol (por ejemplo, AWSCodeStarNotifications-Chatbot-Slack-Role). Esto puede ayudarle a identificar el propósito del rol en el futuro.

    • En los temas de redes sociales, no tienes que elegir un tema o una región. AWS Al elegir el cliente de AWS Chatbot como destino, se crea y configura un tema de Amazon SNS con todos los permisos necesarios para el cliente de AWS Chatbot como parte del proceso de creación de reglas de notificación.

  2. Complete el proceso de creación del cliente. Este cliente estará disponible para que pueda elegirlo como destino al crear reglas de notificación. Para obtener más información, consulte Creación de una regla de notificación.

    nota

    No elimines el tema de Amazon SNS del cliente de AWS Chatbot después de haberlo configurado para ti. Si lo hace, impedirá que las notificaciones se envíen a Slack.

Para crear un cliente de AWS Chatbot con Microsoft Teams para usarlo como objetivo

  1. Siga las instrucciones que se muestran en Configuración de AWS Chatbot con Microsoft Teams en la Guía del administrador de AWS Chatbot. Al hacerlo, estudie las siguientes opciones para realizar una integración óptima con las notificaciones:

    • Cuando se crea un rol de IAM, es conveniente elegir un nombre de rol que permita identificar fácilmente el propósito de este rol (por ejemplo, AWSCodeStarNotifications-Chatbot-Microsoft-Teams-Role). Esto puede ayudarle a identificar el propósito del rol en el futuro.

    • En los temas de SNS, no tienes que elegir un tema o una AWS región. Al elegir el cliente de AWS Chatbot como destino, se crea y configura un tema de Amazon SNS con todos los permisos necesarios para el cliente de AWS Chatbot como parte del proceso de creación de reglas de notificación.

  2. Complete el proceso de creación del cliente. Este cliente estará disponible para que pueda elegirlo como destino al crear reglas de notificación. Para obtener más información, consulte Creación de una regla de notificación.

    nota

    No elimines el tema de Amazon SNS del cliente de AWS Chatbot después de haberlo configurado para ti. Si lo hace, impedirá que las notificaciones se envíen a Microsoft Teams.