Admin-API-er for Enterprise-organisasjoner

Notions admin-API-er lar organisasjonen din håndtere admin-arbeid med kode. Dette inkluderer vanlige oppgaver som å starte en arbeidsområde-eksport, opprette og frigjøre juridiske sperringer, logge ut administrerte brukere fra Notion, og mer.

Du kan sette opp dette i organisasjonsinnstillingene dine. Du oppretter en admin-bot for organisasjonen din, og gir den deretter et token med kun tilgangen den trenger.

• Organisasjonen din må være på Enterprise-abonnementet.

• Du må være organisasjonens eier.

• Dette er bygget for admin-, IT-, sikkerhets- og samsvarsteam. Medlemmer og gjester vil ikke merke noen endring i sitt daglige arbeid.

1. Åpne arbeidsområdebytteren og velg Administrer organisasjon.

2. Gå til Generelt, og åpne deretter Administrer admin-API-token på organisasjonsnivå.

3. Velg Opprett tilkobling.

4. Gi tilkoblingen et navn som teamet ditt vil kjenne igjen, for eksempel «Compliance automation», og velg kun tilgangen den trenger. Hvis en tilkobling kun kjører eksporter, må du ikke gi den tilgang til juridisk sperring.

5. Velg Opprett token, kopier deretter tokenet og lagre det i secrets-behandleren teamet ditt allerede bruker.

Du vil se den nye tilkoblingen oppført i organisasjonsinnstillingene dine, sammen med hvem som opprettet den og når. Du kan når som helst gå tilbake og kopiere tokenet på nytt fra tilkoblingens meny.

• Velg den minste tilgangen som fortsatt får jobben gjort.

• Roter tokener etter en tidsplan som sikkerhetsteamet ditt setter.

• Slett et token umiddelbart hvis det deles ved en feiltakelse eller personen som eide det bytter rolle. Alle skript som bruker det tokenet slutter å fungere umiddelbart.

• Du kan ikke begrense et admin-token til spesifikke IP-adresser eller nettverk. Bruk kontrollene du allerede har, som å lagre tokener i en secrets-behandler og kjøre kall fra systemer du stoler på.

Handlinger utført med et admin-token vises i revisjonsloggen din. Admin-boten er oppført som aktør, slik at du kan skille automatisert arbeid fra menneskelig arbeid.

• Anropet avvises. Kontroller at organisasjonen din har Enterprise-abonnementet.

• Du får en tilgangsfeil. Kontroller at tokenet har tilgang til handlingen du kaller på. Et token med tilgang til Eksporter kan ikke opprette en juridisk sperre.

• Et utloggingsanrop gjør ingenting. Kontroller at kontoen tilhører kategorien Administrerte brukere. Kontoer utenfor de bekreftede domener er ikke dekket.

For forespørselsformater, parametere og kodeeksempler, se admin-API-referansen i utviklerdokumentasjonen.