Como o Provisionamento de Aplicativos funciona no Microsoft Entra ID

Artigo
08/25/2024

O provisionamento automático refere-se à criação de identidades e funções de usuário nos aplicativos de nuvem que os usuários precisam acessar. Além de criar identidades de usuário, o provisionamento automático inclui a manutenção e a remoção de identidades de usuário à medida que o status ou as funções mudam. Antes de iniciar uma implantação, leia este artigo para saber como o provisionamento do Microsoft Entra funciona e obter recomendações de configuração.

O serviço de provisionamento do Microsoft Entra provisiona usuários para aplicativos SaaS e outros sistemas a um ponto de extremidade da API de gerenciamento de usuários do Sistema de Gerenciamento de Usuários entre Domínios (SCIM) 2.0 oferecido pelo fornecedor do aplicativo ou um agente de provisionamento no local. Esse ponto de extremidade do SCIM permite que o Microsoft Entra ID crie, atualize e remova usuários de forma programática. Para os aplicativos selecionados, o serviço de provisionamento também pode criar, atualizar e remover objetos extras relacionados à identidade, como os grupos. O canal usado para provisionamento entre o Microsoft Entra ID e o aplicativo usa a criptografia HTTPS TLS 1.2.

Figura 1: o serviço de provisionamento do Microsoft Entra

Fluxo de trabalho de saída do provisionamento do usuário Figura 2: fluxo de trabalho de provisionamento do usuário de "saída" do Microsoft Entra ID para aplicativos SaaS muito usados

Fluxo de trabalho de entrada do provisionamento de usuário Figura 3: fluxo de trabalho de provisionamento do usuário de "entrada" de aplicativos muito usados de HCM (gerenciamento de capital humano) para o Microsoft Entra ID e o Windows Server Active Directory

Provisionamento usando o SCIM 2.0

O serviço de provisionamento do Microsoft Entra usa o protocolo SCIM 2.0 para provisionamento automático. O serviço se conecta ao ponto de extremidade do SCIM do aplicativo e usa o esquema de objetos do usuário do SCIM e as APIs REST para automatizar o provisionamento e o desprovisionamento de usuários e grupos. Um conector de provisionamento que usa o SCIM é fornecido para a maioria dos aplicativos na galeria do Microsoft Entra. Os desenvolvedores usam a API de gerenciamento de usuário SCIM 2.0 no Microsoft Entra ID para criar pontos de extremidade para seus aplicativos que se integram ao serviço de provisionamento. Para obter mais detalhes, consulte Criar um ponto de extremidade SCIM e configurar o provisionamento do usuário. O agente de provisionamento local também converte as operações do Microsoft Entra SCIM para LDAP, SQL, REST ou SOAP,PowerShell, chamadas para um conector ECMA personalizado ou conectores e gateways criados por parceiros.

Para solicitar um conector de provisionamento automático do Microsoft Entra para um aplicativo que não tenha um, confira Solicitação de aplicativo do Microsoft Entra.

Autorização

As credenciais são necessárias para que o Microsoft Entra ID se conecte à API de gerenciamento de usuários do aplicativo. Enquanto estiver configurando o provisionamento automático de usuário para um aplicativo, você precisará inserir credenciais válidas. Para aplicativos da galeria, você encontrará os tipos e requisitos para o aplicativo no tutorial do aplicativo. Para os aplicativos que não forem da galeria, você poderá consultar a documentação do SCIM para entender os tipos e requisitos de credenciais. No centro de administração do Microsoft Entra, você poderá testar as credenciais fazendo com que o Microsoft Entra ID tente se conectar ao recurso de provisionamento do aplicativo usando as credenciais fornecidas.

Atributos de mapeamento

Ao habilitar o provisionamento de usuário para um aplicativo SaaS de terceiros, o centro de administração do Microsoft Entra controla os valores de seus atributos por meio do mapeamento de atributos. Os mapeamentos determinam os atributos de usuário transmitidos entre o Microsoft Entra ID e o aplicativo de destino, quando as contas de usuário são provisionadas ou atualizadas.

Há um conjunto pré-configurado de atributos e mapeamentos de atributos entre objetos de usuário do Microsoft Entra e cada objeto de usuário do aplicativo SaaS. Alguns aplicativos gerenciam outros tipos de objetos, juntamente com os Usuários, como Grupos.

