REVIEWITDocumentation
This page is generated from Catalogue publié — Okta — it cannot be corrected by hand.Correcting the contract corrects the page. Editing it here would be lost at the next generation.GENERATED ON 18 October 2026 · catalogue v23 · a36ea8a4
Generated referenceUp to date · generated on 18 October 2026

Collection Contracts — Okta

Machine translation, not yet reviewedThis page was translated by a model from the French version, which is authoritative. Read the French version.

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.

PathToken issued byToken audienceIdentifier authentication
okta.management.reviewit.service-app-keyhttps://{okta-domain}/oauth2/v1/tokenhttps://{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

NatureRuleOptions
Rightrequiredokta.apiTokens.read
Membershiprequiredthe 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

FieldRoleTypeRequired
TokenIdobject keytextyes
Namedisplayed to recognize the objecttextyes
UserIdcontext, no effect on the reviewtextno
Logindisplayed to recognize the objecttextno
Createdcontext, no effect on the reviewdate and timeno
LastUpdatedcontext, no effect on the reviewdate and timeno
ExpiresOncontext, no effect on the reviewdate and timeno

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

NatureRuleOptions
Rightallokta.appGrants.read and okta.users.read
Membershiprequiredthe 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

FieldRoleTypeRequired
GrantIdobject keytextyes
UserIdcontext, no effect on the reviewtextno
Logindisplayed to recognize the objecttextyes
ClientIdcontext, no effect on the reviewtextno
AppNamedisplayed to recognize the objecttextno
Scopecontext, no effect on the reviewtextno
Statuscontext, no effect on the reviewtextno
Createdcontext, no effect on the reviewdate and timeno
LastUpdatedcontext, no effect on the reviewdate and timeno

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

NatureRuleOptions
Rightrequiredokta.apps.read
Membershiprequiredthe 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

FieldRoleTypeRequired
AppIdobject keytextyes
Labeldisplayed to recognize the objecttextyes
SignOnModecontext, no effect on the reviewtextno
Statuscontext, no effect on the reviewtextno
Createdcontext, no effect on the reviewdate and timeno
LastUpdatedcontext, no effect on the reviewdate and timeno
Visibilitycontext, no effect on the reviewtextno

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

NatureRuleOptions
Rightrequiredokta.apps.read
Rightrequiredokta.groups.read
Membershiprequiredthe 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

FieldRoleTypeRequired
AssignmentKeyobject keytextyes
AppIdcontext, no effect on the reviewtextyes
Labeldisplayed to recognize the objecttextyes
GroupIdcontext, no effect on the reviewtextyes
GroupNamedisplayed to recognize the objecttextno
Prioritycontext, no effect on the reviewintegerno
Createdcontext, no effect on the reviewdate and timeno
LastUpdatedcontext, no effect on the reviewdate and timeno

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

NatureRuleOptions
Rightrequiredokta.apps.read
Rightrequiredokta.users.read
Membershiprequiredthe 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

FieldRoleTypeRequired
AssignmentKeyobject keytextyes
AppIdcontext, no effect on the reviewtextyes
Labeldisplayed to recognize the objecttextyes
UserIdcontext, no effect on the reviewtextyes
Logindisplayed to recognize the objecttextno
Emailcontext, no effect on the reviewtextno
Scopecontext, no effect on the reviewtextno
Statuscontext, no effect on the reviewtextno
Createdcontext, no effect on the reviewdate and timeno
LastUpdatedcontext, no effect on the reviewdate and timeno

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

NatureRuleOptions
Rightrequiredokta.users.read
Membershiprequiredthe 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

FieldRoleTypeRequired
UserIdobject keytextyes
Logindisplayed to recognize the objecttextyes
Emaildisplayed to recognize the objecttextno
FirstNamecontext, no effect on the reviewtextno
LastNamecontext, no effect on the reviewtextno
Statuscontext, no effect on the reviewtextno
Createdcontext, no effect on the reviewdate and timeno
Activatedcontext, no effect on the reviewdate and timeno

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

