Esegui il provisioning di utenti e gruppi con SCIM

L'API SCIM di Notion ti consente di fare quanto segue:

• Crea e rimuovi membri nel tuo spazio di lavoro.

• Aggiorna le informazioni del profilo di un membro.

• Recupera i membri nel tuo spazio di lavoro.

• Trova membri per email o nome.

• Crea e rimuovi gruppi nel tuo spazio di lavoro.

• Aggiungi e rimuovi membri in un gruppo.

• Recupera i gruppi nel tuo spazio di lavoro.

• Trova gruppi per nome.

Attualmente supportiamo Okta, OneLogin, Rippling e applicazioni SCIM personalizzate. Se utilizzi un altro Identity Provider, faccelo sapere. Consulta le istruzioni per la configurazione dell'Identity Provider per app specifiche qui →

Per utilizzare SCIM con Notion:

• Il tuo spazio di lavoro deve disporre di un piano Enterprise.

• Il tuo Identity Provider (IdP) deve supportare il protocollo SAML 2.0. Consulta le istruzioni per la configurazione dell'Identity Provider per app specifiche qui →

• Un proprietario del workspace deve configurare SCIM per il workspace Notion.

• Devi aver verificato la proprietà di un dominio email se desideri utilizzare SCIM per modificare il nome o l'indirizzo email di un utente. Scopri di più sulla verifica del dominio →

Solo i proprietari dell'organizzazione del piano Enterprise possono generare e visualizzare i token API SCIM. Per creare un token API SCIM:

1. Apri il selettore dello spazio di lavoro e seleziona Gestisci organizzazione. Potrebbe essere necessario Configurare l'organizzazione prima, se non l'hai già fatto. Scopri di più qui →

2. Nella scheda Generale dei controlli a livello di organizzazione, seleziona > accanto a Provisioning SCIM.

Quando un proprietario dello spazio di lavoro lascia lo spazio di lavoro o il suo ruolo viene modificato, il suo token verrà revocato. Quando ciò accade, verrà inviato un messaggio automatico ai restanti proprietari dello spazio di lavoro per notificare loro di sostituire il token revocato.

Inoltre, i token attivi possono essere revocati da qualsiasi proprietario dello spazio di lavoro. Per revocare un token, clicca su 🗑 accanto al token corrispondente.

Se un token viene revocato, dovrai sostituirlo in tutte le integrazioni esistenti.

Qualsiasi integrazione SCIM e provisioning degli utenti che si basano sul token revocato verranno disabilitati finché non verranno sostituiti da un token attivo.

Per controllare se gli utenti riceveranno inviti a spazi di lavoro e gruppi via email quando sottoposti a provisioning tramite SCIM, i proprietari dell'organizzazione del piano Enterprise possono:

1. Apri il selettore dello spazio di lavoro e seleziona Gestisci organizzazione.

2. Nella scheda Generale, attiva Sopprimi email di invito dal provisioning SCIM se non desideri inviare email agli utenti.

Per effettuare il provisioning di un membro con accesso limitato tramite SCIM, devi impostare l'attributo 'role' di SCIM su 'restricted_member':

\"urn:ietf:params:scim:schemas:extension:notion:2.0:User\": { role: string // \"owner\" | \"membership_admin\" | \"member\" | \"restricted_member\" }

Per trasformare un ospite della pagina in un membro con accesso limitato tramite SCIM, devi utilizzare POST /scim/v2/Users.

• GET /ServiceProviderConfig

  • GET

  • Recupera una descrizione delle funzionalità disponibili della specifica SCIM.

  • Definito nella Sezione 5 della specifica del protocollo SCIM.

• GET /ResourceTypes

  • GET

  • Recupera un elenco dei tipi di risorsa SCIM disponibili.

  • Definito nella Sezione 6 della specifica del protocollo SCIM.

