You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/id-governance/custom-data-resource-access-reviews.md
+16-8Lines changed: 16 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -79,6 +79,8 @@ With a catalog created, you can add custom data provided resource to it by doing
79
79
1. Select **Create**.
80
80
81
81
82
+
You can also create an access review programmatically using Microsoft Graph. For more information, see [Create a single stage access review on a catalog](/graph/api/accessreviewset-post-definitions?view=graph-rest-beta&tabs=http#example-6-create-a-single-stage-access-review-on-a-catalog).
83
+
82
84
## Get Access Review Object and Instance ID
83
85
84
86
After creating the catalog access review, but before uploading your custom data, you must get both the Access Review object ID, and the Access Review instance object ID. To get this information, you'd do the following:
@@ -115,6 +117,7 @@ After copying both the Access review object, and access review instance object,
115
117
> To confirm all CSVs were uploaded successfully, view the [audit logs](entitlement-management-logs-and-reporting.md).
116
118
1. You have **up to two hours** from the time the review enters the *Initializing* state to complete the upload.
117
119
120
+
You can also upload custom data via Graph, by creating an upload session and then uploading a CSV file. For more information, see [customDataProvidedResourceUploadSession](/graph/api/resources/customdataprovidedresourceuploadsession?view=graph-rest-beta).
118
121
119
122
## Active review state
120
123
@@ -126,33 +129,38 @@ At the **Active** stage:
126
129
## Applying stage
127
130
128
131
129
-
In the **Applying** stage, you manually get a list of denied users by making the following API call:
132
+
In the **Applying** stage, you can get a list of denied users by making the [list decisions](/graph/api/accessreviewinstance-list-decisions?view=graph-rest-beta&tabs=http) API call:
130
133
131
134
```http
132
-
GET /identityGovernance/accessReviews/definitions/{access review object ID}/instances/{access review instance object ID}/decisions?$filter=(decision eq ‘Deny’ and resourceId eq ‘<custom data provided resource ID>’)
135
+
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitions/{access review object ID}/instances/{access review instance object ID}/decisions?$filter=(decision eq 'Deny' and resourceId eq '<custom data provided resource ID>')
133
136
```
134
137
135
138
For each decision item:
136
139
137
-
Remove access from your own system and Patch each decision item to indicate success or failure for removal by making the following API call:
140
+
Remove access from your own system and then patch each decision item to indicate success or failure for removal by making the [update accessReviewInstanceDecisionItem](/graph/api/accessreviewinstancedecisionitem-update?view=graph-rest-beta&tabs=http) API call:
The review transition to the **Applied** state once all the custom data provided decisions have been applied. For example, if you have five decisions that must be made from the data, you must apply(PATCH) five decisions before the review transitions to **Applied**.
152
+
The review transition to the **Applied** state once all the custom data provided decisions have been applied. For example, if you have five decisions that must be made from the data, you must apply using PATCH each of five decision items before the review transitions to **Applied**.
145
153
146
154
147
155
148
156
149
-
## Complete and apply review decisions
157
+
## Review status
150
158
151
159
As reviewers take actions, the review progresses through several states:
152
160
153
161
| Review Status | Description |
154
162
|--------------------|-----------------|
155
-
| Initializing | Review created; waiting for custom data upload. |
163
+
| Initializing | Review instance created; waiting for custom data upload. |
156
164
| Active | Reviewers can take decisions in the My Access portal. |
157
165
| Applying | Review decisions are being remediated. |
158
166
| Applied | All decisions are marked as applied. |
0 commit comments