알림 이벤트 페이로드

온라인에서 편집하기

다음 알림 이벤트 페이로드를 사용하여 이벤트 알림 웹훅 및 API에 대한 비동기 워크플로와 동기화를 트리거할 수 있습니다.

표 1. 속성 알림
이름 데이터 유형 설명
data.action 문자열 사용자가 해당 리소스에 대해 수행하는 작업.
data.api_grant_type 문자열 JWT의 그랜트 유형.
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로 수행된 요청과 동일한지 여부를 지정합니다. 예를 들어, Scott은 Scott의 MFA 설정을 업데이트합니다.
data.subject 문자열 자원이 영향을 받고 있는 주체.
data.targetid 문자열 조치의 대상을 정의하는 추가 정보. 리소스에서 사용됨: user, group
data.username 문자열 Verify에 로그인하기 위한 고유 식별자입니다. 사용자의 이메일 주소와 동일할 수 있습니다.
data.webhook_id 문자열 웹훅의 고유 식별자.
참고: 웹훅 필드는 외부 MFA 제공업체를 사용할 때 추가됩니다. 이 필드는 MFAP 흐름 중에 발생된 알림 이벤트에서만 표시됩니다.
data.webhook_request_id 문자열 웹훅에서 반환되는 웹훅 요청 자체의 고유 식별자입니다.
참고: 웹훅 필드는 외부 MFA 제공업체를 사용할 때 추가됩니다. 이 필드는 MFAP 흐름 중에 발생된 알림 이벤트에서만 표시됩니다.
geoip.city_name

geoio.continent_name

geoip.country_iso_code

geoip.country_name

geoip.location

geoip.region_name

 문자열 data.origin을 사용하여 이벤트 서비스에서 보강되었습니다.

예제

다음 코드는 샘플 페이로드입니다. 이벤트 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"
    ]
  }
}