REVIEWITDocumentação
Esta página é gerada a partir de Catalogue publié — Okta — não se corrige à mão.Corrigir o contrato corrige a página. Modificá-la aqui perder-se-ia na próxima geração.GERADA EM 18 outubro 2026 · catalogue v23 · a36ea8a4
Referência geradaAtualizada · gerada em 18 outubro 2026

Contratos de coleta — Okta

Tradução automática, ainda não revistaEsta página foi traduzida por um modelo a partir da versão francesa, que faz fé. Ler a versão francesa.

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.

ViaToken emitido porAudiência do tokenAutenticação do identificador
okta.management.reviewit.service-app-keyhttps://{okta-domain}/oauth2/v1/tokenhttps://{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

NaturezaRegraOpções
Direitoobrigatóriaokta.apiTokens.read
Pertençaobrigatóriao 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

CampoPapelTipoObrigatório
TokenIdchave do objetotextosim
Nameexibido para reconhecer o objetotextosim
UserIdcontexto, sem efeito sobre a revisãotextonão
Loginexibido para reconhecer o objetotextonão
Createdcontexto, sem efeito sobre a revisãodata e horanão
LastUpdatedcontexto, sem efeito sobre a revisãodata e horanão
ExpiresOncontexto, sem efeito sobre a revisãodata e horanã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

NaturezaRegraOpções
Direitotodasokta.appGrants.read e okta.users.read
Afiliaçãorequeridao 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

CampoPapelTipoObrigatório
GrantIdchave do objetotextosim
UserIdcontexto, sem efeito sobre a revisãotextonão
Loginexibido para reconhecer o objetotextosim
ClientIdcontexto, sem efeito sobre a revisãotextonão
AppNameexibido para reconhecer o objetotextonão
Scopecontexto, sem efeito sobre a revisãotextonão
Statuscontexto, sem efeito sobre a revisãotextonão
Createdcontexto, sem efeito sobre a revisãodata e horanão
LastUpdatedcontexto, sem efeito sobre a revisãodata e horanã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

NaturezaRegraOpções
Direitorequeridaokta.apps.read
Afiliaçãorequeridao 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

CampoPapelTipoObrigatório
AppIdchave do objetotextosim
Labelexibido para reconhecer o objetotextosim
SignOnModecontexto, sem efeito sobre a revisãotextonão
Statuscontexto, sem efeito sobre a revisãotextonão
Createdcontexto, sem efeito sobre a revisãodata e horanão
LastUpdatedcontexto, sem efeito sobre a revisãodata e horanão
Visibilitycontexto, sem efeito sobre a revisãotextonã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

NaturezaRegraOpções
Direitorequeridaokta.apps.read
Direitorequeridaokta.groups.read
Afiliaçãorequeridao 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

CampoPapelTipoObrigatório
AssignmentKeychave do objetotextosim
AppIdcontexto, sem efeito sobre a revisãotextosim
Labelexibido para reconhecer o objetotextosim
GroupIdcontexto, sem efeito sobre a revisãotextosim
GroupNameexibido para reconhecer o objetotextonão
Prioritycontexto, sem efeito sobre a revisãointeironão
Createdcontexto, sem efeito sobre a revisãodata e horanão
LastUpdatedcontexto, sem efeito sobre a revisãodata e horanã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

NaturezaRegraOpções
Direitorequeridaokta.apps.read
Direitorequeridaokta.users.read
Afiliaçãorequeridao 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

CampoPapelTipoObrigatório
AssignmentKeychave do objetotextosim
AppIdcontexto, sem efeito sobre a revisãotextosim
Labelexibido para reconhecer o objetotextosim
UserIdcontexto, sem efeito sobre a revisãotextosim
Loginexibido para reconhecer o objetotextonão
Emailcontexto, sem efeito sobre a revisãotextonão
Scopecontexto, sem efeito sobre a revisãotextonão
Statuscontexto, sem efeito sobre a revisãotextonão
Createdcontexto, sem efeito sobre a revisãodata e horanão
LastUpdatedcontexto, sem efeito sobre a revisãodata e horanã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

NaturezaRegraOpções
Direitorequeridookta.users.read
Afiliaçãorequeridoo 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

CampoPapelTipoObrigatório
UserIdchave do objetotextosim
Loginexibido para reconhecer o objetotextosim
Emailexibido para reconhecer o objetotextonão
FirstNamecontexto, sem efeito sobre a revisãotextonão
LastNamecontexto, sem efeito sobre a revisãotextonão
Statuscontexto, sem efeito sobre a revisãotextonão
Createdcontexto, sem efeito sobre a revisãodata e horanão
Activatedcontexto, sem efeito sobre a revisãodata e horanã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

