> ## Documentation Index
> Fetch the complete documentation index at: https://developer.box.com/llms.txt
> Use this file to discover all available pages before exploring further.
# スコープ
export const SignupCTA = ({children}) => {
return ;
};
export const Link = ({href, children, className, ...props}) => {
const localizedHref = localizeLink(href);
return
{children}
;
};
開発者コンソールでアプリケーションが作成されると、ユーザーはアプリケーションのスコープを設定する必要があります。ユーザーにBox内のファイルやフォルダへのアクセス権限が付与されるしくみと同様、アプリケーションにも、BoxユーザーやBoxを使用する企業に代わって特定のアクションを実行するための独自の権限が付与されます。アプリケーションに対する権限セットの名前を「スコープ」と言います。つまり、アプリケーションのスコープにより、アプリケーションから呼び出すことのできる
無料のDeveloperアカウントを作成すると、開発者コンソールにアクセスし、アプリケーションスコープを構成してAPIコールの実行を開始できます。
## スコープとOAuth 2承認
アプリケーションを承認するためにクライアント側のOAuth 2フローを介してユーザーを送信する際は、承認URLに一連のスコープを追加してユーザーのアクセストークンをさらに制限できます。
たとえば、アプリケーションで`root_readonly`および`root_readwrite`スコープが有効になっている場合は、ユーザーのリダイレクト時にこのスコープを指定することで、ユーザーのアクセストークンを`root_readonly`に制限できます。
```js theme={null}
GET https://account.box.com/api/oauth2/authorize?scope=root_readonly&client_id=....
```
スコープパラメータが省略されている場合、アプリケーションでは、そのアプリケーションの作成時に設定されたスコープが使用されます。
## セルフサービススコープ
これらのスコープは、アプリケーションの設定時に開発者コンソールから使用できます。\[**構成**] タブの \[**アプリケーションスコープ**] セクションに移動して、以下のスコープから1つ以上を選択します。
### すべてのファイルとフォルダの読み取り
| | |
| ---------------- | ----------------------------- |
| **OAuthスコープ** | `root_readonly` |
| **アプリケーションスコープ** | Boxに格納されているすべてのファイルとフォルダの読み取り |
アプリケーションで、認証済みユーザーはすべてのファイル/フォルダを読み取ることができるようになります。
これにより、アプリケーションにはファイルとフォルダに対する読み取り権限が付与されますが、APIコールを実行するユーザーには、アクセス対象の項目に対するアクセス権限が必要です。
つまり、
これを使用すると、アプリケーションでユーザーを管理できますが、クライアント側アプリケーションの場合、使用されるアクセストークンを、適切な権限を持つ管理者または共同管理者に関連付ける必要があります。
さらに、JWTアプリケーションの場合は、
| | |
| ---------------- | ------------------ |
| **OAuthスコープ** | `manage_app_users` |
| **アプリケーションスコープ** | ユーザーを管理する |
アプリケーションには、
これを使用すると、アプリケーションでグループを管理できますが、クライアント側アプリケーションの場合、使用されるアクセストークンを、適切な権限を持つ管理者または共同管理者に関連付ける必要があります。
さらに、JWTアプリケーションの場合は、
### Webhookを管理する
| | |
| ---------------- | ---------------- |
| **OAuthスコープ** | `manage_webhook` |
| **アプリケーションスコープ** | Webhookを管理する |
アプリケーションには、ユーザーのWebhookを作成するための権限が付与されます。Webhookの
これを使用すると、アプリケーションで企業のプロパティを管理できますが、クライアント側アプリケーションの場合、使用されるアクセストークンを、適切な権限を持つ管理者または共同管理者に関連付ける必要があります。
### リテンションポリシーを管理する
| | |
| ---------------- | ------------------------ |
| **OAuthスコープ** | `manage_data_retention` |
| **アプリケーションスコープ** | リテンションポリシーを管理する |
| **依存先** | `enterprise_content`スコープ |
アプリケーションには、Box Governanceでリテンションポリシーを表示および作成するための権限が付与されます。そのため、企業では[Box Governance][governance]を購入しておく必要があります。
このスコープを使用するには、`enterprise_content`スコープも適切に機能する必要があります。これらのスコープをリクエストするには、当社のサポートチャネルでチケットを作成します。
### 署名リクエストを管理する
| | |
| ---------------- | ------------------------- |
| **OAuthスコープ** | `sign_requests.readwrite` |
| **アプリケーションスコープ** | 署名リクエストを管理する |
アプリケーションには、署名リクエストを取得、作成、キャンセル、および再送信するための権限が付与されます。
このスコープでは、アプリケーションに読み取り/書き込みスコープも設定する必要があります。これらのスコープは、有効にしたときに自動的に選択されます。さらに、企業ではSignが有効になっている必要があります。
### Box AI APIを管理する
| | |
| ---------------- | -------------- |
| **OAuthスコープ** | `ai.readwrite` |
| **アプリケーションスコープ** | AIを管理する |
アプリケーションには、Box AI APIにリクエストを送信するための権限が付与されます。
### Box Relayを管理する
| | |
| ---------------- | ----------------- |
| **OAuthスコープ** | `manage_triggers` |
| **アプリケーションスコープ** | Box Relayを管理する |
アプリケーションには、ワークフローを取得し、`WORKFLOW_MANUAL_START`タイプのフローを開始するための権限が付与されます。
このスコープでは、アプリケーションに読み取り/書き込みスコープも設定する必要があります。
## リクエストに応じて使用可能
リクエスト時にのみ使用できる追加のスコープがいくつかあります。これを使用するには、Boxの[サポートチーム](/support)にチケットを送信してください。サポートチームは、個別にリクエストを確認し、ユースケースにスコープが必要な場合にのみ承認を行います。
無料トライアルのアカウントでは、スコープを追加でリクエストすることはできません。以下に示すスコープの有効化についてサポートリクエストを申請する前に、有料のEnterpriseアカウントにログインするか、[無料のDeveloperアカウントをEnterpriseアカウントプランにアップグレード][pricing]してください。
### リーガルホールドを管理する
| | |
| ------------- | ------------------------ |
| **OAuthスコープ** | `manage_legal_holds` |
| **依存先** | `enterprise_content`スコープ |
アプリケーションには、Box Governanceでリテンションポリシーを表示および作成するための権限が付与されます。そのため、会社ではBox Governanceを購入しておく必要があります。
このスコープが適切に機能するには、`enterprise_content`スコープを必要とします。このスコープは、当社のサポートチャネルでチケットを作成してリクエストできます。
### メール通知を抑制する
| | |
| ---------------- | ------------------ |
| **アプリケーションスコープ** | APIコールからメール通知を抑制する |
APIコールが行われるときに、一部の種類の
**副次的影響**
アプリケーションに対してこのスコープを有効にすると、一部のAPIコールの動作が変更されます。その最も顕著な例として、`as-user`ヘッダーを使用してユーザーとして明示的に認証しないとコンテンツを書き込めなくなることが挙げられます。また、このスコープを有効にすると、別の企業のユーザーが所有するコンテンツにはアクセスできなくなります。
そのため、やむを得ない場合を除き、このスコープはプロビジョニングされません。
## ダウンスコープ用のスコープ
特にトークンをクライアント側 (ブラウザなどの公開された環境) に公開する必要がある場合など、アクセストークンをより厳格な権限レベルに