API di amministrazione per le organizzazioni Enterprise

Le API di amministrazione di Notion consentono alla tua organizzazione di gestire le attività amministrative tramite codice. Ciò include attività comuni come l'avvio di un'esporta dello spazio di lavoro, la creazione e il rilascio di blocchi legali, la disconnessione degli utenti gestiti da Notion e altro ancora.

Puoi configurarlo nelle impostazioni della tua organizzazione. Crei un bot di amministrazione per la tua organizzazione, quindi gli assegni un token con solo l'accesso di cui ha bisogno.

• La tua organizzazione deve disporre del piano Enterprise.

• Devi essere un proprietario dell’organizzazione.

• Questa funzionalità è pensata per i team di amministrazione, IT, sicurezza e conformità. I membri e gli ospiti non noteranno alcun cambiamento nel loro lavoro quotidiano.

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

2. Vai su Generale, quindi apri Gestisci token API di amministrazione a livello di organizzazione.

3. Seleziona Crea connessione.

4. Assegna alla connessione un nome che il tuo team riconoscerà, come “Automazione conformità”, e seleziona solo l'accesso necessario. Se una connessione esegue solo esporta, non assegnarle l'accesso al blocco legale.

5. Seleziona Crea token, quindi copia il token e salvalo nel gestore dei segreti già utilizzato dal tuo team.

Vedrai la nuova connessione elencata nelle impostazioni della tua organizzazione, insieme a chi l'ha creata e quando. Puoi tornare indietro e copiare nuovamente il token in qualsiasi momento dal menu della connessione.

• Scegli il set di accesso più limitato possibile che consenta comunque di svolgere il lavoro.

• Ruota i token secondo un programma stabilito dal tuo team di sicurezza.

• Elimina immediatamente un token se viene condiviso per errore o se la persona che lo possedeva cambia ruolo. Qualsiasi script che utilizza quel token smetterà di funzionare immediatamente.

• Non è possibile limitare un token di amministrazione a indirizzi IP o reti specifici. Utilizza i controlli già in tuo possesso, come l'archiviazione dei token in un gestore dei segreti e l'esecuzione delle chiamate da sistemi di cui ti fidi.

Le azioni eseguite con un token amministratore vengono visualizzate nel registro di controllo. Il bot amministratore è elencato come attore, così puoi distinguere il lavoro automatizzato da quello umano.

• La chiamata viene rifiutata. Verifica che la tua organizzazione disponga del piano Enterprise.

• Ricevi un errore di permesso. Verifica che il token abbia accesso all'azione che stai chiamando. Un token con ambito esporta non può creare un blocco legale.

• Una chiamata di disconnessione non produce alcun effetto. Verifica che l'account sia un utente gestito. Gli account al di fuori dei tuoi domini verificati non sono coperti.

Per i formati di richiesta, i parametri e gli esempi di codice, consulta il riferimento dell'API di amministrazione nella documentazione per sviluppatori.