PhishERの[Settings](設定)の[Webhook]サブタブから、PhishERプラットフォームと使用する他のプラットフォームを接続するWebhookを作成できます。Webhookは、アプリケーションが他のアプリケーションにリアルタイムに情報を提供する方法であり、HTTP Push APIとも呼ばれます。PhishERの特定のアクションによってメッセージがトリガーされるときに、Webhookによってメッセージのデータを他のアプリケーションに送信できます。
WebhookをPhishERプラットフォームと連携させた後に、PhishERアクションを作成し、 [Send to Webhook](Webhookに送信)オプションを選択できます。このオプションにより、PhishERはそのアクションの影響を受けて報告されたメッセージを組織のWebhookに送信できます。アクションが実行された後、PhishERの[Inbox](受信箱)で関連するメッセージをクリックすると、そのメッセージがどのWebhookに送信されているかを確認できます。
新しいWebhookの作成
新しいWebhookをPhishERプラットフォームに接続するには、以下のステップに従って操作します。
- PhishERプラットフォームにログインします。
- [Settings](設定) > [Webhook]に移動します。
- ページの右上隅にある[New Webhook](新しいWebhook)ボタンをクリックすると、[Add Webhook Settings](Webhook設定の追加)ポップアップウィンドウが開きます。
-
[Add Webhook Settings](Webhook設定の追加)ポップアップウィンドウが開いたら、Webhookを設定します。これらの設定の詳細については、以下のスクリーンショットとリストを参照してください。
- [Name](名前):このフィールドに、使用するWebhookの名前を入力します。
- [URL]:このフィールドに、コールバック先のURLを入力します。PhishERと互換性があるURL書き換えツールと短縮ツールのリストは、 「PhishERのFAQ」の記事を参照してください。
- [Authorization](認証):ドロップダウンメニューから、[No Auth](認証なし)、[API Key](APIキー)、[Bearer Token](ベアラートークン)、または[Basic Auth](基本認証)のいずれかのプロトコルを選択します。
-
[Available Data](利用可能なデータ):Webhookに送信するデータのタイプを1つ以上選択します。
注:[Addresses](アドレス)データタイプを選択すると、Webhookペイロードに[From](送信元)、[To](送信先)、[CC]、[Reply To](返信先)、および[Reported By](報告者)にあるメールアドレスを含む、全てのメールアドレスが送信されます。
- [Custom Data](カスタムデータ):Webhookペイロードにカスタムデータを追加するには、プラス記号のアイコンをクリックします。次に、[key](キー)と[value](値)フィールドに記入します。例えば、使用するアプリケーションがデータを受け取るために、ペイロードに「{ "System" : "PhishER" }」が必要となる場合、「System」と「PhishER」と入力できます。
- [Custom Headers](カスタムヘッダー):カスタムヘッダーを追加する場合、プラス記号のアイコンをクリックします。次に、[key](キー)と[value](値)フィールドに記入します。例えば、ファイアウォールでデータの通過を許可するために、「{ "Header" : "PhishER" }」ヘッダーが必要な場合、「Header」と「PhishER」と入力できます。
- [Message Tags](メッセージタグ):Webhookを使用してデータを送信するときに、PhishERがタグを割り当てるようにする場合、このセクションで[Success](成功)または[Failure](失敗)のチェックボックスを選択できます。次に、選択したチェックボックスの隣のフィールドにタグ名を入力します。
- [Create](作成)をクリックします。
Webhookの管理
PhishERの[Settings](設定)の[Webhook]サブタブから、Webhookを接続して管理できます。Webhookを更新するには、Webhookの名前をクリックして、[Update Webhook Settings](Webhook設定の更新)ポップアップウィンドウを開きます。次に、Webhookの情報を更新できます。
[Webhook]サブタブの詳細については、以下のスクリーンショットとリストを参照してください。
- [New Webhook](新しいWebhook):このボタンをクリックして、新しいWebhookを追加できます。新しいWebhookを追加する方法の詳細については、この記事の上のサブセクションを参照してください。
- [Name](名前):この列には、Webhookの名前が表示されます。
- [URL]:この列には、Webhookのコールバック先のURLが表示されます。
- [Selected Data](選択するデータ):この列は、Webhookに送信するデータのタイプが表示されます。
- [Success Tag](成功タグ):この列には、Webhookが正常にデータを送信し、コールバックURLを受信した場合に、PhishERがメッセージに割り当てるタグが表示されます。
- [Failure Tag](失敗タグ):この列には、Webhookがデータを送信できず、コールバックURLを受信できない場合に、PhishERがメッセージに割り当てるタグが表示されます。
- [Actions](アクション):この列には、Webhookエントリで実行可能なアクションが表示されます。ゴミ箱のアイコンをクリックすると、エントリを削除できます。