Configurare Notion per il provisioning di utenti automatico con Microsoft Entra ID

Questo articolo descrive i passaggi da eseguire sia in Notion che in Microsoft Entra ID per configurare il provisioning automatico degli utenti. Se configurato, Microsoft Entra ID effettua automaticamente il provisioning e il deprovisioning di utenti e gruppi in Notion usando il servizio di provisioning Microsoft Entra. Per informazioni importanti sul funzionamento di questo servizio e sulle domande frequenti, vedere Automatizzare il provisioning e il deprovisioning degli utenti nelle applicazioni SaaS con Microsoft Entra ID.

Funzionalità supportate

• Creare utenti in Notion.
• Rimuovere gli utenti in Notion quando non richiedono più l'accesso.
• Mantenere sincronizzati gli attributi utente tra Microsoft Entra ID e Notion.
• Gestire gruppi e membri in Notion.
• Accesso singolo a Notion (consigliato).

Prerequisiti

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

• Un tenant di Microsoft Entra
• Uno dei ruoli seguenti: Amministratore applicazione, Amministratore applicazione cloud o Proprietario applicazione.
• Un account utente in Notion con autorizzazioni di amministratore.

Passaggio 1: Pianificare la distribuzione dell'approvvigionamento

1. Informazioni sul funzionamento del servizio di provisioning.
2. Determinare chi "rientra nell'ambito di provisioning".
3. Determinare quali dati mappare tra Microsoft Entra ID e Notion.

Passaggio 2: Configurare Notion per supportare il provisioning con Microsoft Entra ID

1. Accedere all'area di lavoro Notion, aprire la scheda Impostazioni e membri → Identity & Provisioning e scorrere verso il basso fino alla sezione provisioning SCIM .
2. Se non è già stato generato un token, selezionare + Aggiungi token e copiare il token. Questo token verrà immesso come token segreto nel passaggio 5.5.
3. L'URL del tenant SCIM di Notion è https://www.notion.so/scim/v2, che verrà usato nel passaggio 5.5.

Passaggio 3: Aggiungere Notion dalla raccolta di applicazioni Microsoft Entra

Aggiungere Notion dalla raccolta di applicazioni Microsoft Entra per iniziare a gestire il provisioning in Notion. Se in precedenza si è configurato Notion per l'accesso SSO, è possibile usare la stessa applicazione. Tuttavia, è consigliabile creare un'app separata durante il test iniziale dell'integrazione. Altre informazioni sull'aggiunta di un'applicazione dalla raccolta sono disponibili qui.

Passaggio 4: Definire chi è incluso nel processo di provisioning

Il servizio di provisioning di Microsoft Entra consente di delimitare chi viene fornito in base all'assegnazione all'applicazione o in base agli attributi degli utenti o dei gruppi. Se si sceglie di definire l'ambito di cui è stato effettuato il provisioning nell'app in base all'assegnazione, è possibile usare la procedura per assegnare utenti e gruppi all'applicazione. Se si sceglie di definire l'ambito per cui è stato effettuato il provisioning basandosi esclusivamente sugli attributi dell'utente o del gruppo, è possibile usare un filtro di ambito.

• Iniziare con pochi elementi. Eseguire il test con un piccolo insieme di utenti e gruppi prima di distribuirlo a tutti. Quando l'ambito per il provisioning è impostato su utenti e gruppi assegnati, è possibile controllarlo assegnando uno o due utenti o gruppi all'app. Quando l'ambito è impostato su tutti gli utenti e i gruppi, è possibile specificare un filtro di ambito basato su attributi.

• Se sono necessari ruoli aggiuntivi, è possibile aggiornare il manifesto dell'applicazione per aggiungere nuovi ruoli.

Passaggio 5: Configurare il provisioning automatico degli utenti per Notion

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

Per configurare il provisioning utenti automatico per Notion in Microsoft Entra ID:

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

2. Accedere a Entra ID>App aziendali

   

3. Nell'elenco delle applicazioni selezionare Notion.

   

4. Selezionare la scheda Provisioning .

   

5. Impostare Modalità di provisioning su Automatico.

   

6. Nella sezione Credenziali amministratore immettere l'URL del tenant Notion e il token segreto. Selezionare Test connessione per assicurarsi che Microsoft Entra ID possa connettersi a Notion. Se la connessione non riesce, verificare che l'account Notion disponga delle autorizzazioni di amministratore e riprovare.

   

7. Nel campo Email di Notifica, immettere l'indirizzo di posta elettronica di una persona o di un gruppo che dovrebbe ricevere le notifiche di errore di provisioning e selezionare la casella di controllo Invia una notifica di posta elettronica quando si verifica un errore.

   

8. Selezionare Salva.

9. Nella sezione Mapping selezionare Synchronize Microsoft Entra users to Notion (Sincronizza utenti di Microsoft Entra in Notion).

10. Esamina gli attributi dell'utente sincronizzati da Microsoft Entra ID a Notion nella sezione Mappatura degli attributi. Gli attributi selezionati come proprietà corrispondenti vengono usati per trovare le corrispondenze con gli account utente in Notion per le operazioni di aggiornamento. Se si sceglie di modificare l'attributo di destinazione corrispondente, è necessario assicurarsi che l'API Notion supporti il filtro degli utenti in base a tale attributo. Selezionare il pulsante Salva per eseguire il commit delle modifiche.

    Attributo	TIPO	Supporto per il filtraggio	Obbligatorio per nozione
    nome utente	Stringa	✓	✓
    nome.formattato	Stringa		✓
    attivo	Booleano		✓

11. Nella sezione Mapping selezionare Synchronize Microsoft Entra groups to Notion (Sincronizza gruppi di Microsoft Entra in Notion).

12. Esaminare gli attributi del gruppo sincronizzati da Microsoft Entra ID a Notion nella sezione Attributi di mappatura. Gli attributi selezionati come proprietà corrispondenti vengono usati per trovare le corrispondenze con i gruppi in Notion per le operazioni di aggiornamento. Selezionare il pulsante Salva per eseguire il commit delle modifiche.

    Attributo	TIPO	Supporto per il filtraggio	Obbligatorio per nozione
    nome visualizzato	Stringa	✓	✓
    Membri	Riferimento

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

14. Per abilitare il servizio di provisioning Microsoft Entra per Notion, impostare Stato del provisioning su Attivo nella sezione Impostazioni.

    

15. Definire gli utenti e/o i gruppi di cui si vuole eseguire il provisioning in Notion scegliendo i valori desiderati in Ambito nella sezione Impostazioni .

    

16. Quando sei pronto per il provisioning, seleziona Salva.

    

Questa operazione avvia il ciclo di sincronizzazione iniziale di tutti gli utenti e i gruppi definiti in Ambito nella sezione Impostazioni . Il ciclo iniziale richiede più tempo rispetto ai cicli successivi, che si verificano approssimativamente ogni 40 minuti, purché il servizio di provisioning di Microsoft Entra sia in esecuzione.

Passaggio 6: 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 avanzamento per vedere lo stato del ciclo di provisioning e quanto è vicino 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.

Altre risorse

• Gestione del provisioning degli account degli utenti per le applicazioni aziendali
• Che cos'è l'accesso alle applicazioni e l'accesso Single Sign-On con Microsoft Entra ID?

Contenuto correlato

• Scopri come esaminare i log e ottenere report sull'attività di provisioning