Provisioning in ingresso basato su API con App per la logica di Azure

Questa esercitazione descrive come usare il flusso di lavoro di App per la logica di Azure per implementare il provisioning in ingresso basato su API di Microsoft Entra ID. Usando la procedura descritta in questa esercitazione, è possibile convertire un file CSV contenente i dati HR in un payload della richiesta in blocco e inviarlo all'endpoint API di provisioning /bulkUpload di Microsoft Entra. L'articolo fornisce anche indicazioni su come usare lo stesso modello di integrazione con qualsiasi sistema di registrazione.

Scenario di integrazione

Requisito di business

Il sistema di registrazione in uso genera periodicamente esportazioni di file CSV contenenti dati sui dipendenti. Si vuole implementare un'integrazione che legge i dati dal file CSV ed effettua automaticamente il provisioning degli account utente nella directory di destinazione (Active Directory locale per utenti ibridi e Microsoft Entra ID per gli utenti solo cloud).

Requisito per l'implementazione

Dal punto di vista dell'implementazione:

• Si vuole usare un flusso di lavoro App per la logica di Azure per leggere i dati delle esportazioni di file CSV disponibili in una condivisione file di Azure e inviarli all'endpoint API di provisioning in ingresso.
• Nel flusso di lavoro di App per la logica di Azure non si vuole implementare la logica complessa del confronto dei dati di identità tra il sistema di registrazione e la directory di destinazione.
• Si vuole usare il servizio di provisioning di Microsoft Entra per applicare le regole di provisioning gestito dall'IT per creare/aggiornare/abilitare/disabilitare automaticamente gli account nella directory di destinazione (Active Directory locale o Microsoft Entra ID).

Varianti dello scenario di integrazione

Anche se questa esercitazione usa un file CSV come sistema di registrazione, è possibile personalizzare il flusso di lavoro di App per la logica di Azure di esempio per leggere i dati da qualsiasi sistema di registrazione. App per la logica di Azure offre un'ampia gamma di connettori predefiniti e connettori gestiti con azioni e trigger predefiniti che è possibile usare nel flusso di lavoro di integrazione.

Ecco un elenco delle varianti dello scenario di integrazione aziendale, in cui è possibile implementare il provisioning in ingresso basato su API con un flusso di lavoro di App per la logica.

Dopo aver letto i dati di origine, applicare le regole di pre-elaborazione e convertire l'output del sistema di registrazione in una richiesta in blocco che può essere inviata all'endpoint API di provisioning bulkUpload di Microsoft Entra.

Come usare questa esercitazione

Il modello di distribuzione App per la logica pubblicato nel repository GitHub del provisioning in ingresso di Microsoft Entra automatizza diverse attività. Include anche la logica per la gestione di file CSV di grandi dimensioni e la suddivisione in blocchi della richiesta in blocco per inviare 50 record in ogni richiesta. Ecco come testarlo e personalizzarlo in base ai requisiti di integrazione.

Passaggio 1: Creare un account di archiviazione di Azure per ospitare il file CSV

I passaggi documentati in questa sezione sono facoltativi. Se si ha già un account di archiviazione esistente o si vuole leggere il file CSV da un'altra origine, ad esempio il sito di SharePoint o l'archiviazione BLOB, aggiornare l'app per la logica per usare il connettore preferito.

1. Accedere al portale di Azure come almeno un amministratore dell'applicazione.
2. Cercare "Account di archiviazione" e crearne un nuovo account di archiviazione.
3. Assegnare un gruppo di risorse e assegnargli un nome.
4. Dopo aver creato l'account di archiviazione, passare alla risorsa.
5. Fare clic sull'opzione di menu "Condivisione file" e creare una nuova condivisione file.
6. Verificare che la creazione della condivisione file sia riuscita.
7. Caricare un file CSV di esempio nella condivisione file usando l'opzione di caricamento.
8. Ecco uno screenshot delle colonne nel file CSV.

Passaggio 2: Configurare il convertitore CSV2JSON della funzione di Azure

1. Nel browser associato al portale di Azure aprire l'URL del repository GitHub https://github.com/joelbyford/CSVtoJSONcore.

2. Fare clic sul collegamento "Distribuisci in Azure" per distribuire questa funzione di Azure nel tenant di Azure.

