通知ルールのターゲットの作成または設定

通知ルールのターゲットは、Slack または Microsoft Teams チャネル用に設定された Amazon SNS トピックまたは AWS Chatbot クライアントです。

ターゲットとしてクライアントを選択する前に、 AWS Chatbot クライアントを作成する必要があります。 AWS Chatbot クライアントを通知ルールのターゲットとして選択すると、その AWS Chatbot クライアントに対して Amazon SNS トピックが設定され、通知が Slack または Microsoft Teams チャネルに送信されるために必要なすべてのポリシーが設定されます。既存の Amazon SNS トピックを AWS Chatbot クライアント用に設定する必要はありません。

通知ルールを作成するときに、デベロッパーツールコンソールで Amazon SNS 通知ルールターゲットを作成できます。そのトピックへの通知の送信を許可するポリシーが適用されます。これは、通知ルールのターゲットを作成する最も簡単な方法です。詳細については、「通知ルールの作成」を参照してください。

既存の Amazon SNS トピックを使用する場合は、リソースがそのトピックに通知を送信できるようにするアクセスポリシーを使用して設定する必要があります。例については、通知用に Amazon SNS トピックを設定するを参照してください。

注記

新しいトピックを作成する代わりに既存の Amazon SNS トピックを使用する場合は、[Targets (ターゲット)] でその ARN を選択します。トピックに適切なアクセスポリシーがあり、リソースに関する情報を表示できるユーザーのみがサブスクライバーリストに含まれていることを確認します。Amazon SNS トピックが 2019 年 11 月 5 日より前に CodeCommit 通知に使用されたトピックである場合、 AWS CodeStar が通知に必要なアクセス許可とは異なるアクセス許可を含む公開 CodeCommit を許可するポリシーが含まれます。これらのトピックの使用は非推奨です。そのエクスペリエンス用に作成されたポリシーを使用する場合は、既に存在するポリシーに加えて、 AWS CodeStar 通知に必要なポリシーを追加する必要があります。詳細については、「通知用に Amazon SNS トピックを設定する」および「通知の内容とセキュリティについて」を参照してください。

通知の到達範囲を拡張する場合は、通知と AWS Chatbot の統合を手動で設定して、通知が Amazon Chime チャットルームに送信されるようにできます。詳細については、「ターゲット」および「通知を AWS Chatbot および Amazon Chime と統合するには」を参照してください。

通知ルールのターゲットとして使用する既存の Amazon SNS トピックを設定するには (コンソール)

にサインイン AWS Management Console し、https://console.aws.amazon.com/sns/v3/home で Amazon SNS コンソールを開きます。
ナビゲーションバーで、[トピック] を選択します。トピックを選択し、[編集] を選択します。
[アクセスポリシー]を展開し、アドバンストを選択します。

JSON エディタで、ポリシーに次のポリシーステートメントを追加します。トピック ARN、 AWS リージョン、 AWS アカウント ID、トピック名を含めます。


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

このポリシーステートメントは、次のようになります。


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

[変更を保存] を選択します。
[サブスクリプション] で、トピックサブスクライバーのリストを確認します。この通知ルールのターゲットに合わせて、受信者を追加、編集、または削除します。サブスクライバーのリストには、リソースに関する情報を表示できるユーザーだけが記載されていることを確認します。詳細については、「通知の内容とセキュリティについて」を参照してください。

ターゲットとして使用する Slack で AWS Chatbot クライアントを作成するには

「AWS Chatbot 管理者ガイド」の「AWS Chatbot を Slack で設定する」の手順に従ってください。この場合、通知との統合を最適化するために以下の選択肢を検討してください。
- IAM ロールを作成するときに、このロールの目的を端的に示すロール名 (AWSCodeStarNotifications-Chatbot-Slack-Role など) を選択します。これにより、以後、ロールの使用目的がわかりやすくなります。
- SNS トピック では、トピックまたは AWS リージョンを選択する必要はありません。 AWS Chatbot クライアントをターゲットとして選択すると、通知ルールの作成プロセスの一環として、必要なすべてのアクセス許可を持つ Amazon SNS トピックが AWS Chatbot クライアント用に作成および設定されます。
クライアントの作成プロセスを完了します。通知ルールの作成時に、このクライアントをターゲットとして選択できます。詳細については、「通知ルールの作成」を参照してください。

注記
設定後に Chatbot クライアントから Amazon SNS AWS トピックを削除しないでください。削除すると、Slack に通知が送信されなくなります。

ターゲットとして使用する Microsoft Teams で AWS Chatbot クライアントを作成するには

「AWS Chatbot 管理者ガイド」の「AWS Chatbot を Microsoft Teams で設定する」の手順に従ってください。この場合、通知との統合を最適化するために以下の選択肢を検討してください。
- IAM ロールを作成するときに、このロールの目的を端的に示すロール名 (AWSCodeStarNotifications-Chatbot-Microsoft-Teams-Role など) を選択します。これにより、以後、ロールの使用目的がわかりやすくなります。
- SNS トピック では、トピックまたは AWS リージョンを選択する必要はありません。 AWS Chatbot クライアントをターゲットとして選択すると、通知ルールの作成プロセスの一環として、必要なすべてのアクセス許可を持つ Amazon SNS トピックが AWS Chatbot クライアント用に作成および設定されます。
クライアントの作成プロセスを完了します。通知ルールの作成時に、このクライアントをターゲットとして選択できます。詳細については、「通知ルールの作成」を参照してください。

注記
設定後に Chatbot クライアントから Amazon SNS AWS トピックを削除しないでください。削除すると、Microsoft Teams に通知が送信されなくなります。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

通知ルールのターゲットの使用

通知ルールのターゲットの表示