通知ウェブフックの概要

Webhookは、Forterのシステム内で特定のイベントが発生するたびに、リアルタイム通知をあなたのウェブストアサーバーや他のサービス（ERP/OMS）に送信するようにForterを設定する方法を提供します。

Webhookは、あなたが選択した宛先URLに配信されるHTTPS POSTメッセージです。どこに送信するかを単に教えてください。次に、イベントが発生するたびに、イベントに関連する詳細を含むメッセージを指定されたエンドポイントに送信します。

Webhookの受信を確認するために、あなたのエンドポイントは、MIMEタイプが'application/json'のJSON形式で200 HTTPステータスコードを返す必要があります。リクエストヘッダーやリクエストボディに返す他の情報は無視されます。2xx範囲外の応答コード、3xxコードを含むものは、Forterに対してWebhookを受信しなかったことを示します。これは、URLリダイレクトや「変更なし」応答が失敗として扱われることを意味します。

Webhookが何らかの理由で正常に受信されなかった場合、Forterは次の1時間の間に、間隔を増やしながらWebhookを送信し続けます。

Webhookは、ポータルのツールの下にある統合センターセクションで設定されます。'Webhookを追加'をクリックすると、通知を受信したい新しいURLエンドポイントを追加するためのフォームが表示されます。

本番環境に移行する前に、Webhookが正しく機能していることをテストしてください。この設定ページからテストイベントを送信することで行えます。これらは偽のテストイベントであるため、実際のトランザクションにはマッピングされないことに注意してください。

Webhookエンドポイントは、ネットワークの問題により、同じイベントを複数回受信することがあります。重複したイベント受信に対して保護するために、イベント処理を冪等にすることをお勧めします。これを行う方法の一つは、処理したイベントをログに記録し、すでにログに記録されたイベントを処理しないことです。

Forterとの親子サイト構造の場合、子サイトに設定されたWebhookは親サイトのサイトIDで送信され、検証には親サイトの秘密鍵を使用する必要があることに注意してください。