Provisionamento de entrada orientado por API com Aplicativos Lógicos do Azure

Este tutorial descreve como usar o fluxo de trabalho dos Aplicativos Lógicos do Azure para implementar o provisionamento de entrada orientado por API do Microsoft Entra ID. Usando as etapas neste tutorial, você pode converter um arquivo CSV contendo dados de RH em uma carga útil de solicitação em massa e enviá-lo para o ponto de extremidade da API de provisionamento /bulkUpload do Microsoft Entra. O artigo também fornece orientação sobre como o mesmo padrão de integração pode ser usado com qualquer sistema de registro.

Cenário de integração

Requisitos de negócio

Seu sistema de registro gera periodicamente exportações de arquivos CSV contendo dados de trabalho. Você deseja implementar uma integração que lê dados do arquivo CSV e provisiona automaticamente contas de usuário em seu diretório de destino (Ative Directory local para usuários híbridos e ID do Microsoft Entra para usuários somente na nuvem).

Requisitos de execução

Do ponto de vista da implementação:

• Você deseja usar um fluxo de trabalho de Aplicativos Lógicos do Azure para ler dados das exportações de arquivos CSV disponíveis em um Compartilhamento de Arquivos do Azure e enviá-los para o ponto de extremidade da API de provisionamento de entrada.
• No fluxo de trabalho dos Aplicativos Lógicos do Azure, você não deseja implementar a lógica complexa de comparação de dados de identidade entre seu sistema de registro e diretório de destino.
• Você deseja usar o serviço de provisionamento Microsoft Entra para aplicar suas regras de provisionamento gerenciado de TI para criar/atualizar/habilitar/desabilitar automaticamente contas no diretório de destino (Ative Directory local ou ID do Microsoft Entra).

Variações de cenário de integração

Embora este tutorial use um arquivo CSV como um sistema de registro, você pode personalizar o fluxo de trabalho de exemplo dos Aplicativos Lógicos do Azure para ler dados de qualquer sistema de registro. As Aplicações Lógicas do Azure fornecem uma vasta gama de conectores incorporados e conectores geridos com acionadores e ações pré-criados que pode utilizar no seu fluxo de trabalho de integração.

Aqui está uma lista de variações de cenário de integração empresarial, onde o provisionamento de entrada orientado por API pode ser implementado com um fluxo de trabalho de Aplicativos Lógicos.

Depois de ler os dados de origem, aplique suas regras de pré-processamento e converta a saída do seu sistema de registro em uma solicitação em massa que pode ser enviada para o ponto de extremidade da API bulkUpload de provisionamento do Microsoft Entra.

Como usar este tutorial

O modelo de implantação de Aplicativos Lógicos publicado no repositório GitHub de provisionamento de entrada do Microsoft Entra automatiza várias tarefas. Ele também tem lógica para lidar com arquivos CSV grandes e dividir a solicitação em massa para enviar 50 registros em cada solicitação. Veja como você pode testá-lo e personalizá-lo de acordo com seus requisitos de integração.

Etapa 1: Criar uma conta de Armazenamento do Azure para hospedar o arquivo CSV

As etapas documentadas nesta seção são opcionais. Se você já tiver uma conta de armazenamento existente ou quiser ler o arquivo CSV de outra fonte, como o site do SharePoint ou o armazenamento de Blob, atualize o Aplicativo Lógico para usar o conector de sua escolha.

1. Entre no portal do Azure como pelo menos um Administrador de Aplicativo.
2. Procure por "Contas de armazenamento" e crie uma nova conta de armazenamento.
3. Atribua um grupo de recursos e atribua-lhe um nome.
4. Depois que a conta de armazenamento for criada, vá para o recurso.
5. Clique na opção de menu "Compartilhamento de arquivos" e crie um novo compartilhamento de arquivos.
6. Verifique se a criação do compartilhamento de arquivos foi bem-sucedida.
7. Carregue um arquivo CSV de exemplo para o compartilhamento de arquivos usando a opção de upload.
8. Aqui está uma captura de tela das colunas no arquivo CSV.

Etapa 2: Configurar o conversor de CSV2JSON do Azure Function

1. No navegador associado ao seu portal do Azure, abra a URL do repositório GitHub - https://github.com/joelbyford/CSVtoJSONcore.

2. Clique no link "Implantar no Azure" para implantar essa Função do Azure em seu locatário do Azure.

3. Especifique o grupo de recursos sob o qual implantar essa função do Azure.

   Se você receber o erro "Esta região tem cota de 0 instâncias", tente selecionar uma região diferente.

4. Verifique se a implantação da Função do Azure como um Serviço de Aplicativo foi bem-sucedida.

