Collection Contracts — Okta
01How to read this page #sec_900d4e5d
Each resource that REVIEWIT can collect for Okta has a published contract. It is read like an API reference: what REVIEWIT calls on the collected service and by what means, what the contract requires for the collection to execute, and the data that REVIEWIT retains. REVIEWIT only performs reads.
- Calls: the requests that REVIEWIT sends to the collected service, all in read mode.
- Requirements: each must be satisfied. Its nature indicates what it demands: a right to grant to the identifier, an administration condition (a setting or assignment at the provider that the token does not carry, verified by a real read call), or the identifier's membership in the connection's Okta organization. The rule states how many options are needed: « required » for the single option, « one of » when one is sufficient (they are ranked from narrowest to broadest: prefer the first), « all », or « N of M ».
- Operational conditions: what REVIEWIT verifies before each collection, beyond the requirements.
- Freshness: the maximum age of the verifications on which the verdict is based, set by each contract (here: verifications less than 24 h old; rights must be verified by a real call). REVIEWIT automatically redoes verifications it can perform within this period (token obtained, service responding); « Verify rights », in the connection menu, redoes them on demand. As long as the real call has not been made, the rights remain unverified.
- Data retained: the fields that REVIEWIT keeps from each object; the role indicates what the review does with it.
The verdict of each resource, for your connection, is read on its card. A resource that the connection does not collect can still be fed by importing a report (« Import a report »).
02How REVIEWIT verifies requirements #sec_2df3a117
The Okta token does not carry its rights: the contract requires that they be verified by a real call, in read mode. REVIEWIT does not yet make this call for Okta: it verifies that the token is obtained and that the service responds, but not the rights listed here. Resources are displayed as « Not verified »; they can still be fed by importing a report (« Import a report »).
03Call paths #sec_082df6f4
A path indicates which token REVIEWIT obtains for the identifier: who issues it and for which audience. The addresses called are listed in the calls of each resource; a path starting with « / » is called on the token's audience of its path.
| Path | Token issued by | Token audience | Identifier authentication |
|---|---|---|---|
| okta.management.reviewit.service-app-key | https://{okta-domain}/oauth2/v1/token | https://{okta-domain} | key pair (private_key_jwt) |
In these addresses, {okta-domain} is the Okta domain of the organization (e.g., acme.okta.com or acme.okta-emea.com ).
04API credentials · API tokens #sec_8c7b77dc
okta.credentials.api-tokens:collect · contract revision 1, published on October 18, 2026 · path okta.management.reviewit.service-app-key
Organization API tokens: their bearer, their last use, their expiration
Calls
- GET /api/v1/api-tokens
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | required | okta.apiTokens.read |
| Membership | required | the identifier belongs to the connection's Okta organization |
Operational conditions
- a token is obtained for the identifier
- the service https://{okta-domain} responds
Freshness: verifications less than 24 h old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| TokenId | object key | text | yes |
| Name | displayed to recognize the object | text | yes |
| UserId | context, no effect on the review | text | no |
| Login | displayed to recognize the object | text | no |
| Created | context, no effect on the review | date and time | no |
| LastUpdated | context, no effect on the review | date and time | no |
| ExpiresOn | context, no effect on the review | date and time | no |
05API credentials · OAuth consents #sec_ade404c2
okta.credentials.oauth-grants:collect · contract revision 1, published on October 18, 2026 · path okta.management.reviewit.service-app-key
OAuth consents granted by a person to an application
Calls
- GET /api/v1/apps/{id}/grants
- GET /api/v1/users/{id}/grants
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | all | okta.appGrants.read and okta.users.read |
| Membership | required | the identifier belongs to the Okta organization of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://{okta-domain} responds
Freshness: checks less than 24 h; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| GrantId | object key | text | yes |
| UserId | context, no effect on the review | text | no |
| Login | displayed to recognize the object | text | yes |
| ClientId | context, no effect on the review | text | no |
| AppName | displayed to recognize the object | text | no |
| Scope | context, no effect on the review | text | no |
| Status | context, no effect on the review | text | no |
| Created | context, no effect on the review | date and time | no |
| LastUpdated | context, no effect on the review | date and time | no |
06Application assignments · Applications #sec_2db8add4
okta.apps.applications:collect · contract revision 1, published on October 18, 2026 · path okta.management.reviewit.service-app-key
Applications of the organization, their single authentication mode and their status
Calls
- GET /api/v1/apps
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | required | okta.apps.read |
| Membership | required | the identifier belongs to the Okta organization of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://{okta-domain} responds
Freshness: checks less than 24 h; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| AppId | object key | text | yes |
| Label | displayed to recognize the object | text | yes |
| SignOnMode | context, no effect on the review | text | no |
| Status | context, no effect on the review | text | no |
| Created | context, no effect on the review | date and time | no |
| LastUpdated | context, no effect on the review | date and time | no |
| Visibility | context, no effect on the review | text | no |
07Application assignments · Application assignments (groups) #sec_26496090
okta.apps.group-assignments:collect · contract revision 1, published on October 18, 2026 · path okta.management.reviewit.service-app-key
Groups assigned to an application, and the profile they carry there. Line key: AppId | GroupId.
Calls
- GET /api/v1/apps/{id}/groups
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | required | okta.apps.read |
| Right | required | okta.groups.read |
| Membership | required | the identifier belongs to the Okta organization of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://{okta-domain} responds
Freshness: checks less than 24 h; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| AssignmentKey | object key | text | yes |
| AppId | context, no effect on the review | text | yes |
| Label | displayed to recognize the object | text | yes |
| GroupId | context, no effect on the review | text | yes |
| GroupName | displayed to recognize the object | text | no |
| Priority | context, no effect on the review | integer | no |
| Created | context, no effect on the review | date and time | no |
| LastUpdated | context, no effect on the review | date and time | no |
08Application assignments · Application assignments (users) #sec_894bdc62
okta.apps.user-assignments:collect · contract revision 1, published on October 18, 2026 · path okta.management.reviewit.service-app-key
People assigned to an application, directly or through a group. Line key: AppId | UserId.
Calls
- GET /api/v1/apps/{id}/users
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | required | okta.apps.read |
| Right | required | okta.users.read |
| Membership | required | the identifier belongs to the Okta organization of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://{okta-domain} responds
Freshness: checks less than 24 h; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| AssignmentKey | object key | text | yes |
| AppId | context, no effect on the review | text | yes |
| Label | displayed to recognize the object | text | yes |
| UserId | context, no effect on the review | text | yes |
| Login | displayed to recognize the object | text | no |
| context, no effect on the review | text | no | |
| Scope | context, no effect on the review | text | no |
| Status | context, no effect on the review | text | no |
| Created | context, no effect on the review | date and time | no |
| LastUpdated | context, no effect on the review | date and time | no |
09Directory · Never activated accounts #sec_0c88c27f
okta.directory.pending-users:collect · contract revision 1, published on October 18, 2026 · path okta.management.reviewit.service-app-key
Accounts created and never activated (STAGED, PROVISIONED): accesses granted that no one has taken
Calls
- GET /api/v1/users?filter=status eq "STAGED" or status eq "PROVISIONED"
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | required | okta.users.read |
| Membership | required | the identifier belongs to the Okta organization of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://{okta-domain} responds
Freshness: checks less than 24 hours old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| UserId | object key | text | yes |
| Login | displayed to recognize the object | text | yes |
| displayed to recognize the object | text | no | |
| FirstName | context, no effect on the review | text | no |
| LastName | context, no effect on the review | text | no |
| Status | context, no effect on the review | text | no |
| Created | context, no effect on the review | date and time | no |
| Activated | context, no effect on the review | date and time | no |
10Directory · Closed accounts #sec_4c6f05aa
okta.directory.suspended-users:collect · contract revision 1, published on October 18, 2026 · path okta.management.reviewit.service-app-key
Suspended (SUSPENDED) or deactivated (DEPROVISIONED) accounts, and the accesses they retain
Calls
- GET /api/v1/users?filter=status eq "SUSPENDED" or status eq "DEPROVISIONED"
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | required | okta.users.read |
| Membership | required | the identifier belongs to the Okta organization of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://{okta-domain} responds
Freshness: checks less than 24 hours old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| UserId | object key | text | yes |
| Login | displayed to recognize the object | text | yes |
| displayed to recognize the object | text | no | |
| Status | context, no effect on the review | text | no |
| StatusChanged | context, no effect on the review | date and time | no |
| LastLogin | evaluated by REVIEWIT policies (date of last activity) | date and time | no |
| ManagerId | context, no effect on the review | text | no |
11Directory · Users #sec_c542f4bc
okta.directory.users:collect · contract revision 1, published on October 18, 2026 · path okta.management.reviewit.service-app-key
Organization accounts: status, last login, declared manager
Calls
- GET /api/v1/users
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | required | okta.users.read |
| Membership | required | the identifier belongs to the Okta organization of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://{okta-domain} responds
Freshness: checks less than 24 hours old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| UserId | object key | text | yes |
| Login | displayed to recognize the object | text | yes |
| displayed to recognize the object | text | no | |
| FirstName | context, no effect on the review | text | no |
| LastName | context, no effect on the review | text | no |
| DisplayName | displayed to recognize the object | text | no |
| Status | context, no effect on the review | text | no |
| Department | context, no effect on the review | text | no |
| Title | context, no effect on the review | text | no |
| ManagerId | context, no effect on the review | text | no |
| Created | context, no effect on the review | date and time | no |
| LastLogin | evaluated by REVIEWIT policies (date of last activity) | date and time | no |
12Groups · Group rules #sec_b839b944
okta.groups.group-rules:collect · contract revision 1, published on October 18, 2026 · path okta.management.reviewit.service-app-key
Dynamic membership rules: what gets someone into a group without being added there
Calls
- GET /api/v1/groups/rules
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | required | okta.groups.read |
| Membership | required | the identifier belongs to the Okta organization of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://{okta-domain} responds
Freshness: checks less than 24 hours old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| RuleId | object key | text | yes |
| Name | displayed to recognize the object | text | yes |
| Status | context, no effect on the review | text | no |
| Expression | context, no effect on the review | text | no |
| AssignedGroupIds | context, no effect on the review | text | no |
| AssignedGroupNames | context, no effect on the review | text | no |
| Created | context, no effect on the review | date and time | no |
| LastUpdated | context, no effect on the review | date and time | no |
13Groups #sec_439851da
okta.groups.groups:collect · contract revision 1, published on October 18, 2026 · path okta.management.reviewit.service-app-key
Organization groups: those created in Okta, those imported from an application or directory (AD, LDAP), and integrated groups
Calls
- GET /api/v1/groups
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | required | okta.groups.read |
| Membership | required | the identifier belongs to the Okta organization of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://{okta-domain} responds
Freshness: checks less than 24 h old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| GroupId | object key | text | yes |
| Name | displayed to recognize the object | text | yes |
| Description | context, no effect on the review | text | no |
| Type | context, no effect on the review | text | no |
| Created | context, no effect on the review | date and time | no |
| LastUpdated | context, no effect on the review | date and time | no |
| LastMembershipUpdated | evaluated by REVIEWIT policies (date of last activity) | date and time | no |
14Groups · Group members #sec_8c8f31d8
okta.groups.memberships:collect · contract revision 1, published on October 18, 2026 · path okta.management.reviewit.service-app-key
Membership of a group, person by person. Line key: GroupId | UserId.
Calls
- GET /api/v1/groups/{id}/users
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | required | okta.groups.read |
| Membership | required | the identifier belongs to the Okta organization of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://{okta-domain} responds
Freshness: checks less than 24 h old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| MembershipKey | object key | text | yes |
| GroupId | context, no effect on the review | text | yes |
| GroupName | displayed to recognize the object | text | yes |
| UserId | context, no effect on the review | text | yes |
| Login | displayed to recognize the object | text | no |
| context, no effect on the review | text | no | |
| Status | context, no effect on the review | text | no |
15Privileged roles · Custom administrator roles #sec_6361c4e3
okta.privileged-roles.custom-roles:collect · contract revision 1, published on October 18, 2026 · path okta.management.reviewit.service-app-key
Client-defined administration roles, and the permissions they carry
Calls
- GET /api/v1/iam/roles
- GET /api/v1/iam/roles/{roleId}/permissions
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | required | okta.roles.read |
| Membership | required | the identifier belongs to the Okta organization of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://{okta-domain} responds
Freshness: checks less than 24 h old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| RoleId | object key | text | yes |
| Label | displayed to recognize the object | text | yes |
| Description | context, no effect on the review | text | no |
| Permissions | context, no effect on the review | text | no |
| Created | context, no effect on the review | date and time | no |
| LastUpdated | context, no effect on the review | date and time | no |
16Privileged roles · Administrator role assignments #sec_7a8dffad
okta.privileged-roles.role-assignments:collect · contract revision 1, published on October 18, 2026 · path okta.management.reviewit.service-app-key
Administration roles granted to a person, and their scope
Calls
- GET /api/v1/iam/assignees/users
- GET /api/v1/users/{id}/roles
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | required | okta.roles.read |
| Right | required | okta.users.read |
| Membership | required | the identifier belongs to the Okta organization of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://{okta-domain} responds
Freshness: checks less than 24 h old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| AssignmentId | object key | text | yes |
| Type | context, no effect on the review | text | no |
| RoleLabel | displayed to recognize the object | text | yes |
| PrincipalId | context, no effect on the review | text | yes |
| PrincipalLogin | displayed to recognize the object | text | no |
| PrincipalKind | context, no effect on the review | text | no |
| ResourceSetId | context, no effect on the review | text | no |
| Created | context, no effect on the review | date and time | no |
| LastUpdated | context, no effect on the review | date and time | no |
17To go further #sec_52993119
- Understand a collection connection
- Rights reference by resource
- Read a verdict