Integrações/Conectores
Provisionamento de identidades: SCIM 2.0
O que é
Interface SCIM 2.0 para o fornecedor de identidade (Microsoft Entra ID, Okta) criar, atualizar e desativar automaticamente as contas e os grupos do tenant. É provisionamento de pessoas, não gera Findings nem Evidence.
Como configurar
- Em Definições → SSO (como ADMIN), clicar Gerar token SCIM. O token é mostrado uma única vez: copiar de imediato para o cofre de segredos do IdP. Revoga-se na lista de chaves API.
- No IdP, configurar o provisionamento automático:
| Campo | Entra ID | Okta |
|---|---|---|
| URL | Tenant URL = https://www.etershield.com/api/scim/v2 (o URL do tenant está em Definições → SSO) |
SCIM connector base URL = o mesmo |
| Autenticação | Secret Token = o token SCIM | HTTP Header com Bearer <token_scim> |
| Identificador | objectId → externalId, userPrincipalName → userName |
Unique identifier field = userName |
| Ações | Utilizadores e grupos | Push New Users, Push Profile Updates, Push Groups |
- Opcional: definir em Definições → SSO o Papel por grupo (nome do grupo → papel) e os domínios de email do SSO.
- Validar a ligação («Test Connection» no Entra) e, depois, com o SCIM Validator da Microsoft.
Regras de segurança
- O SCIM só aceita um token com o scope explícito
/api/scim/v2. A API Key única do tenant e as chaves nomeadas sem scopes (acesso total) são recusadas (401), criar e desativar contas é demasiado poder para uma chave de uso geral. E o token SCIM, por sua vez, não serve em nenhuma outra rota. - Limite de 600 pedidos/min por tenant (
429se excedido). - Cada operação fica no audit log como
scim:<nome do token>.
O que faz
| No IdP | No EterShield |
|---|---|
| Atribuir o utilizador à aplicação | Cria a conta (papel inicial = papel JIT por omissão do SSO, normalmente USER); respeita o limite de utilizadores do plano |
| Retirar a atribuição / desativar / apagar | Desativa a pertença, nunca apaga (conta e histórico ficam; a anonimização RGPD é à parte) |
| Reativar | Reativa a pertença |
Alterar nome, cargo (title), externalId |
Atualiza |
| Grupo (criar, renomear, adicionar/retirar membros) | Cria/atualiza o departamento do tenant e a respetiva lista de membros |
- Papel por grupo: se estiver definido, o papel dos utilizadores criados por SCIM segue os grupos a que pertencem (precedência ADMIN > MANAGER > USER > AUDITOR > VIEWER). Nunca atribui
SUPER_ADMINe nunca deixa o tenant sem administrador. - Último administrador: nunca é desativado por SCIM (o IdP recebe
400). - Papel e estado na pertença: papel, cargo, estado e
externalIdvivem na pertença (Membership) a este tenant, incluindo na de origem; um utilizador criado já inativo fica com a conta ativa e a pertença inativa, e só consegue entrar numa organização onde tenha pertença ativa. - Filtros: só
eq,userName/externalIdnos Users edisplayName/externalIdnos Groups, o que o Entra e o Okta usam para encontrar um recurso antes de o criar. Bulk, ordenação e ETags não são suportados. - Membros externos: se o email enviado pelo IdP for o de uma conta que já existe noutra organização (ex.: um consultor de um parceiro), o SCIM não cria uma conta nova, cria ou reativa a pertença dessa conta a este tenant. O nome e o email de um externo pertencem à organização de origem e não são alterados pelo IdP deste cliente (o pedido é aceite, esses campos são ignorados). Desativar um externo retira-lhe só o acesso a este tenant. O tenant pode recusar externos em Definições → Segurança, e a entrada de um externo exige MFA.
- Erros no formato SCIM:
400(pedido/filtro inválido, domínio fora do SSO),401(token),403(limite do plano; externos recusados),404,409(userName,externalIdou nome de grupo duplicado),429.
Onde aparece no EterShield
Pessoas → Acessos (contas, com a marca «Externo · origem» nos membros de outras organizações) e os departamentos do tenant.