Ao configurar o provisionamento, é importante examinar e configurar os mapeamentos de atributos e fluxos de trabalho que definem quais propriedades de usuário (ou grupo) são transmitidas entre o Microsoft Entra ID e o aplicativo. Examine e configure a propriedade correspondente (Corresponder objetos usando este atributo) usada para identificar e corresponder usuários/grupos com exclusividade entre os dois sistemas.

Você pode personalizar mapeamentos de atributos padrão, conforme as necessidades da sua empresa. Sendo assim, você pode alterar ou excluir os mapeamentos de atributos existentes ou criar novos mapeamentos. Para mais informações, consulte Personalizar mapeamentos de atributos para provisionamento de usuário em aplicativos SaaS.

Quando você configura o provisionamento de um aplicativo SaaS, um dos tipos de mapeamentos de atributos que você pode especificar é o mapeamento de expressão. Para esses mapeamentos, você precisa escrever uma expressão semelhante a script, que permite transformar os dados de usuários em formatos que são mais aceitáveis para o aplicativo SaaS. Para obter mais detalhes, consulte Escrever expressões para mapeamentos de atributo.

Escopo

Escopo baseado em atribuição

Para o provisionamento de saída do Microsoft Entra ID para um aplicativo SaaS, a dependência de atribuições de usuário ou grupo é a maneira mais comum de determinar quais usuários estão no escopo para provisionamento. Como as atribuições de usuário também são usadas para habilitar o logon único, o mesmo método pode ser usado para gerenciar o acesso e o provisionamento. O escopo baseado em atribuição não se aplica a cenários de provisionamento de entrada, como o Workday e o Successfactors.

Grupos. Com um plano de licença P1 ou P2 do Microsoft Entra ID, você pode usar os grupos para atribuir acesso a um aplicativo SaaS. Em seguida, quando o escopo de provisionamento estiver definido como Sincronizar apenas os usuários e grupos atribuídos, o serviço de provisionamento do Microsoft Entra provisionará ou desprovisionará os usuários com base na afiliação deles a um grupo que é atribuído ao aplicativo. O objeto do grupo em si não é provisionado, a menos que o aplicativo seja compatível com os objetos do grupo. Verifique se os grupos atribuídos ao seu aplicativo têm a propriedade "SecurityEnabled" definida como "True".
Grupos dinâmicos. O serviço de provisionamento de usuários do Microsoft Entra pode ler e provisionar usuários em grupos de associação dinâmica. Observe estas ressalvas e recomendações:
- Grupos dinâmicos podem afetar o desempenho do provisionamento de ponta a ponta do Microsoft Entra ID para aplicativos SaaS.
- A velocidade do provisionamento ou desprovisionamento de um usuário em um grupo dinâmico de um aplicativo SaaS dependerá da velocidade na qual o grupo dinâmico avalia as alterações da associação. Para informações sobre como verificar o status do processamento de um grupo dinâmico, consulte Verificar o status do processamento para uma regra de associação.
- Quando um usuário perde a associação ao grupo dinâmico, ele é considerado um evento de desprovisionamento. Considere este cenário ao criar regras para grupos dinâmicos.
Grupos aninhados. O serviço de provisionamento de usuário do Microsoft Entra não consegue ler ou provisionar usuários em grupos aninhados. O serviço só conseguirá ler e provisionar usuários que forem membros imediatos de um grupo explicitamente atribuído. Essa limitação de "atribuições baseadas em grupo para aplicativos" também afeta o logon único (consulte Usar um grupo para gerenciar o acesso a aplicativos SaaS). Em vez disso, atribua ou, de outra forma, coloque em escopo os grupos que contêm os usuários que precisam ser provisionados.

Escopo baseado em atributo

Use filtros de escopo para definir regras baseadas em atributo que determinam quais usuários são provisionados para um aplicativo. Esse método é usado normalmente no provisionamento de entrada de aplicativos HCM para o Microsoft Entra ID e Active Directory. Os filtros de escopo são configurados como parte dos mapeamentos de atributos para cada conector de provisionamento de usuário do Microsoft Entra. Para mais informações sobre comoconfigurar filtros de escopo baseados em atributo, consulte Provisionamento de aplicativo baseado em atributo com filtros de escopo.

