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

L'obiettivo di questo articolo è illustrare i passaggi da eseguire in TheOrgWiki e Microsoft Entra ID configurare Microsoft Entra ID per effettuare automaticamente il provisioning e il deprovisioning di utenti e/o gruppi in TheOrgWiki.

Nota

Questo articolo descrive un connettore basato sul servizio di provisioning utenti Microsoft Entra. Per informazioni importanti su cosa fa questo servizio, come funziona e sulle domande frequenti, vedere Automatizzare il provisioning e il deprovisioning degli utenti nelle applicazioni SaaS con Microsoft Entra ID.

Prerequisiti

Lo scenario descritto in questo articolo presuppone che siano già disponibili i prerequisiti seguenti:

Passaggio 1: Assegnare utenti a TheOrgWiki

Microsoft Entra ID usa un concetto denominato assegnazioni per determinare quali utenti devono ricevere l'accesso alle app selezionate. Nel contesto del provisioning utenti automatico, vengono sincronizzati solo gli utenti e/o i gruppi assegnati a un'applicazione in Microsoft Entra ID.

Prima di configurare ed abilitare il provisioning automatico degli utenti, è opportuno determinare quali utenti e/o gruppi in Microsoft Entra ID necessitano di accesso a TheOrgWiki. Dopo aver deciso, è possibile assegnare questi utenti e/o gruppi a TheOrgWiki seguendo le istruzioni Assegnare un utente o un gruppo a un'app aziendale.

Suggerimenti importanti per l'assegnazione di utenti a TheOrgWiki

  • È consigliato assegnare un solo utente Microsoft Entra a TheOrgWiki per testare la configurazione del provisioning automatico degli utenti. In un secondo momento si potranno assegnare altri utenti e/o gruppi.

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

Passaggio 2: Configurare TheOrgWiki per il provisioning

Prima di configurare TheOrgWiki per il provisioning utenti automatico con Microsoft Entra ID, è necessario abilitare il provisioning SCIM in TheOrgWiki.

  1. Accedere alla Console di amministrazione di TheOrgWiki. Selezionare Console di amministrazione.

    Screenshot della finestra OrgWiki con l'avatar dell'utente e la Console di amministrazione evidenziati.

  2. Nella console di amministrazione selezionare la scheda Impostazioni.

    Screenshot della console di amministrazione di TheOrgWiki con la scheda Impostazioni evidenziata.

  3. Accedere a Account di servizio.

    Screenshot della pagina Account di servizio nella console di amministrazione di Org Wiki.

  4. Selezionare +Account del servizio. In Tipo di account del servizio selezionare Basato su token. Seleziona Salva.

    Screenshot della finestra di dialogo Nuovo account del servizio con le opzioni Tipo di account di servizio, Basato su token e Salva evidenziate.

  5. Copiare i Token attivi. Questo valore verrà immesso nel campo Token segreto nella scheda Provisioning dell'applicazione TheOrgWiki.

    Screenshot della finestra di dialogo Gestisci token per il provisioning SCIM.

Per configurare TheOrgWiki per il provisioning degli utenti automatico con Microsoft Entra ID, è necessario aggiungere TheOrgWiki dalla galleria delle applicazioni Microsoft Entra all'elenco di applicazioni SaaS gestite.

  1. Accedi al centro amministrativo di Microsoft Entra come almeno un amministratore delle applicazioni cloud.

  2. Passare a Entra ID>App aziendali>Nuova applicazione.

  3. Nella sezione Aggiungi dalla raccolta digitare TheOrgWiki e selezionare TheOrgWiki nel pannello dei risultati.

    Screenshot di TheOrgWiki nell'elenco dei risultati.

  4. Cliccare sul pulsante Iscrizione per TheOrgWiki per essere reindirizzati alla pagina di accesso di TheOrgWiki.

    Schermata della pagina di accesso di The Org Wiki con l'URL indicato.

  5. Nell'angolo superiore destro selezionare Accedi.

    Screenshot dell'angolo superiore destro della pagina di accesso con l'opzione Accedi evidenziata.

  6. Poiché TheOrgWiki è un'app OpenIDConnect, scegliere di accedere a OrgWiki usando l'account aziendale Microsoft.

    Screenshot della pagina di accesso dell'Org Wiki con l'opzione Accedi con Microsoft evidenziata.

  7. Dopo l'autenticazione, l'applicazione viene aggiunta automaticamente al tenant e verrà reindirizzato all'account TheOrgWiki.

    Screenshot di OrgWiki Aggiungi SCIM.

