Aprovisionamento SCIM com o Microsoft Entra ID, passo a passo

Com o aprovisionamento SCIM, o Microsoft Entra ID cria, atualiza, desativa e remove automaticamente as pessoas e os grupos da organização. Os menus do Entra mudam com o tempo; siga também a documentação atual da Microsoft.

Antes de começar

Crie um token com os dois âmbitos em «Gerir» › «Tokens SCIM» e tenha à mão o «URL da organização» e o «Token secreto». Ver Tokens SCIM.

Passo 1: criar a aplicação no Entra

1. No centro de administração do Entra, abra Enterprise applications e crie uma aplicação fora da galeria (non-gallery).
2. Em Provisioning, defina o modo como Automatic.

Passo 2: ligar ao serviço

1. Tenant URL: o «URL da organização» (https://<endereço da organização>/scim/v2).
2. Secret Token: o «Token secreto».
3. Escolha Test Connection.

Passo 3: mapeamentos dos utilizadores

Mantenha:

• userPrincipalName → userName (o nome de entrada; é guardado em minúsculas);
• objectId → externalId;
• mail → emails[type eq "work"].value;
• o mapeamento de IsSoftDeleted para active.

Remova os atributos de que não precisa.

Passo 4: mapeamentos dos grupos

Mantenha displayName → displayName, objectId → externalId e members → members.

Passo 5: atribuir e arrancar

1. Atribua os utilizadores e os grupos à aplicação.
2. Use Provision on demand com uma pessoa para confirmar.
3. Inicie o aprovisionamento.

As aplicações novas do Entra enviam pedidos PATCH no formato da norma; as antigas podem ser migradas com a opção aadOptscim062020 no Tenant URL. O serviço aceita os dois formatos.

Verificar

As pessoas aparecem em «Gerir» › «Pessoas» e os grupos em «Gerir» › «Grupos» (com nomes scim-…). As pessoas entram depois com passkey ou telemóvel; o SCIM não define palavras-passe.

Problemas

• Test Connection falha com 401: token errado, expirado ou revogado.
• 403 ao criar pessoas: a licença não tem lugares livres.

Ver Comportamento do SCIM.