Usuários B2B (convidados)

É possível usar o serviço de provisionamento de usuário do Microsoft Entra para provisionar usuários B2B (convidados) no Microsoft Entra ID para aplicativos SaaS. No entanto, para que os usuários B2B entrem no aplicativo SaaS usando o Microsoft Entra ID, você precisa configurar manualmente o aplicativo SaaS para usar o Microsoft Entra ID como um provedor de identidade Security Assertion Markup Language (SAML).

Siga essas diretrizes gerais para configurar aplicativos SaaS para usuários B2B (convidados):

Para muitos aplicativos, a configuração do usuário precisa acontecer manualmente. Os usuários também precisam ser criados manualmente no aplicativo.
Para os aplicativos compatíveis com a configuração automática, como o Dropbox, convites separados são criados nos aplicativos. Os usuários devem aceitar cada convite.
Nos atributos do usuário, para mitigar quaisquer problemas com o disco de perfil de usuário danificado (UPD) em usuários convidados, sempre defina o identificador do usuário como user.mail.

Observação

O userPrincipalName para um usuário de colaboração B2B representa o endereço de email do usuário externo alias@theirdomain como "alias_theirdomain#EXT#@yourdomain". Quando o atributo userPrincipalName for incluído nos mapeamentos de atributos como um atributo de origem, e um usuário B2B estiver sendo provisionado, o #EXT# e o domínio são removidos do userPrincipalName. Portanto, somente o alias@theirdomain original é usado para correspondência ou provisionamento. Se você precisar que o nome completo da entidade de usuário, incluindo #EXT# e o domínio, esteja presente, substitua userPrincipalName por originalUserPrincipalName como o atributo de origem.
userPrincipalName = alias@theirdomain
originalUserPrincipalName = alias_theirdomain#EXT#@yourdomain

Ciclos de provisionamento: inicial e incremental

Quando o Microsoft Entra ID for o sistema de origem, o serviço de provisionamento usará a consulta delta para rastrear alterações nos dados do Microsoft Graph visando monitorar usuários e grupos. O serviço de provisionamento executa um ciclo inicial com o sistema de origem e de destino, seguido de ciclos incrementais periódicos.

Ciclo inicial

Quando o serviço de provisionamento for iniciado, o primeiro ciclo irá:

Consultar todos os usuários e grupos do sistema de origem, recuperando todos os atributos definidos nos mapeamentos de atributos.
Filtre os usuários e os grupos retornados usando qualquer atribuição configurada ou filtros de escopo com base em atributo.
Quando um usuário é atribuído ou está no escopo para o provisionamento, o serviço consulta o sistema de destino em busca de um usuário correspondente usando os atributos correspondentes especificados. Exemplo: Se o nome userPrincipal no sistema de origem for o atributo correspondente e mapear para userName no sistema de destino, o serviço de provisionamento consultará o sistema de destino em busca de userNames que correspondam aos valores de nome do userPrincipal no sistema de origem.
Se um usuário correspondente não for encontrado no sistema de destino, ele será criado com os atributos retornados do sistema de origem. Depois que a conta de usuário for criada, o serviço de provisionamento detectará a ID do sistema de destino para o novo usuário. Essa ID é usada para executar todas as operações futuras nesse usuário.
Se um usuário correspondente for encontrado, ele será atualizado com os atributos fornecidos pelo sistema de origem. Depois que houver uma correspondência de conta de usuário, o serviço de provisionamento detectará e armazenará em cache a ID do sistema de destino para o novo usuário. Essa ID é usada para executar todas as operações futuras nesse usuário.
Se os mapeamentos de atributo contiverem atributos "reference", o serviço fará atualizações no sistema de destino para criar e vincular os objetos referenciados. Por exemplo, um usuário pode ter um atributo "Manager" no sistema de destino, vinculado a outro usuário criado no sistema de destino.
Manter uma marca d'água ao final do ciclo inicial para fornecer o ponto de partida para os ciclos incrementais posteriores.

Alguns aplicativos, como ServiceNow, G Suite e Box, oferecem suporte não apenas ao provisionamento de usuários, mas também ao provisionamento de grupos e seus membros. Nesses casos, se o provisionamento de grupos estiver habilitado nos mapeamentos, o serviço de provisionamento sincronizará os usuários e os grupos e, em seguida, as associações dinâmicas de grupos.

