Webhookイベントの登録を解除する

Webhookの登録解除は、以前に確立したWebhook接続を無効にするプロセスです。たとえば、特定のイベント通知を受信する必要がなくなった場合、別のエンドポイントに切り替える場合、またはWebhookを完全に廃止する場合に登録解除します。

ユーザーが、デプロイ済みのWebhookイベントカードを含むフローを無効にすると、登録解除ヘルパーフローがトリガーされます。

開始する前に

  • Okta Workflowsにアクセスできるスーパー管理者でなければなりません。

  • コネクターをまだ作成していないときは、次の手順に従って作成します。

    • Okta Workflowsコンソールコネクタービルダーコンソールのリンクを開きます。

    • コネクタービルダーアイコンをクリックしてコネクターを作成します。新しいコネクターに一意の名前と有用な説明を付けます。

  • コネクターに、基本的なことからすぐに始めるセクションのタスクで基本的な基盤と認証要素があることを確認してください。

このタスクを開始する

  1. メインパネルで新しいコネクターをクリックして開きます。

  2. フロー(Flows)タブで、新規フロー(+ New Flow)をクリックしてフローを作成します。

  3. イベントを追加(Add event)をクリックし、イベント(Events)の選択肢からWebhookイベントの登録解除(Webhook Event: Deregistration)を選択します。

  4. Webhookの登録解除(Webhook Deregistration)カードで、Webhookイベントの登録解除の入力を定義します。

    入力値は次の2つの方法で入力できます。

    • Webhookイベントカードが登録解除フローを実行するたびに使用される静的テキストとして。

    • Webhookイベントカードから登録解除フローに渡されるオプションの値として。Webhookイベントカードに登録解除フローを追加する際には、Webhookイベントのオプションからこのカードの入力に値をマッピングできます。この2番目のオプションでは、同じ登録解除イベントカードを複数のWebhookイベントカードに使用できます。

    カードには登録データ(Registration data)入力フィールドも含まれています。Webhookイベントを登録すると、登録フローによって登録データ(Registration data)がこの登録解除フローで使用できるように保存されます。この情報は、識別子、URL、または登録解除イベントが必要とする、外部サービスによって返されるその他のデータである場合があります。

  5. 関数カードを登録データ(Registration data)入力と一緒に使用して、外部サービスの構築と呼び出しを行い、Webhookの登録を解除します。

これでこの登録解除フローをWebhookイベント内で使用できるようになります。

リターンカード

登録解除イベントフローは親フローにカードを返しません。