Admin-API:er för Enterprise-organisationer

Notions admin-API:er låter din organisation hantera administrativt arbete med kod. Detta inkluderar vanliga uppgifter såsom att starta en export av arbetsyta, skapa och ta bort arkiveringsskyldigheter, och logga ut Hanterade användare från Notion med mera.

Du kan ställa in detta i dina organisationsinställningar. Du skapar en admin-bot för din organisation och ger den sedan en token med endast den åtkomst den behöver.

• Din organisation måste ha Enterprise-abonnemanget.

• Du måste vara en organisationsägare.

• Detta är byggt för admin-, IT-, säkerhets- och efterlevnadsteam. Medlemmar och gäster kommer inte att märka någon förändring i sitt dagliga arbete.

1. Öppna arbetsytaväxlaren och välj Hantera organisation.

2. Gå till Allmänt och öppna sedan Hantera admin-API-token på organisationsnivå.

3. Välj Skapa anslutning.

4. Ge anslutningen ett namn som ditt team känner igen, till exempel ”Compliance automation”, och välj endast den åtkomst som behövs. Om en anslutning bara kör exporter, ge den inte åtkomst till arkiveringsskyldighet.

5. Välj Skapa token, kopiera sedan token och spara den i den hemlighetshanterare som ditt team redan använder.

Du ser den nya anslutningen listad i dina organisationsinställningar, tillsammans med vem som skapade den och när. Du kan när som helst gå tillbaka och kopiera token igen från anslutningens meny.

• Välj den minsta mängden åtkomst som krävs för att få jobbet gjort.

• Rotera token enligt ett schema som ditt säkerhetsteam fastställer.

• Ta bort en token omedelbart om den delas av misstag eller om personen som ägde den byter roll. Alla skript som använder den token slutar fungera omedelbart.

• Du kan inte begränsa en admin-token till specifika IP-adresser eller nätverk. Använd de kontroller du redan har, som att lagra token i en hemlighetshanterare och köra anrop från system du litar på.

Åtgärder som utförs med en admin-token visas i din granskningslogg. Admin-boten listas som aktör, så att du kan skilja automatiserat arbete från mänskligt arbete.

• Anropet avvisas. Kontrollera att din organisation har Enterprise-abonnemanget.

• Du får ett behörighetsfel. Kontrollera att din token har åtkomst till den åtgärd du anropar. En token med begränsad omfattning till exporter kan inte skapa en arkiveringsskyldighet.

• Ett utloggningsanrop gör ingenting. Kontrollera att kontot är en hanterad användare. Konton utanför dina verifierade domäner omfattas inte.

För begärandeformat, parametrar och kodexempel, se admin-API-referensen i utvecklardokumentationen.