Ciclos incrementais

Após o ciclo inicial, todos os outros ciclos irão:

Consultar o sistema de origem em busca de todos os usuários e grupos que tenham sido atualizados desde a última marca d'água armazenada.
Filtre os usuários e os grupos retornados usando qualquer atribuição configurada ou filtros de escopo com base em atributo.
Quando um usuário é atribuído ou está no escopo para o provisionamento, o serviço consulta o sistema de destino em busca de um usuário correspondente usando os atributos correspondentes especificados.
Se um usuário correspondente não for encontrado no sistema de destino, ele será criado com os atributos retornados do sistema de origem. Depois que a conta de usuário for criada, o serviço de provisionamento detectará a ID do sistema de destino para o novo usuário. Essa ID é usada para executar todas as operações futuras nesse usuário.
Se um usuário correspondente for encontrado, ele será atualizado com os atributos fornecidos pelo sistema de origem. Se a correspondência for uma conta atribuída recentemente, o serviço de provisionamento detectará e armazenará em cache a ID do sistema de destino para o novo usuário. Essa ID é usada para executar todas as operações futuras nesse usuário.
Se os mapeamentos de atributo contiverem atributos "reference", o serviço fará atualizações no sistema de destino para criar e vincular os objetos referenciados. Por exemplo, um usuário pode ter um atributo "Manager" no sistema de destino, vinculado a outro usuário criado no sistema de destino.
Se um usuário que estava anteriormente no escopo para provisionamento for removido do escopo, sendo inclusive desatribuído, o serviço desabilitará o usuário no sistema de destino por meio de uma atualização.
Se um usuário que estava anteriormente no escopo para provisionamento for desabilitado ou excluído temporariamente do sistema de origem, o serviço desabilitará o usuário no sistema de destino por meio de uma atualização.
Se um usuário que estava anteriormente no escopo para provisionamento for excluído irreversivelmente do sistema de origem, o serviço excluirá o usuário no sistema de destino. No Microsoft Entra ID, os usuários são excluídos irreversivelmente, 30 dias depois que forem excluídos temporariamente.
Mantenha uma nova marca d'água ao final do ciclo incremental para fornecer o ponto de partida para os ciclos incrementais posteriores.

Observação

Desabilite as operações de criação, atualização ou exclusão operações usando as caixas de seleção Ações do objeto de destino na seção Mapeamentos. A lógica para desabilitar um usuário durante uma atualização também é controlada por meio de um mapeamento de atributos em um campo como accountEnabled.

O serviço de provisionamento continua executando ciclos incrementais back-to-back indefinidamente, em intervalos definidos no tutorial específico para cada aplicativo. Os ciclos incrementais continuam até que um dos eventos ocorra:

O serviço é interrompido manualmente usando o centro de administração do Microsoft Entra ou o comando apropriado da API do Microsoft Graph.
Um novo ciclo inicial é disparado usando a opção Reiniciar o provisionamento no centro de administração do Microsoft Entra ou o comando apropriado da API do Microsoft Graph. Essa ação limpa qualquer marca d'água armazenada e reavalia todos os objetos de origem. Além disso, a ação não interrompe os links entre os objetos de origem e destino. Para interromper os links, use Reiniciar synchronizationJob com a solicitação:

POST https://graph.microsoft.com/beta/servicePrincipals/{id}/synchronization/jobs/{jobId}/restart
Authorization: Bearer <token>
Content-type: application/json
{
   "criteria": {
       "resetScope": "Full"
   }
}

Um novo ciclo inicial é disparado devido a uma alteração nos mapeamentos de atributo ou filtros de escopo. Essa ação também apaga todas as marcas d'água armazenadas e reavalia todos os objetos de origem.
O processo de provisionamento vai para quarentena (veja o exemplo) devido à taxa de erros alta e permanece em quarentena por mais de quatro semanas. Neste caso, o serviço é desabilitado automaticamente.

Erros e novas tentativas

Se um erro no sistema de destino impedir que um usuário individual seja adicionado, atualizado ou excluído no sistema de destino, a operação será repetida no próximo ciclo de sincronização. Os erros são repetidos continuamente, reduzindo gradualmente a frequência de novas tentativas. Para resolver a falha, os administradores devem verificar os logs de provisionamento para determinar a causa raiz e executar a ação apropriada. Entre as falhas comuns podem estar:

