Contratos de recolección — Okta
01Cómo leer esta página #sec_900d4e5d
Cada recurso que REVIEWIT puede recolectar para Okta tiene un contrato publicado. Se lee como una referencia de API: lo que REVIEWIT llama en el servicio recolectado y por qué medio, lo que el contrato exige para que la recolección se ejecute, y los datos que REVIEWIT conserva. REVIEWIT solo realiza lecturas.
- Llamadas: las solicitudes que REVIEWIT dirige al servicio recolectado, todas en lectura.
- Exigencias: cada una debe satisfacerse. Su naturaleza indica lo que solicita: un derecho a conceder al identificador, una condición de administración (una configuración o asignación en el proveedor que el token no tiene, constatada por una llamada real en lectura), o la pertenencia del identificador a la organización Okta de la conexión. La regla indica cuántas opciones se necesitan: « requerida » para la única opción, « una al elección » cuando una sola es suficiente (están ordenadas de la más estrecha a la más amplia: prefiera la primera), « todas », o « N al elección entre M ».
- Condiciones de funcionamiento: lo que REVIEWIT constata antes de cada recolección, más allá de los requisitos.
- Frescura: la edad máxima de las verificaciones sobre las que el veredicto se basa, fijada por cada contrato (aquí: verificaciones de menos de 24 h; los derechos deben ser constatados por una llamada real). REVIEWIT vuelve a hacer automáticamente dentro de este plazo las verificaciones que puede realizar (token obtenido, servicio que responde); « Verificar los derechos », en el menú de la conexión, los vuelve a hacer bajo demanda. Mientras la llamada real no se haya realizado, los derechos permanecen no constatados.
- Datos conservados: los campos que REVIEWIT guarda de cada objeto; el rol indica qué hace la revisión con ellos.
El veredicto de cada recurso, para su conexión, se lee en su ficha. Un recurso que la conexión no recolecta siempre puede ser alimentado por la importación de un informe (« Importar un informe »).
02Cómo REVIEWIT verifica los requisitos #sec_2df3a117
El token Okta no lleva sus derechos: el contrato exige que sean constatados por una llamada real, en lectura. REVIEWIT aún no hace esta llamada para Okta: constata que el token está obtenido y que el servicio responde, pero no los derechos listados aquí. Los recursos se muestran « No verificado »; siempre pueden ser alimentados por la importación de un informe (« Importar un informe »).
03Las vías de llamada #sec_082df6f4
Una vía indica qué token REVIEWIT obtiene para el identificador: quién lo emite y para qué audiencia. Las direcciones llamadas aparecen en las llamadas de cada recurso; un camino que comienza con « / » se llama sobre la audiencia del token de su vía.
| Vía | Token emitido por | Audiencia del token | Autenticación del identificador |
|---|---|---|---|
| okta.management.reviewit.service-app-key | https://{okta-domain}/oauth2/v1/token | https://{okta-domain} | par de claves (private_key_jwt) |
En estas direcciones, {okta-domain} es el dominio Okta de la organización (por ejemplo acme.okta.com o acme.okta-emea.com).
04Credenciales de API · Tokens de API #sec_8c7b77dc
okta.credentials.api-tokens:collect · revisión 1 del contrato, publicado el 18 octubre 2026 · vía okta.management.reviewit.service-app-key
Tokens de API de la organización: su portador, su último uso, su vencimiento
Llamadas
- GET /api/v1/api-tokens
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Derecho | requerida | okta.apiTokens.read |
| Pertenencia | requerida | el identificador pertenece a la organización Okta de la conexión |
Condiciones de funcionamiento
- un token está obtenido para el identificador
- el servicio https://{okta-domain} responde
Frescura: verificaciones de menos de 24 h; los derechos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| TokenId | clave del objeto | texto | sí |
| Name | mostrado para reconocer el objeto | texto | sí |
| UserId | contexto, sin efecto sobre la revisión | texto | no |
| Login | mostrado para reconocer el objeto | texto | no |
| Created | contexto, sin efecto sobre la revisión | fecha y hora | no |
| LastUpdated | contexto, sin efecto sobre la revisión | fecha y hora | no |
| ExpiresOn | contexto, sin efecto sobre la revisión | fecha y hora | no |
05Credenciales de API · Consentes de OAuth #sec_ade404c2
okta.credentials.oauth-grants:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía okta.management.reviewit.service-app-key
Consentimientos OAuth concedidos por una persona a una aplicación
Llamadas
- GET /api/v1/apps/{id}/grants
- GET /api/v1/users/{id}/grants
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | todas | okta.appGrants.read y okta.users.read |
| Pertenencia | requerida | el identificador pertenece a la organización Okta de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://{okta-domain} responde
Frescura: comprobaciones de menos de 24 h; los derechos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| GrantId | clave del objeto | texto | sí |
| UserId | contexto, sin efecto sobre la revisión | texto | no |
| Login | mostrado para reconocer el objeto | texto | sí |
| ClientId | contexto, sin efecto sobre la revisión | texto | no |
| AppName | mostrado para reconocer el objeto | texto | no |
| Scope | contexto, sin efecto sobre la revisión | texto | no |
| Status | contexto, sin efecto sobre la revisión | texto | no |
| Created | contexto, sin efecto sobre la revisión | fecha y hora | no |
| LastUpdated | contexto, sin efecto sobre la revisión | fecha y hora | no |
06Asignaciones de aplicaciones · Aplicaciones #sec_2db8add4
okta.apps.applications:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía okta.management.reviewit.service-app-key
Aplicaciones de la organización, su modo de autenticación única y su estado
Llamadas
- GET /api/v1/apps
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerida | okta.apps.read |
| Pertenencia | requerida | el identificador pertenece a la organización Okta de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://{okta-domain} responde
Frescura: comprobaciones de menos de 24 h; los derechos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| AppId | clave del objeto | texto | sí |
| Label | mostrado para reconocer el objeto | texto | sí |
| SignOnMode | contexto, sin efecto sobre la revisión | texto | no |
| Status | contexto, sin efecto sobre la revisión | texto | no |
| Created | contexto, sin efecto sobre la revisión | fecha y hora | no |
| LastUpdated | contexto, sin efecto sobre la revisión | fecha y hora | no |
| Visibility | contexto, sin efecto sobre la revisión | texto | no |
07Asignaciones de aplicaciones · Asignaciones de aplicaciones (grupos) #sec_26496090
okta.apps.group-assignments:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía okta.management.reviewit.service-app-key
Grupos asignados a una aplicación, y el perfil que portan. Clave de fila: AppId | GroupId.
Llamadas
- GET /api/v1/apps/{id}/groups
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerida | okta.apps.read |
| Permiso | requerida | okta.groups.read |
| Pertenencia | requerida | el identificador pertenece a la organización Okta de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://{okta-domain} responde
Frescura: comprobaciones de menos de 24 h; los derechos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| AssignmentKey | clave del objeto | texto | sí |
| AppId | contexto, sin efecto sobre la revisión | texto | sí |
| Label | mostrado para reconocer el objeto | texto | sí |
| GroupId | contexto, sin efecto sobre la revisión | texto | sí |
| GroupName | mostrado para reconocer el objeto | texto | no |
| Priority | contexto, sin efecto sobre la revisión | entero | no |
| Created | contexto, sin efecto sobre la revisión | fecha y hora | no |
| LastUpdated | contexto, sin efecto sobre la revisión | fecha y hora | no |
08Asignaciones de aplicaciones · Asignaciones de aplicaciones (usuarios) #sec_894bdc62
okta.apps.user-assignments:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía okta.management.reviewit.service-app-key
Personas asignadas a una aplicación, directamente o por un grupo. Clave de fila: AppId | UserId.
Llamadas
- GET /api/v1/apps/{id}/users
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerida | okta.apps.read |
| Permiso | requerida | okta.users.read |
| Pertenencia | requerida | el identificador pertenece a la organización Okta de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://{okta-domain} responde
Frescura: comprobaciones de menos de 24 h; los derechos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| AssignmentKey | clave del objeto | texto | sí |
| AppId | contexto, sin efecto sobre la revisión | texto | sí |
| Label | mostrado para reconocer el objeto | texto | sí |
| UserId | contexto, sin efecto sobre la revisión | texto | sí |
| Login | mostrado para reconocer el objeto | texto | no |
| contexto, sin efecto sobre la revisión | texto | no | |
| Scope | contexto, sin efecto sobre la revisión | texto | no |
| Status | contexto, sin efecto sobre la revisión | texto | no |
| Created | contexto, sin efecto sobre la revisión | fecha y hora | no |
| LastUpdated | contexto, sin efecto sobre la revisión | fecha y hora | no |
09Directorio · Cuentas nunca activadas #sec_0c88c27f
okta.directory.pending-users:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía okta.management.reviewit.service-app-key
Cuentas creadas y nunca activadas (STAGED, PROVISIONED): accesos concedidos que nadie ha tomado
Llamadas
- GET /api/v1/users?filter=status eq "STAGED" or status eq "PROVISIONED"
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerido | okta.users.read |
| Pertenencia | requerido | el identificador pertenece a la organización Okta de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://{okta-domain} responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| UserId | clave del objeto | texto | sí |
| Login | mostrado para reconocer el objeto | texto | sí |
| mostrado para reconocer el objeto | texto | no | |
| FirstName | contexto, sin efecto sobre la revisión | texto | no |
| LastName | contexto, sin efecto sobre la revisión | texto | no |
| Status | contexto, sin efecto sobre la revisión | texto | no |
| Created | contexto, sin efecto sobre la revisión | fecha y hora | no |
| Activated | contexto, sin efecto sobre la revisión | fecha y hora | no |
10Directorio · Cuentas cerradas #sec_4c6f05aa
okta.directory.suspended-users:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía okta.management.reviewit.service-app-key
Cuentas suspendidas (SUSPENDED) o desactivadas (DEPROVISIONED), y los accesos que conservan
Llamadas
- GET /api/v1/users?filter=status eq "SUSPENDED" or status eq "DEPROVISIONED"
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerido | okta.users.read |
| Pertenencia | requerido | el identificador pertenece a la organización Okta de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://{okta-domain} responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| UserId | clave del objeto | texto | sí |
| Login | mostrado para reconocer el objeto | texto | sí |
| mostrado para reconocer el objeto | texto | no | |
| Status | contexto, sin efecto sobre la revisión | texto | no |
| StatusChanged | contexto, sin efecto sobre la revisión | fecha y hora | no |
| LastLogin | evaluado por las políticas REVIEWIT (fecha de última actividad) | fecha y hora | no |
| ManagerId | contexto, sin efecto sobre la revisión | texto | no |
11Directorio · Usuarios #sec_c542f4bc
okta.directory.users:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía okta.management.reviewit.service-app-key
Cuentas de la organización: estado, última conexión, responsable declarado
Llamadas
- GET /api/v1/users
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerido | okta.users.read |
| Pertenencia | requerido | el identificador pertenece a la organización Okta de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://{okta-domain} responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| UserId | clave del objeto | texto | sí |
| Login | mostrado para reconocer el objeto | texto | sí |
| mostrado para reconocer el objeto | texto | no | |
| FirstName | contexto, sin efecto sobre la revisión | texto | no |
| LastName | contexto, sin efecto sobre la revisión | texto | no |
| DisplayName | mostrado para reconocer el objeto | texto | no |
| Status | contexto, sin efecto sobre la revisión | texto | no |
| Department | contexto, sin efecto sobre la revisión | texto | no |
| Title | contexto, sin efecto sobre la revisión | texto | no |
| ManagerId | contexto, sin efecto sobre la revisión | texto | no |
| Created | contexto, sin efecto sobre la revisión | fecha y hora | no |
| LastLogin | evaluado por las políticas REVIEWIT (fecha de última actividad) | fecha y hora | no |
12Grupos · Reglas de grupo #sec_b839b944
okta.groups.group-rules:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía okta.management.reviewit.service-app-key
Reglas de pertenencia dinámica: lo que hace que alguien entre en un grupo sin que se le añada
Llamadas
- GET /api/v1/groups/rules
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerido | okta.groups.read |
| Pertenencia | requerido | el identificador pertenece a la organización Okta de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://{okta-domain} responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| RuleId | clave del objeto | texto | sí |
| Name | mostrado para reconocer el objeto | texto | sí |
| Status | contexto, sin efecto sobre la revisión | texto | no |
| Expression | contexto, sin efecto sobre la revisión | texto | no |
| AssignedGroupIds | contexto, sin efecto sobre la revisión | texto | no |
| AssignedGroupNames | contexto, sin efecto sobre la revisión | texto | no |
| Created | contexto, sin efecto sobre la revisión | fecha y hora | no |
| LastUpdated | contexto, sin efecto sobre la revisión | fecha y hora | no |
13Grupos #sec_439851da
okta.groups.groups:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía okta.management.reviewit.service-app-key
Grupos de la organización: los creados en Okta, los importados de una aplicación o de un directorio (AD, LDAP), y los grupos integrados
Llamadas
- GET /api/v1/groups
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerido | okta.groups.read |
| Pertenencia | requerido | el identificador pertenece a la organización Okta de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://{okta-domain} responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| GroupId | clave del objeto | texto | sí |
| Name | mostrado para reconocer el objeto | texto | sí |
| Description | contexto, sin efecto sobre la revisión | texto | no |
| Type | contexto, sin efecto sobre la revisión | texto | no |
| Created | contexto, sin efecto sobre la revisión | fecha y hora | no |
| LastUpdated | contexto, sin efecto sobre la revisión | fecha y hora | no |
| LastMembershipUpdated | evaluado por las políticas REVIEWIT (fecha de última actividad) | fecha y hora | no |
14Grupos · Miembros del grupo #sec_8c8f31d8
okta.groups.memberships:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía okta.management.reviewit.service-app-key
Pertenencias a un grupo, persona por persona. Clave de fila: GroupId | UserId.
Llamadas
- GET /api/v1/groups/{id}/users
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerido | okta.groups.read |
| Pertenencia | requerido | el identificador pertenece a la organización Okta de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://{okta-domain} responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| MembershipKey | clave del objeto | texto | sí |
| GroupId | contexto, sin efecto sobre la revisión | texto | sí |
| GroupName | mostrado para reconocer el objeto | texto | sí |
| UserId | contexto, sin efecto sobre la revisión | texto | sí |
| Login | mostrado para reconocer el objeto | texto | no |
| contexto, sin efecto sobre la revisión | texto | no | |
| Status | contexto, sin efecto sobre la revisión | texto | no |
15Roles privilegiados · Roles de administrador personalizados #sec_6361c4e3
okta.privileged-roles.custom-roles:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía okta.management.reviewit.service-app-key
Roles de administración definidos por el cliente, y los permisos que portan
Llamadas
- GET /api/v1/iam/roles
- GET /api/v1/iam/roles/{roleId}/permissions
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerido | okta.roles.read |
| Pertenencia | requerido | el identificador pertenece a la organización Okta de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://{okta-domain} responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| RoleId | clave del objeto | texto | sí |
| Label | mostrado para reconocer el objeto | texto | sí |
| Description | contexto, sin efecto sobre la revisión | texto | no |
| Permissions | contexto, sin efecto sobre la revisión | texto | no |
| Created | contexto, sin efecto sobre la revisión | fecha y hora | no |
| LastUpdated | contexto, sin efecto sobre la revisión | fecha y hora | no |
16Roles privilegiados · Asignaciones de roles de administrador #sec_7a8dffad
okta.privileged-roles.role-assignments:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía okta.management.reviewit.service-app-key
Roles de administración concedidos a una persona, y su ámbito
Llamadas
- GET /api/v1/iam/assignees/users
- GET /api/v1/users/{id}/roles
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerido | okta.roles.read |
| Permiso | requerido | okta.users.read |
| Pertenencia | requerido | el identificador pertenece a la organización Okta de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://{okta-domain} responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| AssignmentId | clave del objeto | texto | sí |
| Type | contexto, sin efecto sobre la revisión | texto | no |
| RoleLabel | mostrado para reconocer el objeto | texto | sí |
| PrincipalId | contexto, sin efecto sobre la revisión | texto | sí |
| PrincipalLogin | mostrado para reconocer el objeto | texto | no |
| PrincipalKind | contexto, sin efecto sobre la revisión | texto | no |
| ResourceSetId | contexto, sin efecto sobre la revisión | texto | no |
| Created | contexto, sin efecto sobre la revisión | fecha y hora | no |
| LastUpdated | contexto, sin efecto sobre la revisión | fecha y hora | no |
17Para ir más allá #sec_52993119
- Comprender una conexión de recolección
- Referencia de derechos por recurso
- Leer un veredicto