コンソールで通知配信リストにメールアドレスを追加する

通知の配信リストに電子メールを追加するには、以下の手順に従ってください

1. IBM Cloud コンソールで、「管理」>「アカウント」 > **「通知配布リスト」**と移動します。

2. 「追加」>**「E メール」**を選択します。

3. 名前と E メール・アドレスを入力します。

   最大 10 個の E メール・アドレスを配布リストに追加できます。 E メール・アドレスは、IBM Cloud 内の既知のユーザーに対応する必要はありません。任意のタイプを追加できます。

4. 追加 をクリックします。

通知配布リストの Event Notifications の有効化

IBM Cloud® Event Notificationsを使用すると、E メール、SMS、Webhook などのさまざまな宛先に通知を配信することを選択できます。 Event Notifications は、通知配布リストの代替手段です。 これにより、アカウントで発生した重大なイベントに関する通知を受け取ることができ、大量の通知を管理することができます。 詳しくは、 Event Notifications を参照してください。

関心のあるイベントが IBM Cloud プラットフォームで発生し、イベントが生成されると、通知配布リストは接続された Event Notifications インスタンスと通信して、サポートされる宛先に通知を転送します。 サポートされる Event Notifications 宛先について詳しくは、 イベント宛先 を参照してください。

配布リストへの Web フックの追加

Web フックを配布リストに追加するには、以下の手順を実行します。

1. IBM Cloud® コンソールで管理 > アカウント > 通知配布リストに移動します。

2. **「追加」をクリックし、「Webhook の追加」**を選択します。

3. ウェブフックの識別名とエンドポイントを入力します。 URL ウェブフックがトリガーされた際にイベント通知が送信されます。 お客様自身のカスタム・エンドポイントとなる URL をセットアップしてください。

   カスタム・ヘッダーとセキュア・ヘッダーのフィールドを設定することもできます。 これらを指定するには、**「ヘッダーの追加」または「セキュア・ヘッダーの追加」**をクリックします。 資格情報のためにセキュア・ヘッダーを追加した場合は、プライベート・データとともに資格情報が暗号化されて渡されます。 このタイプのヘッダーは、後で削除はできますが、編集はできません。 カスタム・ヘッダーは、後で簡単に編集および削除できます。

   通知を受信する必要がなくなった場合は、Webhook の行にある アクション・アイコン > 削除をクリックして、配布リストから Webhook を簡単に削除できます。

   コンソールでアカウント・スイッチャーをクリックして、使用する IBM Cloud アカウントを選択できます。 選択したアカウントのユーザーは、そのアカウントに影響するあらゆるイベントについての通知を受信します。

Webhook で通知を受け取ると、指定した Webhook エンドポイント (URL) にペイロードが送信され、発生したイベントに関する全詳細が通知されます。 以下の例を参照してください。

{
  "account_id": "2dd2d2de4add4a098ebd0999be5cc555",
  "body": [
    {
      "language": "en",
      "text": "<p><br />SERVICES/COMPONENTS AFFECTED:<br />- Cloudant NoSQL DB<br />- Code Engine<br />- DNS Services<br />- App ID<br />- IBM Watson Machine Learning<br />- Continuous Delivery - Toolchain<br />- MQ in IBM Cloud<br />- Hyper Protect Crypto Services<br /><br />IMPACT:<br />- Users may experience connectivity issues when trying to connect to Cloudant services.<br /><br />STATUS:<br />- 2021-05-25 14:54 UTC - INVESTIGATING - We are aware of the issue and are currently investigating. More information will be provided as it becomes available.</p>"
    }
  ],
  "category": "Incident",
  "componentNames": "Cloudant",
  "continentNames": [
    "North America",
    "Europe",
    "Asia Pacific"
  ],
  "regionNames": [
    "Washington DC",
    "London",
    "Dallas",
    "Sydney",
    "Tokyo",
    "Frankfurt"
  ],
  "regions": [
    "us-east",
    "eu-gb",
    "us-south",
    "au-syd",
    "jp-tok",
    "eu-de"
  ],
  "severity": "Severity 1",
  "sourceID": "INC3918600",
  "startTime": 1621949594,
  "state": "Investigating",
  "title": [
    {
      "language": "en",
      "text": "INVESTIGATING: IBM Cloudant - selective services  are unavailable"
    }
  ],
  "updateTime": 1621954682
}

配布リストへの Slack Web フックの追加

Slackのウェブフックを配信リストに追加し、それらを通じてアカウント全体にわたる IBM Cloud 通知を受け取ることができます。

Webhook を作成するには、まず Slack でアプリをセットアップし、着信 Webhook を作成します。これによって、通知メッセージ・テキストを JSON ペイロードの形式で送信できる固有の URL が与えられます。 アプリがインストールされた、選択した Slack チャネルで通知を受け取れるようになります。 詳細については 、「Incoming Webhooks を使用したメッセージの送信 」を参照してください。

IBM Cloud コンソールに Slack の Webhook を追加するには、以下の手順を実行します。

1. IBM Cloud コンソールで管理 > アカウント > 通知配布リストに移動します。
2. **「追加」をクリックし、「Slack」**を選択します。
3. Webhook の名前と Slack Webhook URL を入力します。 通知はこの固有の URL に送信されます。

配布リストへの Microsoft Teams Web フックの追加

アカウント全体の IBM Cloud 通知を受信するために、Microsoft Teams の Webhook を配布リストに追加することもできます。

IBM Cloud コンソールで Webhook を作成するには、まず Microsoft Teams で着信 Webhook を作成します。 これにより、外部アプリは Teams チャネルでコンテンツを共有することが可能になり、JSON ペイロードの形式の通知メッセージ・テキストを送信できる固有の URL を提供します。 通知は、着信 Webhook を追加した、選択した Teams チャネルで受け取ります。 詳細については、着信Webhookの作成を参照してください。

IBM Cloud コンソールに Microsoft Teams の Webhook を追加するには、以下の手順を実行します。

1. IBM Cloud コンソールで管理 > アカウント > 通知配布リストに移動します。
2. **「追加」をクリックし、「Microsoft Teams」**を選択します。
3. Webhook の名前と Microsoft Teams の Webhook URL を入力します。 通知はこの固有の URL に送信されます。

ServiceNow ウェブフックの設定

Microsoft Teams Webhook および Slack Webhook の統合とは異なり、ServiceNow Webhook をセットアップするには、Webhook 宛先側での構成が必要です。

まず、ServiceNow Web サイトで Scripted REST API を作成する必要があります。 Scripted REST API を構成したら、Scripted REST API リソースも作成する必要があります。 要求メソッドは HTTP POST に設定する必要があります。 その後に、リソースで実行するコードを指定します。

プロセスの準備ができ、Scripted REST API の URL を用意したら、**「IBM Cloud 通知配布リスト (IBM Cloud Notification distribution list)」**ページでその使用を開始し、Webhook を作成できます。

ServiceNow のウェブフック統合プロセスを完全に理解するには 、「 ServiceNow にウェブフックを統合する方法」というブログ記事の手順に従ってください。 このブログではステップを詳しく説明しています。