PhishERの[設定](Settings)の[Webhook]サブタブから、PhishERプラットフォームと使用する他のプラットフォームを接続するWebhookを作成できます。Webhookは、アプリケーションが他のアプリケーションにリアルタイムに情報を提供する方法であり、HTTP Push APIとも呼ばれます。PhishERの特定のアクションによってメッセージがトリガーされるときに、Webhookによってメッセージのデータを他のアプリケーションに送信できます。
WebhookをPhishERプラットフォームと連携させた後に、PhishERアクションを作成し、 [Webhookに送信](Send to Webhook)オプションを選択できます。このオプションにより、PhishERはそのアクションの影響を受けて報告されたメッセージを組織のWebhookに送信できます。アクションが実行された後、PhishERの[受信箱](Inbox)で関連するメッセージをクリックすると、そのメッセージがどのWebhookに送信されているかを確認できます。
新しいWebhookの作成
新しいWebhookをPhishERプラットフォームに接続するには、以下のステップに従って操作します。
- PhishERプラットフォームにログインします。
- [設定](Settings) > [Webhook]に移動します。
- ページの右上隅にある[新しいWebhook](New Webhook)ボタンをクリックすると、[Webhook設定の追加](Add Webhook Settings)ポップアップウィンドウが開きます。
-
[Webhook設定の追加](Add Webhook Settings)ポップアップウィンドウが開いたら、Webhookを設定します。これらの設定の詳細については、以下のスクリーンショットとリストを参照してください。
- [名前](Name):このフィールドに、使用するWebhookの名前を入力します。
- [URL]:このフィールドに、コールバック先のURLを入力します。PhishERと互換性があるURL書き換えツールと短縮ツールのリストは、 「PhishERのFAQ」の記事を参照してください。
- [認証](Authorization):ドロップダウンメニューから、[認証なし](No Auth)、[APIキー](API Key)、[Bearerトークン](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の名前をクリックして、[Webhook設定の更新](Update Webhook Settings)ポップアップウィンドウを開きます。次に、Webhookの情報を更新できます。
[Webhook]サブタブの詳細については、以下のスクリーンショットとリストを参照してください。
- [新しいWebhook](New Webhook):このボタンをクリックして、新しいWebhookを追加できます。新しいWebhookを追加する方法の詳細については、この記事の上のサブセクションを参照してください。
- [名前](Name):この列には、Webhookの名前が表示されます。
- [URL]:この列には、Webhookのコールバック先のURLが表示されます。
- [選択したデータ](Selected Data):この列は、Webhookに送信するデータのタイプが表示されます。
- [成功タグ](Success Tag):この列には、Webhookが正常にデータを送信し、コールバックURLを受信した場合に、PhishERがメッセージに割り当てるタグが表示されます。
- [失敗タグ](Failure Tag):この列には、Webhookがデータを送信できず、コールバックURLを受信できない場合に、PhishERがメッセージに割り当てるタグが表示されます。
- [アクション](Actions):この列には、Webhookエントリで実行可能なアクションが表示されます。ゴミ箱のアイコンをクリックすると、エントリを削除できます。