Webhookイベントを登録する

Webhook登録は、システム間の接続を確立し、リアルタイム情報の交換を実現するプロセスです。Webhookの登録とは、基本的には、特定のイベントが発生したときにあるシステムが別のシステムにデータを送信する先となる場所を指定することです。

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

開始する前に

Okta Workflowsにアクセスできるスーパー管理者でなければなりません。
コネクターをまだ作成していないときは、次の手順に従って作成します。
- Okta Workflowsコンソールでコネクタービルダーコンソールのリンクを開きます。
- コネクタービルダーでアイコンをクリックしてコネクターを作成します。新しいコネクターに一意の名前と有用な説明を付けます。
コネクターに、基本的なことからすぐに始めるセクションのタスクで基本的な基盤と認証要素があることを確認してください。

このタスクを開始する

メインパネルで新しいコネクターをクリックして開きます。
フロー（Flows）タブで、新規フロー（+ New Flow）をクリックしてフローを作成します。
イベントを追加（Add event）をクリックし、イベント（Events）の選択肢からWebhookイベント：登録（Webhook Event: Registration）を選択します。
Webhookの登録（Webhook Registration）カードで、Webhookの登録の入力を定義します。この入力値は次の2つの方法で入力できます。
- Webhookイベントカードが登録フローを実行するたびに使用される静的テキストとして。
- Webhookイベントカードから登録フローに渡されるオプションの値として。Webhookイベントカードに登録フローを追加する際には、Webhookイベントのオプションからこのカードの入力に値をマッピングできます。この2番目のオプションでは、同じ登録イベントカードを複数のWebhookイベントカードに使用できます。
注:
イベントURL（Event URL）は自動生成されるURLです。これはユーザーがこのWebhookイベントを含むフォローを有効にすると作成されます。
関数カードを使用して外部サービスの構築と呼び出しを行い、Webhookを登録します。

これでこの登録フローをWebhookイベントカード内で参照できるようになります。

リターンカード

リターンカードには登録データ（Registration Data）オブジェクトが含まれています。ユーザーが、Webhookイベントを含むフローを無効にすると、登録解除イベントフローがこのオブジェクト内に保存されている情報を参照してWebhookの登録を解除します。たとえば、これは一意の識別子を含むシンプルなオブジェクトである場合があります。

{  
  "webhook_id": "99b50e15-8809-47f1"  
}

このオブジェクトは、APIエンドポイント、URL、またはWebhookを登録するために必要な、サービスから返されるその他の情報で構成される場合もあります。Webhookイベントの登録を解除するを参照してください。

このフィールドは削除できません。また、リターンカードにその他のフィールドを定義することはできません。

次の手順