Usuários que não tenham um atributo preenchido no sistema de origem necessário no sistema de destino
Usuários que tenham um valor de atributo no sistema de origem para o qual há uma restrição exclusiva no sistema de destino e o mesmo valor está presente em outro registro de usuário

Para resolver essas falhas, ajuste os valores de atributo do usuário afetado no sistema de origem ou os mapeamentos de atributos para que eles não causem conflitos.

Quarentena

Se a maioria ou todas as chamadas feitas no sistema de destino falharem regularmente devido a um erro (por exemplo, credenciais de administrador inválidas), o trabalho de provisionamento entrará em um estado de "quarentena". Esse estado é indicado no relatório de resumo do provisionamento e por email, se as notificações por email estiverem configuradas no centro de administração do Microsoft Entra.

Em quarentena, a frequência dos ciclos incrementais é reduzida gradualmente a uma por dia.

O trabalho de provisionamento sairá da quarentena depois que todos os erros inválidos forem corrigidos e o próximo ciclo de sincronização for iniciado. Se permanecer em quarentena por mais de quatro semanas, o trabalho de provisionamento será desabilitado. Saiba mais sobre o status da quarentena aqui.

Quanto tempo demora o provisionamento

O desempenho depende se o seu trabalho de provisionamento está executando um ciclo de provisionamento inicial ou incremental. Para obter mais informações sobre a duração do provisionamento e como monitorar o status do serviço de provisionamento, consulte Verificar o status do provisionamento de usuário.

Como posso saber se os usuários estão sendo provisionados corretamente

Todas as operações executadas pelo serviço de provisionamento do usuário são registradas nos logs de provisionamento do Microsoft Entra. Os logs incluem todas as operações de gravação feitas para os sistemas de origem e destino, e os dados de usuário que foram lidos ou gravados durante cada operação. Para obter informações sobre como ler os logs de provisionamento no centro de administração do Microsoft Entra, consulte o guia de relatório de provisionamento.

Desprovisionamento

O serviço de provisionamento do Microsoft Entra mantém os sistemas de origem e de destino sincronizados, desprovisionando as contas quando o acesso do usuário é removido.

O serviço de provisionamento é compatível com a exclusão e a desabilitação (às vezes chamada de exclusão temporária) dos usuários. A definição exata de desabilitar e excluir varia conforme a implementação do aplicativo de destino, mas geralmente uma desabilitação indica que o usuário não pode entrar. Uma exclusão indica que o usuário foi completamente removido do aplicativo. Para aplicativos SCIM, uma desabilitação é uma solicitação para definir a propriedade ativa como falsa em um usuário.

Configurar o aplicativo para desabilitar um usuário

Confirme se a caixa de seleção das atualizações está selecionada.

Confirme se o mapeamento está ativo para o aplicativo. Se você estiver usando um aplicativo da galeria de aplicativos, o mapeamento poderá ser um pouco diferente. Nesse caso, use o mapeamento padrão para aplicativos da galeria.

Configurar o aplicativo para excluir um usuário

O cenário dispara uma desabilitação ou uma exclusão:

Um usuário é excluído temporariamente no Microsoft Entra ID (enviado para a lixeira/propriedade AccountEnabled definida como false). Trinta dias depois de um usuário ser excluído no Microsoft Entra ID, ele será permanentemente excluído do locatário. Neste ponto, o serviço de provisionamento envia uma solicitação de EXCLUSÃO para excluir permanentemente o usuário do aplicativo. Durante o período de 30 dias, você pode excluir manualmente um usuário de forma permanente, o que envia uma solicitação de exclusão ao aplicativo.
Um usuário é excluído/removido permanentemente da lixeira no Microsoft Entra ID.
Um usuário não é atribuído em um aplicativo.
Um usuário vai de dentro do escopo para fora do escopo (agora sem passar por um filtro de escopo).

Por padrão, o serviço de provisionamento do Microsoft Entra exclui temporariamente ou desabilita usuários que estiverem fora do escopo. Se você quiser substituir esse comportamento padrão, defina um sinalizador para ignorar exclusões fora do escopo.