La tabella seguente delinea la mappatura tra gli attributi utente SCIM e i campi del profilo utente Notion. I proprietari dell'organizzazione scelgono quali attributi inviare a Notion e possono aggiornare tali attributi in qualsiasi momento. Notion elabora gli attributi inviati tramite l'API SCIM di Notion per migliorare l'esperienza di provisioning e gestione di utenti e gruppi.

• GET /Users

  • GET

  • Recupera un elenco paginato dei membri dello spazio di lavoro.

  • È possibile effettuare la paginazione utilizzando i parametri startIndex e count. Nota che startIndex è numerato a partire da 1 e count ha un massimo di 100.

  • È possibile filtrare i risultati con il parametro filter. Gli attributi validi per il filtro sono email, given_name e family_name, ad esempio GET

  • Nota che given_name e family_name fanno distinzione tra maiuscole e minuscole. L'email viene convertita in minuscolo.

• GET /Users/

  • GET

  • Recupera uno specifico membro dello spazio di lavoro tramite il suo ID utente Notion. Si tratterà di un UUID di 32 caratteri nel seguente formato: 00000000-0000-0000-0000-000000000000.

  • Si noti che meta.created e meta.lastModified non riflettono valori di timestamp significativi.

• POST /Users

  • POST

  • Se l'utente che stai aggiungendo possiede già un account utente Notion con la stessa email, verrà aggiunto al tuo spazio di lavoro.

  • Se l'utente non esiste, questa chiamata creerà un nuovo utente Notion e lo aggiungerà al tuo spazio di lavoro. Verrà associato al profilo utente Notion creato.

  • L'API SCIM leggerà la proprietà della foto del profilo alla creazione dell'utente, ma non negli aggiornamenti futuri.

• PATCH /Users/

  • PATCH

  • Aggiorna tramite una serie di operazioni e restituisce il record utente aggiornato.

• PUT /Users/

  • PUT

  • Aggiorna e restituisce il record utente aggiornato.

• DELETE /Users/

  • DELETE

  • Rimuovi un utente dal tuo spazio di lavoro. L'utente viene disconnesso da tutte le sessioni attive.

    • L'account utente non può essere eliminato tramite SCIM. L'eliminazione dell'account deve essere eseguita manualmente.

    • La rimozione di un utente dal tuo spazio di lavoro può essere ottenuta anche impostando l'attributo utente active su false inviando una richiesta PATCH /Users/ o PUT /Users/.

    • Il proprietario dello spazio di lavoro che ha creato il token del bot SCIM non può essere rimosso tramite l'API. Quando un proprietario dello spazio di lavoro viene rimosso tramite l'API SCIM, tutti i token creati da lui verranno revocati e tutte le integrazioni che utilizzano quel bot smetteranno di funzionare.

• GET /Groups

  • GET

  • Recupera un elenco paginato dei gruppi dello spazio di lavoro.

  • È possibile effettuare la paginazione utilizzando i parametri startIndex e count. Nota che startIndex è indicizzato a partire da 1 e count ha un massimo di 100, ad es. GET

    • Se non viene utilizzata la paginazione, in una richiesta verrà restituito un massimo di 100 gruppi dello spazio di lavoro.

  • È possibile filtrare i risultati con il parametro filter. I gruppi possono essere filtrati in base al loro attributo displayName, ad es. GET

• GET /Groups/

  • GET

  • Recupera un gruppo specifico dello spazio di lavoro tramite il suo ID gruppo Notion. Sarà un UUID di 32 caratteri nel seguente formato: 00000000-0000-0000-0000-000000000000.

• POST /Groups

  • POST

  • Crea un nuovo gruppo dello spazio di lavoro.

• PATCH /Groups/

  • PATCH

  • Aggiorna un gruppo dello spazio di lavoro tramite una serie di operazioni.

• PUT /Groups/

  • PUT

  • Aggiorna un gruppo dello spazio di lavoro.

• DELETE /Groups/

  • DELETE

  • Elimina un gruppo dello spazio di lavoro.