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

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

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

はじめに

  • Okta Workflowsにアクセスできるスーパー管理者である必要があります。

  • コネクターをまだ作成していない場合は、以下の手順に従って作成してください。

    • Okta Workflowsコンソールで、App switcher（アプリスイッチャー）アイコンをクリックしてから、コネクタービルダーコンソールのリンクをクリックします。

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

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

このタスクを開始する

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

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

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

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

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

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

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

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

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

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

リターンカード

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