Passaggio 4: Configurare il provisioning automatico degli utenti su TheOrgWiki

Questa sezione illustra la procedura per configurare il servizio di provisioning Microsoft Entra per creare, aggiornare e disabilitare utenti e/o gruppi in TheOrgWiki in base alle assegnazioni di utenti e/o gruppi in Microsoft Entra ID.

Configurare il provisioning automatico degli utenti per TheOrgWiki in Microsoft Entra ID

  1. Accedi al centro amministrativo di Microsoft Entra come almeno un amministratore delle applicazioni cloud.

  2. Accedere a Entra ID>Applicazioni aziendali

    Screenshot del pannello di applicazioni aziendali.

  3. Nell'elenco delle applicazioni selezionare TheOrgWiki.

    Screenshot del collegamento OrgWiki nell'elenco delle applicazioni.

  4. Selezionare la scheda Provisioning.

    Screenshot delle opzioni di gestione con l'opzione Provisioning evidenziata.

  5. Selezionare + Nuova configurazione.

    Screenshot della nuova configurazione.

  6. Nella sezione Credenziali amministratore, inserisci https://<TheOrgWiki Subdomain value>.theorgwiki.com/api/v2/scim/v2/ in URL tenant.

    Esempio: https://test1.theorgwiki.com/api/v2/scim/v2/

    Nota

    Il valore di Valore sottodominio può essere impostato solo durante il processo di iscrizione iniziale a TheOrgWiki.

  7. Immettere il valore del token nel campo Token segreto recuperato in precedenza da TheOrgWiki. Selezionare Test Connection per assicurarsi che Microsoft Entra ID possa connettersi a TheOrgWiki. Se la connessione non riesce, verificare che l'account TheOrgWiki abbia autorizzazioni di amministratore e riprovare.

    Screenshot della connessione di test del provisioning.

  8. Selezionare Crea per creare la configurazione.

  9. Selezionare Proprietà nella pagina Panoramica .

  10. Selezionare l'icona Modifica per modificare le proprietà. Abilitare i messaggi di posta elettronica di notifica e fornire un messaggio di posta elettronica per ricevere notifiche di quarantena. Abilitare la prevenzione delle eliminazioni accidentali. Seleziona Applica per salvare le modifiche.

    Screenshot delle proprietà di provisioning.

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

  12. Esaminare gli attributi utente sincronizzati da Microsoft Entra ID a TheOrgWiki nella sezione Attribute- Mapping. Gli attributi selezionati come proprietà corrispondenti vengono usati per l'abbinamento con gli account utente in TheOrgWiki per le operazioni di aggiornamento. Selezionare il pulsante Salva per eseguire il commit delle modifiche.

    Screenshot degli attributi utente di TheOrgWiki.

  13. Per configurare i filtri di ambito, vedere le istruzioni fornite nell'articolo Filtro di ambito.

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

  15. Quando si è pronti per procedere al provisioning, selezionare Avvia il provisioning nella pagina Panoramica.

Passaggio 5: Monitorare la distribuzione

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 uno stato problematico, l'applicazione passa in quarantena. Ulteriori informazioni sugli stati di quarantena sono disponibili nell'articolo sullo stato di quarantena del provisioning delle applicazioni.

Altre risorse