証明タスクのアクション
証明タスクのアクションの場合、次のURIを使用します。
-
/certifications GETログイン・ユーザーの証明を返します -
/certifications/{certid} GET証明の詳細を返します -
/certifications/{certid}/tasks GET証明に関連付けられたすべてのタスクを返します -
/certification/{certid}/tasks PUT証明に関連付けられたすべてのタスクを更新します -
/certifications/{certid}/tasks/{taskid} GET指定されたタスクの詳細を返します -
/certifications/{certid}/tasks/{taskid} PUTタスクの失効、タスクのプロキシの作成など、タスクへの更新を許可します -
/certifications/{certid}/tasks/{taskid}/lineitems/ GETタスクに関連付けられた明細項目を返します -
/certifications/{certid/tasks/{taskid}/lineitems PUT要求、棄権の失効、完了など、明細項目に関連付けられたアクションを更新します -
/certifications/{certid}/tasks/{taskid}/lineitems/{lineitemid} GETタスクに関連付けられた明細項目の詳細を返します -
/certifications/{certid}/tasks/[taskid}/lineitems/{linieitemid} PUT単一の明細項目に関連付けられたアクションを更新します
cURLの例: 証明の取得
curl -H "Content-Type: application/json" -X GET -u username:password https://pseudo.com/iam/governance/selfservice/api/v1/certifications
GETレスポンス本文
{
"links": [
{
"rel": "self",
"href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications?offset=1&limit=10"
},
{
"rel": "first",
"href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications?offset=1&limit=10"
}
],
"count": 1,
"hasMore": false,
"totalResult": -1,
"certifications": [
{
"links": [
{
"rel": "self",
"href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677"
}
],
"state": "ASSIGNED",
"name": "userCert [ Ajay Arora ]",
"type": "User",
"id": "1",
"asignee": "aarora",
"createdDate": "2019-07-02T17:05:21Z",
"soaTaskId": "3958c454-a7bb-4390-ba28-36b90c1acf42",
"taskId": "164b640d-e192-4177-8d1b-dc440e260677"
}
]
}
cURLの例: 証明の詳細の取得
curl -H "Content-Type: application/json" -X GET -u username:password https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1
GETレスポンス本文
{
"links": [
{
"rel": "self",
"href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1"
}
],
"certificationDefinitions": [
{
"name": "status",
"value": "New"
},
{
"name": "assignee",
"value": "17"
},
{
"name": "createdDate",
"value": "2019-07-02T17:05:19Z"
},
{
"name": "name",
"value": "userCert [ Ajay Arora ] "
},
{
"name": "id",
"value": "1"
},
{
"name": "percentComplete",
"value": 0
},
{
"name": "type",
"value": "User"
},
{
"name": "users",
"value": 1
},
{
"name": "roleAssignments",
"value": "0 of 2 completed"
},
{
"name": "accountAssignments",
"value": "0 of 0 completed"
},
{
"name": "entitlementAssignments",
"value": "0 of 0 completed"
}
]
}
cURLの例: 証明タスクの取得
curl -H "Content-Type: application/json" -X GET -u username:password https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks
GETレスポンス本文
{
"links": [
{
"rel": "self",
"href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks"
}
],
"count": 1,
"certifications": [
{
"links": [
{
"rel": "self",
"href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677"
}
],
"state": "ASSIGNED",
"name": "userCert [ Ajay Arora ]",
"type": "User",
"id": "1",
"asignee": "aarora",
"createdDate": "2019-07-02T17:05:21Z",
"soaTaskId": "3958c454-a7bb-4390-ba28-36b90c1acf42",
"taskId": "164b640d-e192-4177-8d1b-dc440e260677"
}
]
}
cURLの例: 証明タスクの更新
curl -H "Content-Type: application/json" -X PUT -u username:password https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks
PUTリクエスト本文
{
"tasks": [
{
"id": "164b640d-e192-4177-8d1b-dc440e260677",
"action": "suspend"
}
]
}
PUTレスポンス本文
{
"links": [
{
"rel": "self",
"href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks"
}
],
"tasks": [
{
"links": [
{
"rel": "self",
"href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677"
}
],
"id": "164b640d-e192-4177-8d1b-dc440e260677",
"action": "suspend",
"status": "SUCCESS"
}
]
}
cURLの例: タスクの詳細を返す
curl -H "Content-Type: application/json" -X GET -u username:password https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677
GETレスポンス本文
{
"links": [
{
"rel": "self",
"href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677"
}
],
"taskId": "164b640d-e192-4177-8d1b-dc440e260677",
"taskName": "userCert [ Ajay Arora ] ",
"reviewer": {
"links": [
{
"rel": "reviewer",
"href": "https://pseudo.com/iam/governance/selfservice/api/v1/users/17"
}
],
"id": "17",
"displayName": "Ajay Arora"
},
"status": 1,
"certificationInstance": {
"id": "1"
},
"startDate": "2019-07-02T17:05:20Z",
"certificationState": "11",
"percentComplete": 0
}
cURLの例: タスクの更新
curl -H "Content-Type: application/json" -H "X-Requested-By: <anyvalue>" -X PUT -u username:password -d @put.json https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677
PUTリクエスト本文
{
"action" : "suspend"
}
PUTレスポンス本文
{
"links": [
{
"rel": "self",
"href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677"
}
],
"id": "164b640d-e192-4177-8d1b-dc440e260677",
"action": "suspend",
"status": "SUCCESS",
"fields": [
{
"name": "state",
"value": "SUSPENDED"
},
{
"name": "assignees",
"value": [
"Ajay Arora"
]
}
]
}
cURLの例: タスクの明細項目を返す
curl -H "Content-Type: application/json" -X GET -u username:password https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems
GETレスポンス本文
{
"links": [
{
"rel": "self",
"href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems?offset=1&limit=10"
},
{
"rel": "first",
"href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems?offset=1&limit=10"
}
],
"count": 1,
"hasMore": false,
"totalResult": -1,
"certLineItemList": [
{
"links": [
{
"rel": "self",
"href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems/1"
}
],
"action": "1",
"percentComplete": 0,
"certifiedBy": "AARORA",
"certifyDate": "2019-07-02T17:48:56Z",
"status": "CERTIFIED",
"entityId": 1,
"id": 1,
"createUser": "XELSYSADM",
"updateDate": "2019-06-19T19:45:55Z",
"updateUser": "BKIDDO",
"userLogin": "BKIDDO",
"firstName": "Beatrix",
"lastName": "Kiddo",
"roles": 2,
"accounts": 0,
"entitlements": 0,
"employeeType": "Full-Time Employee",
"identityStatus": "Active",
"manager": "AARORA",
"organization": "Vision",
"accStatus": "false",
"email": "beatrix.kiddo@vision.com",
"iamUserId": 24,
"fullName": "Kiddo, Beatrix"
}
]
}
cURLの例: 明細項目のステータスのリセット
curl -H "Content-Type: application/json" -H "X-Requested-By: <anyvalue>" -X PUT -u username:password -d @put.json https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems
PUTリクエスト本文
{
"lineItems": [
{
"requestId": "100",
"lineItemId": "1",
"action": "ResetStatus",
"comments": "test ResetStatus"
},
{
"requestId": "101",
"lineItemId": "1",
"action": "EditComment",
"comments": "test EditComment"
}
]
}
PUTレスポンス本文
{
"links": [
{
"rel": "self",
"href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems"
}
],
"lineItems": [
{
"links": [
{
"rel": "self",
"href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems/1"
}
],
"action": "ResetStatus",
"requestId": "100",
"lineItemId": "1",
"status": "SUCCESS"
},
{
"links": [
{
"rel": "self",
"href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems/1"
}
],
"action": "EditComment",
"requestId": "101",
"lineItemId": "1",
"status": "SUCCESS"
}
]
}
cURLの例: 明細項目の詳細を返す
curl -H "Content-Type: application/json" -X GET -u username:password https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems/1"
GETレスポンス本文
{
"links": [
{
"rel": "self",
"href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems/1?offset=1&limit=10"
},
{
"rel": "first",
"href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems/1?offset=1&limit=10"
}
],
"count": 2,
"hasMore": false,
"totalResult": -1,
"lineItemDetails": [
{
"id": 1,
"entityId": 2,
"parentEntityId": 1,
"lastReviewerId": 17,
"lastReviewerTaskUid": "164b640d-e192-4177-8d1b-dc440e260677",
"riskSummary": 0,
"itemRisk": 0,
"category": "Role",
"lastDecision": 5,
"entityType": "USER_ROLE",
"provisionedBy": 1007,
"provisioningMethod": 3,
"provMechRisk": 0,
"requestId": {
"name": "requestId",
"value": "1007",
"link": {
"rel": "self",
"href": "https://pseudo.com/iam/governance/selfservice/api/v1/requests/1007"
}
},
"openSodViolations": false,
"roleId": 2,
"sodRisk": 0,
"userId": 1,
"displayName": "Bankcard Services Lead",
"name": "Bankcard Services Lead",
"catalogType": "Role",
"auditObjective": "SOX Compliance",
"dataOwner": 7,
"dataOwnerLogin": "HHANZO",
"dataOwnerDisplayName": "Hattori Hanzo",
"iamId": 12
},
{
"id": 2,
"entityId": 1,
"parentEntityId": 1,
"lastReviewerId": 17,
"lastReviewerTaskUid": "164b640d-e192-4177-8d1b-dc440e260677",
"riskSummary": 0,
"itemRisk": 0,
"category": "Role",
"lastDecision": 5,
"entityType": "USER_ROLE",
"provisionedBy": 1006,
"provisioningMethod": 3,
"provMechRisk": 0,
"requestId": {
"name": "requestId",
"value": "1006",
"link": {
"rel": "self",
"href": "https://pseudo.com/iam/governance/selfservice/api/v1/requests/1006"
}
},
"openSodViolations": false,
"roleId": 1,
"sodRisk": 0,
"userId": 1,
"displayName": "Bankcard Services Analyst",
"name": "Bankcard Services Analyst",
"catalogType": "Role",
"auditObjective": "SOX Compliance",
"dataOwner": 7,
"dataOwnerLogin": "HHANZO",
"dataOwnerDisplayName": "Hattori Hanzo",
"iamId": 13
}
]
}
cURLの例: 単一明細項目アクションの更新
curl -H "Content-Type: application/json" -H "X-Requested-By: <anyvalue>" -X PUT -u username:password -d @put.json https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems/1"
PUTリクエスト本文
{
"lineItem": {
"action": "Complete",
"fields": [
{
"name": "comment",
"value": "test complete"
}
]
}
}
PUTレスポンス本文
{
"links": [
{
"rel": "self",
"href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems/1"
}
],
"lineItem": {
"action": "Complete",
"status": "SUCCESS",
"lineItemId": "1"
}
}