Okta Expression Languageとイベントフック

早期アクセスリリース。「早期アクセス機能とBeta機能を管理する」を参照してください。

Okta Expression Language（EL）式を使用して、Oktaイベントフックをトリガーする特定のイベントのみを識別します。イベントフックを作成または変更する際に、Okta EL式を使用して次のタスクを実行できます。

• イベントフックによってトリガーされるイベントのサブセットを許可するフィルターを定義する。

• イベントフックを処理する外部Webサービスに対するノイズを低減する。

Okta ELの詳細については、「Okta Expression Languageの概要」を参照してください。

構成情報

• イベントフックのフィルターを定義する際、式がブール値として評価されることを確認してください。

• 簡単な式から始めて、徐々に条件を追加してください。このアプローチは、式が期待通りに動作することを確認するのに役立ちます。

サポートされるフィルターフィールド

イベントフックでは、以下のフィールドのデータのみに基づいてイベントをフィルターできます。

演算子

• eqは等値演算子を示します。

• neは非等値演算子を示します。

• &&はAnd演算子を示します。

• ||はOr演算子を示します。

グループ条件を定義する

Okta ELを使用して、イベントフックをアクティブ化できるグループのリストを定義します。式がブール値で評価されることを確認します。グループを含める場合はTrue、イベントフックをアクティブしない場合はFalseです。

次の例では、Okta ELを使用して、Salesというグループのイベントフックをアクティブ化します。

event.target.?[type eq 'UserGroup' && displayName eq 'Sales'].size()> 0

...
   "target": [
      {
        "id": "00gsnc3qy7Uy6JZfy0h7",
        "type": "UserGroup",
        "alternateId": "unknown",
        "displayName": "Sales"
      }
    ],
...

グループ条件では次のイベントタイプを使用します。

• group.user_membership.add

• group.user_membership.remove

• group.lifecycle.create

• group.lifecycle.delete

• group.profile.update

• group.privilege.revoke

• group.privilege.grant

• system.import.group.create

• system.import.group.delete

式のサンプル

アプリケーション条件を定義する

Okta ELを使用して、イベントフックをアクティブ化できるアプリケーションのリストを定義します。式がブール値で評価されることを確認します。アプリケーションを含める場合はTrue、イベントフックをアクティブ化しない場合はFalseです。

次の例では、Okta ELを使用して、My COMPANY Bookmark Appという名前のブックマークアプリケーションのイベントフックをアクティブ化します。

event.target.?[type eq 'AppInstance' && alternateId eq 'My COMPANY Bookmark App'].size()> 0

...
     "target": [
        {
          "id": "0oat26meilfdn0Em90h7",
          "type": "AppInstance",
          "alternateId": "MY COMPANY Bookmark App",
          "displayName": "Bookmark App"
        },
...

アプリケーション条件では次のイベントタイプを使用します。

• application.lifecycle.create

• application.lifecycle.update

• application.lifecycle.delete

• application.lifecycle.activate

• application.lifecycle.deactivate

• application.user_membership.add

• application.user_membership.remove

• application.user_membership.change_password

• application.provision.user.sync

• app.oauth2.as.consent.grant

式のサンプル

ユーザープロファイル条件を定義する

Okta ELを使用して、イベントフックをアクティブ化するユーザープロファイル属性のリストを定義します。式がブール値で評価されることを確認します。アプリケーションを含める場合は True、イベントフックをアクティブ化しない場合はFalseです。

次の例では、Okta ELを使用して、メールが更新されたユーザーのイベントフックをアクティブ化します。

event.debugData.changedAttributes.contains('email')

..
     "debugContext": {
        "debugData": {
          "requestId": "XyMjlc1OvvWkZPMA7QazbwAAFIs",
          "threatSuspected": "false",
          "requestUri": "/api/v1/users/00ut27as6fbC0K3rS0h7",
          "changedAttributes": "email",
          "targetEventHookIds": "whot1dekaabE2suVh0h7",
          "url": "/api/v1/users/00ut27as6fbC0K3rS0h7?"
        }
      },
...

以下は、プロファイル条件の最も一般的なイベントタイプを表しています。

• user.account.update_profile

式のサンプル

サインイン条件を定義する

Okta ELを使用して、イベントフックをアクティブ化する特定のサインイン条件を定義します。式がブール値で評価されることを確認します。アプリケーションを含める場合はTrue、イベントフックをアクティブ化しない場合はFalseです。

このリストには、利用可能な結果のオプション（SUCCESS、FAILURE、SKIPPED、UNKNOWN、CHALLENGE、DENY）が表示されます。

次の例では、Okta ELを使用して、ユーザーサインインの成功イベントのイベントフックをアクティブ化します。

event.outcome.result eq'SUCCESS'

次の例では、Okta ELを使用して、ユーザーサインインの失敗イベントのイベントフックをアクティブ化します。

event.outcome.result eq'FAILURE'

以下は、サインイン条件の最も一般的なイベントタイプを表しています。

• user.session.start

式のサンプル

MFA要素条件を定義する

Okta ELを使用して、イベントフックをアクティブ化できるMFA要素のリストを定義します。式がブール値で評価されることを確認します。アプリケーションを含める場合はTrue、イベントフックをアクティブ化しない場合はFalseです。

次の例では、セキュリティ質問がMFA要素として設定されている場合に、Okta ELを使用してイベントフックをアクティブ化します。

event.outcome.reason.contains( 'SECURITY_QUESTION')

要素条件では次のイベントタイプを使用します。

• user.mfa.factor.activate

• user.mfa.factor.deactivate

式のサンプル

関連項目

イベントフックを確認する

イベントフック

イベントフックのプレビュー