Como baixar e analisar os logs de provisionamento do Microsoft Entra

Os logs de provisionamento do Microsoft Entra fornecem detalhes sobre os eventos de provisionamento que ocorrem em seu locatário. Você pode usar as informações capturadas nos logs de provisionamento para ajudar a solucionar problemas com um usuário provisionado.

Este artigo descreve as opções para baixar os logs de provisionamento do centro de administração do Microsoft Entra e como analisar os logs. Códigos de erro e considerações especiais também estão incluídos.

Pré-requisitos

Para exibir os logs de provisionamento, seu locatário deve ter uma licença do Microsoft Entra ID P1 ou P2 associada a ele. Para atualizar sua edição do Microsoft Entra, consulte Introdução ao Microsoft Entra ID P1 ou P2.

Os proprietários de aplicativos podem exibir logs para seus próprios aplicativos. As seguintes funções são necessárias para exibir logs de provisionamento:

• Leitor de relatórios
• Leitor de Segurança
• Operador de Segurança
• Administrador de Segurança
• Administrador de aplicativos
• Administrador de aplicativos na nuvem
• Usuários em uma função personalizada com a permissão provisioningLogs

Como exibir os logs de provisionamento

Há várias maneiras de exibir ou analisar os logs de provisionamento:

• Ver no centro de administração do Microsoft Entra.
• Transmita logs para o Azure Monitor por meio de configurações de diagnóstico.
• Analise logs por meio de modelos de pasta de trabalho .
• Acesse logs programaticamente por meio da API do Microsoft Graph.
• Baixe os logs como um arquivo CSV ou JSON.

Para acessar os logs no centro de administração do Microsoft Entra:

1. Entre no centro de administração do Microsoft Entra como pelo menos um Leitor de Relatórios.
2. Navegue até Monitoramento de identidade>& logs de provisionamento de integridade>.

Como baixar os logs de provisionamento

Para baixar os logs de provisionamento, selecione Baixar na página Logs de provisionamento. Defina os filtros o mais específicos possível para reduzir o tamanho e o tempo do download.

Formato CSV

O download CSV inclui três arquivos:

• ProvisioningLogs: Baixa todos os logs, exceto as etapas de provisionamento e as propriedades modificadas.
• ProvisioningLogs_ProvisioningSteps: Contém as etapas de provisionamento e a ID de alteração. Você pode usar o ID de alteração para ingressar no evento com os outros dois arquivos.
• ProvisioningLogs_ModifiedProperties: Contém os atributos que foram alterados e a ID de alteração. Você pode usar o ID de alteração para ingressar no evento com os outros dois arquivos.

Formato JSON

Para abrir o arquivo JSON, use um editor de texto, como o Microsoft Visual Studio Code. O Visual Studio Code torna o arquivo mais fácil de ler fornecendo realce de sintaxe. Você também pode abrir o arquivo JSON usando navegadores em um formato não editável, como o Microsoft Edge.

Prettify o arquivo JSON

O arquivo JSON é baixado em um formato para reduzir o tamanho do download. Este formato pode tornar a carga útil difícil de ler. Para prettify o arquivo, há duas opções:

• Use o Visual Studio Code para formatar o JSON.

• Use o PowerShell para formatar o JSON. Esse script produz uma saída JSON em um formato que inclui guias e espaços:

  $JSONContent = Get-Content -Path "<PATH TO THE PROVISIONING LOGS FILE>" | ConvertFrom-JSON

  $JSONContent | ConvertTo-Json > <PATH TO OUTPUT THE JSON FILE>

Analisar o arquivo JSON

Você pode usar qualquer linguagem de programação com a qual se sinta confortável. Os exemplos a seguir estão no PowerShell.

• Leia o arquivo JSON:

  $JSONContent = Get-Content -Path "<PATH TO THE PROVISIONING LOGS FILE>" | ConvertFrom-JSON

Agora você pode analisar os dados de acordo com seu cenário. Eis alguns exemplos:

• Saída de todos os IDs de trabalho no arquivo JSON:

  foreach ($provitem in $JSONContent) { $provitem.jobId }

• Saída de todas as IDs de alteração para eventos em que a ação foi "criada":

  foreach ($provitem in $JSONContent) { if ($provItem.action -eq 'Create') { $provitem.changeId } }

O que deve saber

Aqui estão algumas dicas e considerações para analisar os logs de provisionamento:

• O centro de administração do Microsoft Entra armazena dados de provisionamento relatados por 30 dias se você tiver uma edição premium e 7 dias se tiver uma edição gratuita. Você pode rotear os logs de provisionamento para os logs do Azure Monitor para retenção além de 30 dias.

• Você pode usar o atributo change ID como identificador exclusivo, o que pode ser útil quando você está interagindo com o suporte ao produto, por exemplo.

• Você pode ver eventos ignorados para usuários que não estão no escopo.

  • Exemplo 1: Se o escopo estiver definido como all users and groups e configurar filtros de escopo, você poderá ver logs ignorados para usuários que não atendem aos critérios de escopo.
  • Exemplo 2: Se o escopo estiver definido como assigned users and groups, você poderá continuar a ver os usuários nos logs como ignorados, mesmo que eles não estejam atribuídos ao aplicativo. A maneira como o serviço de provisionamento recebe alterações do diretório faz com que esses usuários apareçam.

• Os logs de provisionamento não mostram importações de função (aplica-se à Amazon Web Services, Salesforce e Zendesk). Você pode encontrar os logs para importações de função nos logs de auditoria.

Códigos de erro

Use a tabela a seguir para entender melhor como resolver erros encontrados nos logs de provisionamento.

Códigos de erro para sincronização entre locatários

Use a tabela a seguir para entender melhor como resolver erros encontrados nos logs de provisionamento para sincronização entre locatários.

Próximos passos

• Verificar o status do provisionamento do usuário
• Problema ao configurar o provisionamento de usuários para um aplicativo Microsoft Entra Gallery
• Graph API para provisionamento de logs