Configurare Harness per il provisioning automatico degli utenti con Microsoft Entra ID

Questo articolo illustra come configurare Microsoft Entra ID per effettuare automaticamente il provisioning e il deprovisioning di utenti o gruppi in Harness. Il provisioning automatico elimina la gestione manuale degli utenti sincronizzando le modifiche del ciclo di vita degli utenti dal provider di identità a Harness.

Prerequisiti

Lo scenario descritto in questo articolo presuppone che siano presenti i prerequisiti seguenti:

• Un account utente di Microsoft Entra con una sottoscrizione attiva. Se non è già disponibile, è possibile creare gratuitamente un account.
• Uno dei ruoli seguenti:
  • Amministratore dell'applicazione
  • Amministratore di applicazioni cloud
  • Proprietario dell'applicazione.

• Un cliente Harness
• Un account utente in Harness con autorizzazioni di amministratore

Assegnare utenti a Harness

Prima di configurare il provisioning, è necessario assegnare utenti o gruppi all'applicazione Harness in Microsoft Entra ID. Microsoft Entra ID usa le assegnazioni per determinare quali utenti devono ricevere l'accesso alle applicazioni selezionate. Nel contesto del provisioning utenti automatico vengono sincronizzati solo gli utenti e/o i gruppi che sono stati assegnati a un'applicazione in Microsoft Entra ID.

Prima di configurare e abilitare il provisioning automatico degli utenti, è necessario stabilire quali utenti o gruppi in Microsoft Entra ID devono accedere a Harness. È quindi possibile assegnare questi utenti o gruppi a Harness seguendo le istruzioni riportate in Assegnare un utente o un gruppo a un'app aziendale.

Raccomandazioni per l'assegnazione degli utenti

Iniziare con un piccolo gruppo di test prima di implementare il provisioning nell'intera organizzazione. Assegnare un singolo utente Microsoft Entra a Harness per testare la configurazione del provisioning automatico degli utenti. Dopo aver verificato che il provisioning funzioni correttamente, è possibile assegnare altri utenti o gruppi.

Quando si assegna un utente a Harness, è necessario selezionare un ruolo specifico dell'applicazione valido , se disponibile, nella finestra di dialogo Assegnazione . Gli utenti con il ruolo Accesso predefinito vengono esclusi dal provisioning.

Se si ha attualmente una configurazione di Harness App Integration in Microsoft Entra ID e si sta tentando di configurare una per Harness, assicurarsi che le informazioni utente siano incluse anche nell'integrazione dell'app prima di tentare di accedere a Harness tramite SSO.

Configurare Harness per il provisioning

Prima di poter configurare il provisioning in Microsoft Entra ID, è necessario generare un token DELL'API SCIM in Harness. Questo token consente Microsoft Entra ID di connettersi in modo sicuro all'endpoint SCIM Harness e di effettuare il provisioning degli utenti.

1. Accedere alla console di amministrazione di Harness, selezionare il profilo nell'angolo inferiore sinistro della pagina e passare a Panoramica del profilo.

   

2. In Chiavi API personali selezionare +Chiave API. Verrà visualizzata la finestra per creare una chiave API.

   

3. Specificare un nome e selezionare Salva. Harness crea una chiave API per l'account.

   

4. Per creare un token per la chiave API, selezionare +Token nella chiave API appena creata.

   a) Specificare un nome e selezionare Genera token.

   b. Copia il valore del token in una posizione sicura. Questo token sarà necessario per configurare la connessione in Microsoft Entra ID.

   c. Seleziona Chiudi.

   

Aggiungi Harness dalla raccolta

È necessario aggiungere l'applicazione Harness dalla raccolta applicazioni di Microsoft Entra prima di poter configurare il provisioning automatico degli utenti. Questo registra Harness come applicazione SaaS gestita nel tenant Microsoft Entra.

1. Accedere all'interfaccia di amministrazione di Microsoft Entra come almeno un amministratore di applicazioni cloud.

2. Passare a Entra ID>App aziendali.

   

3. Per aggiungere una nuova applicazione, selezionare il pulsante Nuova applicazione nella parte superiore del riquadro.

   Pulsante "Nuova applicazione"

4. Nella casella di ricerca immettere Harness, selezionare Harness nell'elenco dei risultati e quindi selezionare il pulsante Aggiungi per aggiungere l'applicazione.

   

