管理イベントのペイロードをリクエストする
以下のリクエスト管理イベントのペイロードを使用すると、イベント通知のWebhookやAPIに対して、非同期ワークフローや同期処理をトリガーすることができます。
次の表は、アクセス要求イベントに含まれる属性を示しています。
| 名前 | データ・タイプ | 説明 |
|---|---|---|
| data.action | ストリング | ユーザーがリソースに対して行う操作。 |
| data.approver | ストリング | 割り当てられたリクエストに対してアクションを実行した承認者を指定します。 |
| data.approver_comment | ストリング | 承認者のコメントを指定します。 |
| data.approvers | 配列リスト | 割り当てられたリクエストに対してアクションを実行できる承認者のリストを指定します。 |
| data.beneficiary | ストリング | リクエストの受信者を指定します。 |
| data.cause | ストリング | エラーメッセージを指定します。 |
| data.creationDate | ストリング | リクエストが作成された時刻を指定します。 |
| data.current_step | ストリング | マルチステップフローにおける現在のステップ名を指定します。 |
| data.entitlement_name | ストリング | 権限の名前を指定します。 |
| data.entitlement_rights | List<String> | エンタイトルメントの権限を指定します。 |
| data.entitlement_type | ストリング | 権利の種類を指定します。 |
| data.justification | ストリング | リクエストの理由を指定します。 |
| data.performedby | ストリング | そのインスタンスに対して操作を実行したユーザーID。 |
| data.reference | ストリング | リクエストの参照を指定します。 複数の権限をまとめてリクエストする場合、参照情報はすべてのリクエストで共通です。 |
| data.request | ストリング | リクエストの一意の識別子( RequestId )を指定します。 |
| data.request_number | ストリング | リクエストを追跡するためのリクエスト番号を指定します。 |
| data.requestor | ストリング | 依頼者のIDを指定します。 |
| data.resource | ストリング | フローの種類。 例えば、給付資格など。 |
| data.status | ストリング | リクエストの状態を指定します。 |
| data.workflow | ストリング | リクエストに関連付けられたワークフローを指定します。 |
| data.workflow_configuration | List<String> | リクエストに関連付けられたワークフローの設定を指定します。 |
例
以下のコードはペイロードのサンプルです。 実際の属性を取得するには、Events API を使用してください。 https://docs.verify.ibm.com/verify/reference/getallevents および https://docs.verify.ibm.com/verify/docs/pulling-event-data を参照してください。
{"data": {
"action": "APPROVE",
"approver": "jane.doe",
"approver_comment": "Request approved due to valid justification.",
"approvers": ["jane.doe", "john.smith"],
"beneficiary": "alice.johnson",
"cause": "N/A",
"creationDate": "2025-05-20T14:30:00Z",
"current_step": "ManagerApproval",
"entitlement_name": "Admin Access",
"entitlement_rights": ["READ", "WRITE", "EXECUTE"],
"entitlement_type": "Role-Based Access",
"justification": "Required access to manage system configurations.",
"performedby": "jane.doe",
"reference": "REF-20250520-1234",
"request": "REQ-0001234567",
"request_number": "AR-20250520-7890",
"requestor": "bob.martin",
"resource": "grant-entitlement",
"status": "APPROVED",
"workflow": "WF-AccessApproval-01",
"workflow_configuration": ["Step1:Submit", "Step2:ManagerApproval", "Step3:FinalApproval"]
}