Contrats de collecte — Okta
01Comment lire cette page #sec_900d4e5d
Chaque ressource que REVIEWIT sait collecter pour Okta a un contrat publié. Il se lit comme une référence d'API : ce que REVIEWIT appelle sur le service collecté et par quelle voie, ce que le contrat exige pour que la collecte s'exécute, et les données que REVIEWIT conserve. REVIEWIT ne fait que des lectures.
- Appels : les requêtes que REVIEWIT adresse au service collecté, toutes en lecture.
- Exigences : chacune doit être satisfaite. Sa nature dit ce qu'elle demande : un droit à accorder à l'identifiant, une condition d'administration (un réglage ou une attribution chez le fournisseur que le jeton ne porte pas, constaté par un appel réel en lecture), ou l'appartenance de l'identifiant à l'organisation Okta de la connexion. La règle dit combien d'options il faut : « requise » pour l'unique option, « une au choix » quand une seule suffit (elles sont rangées de la plus étroite à la plus large : préférez la première), « toutes », ou « N au choix parmi M ».
- Conditions de fonctionnement : ce que REVIEWIT constate avant chaque collecte, au-delà des exigences.
- Fraîcheur : l'âge maximal des vérifications sur lesquelles le verdict s'appuie, fixé par chaque contrat (ici : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel). REVIEWIT refait automatiquement dans ce délai les vérifications qu'il sait faire (jeton obtenu, service qui répond) ; « Vérifier les droits », dans le menu de la connexion, les refait à la demande. Tant que l'appel réel n'est pas fait, les droits restent non constatés.
- Données conservées : les champs que REVIEWIT garde de chaque objet ; le rôle dit ce que la revue en fait.
Le verdict de chaque ressource, pour votre connexion, se lit sur sa fiche. Une ressource que la connexion ne collecte pas peut toujours être alimentée par l'import d'un rapport (« Importer un rapport »).
02Comment REVIEWIT vérifie les exigences #sec_2df3a117
Le jeton Okta ne porte pas ses droits : le contrat exige qu'ils soient constatés par un appel réel, en lecture. REVIEWIT ne fait pas encore cet appel pour Okta : il constate que le jeton est obtenu et que le service répond, mais pas les droits listés ici. Les ressources s'affichent « Non vérifié » ; elles peuvent toujours être alimentées par l'import d'un rapport (« Importer un rapport »).
03Les voies d'appel #sec_082df6f4
Une voie dit quel jeton REVIEWIT obtient pour l'identifiant : qui le délivre et pour quelle audience. Les adresses appelées figurent dans les appels de chaque ressource ; un chemin qui commence par « / » s'appelle sur l'audience du jeton de sa voie.
| Voie | Jeton délivré par | Audience du jeton | Authentification de l'identifiant |
|---|---|---|---|
| okta.management.reviewit.service-app-key | https://{okta-domain}/oauth2/v1/token | https://{okta-domain} | paire de clés (private_key_jwt) |
Dans ces adresses, {okta-domain} est le domaine Okta de l'organisation (par exemple acme.okta.com ou acme.okta-emea.com ).
04API credentials · API tokens #sec_8c7b77dc
okta.credentials.api-tokens:collect · révision 1 du contrat, publiée le 18 octobre 2026 · voie okta.management.reviewit.service-app-key
Jetons d'API de l'organisation : leur porteur, leur dernière utilisation, leur échéance
Appels
- GET /api/v1/api-tokens
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | okta.apiTokens.read |
| Appartenance | requise | l'identifiant appartient à l'organisation Okta de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://{okta-domain} répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| TokenId | clé de l'objet | texte | oui |
| Name | affiché pour reconnaître l'objet | texte | oui |
| UserId | contexte, sans effet sur la revue | texte | non |
| Login | affiché pour reconnaître l'objet | texte | non |
| Created | contexte, sans effet sur la revue | date et heure | non |
| LastUpdated | contexte, sans effet sur la revue | date et heure | non |
| ExpiresOn | contexte, sans effet sur la revue | date et heure | non |
05API credentials · OAuth consents #sec_ade404c2
okta.credentials.oauth-grants:collect · révision 1 du contrat, publiée le 18 octobre 2026 · voie okta.management.reviewit.service-app-key
Consentements OAuth accordés par une personne à une application
Appels
- GET /api/v1/apps/{id}/grants
- GET /api/v1/users/{id}/grants
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | toutes | okta.appGrants.read et okta.users.read |
| Appartenance | requise | l'identifiant appartient à l'organisation Okta de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://{okta-domain} répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| GrantId | clé de l'objet | texte | oui |
| UserId | contexte, sans effet sur la revue | texte | non |
| Login | affiché pour reconnaître l'objet | texte | oui |
| ClientId | contexte, sans effet sur la revue | texte | non |
| AppName | affiché pour reconnaître l'objet | texte | non |
| Scope | contexte, sans effet sur la revue | texte | non |
| Status | contexte, sans effet sur la revue | texte | non |
| Created | contexte, sans effet sur la revue | date et heure | non |
| LastUpdated | contexte, sans effet sur la revue | date et heure | non |
06Application assignments · Applications #sec_2db8add4
okta.apps.applications:collect · révision 1 du contrat, publiée le 18 octobre 2026 · voie okta.management.reviewit.service-app-key
Applications de l'organisation, leur mode d'authentification unique et leur état
Appels
- GET /api/v1/apps
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | okta.apps.read |
| Appartenance | requise | l'identifiant appartient à l'organisation Okta de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://{okta-domain} répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| AppId | clé de l'objet | texte | oui |
| Label | affiché pour reconnaître l'objet | texte | oui |
| SignOnMode | contexte, sans effet sur la revue | texte | non |
| Status | contexte, sans effet sur la revue | texte | non |
| Created | contexte, sans effet sur la revue | date et heure | non |
| LastUpdated | contexte, sans effet sur la revue | date et heure | non |
| Visibility | contexte, sans effet sur la revue | texte | non |
07Application assignments · Application assignments (groups) #sec_26496090
okta.apps.group-assignments:collect · révision 1 du contrat, publiée le 18 octobre 2026 · voie okta.management.reviewit.service-app-key
Groupes affectés à une application, et le profil qu'ils y portent. Clé de ligne : AppId | GroupId.
Appels
- GET /api/v1/apps/{id}/groups
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | okta.apps.read |
| Droit | requise | okta.groups.read |
| Appartenance | requise | l'identifiant appartient à l'organisation Okta de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://{okta-domain} répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| AssignmentKey | clé de l'objet | texte | oui |
| AppId | contexte, sans effet sur la revue | texte | oui |
| Label | affiché pour reconnaître l'objet | texte | oui |
| GroupId | contexte, sans effet sur la revue | texte | oui |
| GroupName | affiché pour reconnaître l'objet | texte | non |
| Priority | contexte, sans effet sur la revue | entier | non |
| Created | contexte, sans effet sur la revue | date et heure | non |
| LastUpdated | contexte, sans effet sur la revue | date et heure | non |
08Application assignments · Application assignments (users) #sec_894bdc62
okta.apps.user-assignments:collect · révision 1 du contrat, publiée le 18 octobre 2026 · voie okta.management.reviewit.service-app-key
Personnes affectées à une application, directement ou par un groupe. Clé de ligne : AppId | UserId.
Appels
- GET /api/v1/apps/{id}/users
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | okta.apps.read |
| Droit | requise | okta.users.read |
| Appartenance | requise | l'identifiant appartient à l'organisation Okta de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://{okta-domain} répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| AssignmentKey | clé de l'objet | texte | oui |
| AppId | contexte, sans effet sur la revue | texte | oui |
| Label | affiché pour reconnaître l'objet | texte | oui |
| UserId | contexte, sans effet sur la revue | texte | oui |
| Login | affiché pour reconnaître l'objet | texte | non |
| contexte, sans effet sur la revue | texte | non | |
| Scope | contexte, sans effet sur la revue | texte | non |
| Status | contexte, sans effet sur la revue | texte | non |
| Created | contexte, sans effet sur la revue | date et heure | non |
| LastUpdated | contexte, sans effet sur la revue | date et heure | non |
09Directory · Never activated accounts #sec_0c88c27f
okta.directory.pending-users:collect · révision 1 du contrat, publiée le 18 octobre 2026 · voie okta.management.reviewit.service-app-key
Comptes créés et jamais activés (STAGED, PROVISIONED) : des accès accordés que personne n'a pris
Appels
- GET /api/v1/users?filter=status eq "STAGED" or status eq "PROVISIONED"
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | okta.users.read |
| Appartenance | requise | l'identifiant appartient à l'organisation Okta de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://{okta-domain} répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| UserId | clé de l'objet | texte | oui |
| Login | affiché pour reconnaître l'objet | texte | oui |
| affiché pour reconnaître l'objet | texte | non | |
| FirstName | contexte, sans effet sur la revue | texte | non |
| LastName | contexte, sans effet sur la revue | texte | non |
| Status | contexte, sans effet sur la revue | texte | non |
| Created | contexte, sans effet sur la revue | date et heure | non |
| Activated | contexte, sans effet sur la revue | date et heure | non |
10Directory · Closed accounts #sec_4c6f05aa
okta.directory.suspended-users:collect · révision 1 du contrat, publiée le 18 octobre 2026 · voie okta.management.reviewit.service-app-key
Comptes suspendus (SUSPENDED) ou désactivés (DEPROVISIONED), et les accès qu'ils conservent
Appels
- GET /api/v1/users?filter=status eq "SUSPENDED" or status eq "DEPROVISIONED"
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | okta.users.read |
| Appartenance | requise | l'identifiant appartient à l'organisation Okta de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://{okta-domain} répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| UserId | clé de l'objet | texte | oui |
| Login | affiché pour reconnaître l'objet | texte | oui |
| affiché pour reconnaître l'objet | texte | non | |
| Status | contexte, sans effet sur la revue | texte | non |
| StatusChanged | contexte, sans effet sur la revue | date et heure | non |
| LastLogin | évalué par les politiques REVIEWIT (date de dernière activité) | date et heure | non |
| ManagerId | contexte, sans effet sur la revue | texte | non |
11Directory · Users #sec_c542f4bc
okta.directory.users:collect · révision 1 du contrat, publiée le 18 octobre 2026 · voie okta.management.reviewit.service-app-key
Comptes de l'organisation : état, dernière connexion, responsable déclaré
Appels
- GET /api/v1/users
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | okta.users.read |
| Appartenance | requise | l'identifiant appartient à l'organisation Okta de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://{okta-domain} répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| UserId | clé de l'objet | texte | oui |
| Login | affiché pour reconnaître l'objet | texte | oui |
| affiché pour reconnaître l'objet | texte | non | |
| FirstName | contexte, sans effet sur la revue | texte | non |
| LastName | contexte, sans effet sur la revue | texte | non |
| DisplayName | affiché pour reconnaître l'objet | texte | non |
| Status | contexte, sans effet sur la revue | texte | non |
| Department | contexte, sans effet sur la revue | texte | non |
| Title | contexte, sans effet sur la revue | texte | non |
| ManagerId | contexte, sans effet sur la revue | texte | non |
| Created | contexte, sans effet sur la revue | date et heure | non |
| LastLogin | évalué par les politiques REVIEWIT (date de dernière activité) | date et heure | non |
12Groups · Group rules #sec_b839b944
okta.groups.group-rules:collect · révision 1 du contrat, publiée le 18 octobre 2026 · voie okta.management.reviewit.service-app-key
Règles d'appartenance dynamique : ce qui fait entrer quelqu'un dans un groupe sans qu'on l'y mette
Appels
- GET /api/v1/groups/rules
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | okta.groups.read |
| Appartenance | requise | l'identifiant appartient à l'organisation Okta de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://{okta-domain} répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| RuleId | clé de l'objet | texte | oui |
| Name | affiché pour reconnaître l'objet | texte | oui |
| Status | contexte, sans effet sur la revue | texte | non |
| Expression | contexte, sans effet sur la revue | texte | non |
| AssignedGroupIds | contexte, sans effet sur la revue | texte | non |
| AssignedGroupNames | contexte, sans effet sur la revue | texte | non |
| Created | contexte, sans effet sur la revue | date et heure | non |
| LastUpdated | contexte, sans effet sur la revue | date et heure | non |
13Groups #sec_439851da
okta.groups.groups:collect · révision 1 du contrat, publiée le 18 octobre 2026 · voie okta.management.reviewit.service-app-key
Groupes de l'organisation : ceux créés dans Okta, ceux importés d'une application ou d'un annuaire (AD, LDAP), et les groupes intégrés
Appels
- GET /api/v1/groups
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | okta.groups.read |
| Appartenance | requise | l'identifiant appartient à l'organisation Okta de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://{okta-domain} répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| GroupId | clé de l'objet | texte | oui |
| Name | affiché pour reconnaître l'objet | texte | oui |
| Description | contexte, sans effet sur la revue | texte | non |
| Type | contexte, sans effet sur la revue | texte | non |
| Created | contexte, sans effet sur la revue | date et heure | non |
| LastUpdated | contexte, sans effet sur la revue | date et heure | non |
| LastMembershipUpdated | évalué par les politiques REVIEWIT (date de dernière activité) | date et heure | non |
14Groups · Group members #sec_8c8f31d8
okta.groups.memberships:collect · révision 1 du contrat, publiée le 18 octobre 2026 · voie okta.management.reviewit.service-app-key
Appartenances à un groupe, personne par personne. Clé de ligne : GroupId | UserId.
Appels
- GET /api/v1/groups/{id}/users
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | okta.groups.read |
| Appartenance | requise | l'identifiant appartient à l'organisation Okta de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://{okta-domain} répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| MembershipKey | clé de l'objet | texte | oui |
| GroupId | contexte, sans effet sur la revue | texte | oui |
| GroupName | affiché pour reconnaître l'objet | texte | oui |
| UserId | contexte, sans effet sur la revue | texte | oui |
| Login | affiché pour reconnaître l'objet | texte | non |
| contexte, sans effet sur la revue | texte | non | |
| Status | contexte, sans effet sur la revue | texte | non |
15Privileged roles · Custom administrator roles #sec_6361c4e3
okta.privileged-roles.custom-roles:collect · révision 1 du contrat, publiée le 18 octobre 2026 · voie okta.management.reviewit.service-app-key
Rôles d'administration définis par le client, et les permissions qu'ils portent
Appels
- GET /api/v1/iam/roles
- GET /api/v1/iam/roles/{roleId}/permissions
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | okta.roles.read |
| Appartenance | requise | l'identifiant appartient à l'organisation Okta de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://{okta-domain} répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| RoleId | clé de l'objet | texte | oui |
| Label | affiché pour reconnaître l'objet | texte | oui |
| Description | contexte, sans effet sur la revue | texte | non |
| Permissions | contexte, sans effet sur la revue | texte | non |
| Created | contexte, sans effet sur la revue | date et heure | non |
| LastUpdated | contexte, sans effet sur la revue | date et heure | non |
16Privileged roles · Administrator role assignments #sec_7a8dffad
okta.privileged-roles.role-assignments:collect · révision 1 du contrat, publiée le 18 octobre 2026 · voie okta.management.reviewit.service-app-key
Rôles d'administration accordés à une personne, et leur périmètre
Appels
- GET /api/v1/iam/assignees/users
- GET /api/v1/users/{id}/roles
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | okta.roles.read |
| Droit | requise | okta.users.read |
| Appartenance | requise | l'identifiant appartient à l'organisation Okta de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://{okta-domain} répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| AssignmentId | clé de l'objet | texte | oui |
| Type | contexte, sans effet sur la revue | texte | non |
| RoleLabel | affiché pour reconnaître l'objet | texte | oui |
| PrincipalId | contexte, sans effet sur la revue | texte | oui |
| PrincipalLogin | affiché pour reconnaître l'objet | texte | non |
| PrincipalKind | contexte, sans effet sur la revue | texte | non |
| ResourceSetId | contexte, sans effet sur la revue | texte | non |
| Created | contexte, sans effet sur la revue | date et heure | non |
| LastUpdated | contexte, sans effet sur la revue | date et heure | non |
17Pour aller plus loin #sec_52993119
- Comprendre une connexion de collecte
- Référence des droits par ressource
- Lire un verdict