Menu AuthGuardCentro de ajuda
Englishauthguard.pt

Administradores · SCIM e diretório

Tokens SCIM (criar, rodar e revogar)

  • 2 min de leitura
  • SaaS · Instalação própria
  • Vídeo
Tutorial 05Pessoas e grupos por SCIM2:36 · Legendas em português e em inglês.Transcrição e detalhes

O Microsoft Entra ID e o Okta criam, alteram e removem as pessoas e os grupos da organização por SCIM 2.0. Autenticam-se com um token que cria em «Gerir» › «Tokens SCIM».

Como crio um token?

  1. Abra «Gerir» › «Tokens SCIM». A consola explica que o serviço guarda apenas uma impressão digital de cada token.
  2. Escolha «Criar token» e preencha:
    • Nome (1 a 64 caracteres), por exemplo "Entra produção".
    • Âmbitos: «Utilizadores (scim:users)» e/ou «Grupos (scim:groups)». Para o Entra e o Okta, escolha os dois.
    • «Válido durante»: «30 dias», «90 dias», «1 ano» ou «2 anos».
  3. Confirme. Abre «Novo token SCIM» com o «URL da organização» e o «Token secreto». «O segredo só é mostrado uma vez.»
  4. Copie os dois para o fornecedor de identidade e escolha «Concluído».

O URL tem a forma https://<endereço da organização>/scim/v2. Cada organização tem no máximo cinco tokens ativos.

Como rodo um token?

  1. Na linha do token, escolha «Rodar token».
  2. Escolha o que acontece ao antigo: «deixa de funcionar de imediato», «funciona durante mais 1 hora», «funciona durante mais 24 horas» (omissão) ou «funciona durante mais 7 dias».
  3. Copie o novo segredo para o fornecedor de identidade: «Token rodado. Copie agora o novo segredo para o fornecedor de identidade.»

O novo token mantém o nome e os âmbitos.

Como revogo?

«Revogar» › «Confirmar revogação». A revogação é imediata.

Estados

«Ativo», «A expirar», «Expirado», «Revogado». A coluna «Última utilização» mostra se o fornecedor de identidade está a usar o token.

Erros que o fornecedor de identidade vê

RespostaCausa
401Token em falta, errado, expirado ou revogado (todos dão a mesma resposta)
403O token não tem o âmbito do recurso pedido, ou a licença não tem lugares

Ver O SCIM devolve 401.

Criar, rodar e revogar exigem uma confirmação recente e ficam na auditoria.

Códigos de erro deste artigo

Referência do artigoad-scim-tokensindique-a ao suporte para identificar este artigo. Verificado contra o produto no commit 5f6607a8.