Opsgenie にアラートを送信する
Webhook と Jira 自動化を使用して Opsgenie にアラートを送信します。Jira 自動化について
この操作を実行できるユーザー |
ステップ 1: Opsgenie で新しい API 統合を作成する
Opsgenie では、設定内またはチーム内で API 統合を作成できます。この例では、チーム向けの統合を作成します。Opsgenie で API 統合を作成する方法
Opsgenie で新しい API 統合を作成するには、次の手順に従います。
Opsgenie でチームに移動して、[統合] を選択します。
[統合の追加] を選択します。
API 統合を検索します。
統合に名前をつけます (例: アトラシアン)。
アラート)、チームに割り当てます。
[続行] を選択します。
API キーをメモしておきます。これは後ほどステップで必要となります。
ステップ 2: Jira 自動化ルールを作成する
自動化ルールはグローバル ルールとして作成できますが、ご自身が Jira 管理者でない場合は Jira プロジェクトでも作成できます。この例では、プロジェクト内でルールを作成します。
Jira で自動化ルールを作成するには、次の手順に従います。
Jira でプロジェクトに移動します。
[プロジェクト設定] > [自動化] に進みます。
[ルールを作成] を選択します。
[受信 Webhook] コンポーネントを検索します。
[コンポーネントを追加] を選択します。 次のステップまで、Webhook を設定することはできません。
[THEN: アクションを追加] を選択します。
[Web リクエストを送信] コンポーネントを検索します。
Opsgenie API URL や API キーなど、Web リクエストの詳細を入力します。下のテーブルをご参照ください。
[Web リクエストを送信] コンポーネントに変更を [保存] します。
[ルールをオンにする] メニューから [ルールを有効化せずに保存] を選択します。
メッセージが表示されたら、ルールに名前を付けて [保存] します。
Web リクエストの詳細
次の情報を使用して Web リクエストを設定します。
Web リクエスト URL |
|
|---|---|
ヘッダー |
|
HTTP メソッド | POST |
Web リクエスト本文 | カスタム データ |
カスタム データ | Webhook ペイロードのデータを Opsgenie アラートに含めることができます。たとえば、次のようにアラートのタイトルを含められます。 {
"message":"{{webhookData.alertTitle}}"
}これはシンプルな一例です。Webhook ペイロードの任意の属性を使用して、Opsgenie フィールドにマッピングできます。 |
ステップ 3: 自動化の Webhook URL を取得する
Webhook URL を取得する手順は以下のとおりです。
Jira で自動化ルールに戻り、[受信 Webhook] トリガーを選択します。
Webhook URL とシークレットをコピーします。これは次のステップで必要となります。
自動化ルールの実行方法を尋ねられたら、[Webhook からの課題がない] を選択します。
[受信 Webhook] コンポーネントに変更を保存します。
準備ができた段階でルールを有効にします。
ステップ 4: Webhook URL を Guard Detect に追加する
Webhook URL を追加するには、次の手順に従います。
Guard Detect で、[統合] > [SIEM Webhook] に移動します。
[Webhook URL を追加] を選択します。
Jira からコピーした Webhook URL を貼り付けて [保存] します。
[その他のアクション] (…) > [Add authorization header (認証ヘッダーを追加)] の順に選択します。
Jira からコピーしたシークレットを貼り付けて [保存] します。
![Webhook URL の例と [Webhook を追加] ボタンを表示する SIEM 統合](http://images.ctfassets.net/zsv3d0ugroxu/77iamLO91sSFZZHI3hMuqs/80b5eb2f65ee6e74546f3d044e882a9b/Screenshot_detect-integration-SIEM-activewebhook.png)
ステップ 4: 課題を作成するための自動化ルールを設定する
Jira で自動化ルールに戻り、[THEN: アクションを追加] を選択します。
[Web リクエストを送信] コンポーネントを検索します。
Opsgenie API URL や API キーなど、Web リクエストの詳細を入力します。下のテーブルをご参照ください。
[Web リクエストを送信] コンポーネントに変更を [保存] します。
自動化ルールに名前を付けて [オンにする] を選択します。
ステップ 5: テスト アラートを送信する
テスト アラートを送信するには、次の手順に従います。
Guard Detect で、[統合] > [SIEM Webhook] に移動します。
この統合用の Webhook の横にある [テスト] を選択します。
統合が機能していれば、Opsgenie チームに対して新しいアラートが表示されるようになります。
ツールに送信されるデータ
統合を設定すると、選択したサードパーティ ツールにアラート データが送信されるようになります。 アラートのタイトル、説明、コンテキストが送信され、以下が含まれる場合があります。
アクターの名前とそのプロフィール写真
対象の名前 (個人、またはスペース、プロジェクト、ポリシーなどのエンティティ)
アクティビティが発生したサイト URL またはページ URL
アクターの Atlassian アカウント プロフィールの表示設定が優先されます。 アクターが自分のプロフィール写真をアトラシアン組織と共有しないことを選択している場合にはその設定が優先されます。
統合を設定する前に、このデータをサードパーティ ツールと共有することが適切であることを確認する必要があります。
この内容はお役に立ちましたか?