Admin-API'er for Enterprise-organisationer

Notions admin-API'er lader din organisation håndtere admin-arbejde med kode. Dette inkluderer almindelige opgaver som at starte en arbejdsområde-eksport, oprette og frigive lagringspligt, logge administrerede brugere ud af Notion og meget mere.

Du kan konfigurere dette i dine organisationsindstillinger. Du opretter en admin-bot til din organisation og giver den derefter et token med kun den adgang, den har brug for.

• Din organisation skal være på Enterprise-abonnementet.

• Du skal være organisationsejer.

• Dette er bygget til admin-, it-, sikkerheds- og compliance-teams. Medlemmer og gæster vil ikke bemærke nogen ændring i deres daglige arbejde.

1. Åbn arbejdsområdeskifteren, og vælg Administrér organisation.

2. Gå til Generelt, og åbn derefter Administrer admin-API-tokens på organisationsniveau.

3. Vælg Opret forbindelse.

4. Giv forbindelsen et navn, som dit team kan genkende, f.eks. "Compliance-automatisering", og vælg kun den adgang, den har brug for. Hvis en forbindelse kun kører eksporter, skal du ikke give den adgang til lagringspligt.

5. Vælg Opret token, kopier derefter tokenet, og gem det i secrets manageren, som dit team allerede bruger.

Du vil se den nye forbindelse på listen i dine organisationsindstillinger sammen med, hvem der oprettede den, og hvornår. Du kan altid vende tilbage og kopiere tokenet igen fra forbindelsens menu.

• Vælg den mindste adgang, der stadig får arbejdet gjort.

• Roter tokens efter en tidsplan, som dit sikkerhedsteam fastsætter.

• Slet et token med det samme, hvis det deles ved en fejl, eller hvis den person, der ejede det, skifter rolle. Ethvert script, der bruger det token, holder op med at fungere med det samme.

• Du kan ikke begrænse et admin-token til specifikke IP-adresser eller netværk. Brug de kontroller, du allerede har, såsom at gemme tokens i secrets manageren og køre kald fra systemer, du stoler på.

Handlinger foretaget med et admin-token vises i din revisionslog. Admin-botten er angivet som aktør, så du kan kende forskel på automatiseret arbejde og menneskeligt arbejde.

• Opkaldet afvises. Kontrollér, at din organisation er på Enterprise-abonnementet.

• Du får en tilladelsesfejl. Kontrollér, at tokenet har adgang til den handling, du kalder. Et token med adgang til eksport kan ikke oprette en lagringspligt.

• Et logout-kald gør intet. Kontrollér, at kontoen er en administreret bruger. Konti uden for dine verificerede domæner er ikke dækket.

For anmodningsformater, parametre og kodeeksempler, se admin API-reference i udviklerdokumentationen.