Contratos de coleta — Okta
01Como ler esta página #sec_900d4e5d
Cada recurso que o REVIEWIT pode coletar para o Okta tem um contrato publicado. Ele é lido como uma referência de API: o que o REVIEWIT chama no serviço coletado e por qual meio, o que o contrato exige para que a coleta seja executada e os dados que o REVIEWIT mantém. O REVIEWIT apenas realiza leituras.
- Chamadas: as requisições que o REVIEWIT faz ao serviço coletado, todas em leitura.
- Exigências: cada uma deve ser satisfeita. Sua natureza diz o que ela solicita: um direito a conceder ao identificador, uma condição de administração (uma configuração ou atribuição no fornecedor que o token não possui, constatada por uma chamada real em leitura) ou a pertença do identificador à organização Okta da conexão. A regra diz quantas opções são necessárias: « obrigatória » para a única opção, « uma à escolha » quando uma única basta (elas são ordenadas da mais estreita à mais ampla: prefira a primeira), « todas » ou « N à escolha entre M ».
- Condições de funcionamento: o que o REVIEWIT constata antes de cada coleta, além das exigências.
- Frescura: a idade máxima das verificações sobre as quais o veredicto se baseia, definida por cada contrato (aqui: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real). O REVIEWIT refaz automaticamente dentro desse prazo as verificações que ele sabe fazer (token obtido, serviço que responde); « Verificar os direitos », no menu da conexão, os refaz sob demanda. Enquanto a chamada real não for feita, os direitos permanecem não constatados.
- Dados mantidos: os campos que o REVIEWIT mantém de cada objeto; o papel diz o que a revisão faz com eles.
O veredicto de cada recurso, para sua conexão, é lido em sua ficha. Um recurso que a conexão não coleta pode sempre ser alimentado pela importação de um relatório (« Importar um relatório »).
02Como o REVIEWIT verifica as exigências #sec_2df3a117
O token Okta não possui seus direitos: o contrato exige que eles sejam constatados por uma chamada real, em leitura. O REVIEWIT ainda não faz essa chamada para o Okta: ele constata que o token é obtido e que o serviço responde, mas não os direitos listados aqui. Os recursos são exibidos como « Não verificado »; eles podem sempre ser alimentados pela importação de um relatório (« Importar um relatório »).
03As vias de chamada #sec_082df6f4
Uma via indica qual token o REVIEWIT obtém para o identificador: quem o emite e para qual audiência. Os endereços chamados aparecem nas chamadas de cada recurso; um caminho que começa com « / » é chamado na audiência do token de sua via.
| Via | Token emitido por | Audiência do token | Autenticação do identificador |
|---|---|---|---|
| okta.management.reviewit.service-app-key | https://{okta-domain}/oauth2/v1/token | https://{okta-domain} | par de chaves (private_key_jwt) |
Nesses endereços, {okta-domain} é o domínio Okta da organização (por exemplo, acme.okta.com ou acme.okta-emea.com).
04Credenciais de API · Tokens de API #sec_8c7b77dc
okta.credentials.api-tokens:collect · revisão 1 do contrato, publicada em 18 de outubro de 2026 · via okta.management.reviewit.service-app-key
Tokens de API da organização: seu portador, sua última utilização, sua validade
Chamadas
- GET /api/v1/api-tokens
Exigências
| Natureza | Regra | Opções |
|---|---|---|
| Direito | obrigatória | okta.apiTokens.read |
| Pertença | obrigatória | o identificador pertence à organização Okta da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://{okta-domain} responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados mantidos
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| TokenId | chave do objeto | texto | sim |
| Name | exibido para reconhecer o objeto | texto | sim |
| UserId | contexto, sem efeito sobre a revisão | texto | não |
| Login | exibido para reconhecer o objeto | texto | não |
| Created | contexto, sem efeito sobre a revisão | data e hora | não |
| LastUpdated | contexto, sem efeito sobre a revisão | data e hora | não |
| ExpiresOn | contexto, sem efeito sobre a revisão | data e hora | não |
05Credenciais de API · Consentos OAuth #sec_ade404c2
okta.credentials.oauth-grants:collect · revisão 1 do contrato, publicada em 18 de outubro de 2026 · via okta.management.reviewit.service-app-key
Consentimentos OAuth concedidos por uma pessoa a uma aplicação
Chamadas
- GET /api/v1/apps/{id}/grants
- GET /api/v1/users/{id}/grants
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | todas | okta.appGrants.read e okta.users.read |
| Afiliação | requerida | o identificador pertence à organização Okta da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://{okta-domain} responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| GrantId | chave do objeto | texto | sim |
| UserId | contexto, sem efeito sobre a revisão | texto | não |
| Login | exibido para reconhecer o objeto | texto | sim |
| ClientId | contexto, sem efeito sobre a revisão | texto | não |
| AppName | exibido para reconhecer o objeto | texto | não |
| Scope | contexto, sem efeito sobre a revisão | texto | não |
| Status | contexto, sem efeito sobre a revisão | texto | não |
| Created | contexto, sem efeito sobre a revisão | data e hora | não |
| LastUpdated | contexto, sem efeito sobre a revisão | data e hora | não |
06Atribuições de aplicação · Aplicações #sec_2db8add4
okta.apps.applications:collect · revisão 1 do contrato, publicada em 18 de outubro de 2026 · via okta.management.reviewit.service-app-key
Aplicações da organização, seu modo de autenticação única e seu estado
Chamadas
- GET /api/v1/apps
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | requerida | okta.apps.read |
| Afiliação | requerida | o identificador pertence à organização Okta da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://{okta-domain} responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| AppId | chave do objeto | texto | sim |
| Label | exibido para reconhecer o objeto | texto | sim |
| SignOnMode | contexto, sem efeito sobre a revisão | texto | não |
| Status | contexto, sem efeito sobre a revisão | texto | não |
| Created | contexto, sem efeito sobre a revisão | data e hora | não |
| LastUpdated | contexto, sem efeito sobre a revisão | data e hora | não |
| Visibility | contexto, sem efeito sobre a revisão | texto | não |
07Atribuições de aplicação · Atribuições de aplicação (grupos) #sec_26496090
okta.apps.group-assignments:collect · revisão 1 do contrato, publicada em 18 de outubro de 2026 · via okta.management.reviewit.service-app-key
Grupos afetados a uma aplicação e o perfil que eles carregam. Chave de linha: AppId | GroupId.
Chamadas
- GET /api/v1/apps/{id}/groups
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | requerida | okta.apps.read |
| Direito | requerida | okta.groups.read |
| Afiliação | requerida | o identificador pertence à organização Okta da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://{okta-domain} responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| AssignmentKey | chave do objeto | texto | sim |
| AppId | contexto, sem efeito sobre a revisão | texto | sim |
| Label | exibido para reconhecer o objeto | texto | sim |
| GroupId | contexto, sem efeito sobre a revisão | texto | sim |
| GroupName | exibido para reconhecer o objeto | texto | não |
| Priority | contexto, sem efeito sobre a revisão | inteiro | não |
| Created | contexto, sem efeito sobre a revisão | data e hora | não |
| LastUpdated | contexto, sem efeito sobre a revisão | data e hora | não |
08Atribuições de aplicação · Atribuições de aplicação (utilizadores) #sec_894bdc62
okta.apps.user-assignments:collect · revisão 1 do contrato, publicada em 18 de outubro de 2026 · via okta.management.reviewit.service-app-key
Utilizadores afetados a uma aplicação, diretamente ou por um grupo. Chave de linha: AppId | UserId.
Chamadas
- GET /api/v1/apps/{id}/users
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | requerida | okta.apps.read |
| Direito | requerida | okta.users.read |
| Afiliação | requerida | o identificador pertence à organização Okta da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://{okta-domain} responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| AssignmentKey | chave do objeto | texto | sim |
| AppId | contexto, sem efeito sobre a revisão | texto | sim |
| Label | exibido para reconhecer o objeto | texto | sim |
| UserId | contexto, sem efeito sobre a revisão | texto | sim |
| Login | exibido para reconhecer o objeto | texto | não |
| contexto, sem efeito sobre a revisão | texto | não | |
| Scope | contexto, sem efeito sobre a revisão | texto | não |
| Status | contexto, sem efeito sobre a revisão | texto | não |
| Created | contexto, sem efeito sobre a revisão | data e hora | não |
| LastUpdated | contexto, sem efeito sobre a revisão | data e hora | não |
09Directory · Contas nunca ativados #sec_0c88c27f
okta.directory.pending-users:collect · revisão 1 do contrato, publicada em 18 de outubro de 2026 · via okta.management.reviewit.service-app-key
Contas criados e nunca ativados (STAGED, PROVISIONED): acessos concedidos que ninguém utilizou
Chamadas
- GET /api/v1/users?filter=status eq "STAGED" or status eq "PROVISIONED"
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | requerido | okta.users.read |
| Afiliação | requerido | o identificador pertence à organização Okta da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://{okta-domain} responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| UserId | chave do objeto | texto | sim |
| Login | exibido para reconhecer o objeto | texto | sim |
| exibido para reconhecer o objeto | texto | não | |
| FirstName | contexto, sem efeito sobre a revisão | texto | não |
| LastName | contexto, sem efeito sobre a revisão | texto | não |
| Status | contexto, sem efeito sobre a revisão | texto | não |
| Created | contexto, sem efeito sobre a revisão | data e hora | não |
| Activated | contexto, sem efeito sobre a revisão | data e hora | não |
10Directory · Contas fechadas #sec_4c6f05aa
okta.directory.suspended-users:collect · revisão 1 do contrato, publicada em 18 de outubro de 2026 · via okta.management.reviewit.service-app-key
Contas suspensas (SUSPENDED) ou desativadas (DEPROVISIONED), e os acessos que mantêm
Chamadas
- GET /api/v1/users?filter=status eq "SUSPENDED" or status eq "DEPROVISIONED"
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | requerido | okta.users.read |
| Afiliação | requerido | o identificador pertence à organização Okta da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://{okta-domain} responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| UserId | chave do objeto | texto | sim |
| Login | exibido para reconhecer o objeto | texto | sim |
| exibido para reconhecer o objeto | texto | não | |
| Status | contexto, sem efeito sobre a revisão | texto | não |
| StatusChanged | contexto, sem efeito sobre a revisão | data e hora | não |
| LastLogin | avaliado pelas políticas REVIEWIT (data da última atividade) | data e hora | não |
| ManagerId | contexto, sem efeito sobre a revisão | texto | não |
11Directory · Utilizadores #sec_c542f4bc
okta.directory.users:collect · revisão 1 do contrato, publicada em 18 de outubro de 2026 · via okta.management.reviewit.service-app-key
Contas da organização: estado, última conexão, responsável declarado
Chamadas
- GET /api/v1/users
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | requerido | okta.users.read |
| Afiliação | requerido | o identificador pertence à organização Okta da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://{okta-domain} responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| UserId | chave do objeto | texto | sim |
| Login | exibido para reconhecer o objeto | texto | sim |
| exibido para reconhecer o objeto | texto | não | |
| FirstName | contexto, sem efeito sobre a revisão | texto | não |
| LastName | contexto, sem efeito sobre a revisão | texto | não |
| DisplayName | exibido para reconhecer o objeto | texto | não |
| Status | contexto, sem efeito sobre a revisão | texto | não |
| Department | contexto, sem efeito sobre a revisão | texto | não |
| Title | contexto, sem efeito sobre a revisão | texto | não |
| ManagerId | contexto, sem efeito sobre a revisão | texto | não |
| Created | contexto, sem efeito sobre a revisão | data e hora | não |
| LastLogin | avaliado pelas políticas REVIEWIT (data da última atividade) | data e hora | não |
12Groups · Regras de grupo #sec_b839b944
okta.groups.group-rules:collect · revisão 1 do contrato, publicada em 18 de outubro de 2026 · via okta.management.reviewit.service-app-key
Regras de pertença dinâmica: o que faz entrar alguém num grupo sem que seja colocado lá
Chamadas
- GET /api/v1/groups/rules
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | requerido | okta.groups.read |
| Afiliação | requerido | o identificador pertence à organização Okta da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://{okta-domain} responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| RuleId | chave do objeto | texto | sim |
| Name | exibido para reconhecer o objeto | texto | sim |
| Status | contexto, sem efeito sobre a revisão | texto | não |
| Expression | contexto, sem efeito sobre a revisão | texto | não |
| AssignedGroupIds | contexto, sem efeito sobre a revisão | texto | não |
| AssignedGroupNames | contexto, sem efeito sobre a revisão | texto | não |
| Created | contexto, sem efeito sobre a revisão | data e hora | não |
| LastUpdated | contexto, sem efeito sobre a revisão | data e hora | não |
13Grupos #sec_439851da
okta.groups.groups:collect · revisão 1 do contrato, publicada em 18 de outubro de 2026 · via okta.management.reviewit.service-app-key
Grupos da organização: aqueles criados no Okta, importados de uma aplicação ou de um diretório (AD, LDAP), e grupos integrados
Chamadas
- GET /api/v1/groups
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | requerido | okta.groups.read |
| Membresia | requerido | o identificador pertence à organização Okta da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://{okta-domain} responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| GroupId | chave do objeto | texto | sim |
| Name | exibido para reconhecer o objeto | texto | sim |
| Description | contexto, sem efeito sobre a revisão | texto | não |
| Type | contexto, sem efeito sobre a revisão | texto | não |
| Created | contexto, sem efeito sobre a revisão | data e hora | não |
| LastUpdated | contexto, sem efeito sobre a revisão | data e hora | não |
| LastMembershipUpdated | avaliado pelas políticas REVIEWIT (data da última atividade) | data e hora | não |
14Grupos · Membros do grupo #sec_8c8f31d8
okta.groups.memberships:collect · revisão 1 do contrato, publicada em 18 de outubro de 2026 · via okta.management.reviewit.service-app-key
Membresias a um grupo, pessoa por pessoa. Chave da linha: GroupId | UserId.
Chamadas
- GET /api/v1/groups/{id}/users
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | requerido | okta.groups.read |
| Membresia | requerido | o identificador pertence à organização Okta da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://{okta-domain} responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| MembershipKey | chave do objeto | texto | sim |
| GroupId | contexto, sem efeito sobre a revisão | texto | sim |
| GroupName | exibido para reconhecer o objeto | texto | sim |
| UserId | contexto, sem efeito sobre a revisão | texto | sim |
| Login | exibido para reconhecer o objeto | texto | não |
| contexto, sem efeito sobre a revisão | texto | não | |
| Status | contexto, sem efeito sobre a revisão | texto | não |
15Papéis privilegiados · Papéis de administrador personalizados #sec_6361c4e3
okta.privileged-roles.custom-roles:collect · revisão 1 do contrato, publicada em 18 de outubro de 2026 · via okta.management.reviewit.service-app-key
Papéis de administração definidos pelo cliente, e as permissões que carregam
Chamadas
- GET /api/v1/iam/roles
- GET /api/v1/iam/roles/{roleId}/permissions
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | requerido | okta.roles.read |
| Membresia | requerido | o identificador pertence à organização Okta da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://{okta-domain} responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| RoleId | chave do objeto | texto | sim |
| Label | exibido para reconhecer o objeto | texto | sim |
| Description | contexto, sem efeito sobre a revisão | texto | não |
| Permissions | contexto, sem efeito sobre a revisão | texto | não |
| Created | contexto, sem efeito sobre a revisão | data e hora | não |
| LastUpdated | contexto, sem efeito sobre a revisão | data e hora | não |
16Papéis privilegiados · Atribuições de papéis de administrador #sec_7a8dffad
okta.privileged-roles.role-assignments:collect · revisão 1 do contrato, publicada em 18 de outubro de 2026 · via okta.management.reviewit.service-app-key
Papéis de administração concedidos a uma pessoa, e seu escopo
Chamadas
- GET /api/v1/iam/assignees/users
- GET /api/v1/users/{id}/roles
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | requerido | okta.roles.read |
| Direito | requerido | okta.users.read |
| Membresia | requerido | o identificador pertence à organização Okta da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://{okta-domain} responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| AssignmentId | chave do objeto | texto | sim |
| Type | contexto, sem efeito sobre a revisão | texto | não |
| RoleLabel | exibido para reconhecer o objeto | texto | sim |
| PrincipalId | contexto, sem efeito sobre a revisão | texto | sim |
| PrincipalLogin | exibido para reconhecer o objeto | texto | não |
| PrincipalKind | contexto, sem efeito sobre a revisão | texto | não |
| ResourceSetId | contexto, sem efeito sobre a revisão | texto | não |
| Created | contexto, sem efeito sobre a revisão | data e hora | não |
| LastUpdated | contexto, sem efeito sobre a revisão | data e hora | não |
17Para ir mais longe #sec_52993119
- Compreender uma ligação de recolha
- Referência dos direitos por recurso
- Ler um veredicto