Quando um dos quatro eventos ocorrer e o aplicativo de destino não for compatível com as exclusões temporárias, o serviço de provisionamento enviará uma solicitação de EXCLUSÃO para excluir permanentemente o usuário do aplicativo.

Se IsSoftDeleted for exibido no mapeamento de atributos, ele será usado para determinar o estado do usuário e se você quer enviar uma solicitação de atualização com active = false para a exclusão temporária do usuário.

Desprovisionar eventos

A tabela descreve como você pode configurar ações de desprovisionamento com o serviço de provisionamento do Microsoft Entra. Essas regras foram escritas voltadas para o aplicativo personalizado/fora da galeria, mas geralmente se aplicam aos aplicativos da galeria. No entanto, o comportamento dos aplicativos da galeria pode ser diferente, pois eles foram otimizados para atender às necessidades do aplicativo. Por exemplo, se o aplicativo de destino for compatível com a exclusão temporária, o serviço de provisionamento do Microsoft Entra poderá enviar uma solicitação de exclusão irreversível para excluir usuários em vez de enviar uma solicitação de exclusão temporária.

Cenário	Como configurar no Microsoft Entra ID
Um usuário tem a atribuição em um aplicativo cancelada, é excluído temporariamente no Microsoft Entra ID ou tem sua entrada bloqueada. Você não quer que nada seja feito.	Remova `isSoftDeleted` dos mapeamentos de atributos e/ou defina a propriedade ignorar exclusões fora do escopo como true.
Um usuário tem a atribuição em um aplicativo cancelada, é excluído temporariamente no Microsoft Entra ID ou tem sua entrada bloqueada. Você deseja definir um atributo específico como `true` ou `false`.	Mapeie `isSoftDeleted` para o atributo que deseja definir como falso.
Um usuário está desabilitado no Microsoft Entra ID, teve a atribuição cancelada em um aplicativo, foi excluído temporariamente do Microsoft Entra ID ou foi impedido de entrar. Você deseja enviar uma solicitação EXCLUIR para o aplicativo de destino.	Atualmente, essa opção é compatível em um conjunto limitado de aplicativos da galeria na qual a funcionalidade é obrigatória. Não pode ser configurado pelos clientes.
Um usuário é excluído no Microsoft Entra ID. Você não quer que nada seja feito no aplicativo de destino.	Verifique se a opção "Excluir" não está selecionada como uma das ações do objeto de destino em experiência de configuração do atributo.
Um usuário é excluído no Microsoft Entra ID. Você deseja definir o valor de um atributo no aplicativo de destino.	Incompatível.
Um usuário é excluído no Microsoft Entra ID. Você deseja excluir o usuário no aplicativo de destino	Verifique se a opção Excluir está selecionada como uma das ações do objeto de destino na experiência de configuração de atributo.

Limitações conhecidas

Quando um usuário ou grupo tiver a atribuição de um aplicativo cancelada e não for mais gerenciado pelo serviço de provisionamento, uma solicitação de desabilitação será enviada. Nesse ponto, o serviço não gerencia o usuário e uma solicitação de exclusão não é enviada quando o usuário é excluído do diretório.
O provisionamento de um usuário que está desabilitado no Microsoft Entra ID não é compatível. Eles devem estar ativos no Microsoft Entra ID antes de serem provisionados.
Quando um usuário passa de excluído temporariamente para ativo, o serviço de provisionamento do Microsoft Entra ativa o usuário no aplicativo de destino, mas não restaura automaticamente as associações do grupo. O aplicativo de destino deve manter as associações dinâmicas de grupo para o usuário no estado inativo. Se o aplicativo de destino não for compatível com a manutenção do estado inativo, reinicie o provisionamento para atualizar os grupos de associações dinâmicas.

Recomendação

Ao desenvolver um aplicativo, sempre ofereça suporte às exclusões temporárias e irreversíveis. Isso permitirá que os clientes se recuperem quando um usuário for desabilitado acidentalmente.

Próximas etapas

Planejar uma implantação de provisionamento do usuário automática

Configurar provisionamento para um aplicativo da galeria

Criar um ponto de extremidade SCIM e configurar o provisionamento ao criar seu próprio aplicativo

Solucionar problemas com a configuração e o provisionamento de usuários para um aplicativo.

Compartilhar via