3. Specificare il gruppo di risorse in cui distribuire questa funzione di Azure.

   Se viene visualizzato l'errore "Questa area ha una quota di 0 istanze per la sottoscrizione", provare a selezionare un'area diversa.

4. Assicurarsi che la distribuzione della funzione di Azure come servizio app sia riuscita.

5. Passare al gruppo di risorse e aprire la configurazione dell'app Web. Assicurarsi che lo stato sia "In esecuzione". Copiare il nome di dominio predefinito associato all'app Web.

6. Eseguire lo script di PowerShell seguente per verificare se l'endpoint CSVtoJSON funziona come previsto. Impostare i valori corretti per le variabili $csvFilePath e $uri nello 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 la distribuzione della funzione di Azure ha esito positivo, l'ultima riga dello script restituisce la versione JSON del file CSV.

   .

8. Per consentire ad App per la logica di richiamare questa funzione di Azure, nell'impostazione CORS per l'app Web immettere un asterisco (*) e fare clic su "Salva" per salvare la configurazione.

Passaggio 3: Configurare il provisioning utenti in ingresso basato su API

• Configurare il provisioning utenti in ingresso basato su API.

Passaggio 4: Configurare il flusso di lavoro di App per la logica di Azure

1. Fare clic sul pulsante seguente per distribuire il modello di ARM per il flusso di lavoro CSV2SCIMBulkUpload di App per la logica.

   

2. Nei dettagli dell'istanza aggiornare gli elementi evidenziati, copiando e incollando i valori dei passaggi precedenti.

3. Per il parametro Azurefile_access Key, aprire l'account di archiviazione file di Azure e copiare la chiave di accesso presente in "Sicurezza e rete".
   

4. Fare clic sull'opzione "Rivedi e crea" per avviare la distribuzione.

5. Al termine della distribuzione, verrà visualizzato il messaggio seguente.

Passaggio 5: Configurare l'identità gestita assegnata dal sistema

1. Aprire il riquadro Impostazioni -> Identità del flusso di lavoro di App per la logica.
2. Abilitare Identità gestita assegnata dal sistema.
3. Verrà visualizzato un prompt per confermare l'uso dell'identità gestita. Fare clic su Sì.
4. Concedere all'identità gestita le autorizzazioni per eseguire il caricamento in blocco.

Passaggio 6: Esaminare e modificare i passaggi del flusso di lavoro

1. Aprire l'app per la logica nella visualizzazione di progettazione.

2. Esaminare la configurazione di ogni passaggio del flusso di lavoro per assicurarsi che sia corretta.

3. Aprire il passaggio "Ottieni contenuto file in base al percorso" e correggerlo per passare ad Archiviazione file di Azure nel tenant.

4. Aggiornare la connessione, se necessario.

5. Assicurarsi che il passaggio "Converti CSV in JSON" punti all'istanza corretta dell'app Web per la funzione di Azure.

6. Se il contenuto/intestazione del file CSV è diverso, aggiornare il passaggio "Analizza JSON" con l'output JSON che è possibile recuperare dalla chiamata API alla funzione di Azure. Usare l'output di PowerShell del passaggio 2.

7. Nel passaggio "Costruisci SCIMUser" assicurarsi che i campi del file CSV vengano abbinati correttamente agli attributi SCIM che verranno usati per l'elaborazione.

   

8. Nel passaggio "Invia SCIMBulkPayload all'endpoint API" assicurarsi di usare il meccanismo di autenticazione e l'endpoint API corretti.

   

Passaggio 7: Eseguire il trigger e testare il flusso di lavoro di App per la logica

1. Nella versione "Disponibile a livello generale" della finestra di progettazione di App per la logica fare clic su Esegui trigger per eseguire manualmente il flusso di lavoro.
2. Al termine dell'esecuzione, esaminare l'azione eseguita da App per la logica in ogni iterazione.
3. Nell'iterazione finale i dati di caricamento di App per la logica dovrebbero essere visualizzati nell'endpoint API di provisioning in ingresso. Cercare il codice di stato 202 Accept. È possibile copiare e incollare la richiesta di caricamento in blocco e quindi verificarla.

Passaggi successivi

• Risolvere i problemi relativi all'API di provisioning in ingresso
• Concetti relativi al provisioning in ingresso basato su API
• Domande frequenti sul provisioning in ingresso basato su API