Admin API's voor Enterprise-organisaties

Met de admin API's van Notion kan je organisatie adminwerk afhandelen met code. Dit omvat algemene taken zoals het starten van een workspace-export, het aanmaken en vrijgeven van juridische reserveringen, het afmelden van beheerde gebruikers bij Notion, en meer.

Je kunt dit instellen in je organisatie-instellingen. Je maakt een admin-bot voor je organisatie en geeft deze vervolgens een token met alleen de toegang die nodig is.

• Je organisatie moet het Enterprise-abonnement hebben.

• Je moet een organisatie-eigenaar zijn.

• Dit is gebouwd voor teams op het gebied van admin, IT, beveiliging en compliance. Leden en gasten merken geen verandering in hun dagelijkse werk.

1. Open de workspace-switcher en selecteer Organisatie beheren.

2. Ga naar Algemeen en open Beheer admin API-tokens op organisatieniveau.

3. Selecteer Koppeling maken.

4. Geef de koppeling een naam die je team herkent, zoals "Compliance automatisering", en kies alleen de toegang die nodig is. Als een koppeling alleen exporten uitvoert, geef deze dan geen toegang tot juridische reservering.

5. Selecteer Token maken, kopieer het token en sla het op in de secrets manager die je team al gebruikt.

Je ziet de nieuwe koppeling in je organisatie-instellingen staan, samen met wie deze heeft gemaakt en wanneer. Je kunt op elk gewenst moment teruggaan en het token opnieuw kopiëren vanuit het menu van de koppeling.

• Kies alleen de toegang die nodig is.

• Roteer tokens volgens een schema dat door je beveiligingsteam is vastgesteld.

• Verwijder een token direct als het per ongeluk wordt gedeeld of als de eigenaar van rol verandert. Elk script dat dat token gebruikt, stopt meteen met werken.

• Je kunt een admin token niet beperken tot specifieke IP-adressen of netwerken. Gebruik de controles die je al hebt, zoals het opslaan van tokens in een secrets manager en het uitvoeren van aanroepen vanuit systemen die je vertrouwt.

Acties die met een admin token worden uitgevoerd, verschijnen in je auditlogboek. De admin bot wordt vermeld als de actor, zodat je geautomatiseerd werk kunt onderscheiden van menselijk werk.

• Het gesprek wordt geweigerd. Controleer of je organisatie het Enterprise-abonnement heeft.

• Je krijgt een machtigingsfout. Controleer of het token toegang heeft tot de actie die je bedoelt. Een token dat alleen voor export bedoeld is, kan geen juridische reservering aanmaken.

• Een uitloggesprek doet niets. Controleer of het account een Beheerde gebruiker is. Accounts buiten je geverifieerde domeinen vallen hier niet onder.

Voor aanvraagformaten, parameters en codevoorbeelden, zie de beheerder API-referentie in de ontwikkelaarsdocumentatie.