NaturezaRegraOpções
Direitorequeridookta.users.read
Afiliaçãorequeridoo 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

CampoPapelTipoObrigatório
UserIdchave do objetotextosim
Loginexibido para reconhecer o objetotextosim
Emailexibido para reconhecer o objetotextonão
Statuscontexto, sem efeito sobre a revisãotextonão
StatusChangedcontexto, sem efeito sobre a revisãodata e horanão
LastLoginavaliado pelas políticas REVIEWIT (data da última atividade)data e horanão
ManagerIdcontexto, sem efeito sobre a revisãotextonã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

NaturezaRegraOpções
Direitorequeridookta.users.read
Afiliaçãorequeridoo 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

CampoPapelTipoObrigatório
UserIdchave do objetotextosim
Loginexibido para reconhecer o objetotextosim
Emailexibido para reconhecer o objetotextonão
FirstNamecontexto, sem efeito sobre a revisãotextonão
LastNamecontexto, sem efeito sobre a revisãotextonão
DisplayNameexibido para reconhecer o objetotextonão
Statuscontexto, sem efeito sobre a revisãotextonão
Departmentcontexto, sem efeito sobre a revisãotextonão
Titlecontexto, sem efeito sobre a revisãotextonão
ManagerIdcontexto, sem efeito sobre a revisãotextonão
Createdcontexto, sem efeito sobre a revisãodata e horanão
LastLoginavaliado pelas políticas REVIEWIT (data da última atividade)data e horanã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

NaturezaRegraOpções
Direitorequeridookta.groups.read
Afiliaçãorequeridoo 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

CampoPapelTipoObrigatório
RuleIdchave do objetotextosim
Nameexibido para reconhecer o objetotextosim
Statuscontexto, sem efeito sobre a revisãotextonão
Expressioncontexto, sem efeito sobre a revisãotextonão
AssignedGroupIdscontexto, sem efeito sobre a revisãotextonão
AssignedGroupNamescontexto, sem efeito sobre a revisãotextonão
Createdcontexto, sem efeito sobre a revisãodata e horanão
LastUpdatedcontexto, sem efeito sobre a revisãodata e horanã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

NaturezaRegraOpções
Direitorequeridookta.groups.read
Membresiarequeridoo 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

CampoPapelTipoObrigatório
GroupIdchave do objetotextosim
Nameexibido para reconhecer o objetotextosim
Descriptioncontexto, sem efeito sobre a revisãotextonão
Typecontexto, sem efeito sobre a revisãotextonão
Createdcontexto, sem efeito sobre a revisãodata e horanão
LastUpdatedcontexto, sem efeito sobre a revisãodata e horanão
LastMembershipUpdatedavaliado pelas políticas REVIEWIT (data da última atividade)data e horanã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

NaturezaRegraOpções
Direitorequeridookta.groups.read
Membresiarequeridoo 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

CampoPapelTipoObrigatório
MembershipKeychave do objetotextosim
GroupIdcontexto, sem efeito sobre a revisãotextosim
GroupNameexibido para reconhecer o objetotextosim
UserIdcontexto, sem efeito sobre a revisãotextosim
Loginexibido para reconhecer o objetotextonão
Emailcontexto, sem efeito sobre a revisãotextonão
Statuscontexto, sem efeito sobre a revisãotextonã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

NaturezaRegraOpções
Direitorequeridookta.roles.read
Membresiarequeridoo 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

CampoPapelTipoObrigatório
RoleIdchave do objetotextosim
Labelexibido para reconhecer o objetotextosim
Descriptioncontexto, sem efeito sobre a revisãotextonão
Permissionscontexto, sem efeito sobre a revisãotextonão
Createdcontexto, sem efeito sobre a revisãodata e horanão
LastUpdatedcontexto, sem efeito sobre a revisãodata e horanã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

NaturezaRegraOpções
Direitorequeridookta.roles.read
Direitorequeridookta.users.read
Membresiarequeridoo 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

CampoPapelTipoObrigatório
AssignmentIdchave do objetotextosim
Typecontexto, sem efeito sobre a revisãotextonão
RoleLabelexibido para reconhecer o objetotextosim
PrincipalIdcontexto, sem efeito sobre a revisãotextosim
PrincipalLoginexibido para reconhecer o objetotextonão
PrincipalKindcontexto, sem efeito sobre a revisãotextonão
ResourceSetIdcontexto, sem efeito sobre a revisãotextonão
Createdcontexto, sem efeito sobre a revisãodata e horanão
LastUpdatedcontexto, sem efeito sobre a revisãodata e horanão

17Para ir mais longe #sec_52993119

  • Compreender uma ligação de recolha
  • Referência dos direitos por recurso
  • Ler um veredicto
Esc
↑↓ navegar↵ abrirVer todos os resultados →