Configurare il provisioning automatico degli utenti per Harness

Dopo aver aggiunto Harness dalla raccolta e generato un token SCIM, è possibile configurare la connessione di provisioning. Questa sezione illustra i passaggi per configurare il servizio di provisioning Microsoft Entra per creare, aggiornare e disabilitare utenti o gruppi in Harness in base alle assegnazioni di utenti o gruppi in Microsoft Entra ID.

Per configurare il provisioning utenti automatico per Harness in Microsoft Entra ID, seguire questa procedura:

1. Accedere all'interfaccia di amministrazione di Microsoft Entra come almeno un amministratore di applicazioni cloud.

2. Passare a Entra ID>App aziendali.

   

3. Nell'elenco delle applicazioni selezionare Harness.

   

4. Selezionare la scheda Provisioning.

   

5. Selezionare + Nuova configurazione.

   

6. In Credenziali amministratore eseguire le operazioni seguenti:

   

   • Nella casella URL tenant inserire https://app.harness.io/gateway/api/scim/account/<your_harness_account_ID>. È possibile ottenere l'ID dell'account Harness dall'URL nel browser quando si è connessi a Harness.

   • Nella casella Secret Token, immetti il valore del token di autenticazione SCIM che hai salvato nel passaggio 3 della sezione "Configura Harness per il provisioning".

   • Selezionare Test connessione per assicurarsi che Microsoft Entra ID possa connettersi a Harness. Se la connessione non riesce, verificare che l'account Harness disponga delle autorizzazioni di amministratore e quindi riprovare.

     

7. Selezionare Crea per creare la configurazione.

8. Selezionare Proprietà nella pagina Panoramica .

9. Selezionare la matita per modificare le proprietà. Abilitare i messaggi di posta elettronica di notifica e fornire un messaggio di posta elettronica per ricevere messaggi di posta elettronica di quarantena. Abilitare la prevenzione delle eliminazioni accidentali. Seleziona Applica per salvare le modifiche.

   

10. Selezionare Mapping attributi nel pannello sinistro e selezionare utenti.

11. Esaminare gli attributi utente sincronizzati da Microsoft Entra ID a Harness nella sezione Mappatura attributi. Gli attributi selezionati come proprietà corrispondenti vengono usati per trovare le corrispondenze con gli account utente in Harness per le operazioni di aggiornamento. Selezionare il pulsante Salva per confermare le modifiche.

    

12. In Mapping selezionare Synchronize Microsoft Entra groups to Harness (Sincronizza gruppi di Microsoft Entra in Harness).

13. Esamina gli attributi del gruppo sincronizzati da Microsoft Entra ID ad Harness nella sezione Mappatura attributi. Gli attributi selezionati come proprietà corrispondenti vengono usati per trovare le corrispondenze con i gruppi in Harness per le operazioni di aggiornamento. Selezionare il pulsante Salva per confermare le modifiche.

    

14. Per configurare i filtri di ambito, vedere le istruzioni seguenti fornite nell'articolo Definizione dell'ambito del filtro.

15. Usare il provisioning su richiesta per convalidare la sincronizzazione con un numero ridotto di utenti prima di distribuire in modo più ampio nell'organizzazione.

16. Quando si è pronti per eseguire il provisioning, selezionare Avvia provisioning dalla pagina Panoramica.

Monitora la tua distribuzione

Dopo aver avviato il provisioning, controlla i log di provisioning per verificare che utenti e gruppi siano sincronizzati correttamente tra Microsoft Entra ID e Harness.

Dopo aver configurato il provisioning, usare le risorse seguenti per monitorare la distribuzione:

1. Usare i log di provisioning per determinare gli utenti di cui è stato eseguito il provisioning correttamente o in modo non riuscito
2. Controllare la barra di progresso per visualizzare lo stato del ciclo di provisioning e quanto vicino sia al completamento.
3. Se la configurazione del provisioning sembra essere in cattivo stato, l'applicazione entra in quarantena. Ulteriori informazioni sugli stati di quarantena sono disponibili nell'articolo sullo stato di quarantena del provisioning delle applicazioni.

Contenuto correlato

• Scopri come esaminare i log e ricevere report sull'attività di provisioning
• Gestire il provisioning degli account utente per le app aziendali
• Accesso alle applicazioni e Single Sign-On con Microsoft Entra ID