イベントのペイロードに関する通知

オンラインで編集

以下の通知イベントのペイロードを使用して、イベント通知のWebhookやAPI向けの非同期ワークフローや同期処理をトリガーすることができます。

表 1. 属性について
名前 データ・タイプ 説明
data.action ストリング ユーザーがリソースに対して行う操作。
data.api_grant_type ストリング JWT内のgrant-type。
data.cause ストリング そのアクションを説明するメッセージ。
data.devicetype ストリング ブラウザのユーザーエージェント。
data.intraservice ストリング そのイベントがシステムによって実行されたか、それともティアアクションによって実行されたかを示します。
data.origin ストリング イベントの生成の原因となったシステムの IP アドレス。
data.performedby ストリング クラウドディレクトリのユーザーID、またはAPIクライアントのUUID。
data.performedby_realm ストリング その行動を行った人物の領域。
data.performedby_type ストリング API、デバイス、システム、またはユーザー。
data.performedby_username ストリング その操作を実行したユーザーのユーザー名。
data.realm ストリング

ユーザーの ID ソース。 例

クラウドディレクトリ - CloudIdentityRealm,

IBMid - www.ibm.com

SAML エンタープライズ - AzureRealm

LDAP パススルー - www.cloudsecurity.com

OIDC - www.yahoo.com
data.resource ストリング
  • fido2_metadata - FIDO2 デバイス・メタデータ: 作成、削除、変更
  • mfa_device: 作成、削除、変更
  • external_mfa: 開始、検索、試行
data.result ストリング イベントの結果。 例えば、成功か失敗か。
data.self ストリング リクエストのターゲットが、value によって実行されたリクエストと同じかどうかを指定します。 たとえば、スコットはスコットのMFA設定を更新します。
data.subject ストリング リソースに影響を受けているエンティティ。
data.targetid ストリング アクションのターゲットを定義するための補足情報。 リソースで使用されます: ユーザー、グループ
data.username ストリング Verifyにログインするための固有の識別子。 これは、ユーザーの E メール・アドレスと同一にすることができます。
data.webhook_id ストリング Webhookの一意の識別子。
注： Webhookフィールドは、外部MFAプロバイダーを使用する場合に追加されます。このフィールドは、MFAフロー中に通知イベントが発生した場合にのみ表示されます。
data.webhook_request_id ストリング Webhookから返される、Webhookリクエスト自体の固有の識別子。
注： Webhookフィールドは、外部MFAプロバイダーを使用する場合に追加されます。このフィールドは、MFAフロー中に通知イベントが発生した場合にのみ表示されます。
geoip.city_name

geoio.continent_name

geoip.country_iso_code

geoip.country_name

geoip.location

geoip.region_name

 ストリング data.origin を使用してイベント・サービスによって拡張

例

以下のコードはペイロードのサンプルです。 実際の属性を取得するには、Events API を使用してください。 https://docs.verify.ibm.com/verify/reference/getallevents および https://docs.verify.ibm.com/verify/docs/pulling-event-data を参照してください。

{
  "_index": "event-notice-2024.10-000001",
  "_type": "_doc",
  "_id": "1a1111a1-aa1a-111a-a11a-aa111a11a111",
  "_version": 1,
  "_score": 1,
  "_source": {
    "data": {
      "result": "failure",
      "performedby": "system",
      "targetid": "22222b22-2b2b-2222-bb22-22b222bb2222",
      "resource": "fido2_metadata",
      "action": "attempted",
      "devicetype": "system"
    },
    "year": 2024,
    "@metadata": {
      "source_dc": "ic-classic-dev-us02a"
    },
    "event_type": "notice",
    "month": 10,
    "indexed_at": 1727870534252,
    "@processing_time": 1503,
    "tenantid": "default",
    "tenantname": "c33c3ccc-c3c3-333c-3ccc-3c3333333333",
    "servicename": "factors",
    "id": "1a1111a1-aa1a-111a-a11a-aa111a11a111",
    "time": 1727870532749,
    "day": 2
  },
  "fields": {
    "data.performedby.lowercase": [
      "system"
    ],
    "year": [
      2024
    ],
    "data.devicetype.lowercase": [
      "system"
    ],
    "data.result": [
      "failure"
    ],
    "event_type.keyword": [
      "notice"
    ],
    "data.resource.lowercase": [
      "fido2_metadata"
    ],
    "data.result.lowercase": [
      "failure"
    ],
    "event_type": [
      "notice"
    ],
    "id.keyword": [
      "1a1111a1-aa1a-111a-a11a-aa111a11a111"
    ],
    "indexed_at": [
      "2024-10-02T12:02:14.252Z"
    ],
    "@processing_time": [
      1503
    ],
    "tenantid.keyword": [
      "default"
    ],
    "data.targetid": [
      "22222b22-2b2b-2222-bb22-22b222bb2222"
    ],
    "tenantid": [
      "default"
    ],
    "event_type.lowercase": [
      "notice"
    ],
    "@metadata.source_dc.lowercase": [
      "ic-classic-dev-us02a"
    ],
    "servicename": [
      "factors"
    ],
    "id": [
      "1a1111a1-aa1a-111a-a11a-aa111a11a111"
    ],
    "tenantid.lowercase": [
      "default"
    ],
    "day": [
      2
    ],
    "data.action.keyword": [
      "attempted"
    ],
    "data.performedby": [
      "system"
    ],
    "servicename.keyword": [
      "factors"
    ],
    "id.lowercase": [
      "1a1111a1-aa1a-111a-a11a-aa111a11a111"
    ],
    "servicename.lowercase": [
      "factors"
    ],
    "data.resource.keyword": [
      "fido2_metadata"
    ],
    "data.targetid.lowercase": [
      "22222b22-2b2b-2222-bb22-22b222bb2222"
    ],
    "data.targetid.keyword": [
      "22222b22-2b2b-2222-bb22-22b222bb2222"
    ],
    "data.performedby.keyword": [
      "system"
    ],
    "@metadata.source_dc.keyword": [
      "ic-classic-dev-us02a"
    ],
    "data.result.keyword": [
      "failure"
    ],
    "data.devicetype.keyword": [
      "system"
    ],
    "data.devicetype": [
      "system"
    ],
    "tenantname.lowercase": [
      "c33c3ccc-c3c3-333c-3ccc-3c3333333333"
    ],
    "month": [
      10
    ],
    "data.action": [
      "attempted"
    ],
    "data.resource": [
      "fido2_metadata"
    ],
    "tenantname.keyword": [
      "c33c3ccc-c3c3-333c-3ccc-3c3333333333"
    ],
    "tenantname": [
      "c33c3ccc-c3c3-333c-3ccc-3c3333333333"
    ],
    "time": [
      "2024-10-02T12:02:12.749Z"
    ],
    "@metadata.source_dc": [
      "ic-classic-dev-us02a"
    ],
    "data.action.lowercase": [
      "attempted"
    ]
  }
}