Aprovisionamento SCIM

Com o SCIM 2.0, o teu fornecedor de identidade, por exemplo o Microsoft Entra ID ou o Okta, gere os utilizadores do exoCortex por ti: quando contratas uma pessoa, o utilizador é criado; quando muda de função, é atualizado; quando sai da empresa, é desativado.

Ligar o fornecedor de identidade

1. No exoCortex Core, abre Identity → SCIM e gera um token SCIM. Copia-o de imediato: só é mostrado uma vez.
2. No teu fornecedor de identidade, acrescenta uma aplicação com aprovisionamento SCIM 2.0 e indica:
   • URL base: https://exocortex-api.ai-exo-cortex.com/scim/v2
   • Autenticação: token bearer, com o token gerado no passo 1.
3. Inicia um teste de ligação a partir do fornecedor de identidade e depois atribui à aplicação os utilizadores e os grupos a sincronizar.

O token pertence a um tenant: o fornecedor de identidade só vê e gere os utilizadores desse tenant.

O que o exoCortex suporta

Funcionalidade	Suporte
Utilizadores: criação, leitura, substituição, atualização (PATCH), eliminação	sim
Grupos: criação, leitura, atualização (PATCH), eliminação	sim
Filtros	sim, por exemplo userName eq "[email protected]", também com and; até 200 resultados
Ordenação	sim
Operações em bloco (bulk)	não
Alteração da palavra-passe	não: a palavra-passe é escolhida pelo utilizador
ETag	não

Atributos do utilizador

O exoCortex usa os atributos padrão do esquema de utilizador SCIM:

• userName: o identificador do utilizador, normalmente o email da empresa;
• externalId: o identificador do utilizador no teu fornecedor de identidade;
• name.givenName e name.familyName, displayName;
• emails, com o endereço principal marcado como primary;
• active: se for false, o utilizador está desativado;
• title e userType, se existirem.

Desativar e remover um utilizador

Quando um utilizador sai da empresa, o fornecedor de identidade desativa-o com um PATCH que define active como false:

{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
  "Operations": [{ "op": "replace", "path": "active", "value": false }]
}

Um pedido DELETE sobre o utilizador remove-o do aprovisionamento (desaprovisionamento).

Erros

Os endpoints SCIM respondem com documentos de erro SCIM (RFC 7644). Um 401 indica um token em falta, inválido, revogado ou expirado: gera um novo token e atualiza-o no fornecedor de identidade.