EterShieldDocs
etershield.com
ENEntrar
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

  1. 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.
  2. 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
  1. Opcional: definir em Definições → SSO o Papel por grupo (nome do grupo → papel) e os domínios de email do SSO.
  2. 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 (429 se 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_ADMIN e 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 externalId vivem 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/externalId nos Users e displayName/externalId nos 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, externalId ou 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.

EterShield, uma plataforma Eter Growth