設定

​

認証方法の選択

​

アプリケーション設定の構成

1. [アプリケーションアクセス] で [アプリアクセスのみ] を選択します。そうすることで、アプリケーションが固有のサービスアカウントコンテンツに制限されます。これは、Box Viewの標準的な構成です。
2. [アプリケーションスコープ] で、少なくとも、以下のオプションを有効にします。
   • [Boxに格納されているすべてのファイルとフォルダの読み取り] (root_readonly)
   • [Boxに格納されているすべてのファイルとフォルダの読み取りと書き込み] (root_readwrite)
3. アプリケーションが (例えばBox UI Elementsを使用して) フロントエンドのブラウザコードからAPIコールを実行する場合は、[構成] タブの下部にあるCORS許可リストにドメインを追加します。
4. [構成] タブから資格情報をコピーします。
   • CCGの場合、[クライアントID] と [クライアントシークレット] をコピーします。シークレットを確認するには、多要素認証が必要です。
   • JWTの場合、公開/秘密キーペアを生成した後にJSON構成ファイルをダウンロードします。

​

アプリケーションの承認

1. 開発者コンソールで [承認] タブに移動します。
2. [確認して送信] をクリックします。企業のBox管理者には、管理コンソールでアプリケーションを承認するためのメールが送信されます。詳細については、Platformアプリの承認ガイドを参照してください。

​

アクセストークンの取得

​

クライアント資格情報許可 (CCG) で認証されるPlatformアプリ

curl -X POST https://api.box.com/oauth2/token \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "grant_type=client_credentials" \
  -d "box_subject_type=enterprise" \
  -d "box_subject_id=YOUR_ENTERPRISE_ID"

{
  "access_token": "c3FIOG9vSGV4VHo4QzAy...",
  "expires_in": 4169,
  "restricted_to": [],
  "token_type": "bearer"
}

from box_sdk_gen import BoxClient, BoxCCGAuth, CCGConfig

auth = BoxCCGAuth(
    config=CCGConfig(
        client_id="YOUR_CLIENT_ID",
        client_secret="YOUR_CLIENT_SECRET",
        enterprise_id="YOUR_ENTERPRISE_ID",
    )
)
client = BoxClient(auth=auth)

​

JWTで認証されるPlatformアプリ

from box_sdk_gen import BoxClient, BoxJWTAuth, JWTConfig

jwt_config = JWTConfig.from_config_file("/path/to/config.json")
auth = BoxJWTAuth(config=jwt_config)
client = BoxClient(auth=auth)

​

クライアント側で使用するトークンのダウンスコープ

curl -X POST https://api.box.com/oauth2/token \
  -d "subject_token=YOUR_ACCESS_TOKEN" \
  -d "subject_token_type=urn:ietf:params:oauth:token-type:access_token" \
  -d "grant_type=urn:ietf:params:oauth:grant-type:token-exchange" \
  -d "scope=item_preview" \
  -d "resource=https://api.box.com/2.0/files/FILE_ID"

​

セキュリティのベストプラクティス

• クライアントシークレットまたはアクセストークン全体をクライアント側のコードで公開しないようにしてください。トークンは、ブラウザに送信する前に常にダウンスコープします。
• 資格情報は安全に保存します。クライアントID、クライアントシークレット、Enterprise IDには、環境変数またはシークレットマネージャを使用してください。
• 企業全体でのコンテンツアクセスが特に必要でない限り、[アプリケーションアクセス] は [アプリアクセスのみ] に設定しておきます。
• 必要なCORSドメインのみを追加します。許可リストは、ブラウザ側のAPIコールを実際に実行するドメインに制限してください。

​

従来のアクセス制限付きアプリ

1. 上記の手順に従って、CCGまたはJWTを使用する新しいPlatformアプリを作成します。
2. コンテンツを新しいアプリのサービスアカウントに再アップロードします。または、コラボレーションを使用して既存のコンテンツを共有します。
3. ハードコードされたアプリトークンを、プログラムによるCCGまたはJWTトークンの取得に置き換えます。
4. ダウンスコープされたトークンのコールを更新します。フローは同じで、の値のみが変わります。