エンタープライズ組織向け管理者API

Notionの管理者APIを使用すると、組織の管理作業をコードで処理できます。これには、ワークスペースのエクスポートの開始、訴訟ホールドの作成と解除、管理対象ユーザーのNotionからのログアウトなど、一般的なタスクが含まれます。

これは組織の設定でセットアップできます。組織用の管理者ボットを作成し、必要なアクセス権のみを持つトークンを付与します。

• 組織がエンタープライズプランに加入している必要があります。

• 組織オーナーである必要があります。

• これは、管理者、IT、セキュリティ、コンプライアンスチーム向けに構築されています。メンバーやゲストの日常業務に変更はありません。

1. ワークスペース切り替えメニューを開き、組織を管理するを選択します。

2. 全般に移動し、組織レベルの管理者APIトークンを管理を開きます。

3. 接続を作成を選択します。

4. チームが認識できる名前（「コンプライアンス自動化」など）を接続に付け、必要なアクセス権のみを選択します。接続がエクスポートのみを実行する場合は、訴訟ホールドのアクセスを付与しないでください。

5. トークンを作成を選択し、トークンをコピーして、チームが既に使用しているシークレットマネージャーに保存します。

新しい接続が組織の設定に一覧表示され、作成者と作成日時も表示されます。接続のメニューからいつでも戻ってトークンを再コピーできます。

• 業務を遂行できる最小限のアクセス権を選択してください。

• セキュリティチームが設定したスケジュールに従ってトークンをローテーションしてください。

• 誤って共有された場合や、トークンの所有者が役割を変更した場合は、すぐにトークンを削除してください。そのトークンを使用しているスクリプトは直ちに動作を停止します。

• 管理者トークンを特定のIPアドレスやネットワークに制限することはできません。トークンをシークレットマネージャーに保存したり、信頼できるシステムから呼び出しを実行したりするなど、既存の管理方法を使用してください。

管理者トークンを使用して実行されたアクションは、監査ログに表示されます。管理者ボットが実行者として記録されるため、自動化された作業と人間による作業を区別できます。

• 呼び出しが拒否されます。組織がエンタープライズプランに加入していることを確認してください。

• 権限エラーが発生します。トークンが呼び出そうとしているアクションへのアクセス権を持っていることを確認してください。エクスポートにスコープ設定されたトークンでは、訴訟ホールドを作成できません。

• ログアウトの呼び出しが機能しません。アカウントが管理対象ユーザーであることを確認してください。検証済みドメイン外のアカウントは対象外です。

リクエスト形式、パラメータ、コードサンプルについては、開発者向けドキュメントの管理者APIリファレンスを参照してください。