NatureRuleOptions
Rightrequiredokta.users.read
Membershiprequiredthe 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

FieldRoleTypeRequired
UserIdobject keytextyes
Logindisplayed to recognize the objecttextyes
Emaildisplayed to recognize the objecttextno
Statuscontext, no effect on the reviewtextno
StatusChangedcontext, no effect on the reviewdate and timeno
LastLoginevaluated by REVIEWIT policies (date of last activity)date and timeno
ManagerIdcontext, no effect on the reviewtextno

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

NatureRuleOptions
Rightrequiredokta.users.read
Membershiprequiredthe 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

FieldRoleTypeRequired
UserIdobject keytextyes
Logindisplayed to recognize the objecttextyes
Emaildisplayed to recognize the objecttextno
FirstNamecontext, no effect on the reviewtextno
LastNamecontext, no effect on the reviewtextno
DisplayNamedisplayed to recognize the objecttextno
Statuscontext, no effect on the reviewtextno
Departmentcontext, no effect on the reviewtextno
Titlecontext, no effect on the reviewtextno
ManagerIdcontext, no effect on the reviewtextno
Createdcontext, no effect on the reviewdate and timeno
LastLoginevaluated by REVIEWIT policies (date of last activity)date and timeno

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

NatureRuleOptions
Rightrequiredokta.groups.read
Membershiprequiredthe 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

FieldRoleTypeRequired
RuleIdobject keytextyes
Namedisplayed to recognize the objecttextyes
Statuscontext, no effect on the reviewtextno
Expressioncontext, no effect on the reviewtextno
AssignedGroupIdscontext, no effect on the reviewtextno
AssignedGroupNamescontext, no effect on the reviewtextno
Createdcontext, no effect on the reviewdate and timeno
LastUpdatedcontext, no effect on the reviewdate and timeno

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

NatureRuleOptions
Rightrequiredokta.groups.read
Membershiprequiredthe 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

FieldRoleTypeRequired
GroupIdobject keytextyes
Namedisplayed to recognize the objecttextyes
Descriptioncontext, no effect on the reviewtextno
Typecontext, no effect on the reviewtextno
Createdcontext, no effect on the reviewdate and timeno
LastUpdatedcontext, no effect on the reviewdate and timeno
LastMembershipUpdatedevaluated by REVIEWIT policies (date of last activity)date and timeno

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

NatureRuleOptions
Rightrequiredokta.groups.read
Membershiprequiredthe 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

FieldRoleTypeRequired
MembershipKeyobject keytextyes
GroupIdcontext, no effect on the reviewtextyes
GroupNamedisplayed to recognize the objecttextyes
UserIdcontext, no effect on the reviewtextyes
Logindisplayed to recognize the objecttextno
Emailcontext, no effect on the reviewtextno
Statuscontext, no effect on the reviewtextno

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

NatureRuleOptions
Rightrequiredokta.roles.read
Membershiprequiredthe 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

FieldRoleTypeRequired
RoleIdobject keytextyes
Labeldisplayed to recognize the objecttextyes
Descriptioncontext, no effect on the reviewtextno
Permissionscontext, no effect on the reviewtextno
Createdcontext, no effect on the reviewdate and timeno
LastUpdatedcontext, no effect on the reviewdate and timeno

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

NatureRuleOptions
Rightrequiredokta.roles.read
Rightrequiredokta.users.read
Membershiprequiredthe 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

FieldRoleTypeRequired
AssignmentIdobject keytextyes
Typecontext, no effect on the reviewtextno
RoleLabeldisplayed to recognize the objecttextyes
PrincipalIdcontext, no effect on the reviewtextyes
PrincipalLogindisplayed to recognize the objecttextno
PrincipalKindcontext, no effect on the reviewtextno
ResourceSetIdcontext, no effect on the reviewtextno
Createdcontext, no effect on the reviewdate and timeno
LastUpdatedcontext, no effect on the reviewdate and timeno

17To go further #sec_52993119

  • Understand a collection connection
  • Rights reference by resource
  • Read a verdict
Esc
↑↓ navigate↵ openSee all results →