5. Vá para o grupo de recursos e abra a configuração do WebApp. Certifique-se de que está no estado "Em execução". Copie o nome de domínio padrão associado ao Web App.

6. Execute o seguinte script do PowerShell para testar se o ponto de extremidade CSVtoJSON funciona conforme o esperado. Defina os valores corretos para as variáveis $csvFilePath e $uri no script.

   # Step 1: Read the CSV file 
   $csvFilePath = "C:\Path-to-CSV-file\hr-user-data.csv" 
   $csvContent = Get-Content -Path $csvFilePath 
   
   # Step 2: Set up the request 
   $uri = "https://az-function-webapp-your-domain/csvtojson" 
   $headers = @{ 
        "Content-Type" = "text/csv" 
   } 
   $body = $csvContent -join "`n"  # Join the CSV lines into a single string 
   
   # Step 3: Send the POST request 
   $response = Invoke-WebRequest -Uri $uri -Method POST -Headers $headers -Body $body 
   
   # Output and format the JSON response 
   $response.Content | ConvertFrom-JSON | ConvertTo-JSON 
   

7. Se a implantação do Azure Function for bem-sucedida, a última linha do script produzirá a versão JSON do arquivo CSV.

   .

8. Para permitir que os Aplicativos Lógicos invoquem essa Função do Azure, na configuração CORS para o WebApp, insira o asterisco (*) e "Salvar" a configuração.

Etapa 3: Configurar o provisionamento de usuário de entrada controlado por API

• Configure o provisionamento de usuário de entrada orientado por API.

Etapa 4: Configurar o fluxo de trabalho dos Aplicativos Lógicos do Azure

1. Clique no botão abaixo para implantar o modelo do Azure Resource Manager para o fluxo de trabalho CSV2SCIMBulkUpload Logic Apps.

   

2. Em detalhes da instância, atualize os itens realçados, copiando e colando valores das etapas anteriores.

3. Para o Azurefile_access Key parâmetro, abra sua conta de armazenamento de arquivos do Azure e copie a chave de acesso presente em "Segurança e Rede".
   

4. Clique na opção "Revisar e criar" para iniciar a implantação.

5. Quando a implantação estiver concluída, você verá a seguinte mensagem.

Etapa 5: Configurar a identidade gerenciada atribuída ao sistema

1. Visite a folha Configurações -> Identidade do seu fluxo de trabalho de Aplicativos Lógicos.
2. Habilite a identidade gerenciada atribuída ao sistema.
3. Você receberá uma solicitação para confirmar o uso da identidade gerenciada. Clique em Sim.
4. Conceda as permissões de identidade gerenciada para executar o upload em massa.

Etapa 6: Revisar e ajustar as etapas do fluxo de trabalho

1. Abra o Aplicativo Lógico na visualização do designer.

2. Revise a configuração de cada etapa do fluxo de trabalho para verificar se está correta.

3. Abra a etapa "Obter conteúdo de arquivo usando caminho" e corrija-a para navegar até o Armazenamento de Arquivos do Azure em seu locatário.

4. Atualize a conexão, se necessário.

5. Verifique se a etapa "Converter CSV em JSON" está apontando para a instância correta do Aplicativo Web do Azure Function.

6. Se o conteúdo/cabeçalhos do arquivo CSV for diferente, atualize a etapa "Analisar JSON" com a saída JSON que você pode recuperar da sua chamada de API para a Função do Azure. Use a saída do PowerShell da Etapa 2.

7. Na etapa "Construir SCIMUser", verifique se os campos CSV estão mapeados corretamente para os atributos SCIM que serão usados para processamento.

   

8. Na etapa "Enviar SCIMBulkPayload para o ponto de extremidade da API", verifique se você está usando o ponto de extremidade da API e o mecanismo de autenticação corretos.

   

Etapa 7: Executar, acionar e testar seu fluxo de trabalho de Aplicativos Lógicos

1. Na versão "Geralmente disponível" do designer de aplicativos lógicos, clique em Executar gatilho para executar manualmente o fluxo de trabalho.
2. Após a conclusão da execução, revise qual ação os Aplicativos Lógicos executaram em cada iteração.
3. Na iteração final, você verá os dados de upload dos Aplicativos Lógicos para o ponto de extremidade da API de provisionamento de entrada. Procure o 202 Accept código de status. Você pode copiar e colar e verificar a solicitação de upload em massa.

Próximos passos

• Solucionar problemas com a API de provisionamento de entrada
• Conceitos de provisionamento de entrada orientados por API
• Perguntas frequentes sobre o provisionamento de entrada orientado por API