Provisionamento de entrada controlado 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 controlado por API do Microsoft Entra ID. Usando as etapas neste tutorial, você pode converter um arquivo CSV que contém dados de RH em uma carga 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 diretrizes sobre como o mesmo padrão de integração pode ser usado com qualquer sistema de registro.

Cenário de integração

Requisito de negócios

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

Requisito de implementação

De uma perspectiva de implementação:

• Você deseja usar um fluxo de trabalho dos 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 seu 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 o sistema de registro e o diretório de destino.
• Você deseja usar o serviço de provisionamento do Microsoft Entra para aplicar suas regras de provisionamento gerenciado de TI para criar/atualizar/habilitar/desabilitar automaticamente contas no diretório de destino (Active Directory local ou Microsoft Entra ID).

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

Embora este tutorial use um arquivo CSV como um sistema de registro, é possível personalizar o fluxo de trabalho de exemplo dos Aplicativos Lógicos do Azure para ler dados de qualquer sistema de registro. Os Aplicativos Lógicos do Azure fornece uma ampla gama de conectores integrados e conectores gerenciados com gatilhos e ações pré-compilados que você pode usar em seu fluxo de trabalho de integração.

Aqui está uma lista de variações de cenários de integração empresarial, em que o provisionamento de entrada controlado por API pode ser implementado com um fluxo de trabalho dos Aplicativos Lógicos do Azure.

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

Como usar este tutorial

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

Etapa 1: crie uma conta de Armazenamento do Microsoft 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 Blobs, atualize o Aplicativo Lógico para usar o conector de sua escolha.

1. Entre no portal do Azure com a função mínima de Administrador de aplicativos.
2. Pesquise "Contas de armazenamento" e crie uma nova conta de armazenamento.
3. Atribua um grupo de recursos e dê um nome a ele.
4. Depois que a conta de armazenamento for criada, vá para o recurso.
5. Clique na opção de menu "Compartilhamento de arquivo" e crie um novo compartilhamento de arquivo.
6. Verifique se a criação do compartilhamento de arquivos foi bem-sucedida.
7. Carregue um arquivo CSV de exemplo no compartilhamento de arquivos usando a opção de upload.
8. Aqui está uma captura de tela das colunas no arquivo CSV.

Etapa 2: configure o conversor CSV2JSON do Azure Function

1. No navegador associado ao seu portal do Azure, abra a URL do repositório do 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 no 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. Acesse o grupo de recursos e abra a configuração do WebApp. Verifique se ele está no estado "Em execução". Copie o nome de domínio padrão associado ao Aplicativo Web.

6. Execute o script do PowerShell a seguir 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 gerará 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 do WebApp, insira asterisco (*) e "Salve" a configuração.

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

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

Etapa 4: configure 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 dos Aplicativos Lógicos CSV2SCIMBulkUpload.

   

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

3. Para o parâmetro Azurefile_access Key, 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 "Examinar e criar" para iniciar a implantação.

5. Depois que a implantação for concluída, você verá a mensagem a seguir.

Etapa 5: configure a identidade gerenciada atribuída pelo sistema

1. Visite a folha Configurações –> Identidade do fluxo de trabalho dos Aplicativos Lógicos.
2. Habilitar identidade gerenciada atribuída pelo sistema.
3. Você receberá um prompt 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: examine e ajuste as etapas do fluxo de trabalho

1. Abra o Aplicativo Lógico no modo de exibição do designer.

2. Examine a configuração de cada etapa no fluxo de trabalho para verificar se ela está correta.

3. Abra a etapa "Obter conteúdo do arquivo usando o caminho" e corrija-o 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 de aplicativo Web de função do Azure correta.

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

7. Na etapa "Construir SCIMUser", certifique-se de que os campos CSV estejam mapeados corretamente para os atributos SCIM que serão usados para processamento.

   

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

   

Etapa 7: execute o gatilho e teste o fluxo de trabalho dos Aplicativos Lógicos

1. Na versão "Disponibilidade Geral" do designer dos Aplicativos Lógicos, clique em Executar Gatilho para executar manualmente o fluxo de trabalho.
2. Depois que a execução for concluída, examine qual ação os Aplicativos Lógicos executaram em cada iteração.
3. Na iteração final, você verá os Aplicativos Lógicos carregarem dados no ponto de extremidade da API de provisionamento de entrada. Procure pelo código de status 202 Accept. Você pode copiar e colar e verificar a solicitação de upload em massa.

Próximas etapas

• Solucionar problemas da API de provisionamento de entrada
• Conceitos do provisionamento de entrada controlado por API
• Perguntas frequentes sobre o provisionamento de entrada controlado por API