Contratti di raccolta — Okta
01Come leggere questa pagina #sec_900d4e5d
Ogni risorsa che REVIEWIT può raccogliere per Okta ha un contratto pubblicato. Si legge come una referencia API: ciò che REVIEWIT chiama sul servizio raccolto e con quale metodo, ciò che il contratto richiede affinché la raccolta si esegua e i dati che REVIEWIT conserva. REVIEWIT esegue solo letture.
- Chiamate: le richieste che REVIEWIT invia al servizio raccolto, tutte in lettura.
- Requisiti: ciascuno deve essere soddisfatto. La sua natura indica cosa richiede: un diritto da concedere all'identificativo, una condizione di amministrazione (un'impostazione o un'assegnazione presso il fornitore che il token non porta, verificata da una chiamata reale in lettura) o l'appartenenza dell'identificativo all'organizzazione Okta della connessione. La regola indica quante opzioni sono necessarie: « obbligatoria » per l'unica opzione, « una a scelta » quando ne basta una (sono ordinate dalla più ristretta alla più ampia: preferisci la prima), « tutte » o « N a scelta tra M ».
- Condizioni di funzionamento: ciò che REVIEWIT verifica prima di ogni raccolta, oltre ai requisiti.
- Freschezza: l'età massima delle verifiche su cui si basa il verdetto, fissata da ogni contratto (qui: verifiche di meno di 24 ore; i diritti devono essere verificati da una chiamata reale). REVIEWIT esegue automaticamente entro questo termine le verifiche che sa eseguire (token ottenuto, servizio che risponde); « Verifica i diritti », nel menu della connessione, li esegue su richiesta. Finché la chiamata reale non è stata effettuata, i diritti rimangono non verificati.
- Dati conservati: i campi che REVIEWIT conserva di ogni oggetto; il ruolo indica cosa ne fa la revisione.
Il verdetto di ogni risorsa, per la vostra connessione, si legge sulla sua scheda. Una risorsa che la connessione non raccoglie può comunque essere alimentata dall'import di un rapporto (« Importa un rapporto »).
02Come REVIEWIT verifica i requisiti #sec_2df3a117
Il token Okta non porta i suoi diritti: il contratto richiede che siano verificati da una chiamata reale, in lettura. REVIEWIT non effettua ancora questa chiamata per Okta: verifica che il token sia ottenuto e che il servizio risponda, ma non i diritti elencati qui. Le risorse vengono visualizzate come « Non verificato »; possono comunque essere alimentate dall'import di un rapporto (« Importare un rapporto »).
03I percorsi di chiamata #sec_082df6f4
Un percorso indica quale token REVIEWIT ottiene per l'identificatore: chi lo rilascia e per quale audience. Gli indirizzi chiamati sono indicati nelle chiamate di ogni risorsa; un percorso che inizia con « / » è chiamato sull'audience del token del suo percorso.
| Percorso | Token rilasciato da | Audience del token | Autenticazione dell'identificatore |
|---|---|---|---|
| okta.management.reviewit.service-app-key | https://{okta-domain}/oauth2/v1/token | https://{okta-domain} | coppia di chiavi (private_key_jwt) |
In questi indirizzi, {okta-domain} è il dominio Okta dell'organizzazione (ad esempio acme.okta.com o acme.okta-emea.com).
04Credenziali API · Token API #sec_8c7b77dc
okta.credentials.api-tokens:collect · revisione 1 del contratto, pubblicata il 18 ottobre 2026 · via okta.management.reviewit.service-app-key
Token API dell'organizzazione: il loro portatore, il loro ultimo utilizzo, la loro scadenza
Chiamate
- GET /api/v1/api-tokens
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | richiesto | okta.apiTokens.read |
| Appartenenza | richiesto | l'identificativo appartiene all'organizzazione Okta della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://{okta-domain} risponde
Frescura: verifiche di meno di 24 ore; i diritti devono essere constatati da una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| TokenId | chiave dell'oggetto | testo | sì |
| Name | visualizzato per riconoscere l'oggetto | testo | sì |
| UserId | contesto, senza effetto sulla revisione | testo | no |
| Login | visualizzato per riconoscere l'oggetto | testo | no |
| Created | contesto, senza effetto sulla revisione | data e ora | no |
| LastUpdated | contesto, senza effetto sulla revisione | data e ora | no |
| ExpiresOn | contesto, senza effetto sulla revisione | data e ora | no |
05Credenziali API · Consensi OAuth #sec_ade404c2
okta.credentials.oauth-grants:collect · revisione 1 del contratto, pubblicata il 18 ottobre 2026 · via okta.management.reviewit.service-app-key
Consensi OAuth concessi da una persona a un'applicazione
Chiamate
- GET /api/v1/apps/{id}/grants
- GET /api/v1/users/{id}/grants
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | tutte | okta.appGrants.read e okta.users.read |
| Appartenenza | richiesta | l'identificativo appartiene all'organizzazione Okta della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://{okta-domain} risponde
Frescura: verifiche inferiori a 24 ore; i diritti devono essere verificati con una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| GrantId | chiave dell'oggetto | testo | sì |
| UserId | contesto, senza effetto sulla revisione | testo | no |
| Login | visualizzato per riconoscere l'oggetto | testo | sì |
| ClientId | contesto, senza effetto sulla revisione | testo | no |
| AppName | visualizzato per riconoscere l'oggetto | testo | no |
| Scope | contesto, senza effetto sulla revisione | testo | no |
| Status | contesto, senza effetto sulla revisione | testo | no |
| Created | contesto, senza effetto sulla revisione | data e ora | no |
| LastUpdated | contesto, senza effetto sulla revisione | data e ora | no |
06Assegnazioni applicazioni · Applicazioni #sec_2db8add4
okta.apps.applications:collect · revisione 1 del contratto, pubblicata il 18 ottobre 2026 · via okta.management.reviewit.service-app-key
Applicazioni dell'organizzazione, il loro modo di autenticazione unica e il loro stato
Chiamate
- GET /api/v1/apps
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | richiesto | okta.apps.read |
| Appartenenza | richiesto | l'identificativo appartiene all'organizzazione Okta della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://{okta-domain} risponde
Frescura: verifiche inferiori a 24 ore; i diritti devono essere verificati con una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| AppId | chiave dell'oggetto | testo | sì |
| Label | visualizzato per riconoscere l'oggetto | testo | sì |
| SignOnMode | contesto, senza effetto sulla revisione | testo | no |
| Status | contesto, senza effetto sulla revisione | testo | no |
| Created | contesto, senza effetto sulla revisione | data e ora | no |
| LastUpdated | contesto, senza effetto sulla revisione | data e ora | no |
| Visibility | contesto, senza effetto sulla revisione | testo | no |
07Assegnazioni applicazioni · Assegnazioni applicazioni (gruppi) #sec_26496090
okta.apps.group-assignments:collect · revisione 1 del contratto, pubblicata il 18 ottobre 2026 · via okta.management.reviewit.service-app-key
Gruppi assegnati a un'applicazione e il profilo che vi portano. Chiave di riga: AppId | GroupId.
Chiamate
- GET /api/v1/apps/{id}/groups
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | richiesto | okta.apps.read |
| Diritto | richiesto | okta.groups.read |
| Appartenenza | richiesto | l'identificativo appartiene all'organizzazione Okta della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://{okta-domain} risponde
Frescura: verifiche inferiori a 24 ore; i diritti devono essere verificati con una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| AssignmentKey | chiave dell'oggetto | testo | sì |
| AppId | contesto, senza effetto sulla revisione | testo | sì |
| Label | visualizzato per riconoscere l'oggetto | testo | sì |
| GroupId | contesto, senza effetto sulla revisione | testo | sì |
| GroupName | visualizzato per riconoscere l'oggetto | testo | no |
| Priority | contesto, senza effetto sulla revisione | intero | no |
| Created | contesto, senza effetto sulla revisione | data e ora | no |
| LastUpdated | contesto, senza effetto sulla revisione | data e ora | no |
08Assegnazioni applicazioni · Assegnazioni applicazioni (utenti) #sec_894bdc62
okta.apps.user-assignments:collect · revisione 1 del contratto, pubblicata il 18 ottobre 2026 · via okta.management.reviewit.service-app-key
Personale assegnate a un'applicazione, direttamente o tramite un gruppo. Chiave di riga: AppId | UserId.
Chiamate
- GET /api/v1/apps/{id}/users
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | richiesto | okta.apps.read |
| Diritto | richiesto | okta.users.read |
| Appartenenza | richiesto | l'identificativo appartiene all'organizzazione Okta della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://{okta-domain} risponde
Frescura: verifiche inferiori a 24 ore; i diritti devono essere verificati con una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| AssignmentKey | chiave dell'oggetto | testo | sì |
| AppId | contesto, senza effetto sulla revisione | testo | sì |
| Label | visualizzato per riconoscere l'oggetto | testo | sì |
| UserId | contesto, senza effetto sulla revisione | testo | sì |
| Login | visualizzato per riconoscere l'oggetto | testo | no |
| contesto, senza effetto sulla revisione | testo | no | |
| Scope | contesto, senza effetto sulla revisione | testo | no |
| Status | contesto, senza effetto sulla revisione | testo | no |
| Created | contesto, senza effetto sulla revisione | data e ora | no |
| LastUpdated | contesto, senza effetto sulla revisione | data e ora | no |
09Directory · Account mai attivati #sec_0c88c27f
okta.directory.pending-users:collect · revisione 1 del contratto, pubblicata il 18 ottobre 2026 · via okta.management.reviewit.service-app-key
Account creati e mai attivati (STAGED, PROVISIONED) : accessi concessi che nessuno ha utilizzato
Chiamate
- GET /api/v1/users?filter=status eq "STAGED" or status eq "PROVISIONED"
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Permesso | richiesto | okta.users.read |
| Appartenenza | richiesto | l'identificativo appartiene all'organizzazione Okta della connessione |
Condizioni di funzionamento
- viene ottenuto un token per l'identificativo
- il servizio https://{okta-domain} risponde
Freschezza : controlli di meno di 24 ore ; i permessi devono essere verificati da una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| UserId | chiave dell'oggetto | testo | sì |
| Login | visualizzato per riconoscere l'oggetto | testo | sì |
| visualizzato per riconoscere l'oggetto | testo | no | |
| FirstName | contesto, senza effetto sulla revisione | testo | no |
| LastName | contesto, senza effetto sulla revisione | testo | no |
| Status | contesto, senza effetto sulla revisione | testo | no |
| Created | contesto, senza effetto sulla revisione | data e ora | no |
| Activated | contesto, senza effetto sulla revisione | data e ora | no |
10Directory · Account chiusi #sec_4c6f05aa
okta.directory.suspended-users:collect · revisione 1 del contratto, pubblicata il 18 ottobre 2026 · via okta.management.reviewit.service-app-key
Account sospesi (SUSPENDED) o disattivati (DEPROVISIONED), e gli accessi che mantengono
Chiamate
- GET /api/v1/users?filter=status eq "SUSPENDED" or status eq "DEPROVISIONED"
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Permesso | richiesto | okta.users.read |
| Appartenenza | richiesto | l'identificativo appartiene all'organizzazione Okta della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://{okta-domain} risponde
Freschezza: verifiche di meno di 24 ore; i permessi devono essere constatati da una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| UserId | chiave dell'oggetto | testo | sì |
| Login | visualizzato per riconoscere l'oggetto | testo | sì |
| visualizzato per riconoscere l'oggetto | testo | no | |
| Status | contesto, senza effetto sulla revisione | testo | no |
| StatusChanged | contesto, senza effetto sulla revisione | data e ora | no |
| LastLogin | valutato dalle politiche REVIEWIT (data dell'ultima attività) | data e ora | no |
| ManagerId | contesto, senza effetto sulla revisione | testo | no |
11Directory · Utenti #sec_c542f4bc
okta.directory.users:collect · revisione 1 del contratto, pubblicata il 18 ottobre 2026 · via okta.management.reviewit.service-app-key
Account dell'organizzazione : stato, ultima connessione, responsabile dichiarato
Chiamate
- GET /api/v1/users
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | richiesto | okta.users.read |
| Appartenenza | richiesto | l'identificativo appartiene all'organizzazione Okta della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://{okta-domain} risponde
Freschezza : verifiche di meno di 24 h ; i diritti devono essere constatati da una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obligatorio |
|---|---|---|---|
| UserId | chiave dell'oggetto | testo | sì |
| Login | visualizzato per riconoscere l'oggetto | testo | sì |
| visualizzato per riconoscere l'oggetto | testo | no | |
| FirstName | contesto, senza effetto sulla revisione | testo | no |
| LastName | contesto, senza effetto sulla revisione | testo | no |
| DisplayName | visualizzato per riconoscere l'oggetto | testo | no |
| Status | contesto, senza effetto sulla revisione | testo | no |
| Department | contesto, senza effetto sulla revisione | testo | no |
| Title | contesto, senza effetto sulla revisione | testo | no |
| ManagerId | contesto, senza effetto sulla revisione | testo | no |
| Created | contesto, senza effetto sulla revisione | data e ora | no |
| LastLogin | valutato dalle politiche REVIEWIT (data dell'ultima attività) | data e ora | no |
12Gruppi · Regole dei gruppi #sec_b839b944
okta.groups.group-rules:collect · revisione 1 del contratto, pubblicata il 18 ottobre 2026 · via okta.management.reviewit.service-app-key
Regole di appartenenza dinamica: ciò che fa entrare qualcuno in un gruppo senza che venga aggiunto manualmente
Chiamate
- GET /api/v1/groups/rules
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | richiesto | okta.groups.read |
| Appartenenza | richiesto | l'identificativo appartiene all'organizzazione Okta della connessione |
Condizioni di funzionamento
- viene ottenuto un token per l'identificativo
- il servizio https://{okta-domain} risponde
Aggiornamento: controlli di meno di 24 ore; i diritti devono essere verificati mediante una chiamata effettiva.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| RuleId | chiave dell'oggetto | testo | sì |
| Name | visualizzato per riconoscere l'oggetto | testo | sì |
| Status | contesto, senza effetto sulla revisione | testo | no |
| Expression | contesto, senza effetto sulla revisione | testo | no |
| AssignedGroupIds | contesto, senza effetto sulla revisione | testo | no |
| AssignedGroupNames | contesto, senza effetto sulla revisione | testo | no |
| Created | contesto, senza effetto sulla revisione | data e ora | no |
| LastUpdated | contesto, senza effetto sulla revisione | data e ora | no |
13Gruppi #sec_439851da
okta.groups.groups:collect · revisione 1 del contratto, pubblicata il 18 ottobre 2026 · via okta.management.reviewit.service-app-key
Gruppi dell'organizzazione: quelli creati in Okta, quelli importati da un'applicazione o da un directory (AD, LDAP) e i gruppi integrati
Chiamate
- GET /api/v1/groups
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | richiesto | okta.groups.read |
| Appartenenza | richiesto | l'identificativo appartiene all'organizzazione Okta della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://{okta-domain} risponde
Freschezza: verifiche di meno di 24 ore; i diritti devono essere verificati da una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| GroupId | chiave dell'oggetto | testo | sì |
| Name | visualizzato per riconoscere l'oggetto | testo | sì |
| Description | contesto, senza effetto sulla revisione | testo | no |
| Type | contesto, senza effetto sulla revisione | testo | no |
| Created | contesto, senza effetto sulla revisione | data e ora | no |
| LastUpdated | contesto, senza effetto sulla revisione | data e ora | no |
| LastMembershipUpdated | valutato dalle politiche REVIEWIT (data dell'ultima attività) | data e ora | no |
14Gruppi · Membri del gruppo #sec_8c8f31d8
okta.groups.memberships:collect · revisione 1 del contratto, pubblicata il 18 ottobre 2026 · via okta.management.reviewit.service-app-key
Appartenenze a un gruppo, persona per persona. Chiave di riga: GroupId | UserId.
Chiamate
- GET /api/v1/groups/{id}/users
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | richiesto | okta.groups.read |
| Appartenenza | richiesto | l'identificativo appartiene all'organizzazione Okta della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://{okta-domain} risponde
Freschezza: verifiche di meno di 24 ore; i diritti devono essere verificati da una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| MembershipKey | chiave dell'oggetto | testo | sì |
| GroupId | contesto, senza effetto sulla revisione | testo | sì |
| GroupName | visualizzato per riconoscere l'oggetto | testo | sì |
| UserId | contesto, senza effetto sulla revisione | testo | sì |
| Login | visualizzato per riconoscere l'oggetto | testo | no |
| contesto, senza effetto sulla revisione | testo | no | |
| Status | contesto, senza effetto sulla revisione | testo | no |
15Ruoli privilegiati · Ruoli amministratore personalizzati #sec_6361c4e3
okta.privileged-roles.custom-roles:collect · revisione 1 del contratto, pubblicata il 18 ottobre 2026 · via okta.management.reviewit.service-app-key
Ruoli di amministrazione definiti dal cliente e le autorizzazioni che comportano
Chiamate
- GET /api/v1/iam/roles
- GET /api/v1/iam/roles/{roleId}/permissions
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | richiesto | okta.roles.read |
| Appartenenza | richiesto | l'identificativo appartiene all'organizzazione Okta della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://{okta-domain} risponde
Freschezza: verifiche di meno di 24 ore; i diritti devono essere verificati da una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| RoleId | chiave dell'oggetto | testo | sì |
| Label | visualizzato per riconoscere l'oggetto | testo | sì |
| Description | contesto, senza effetto sulla revisione | testo | no |
| Permissions | contesto, senza effetto sulla revisione | testo | no |
| Created | contesto, senza effetto sulla revisione | data e ora | no |
| LastUpdated | contesto, senza effetto sulla revisione | data e ora | no |
16Ruoli privilegiati · Assegnazioni di ruoli amministratore #sec_7a8dffad
okta.privileged-roles.role-assignments:collect · revisione 1 del contratto, pubblicata il 18 ottobre 2026 · via okta.management.reviewit.service-app-key
Ruoli di amministrazione concessi a una persona e la loro portata
Chiamate
- GET /api/v1/iam/assignees/users
- GET /api/v1/users/{id}/roles
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | richiesto | okta.roles.read |
| Diritto | richiesto | okta.users.read |
| Appartenenza | richiesto | l'identificativo appartiene all'organizzazione Okta della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://{okta-domain} risponde
Freschezza: verifiche di meno di 24 ore; i diritti devono essere verificati da una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| AssignmentId | chiave dell'oggetto | testo | sì |
| Type | contesto, senza effetto sulla revisione | testo | no |
| RoleLabel | visualizzato per riconoscere l'oggetto | testo | sì |
| PrincipalId | contesto, senza effetto sulla revisione | testo | sì |
| PrincipalLogin | visualizzato per riconoscere l'oggetto | testo | no |
| PrincipalKind | contesto, senza effetto sulla revisione | testo | no |
| ResourceSetId | contesto, senza effetto sulla revisione | testo | no |
| Created | contesto, senza effetto sulla revisione | data e ora | no |
| LastUpdated | contesto, senza effetto sulla revisione | data e ora | no |
17Per andare oltre #sec_52993119
- Comprendere una connessione di raccolta
- Riferimento dei diritti per risorsa
- Leggere un verdetto