Box の認証

UiPath では、Box に対して以下の認証の種類をサポートしています。詳細については、 Box の認証に関するドキュメントをご覧ください。

認証の種類	説明	最適な用途
OAuth 2.0 の認可コード	ユーザーは Box 経由でログインし、API アクセスを許可します。	個々のユーザー アクセス (有人オートメーションまたは個人オートメーション)
OAuth 2.0 クライアント資格情報	非対話型のサービス間認証。	ユーザーのワークスペース内でのサービス間アクセス。
独自の OAuth 2.0 アプリ (BYOA) を使用する	UiPath のコールバック URL で独自の OAuth アプリを使用します。	独自のBoxアプリとキーを管理する顧客。
個人用アクセス トークン (PAT)	Box JWT 秘密鍵と enterprise/user ID を使用します。	エンタープライズ レベルのサーバー間連携。アプリ専用または企業全体のアクセスでユーザーの操作を介さないアクセスが必要

認証の種類の詳細

OAuth 2.0 の認可コード

フィールド	説明
OAuth API キー	Box クライアント ID。
OAuth API シークレットです。	Box のクライアント シークレットです。
スコープ	Box アプリで構成されているスコープを選択します。

OAuth 2.0 クライアント資格情報

フィールド	説明
OAuth API キー	Box クライアント ID。
OAuth API シークレットです。	Box のクライアント シークレットです。
サブジェクトの種類	"Enterprise" OR "User"
エンタープライズ ID/ユーザー ID	Box Enterprise ID または Box ユーザー ID。
スコープ	Box で設定したスコープと一致する必要があります。

独自の OAuth 2.0 アプリ (BYOA) を使用する

フィールド	説明
OAuth API キー	Box クライアント ID。
OAuth API シークレットです。	Box のクライアント シークレットです。
スコープ	定義済みまたはカスタムの Box スコープ。

重要:

Box アプリでリダイレクト URI を https://{baseURL}/provisioning_/callback に設定します (例: https://cloud.uipath.com/provisioning_/callback)。

個人用アクセス トークン (PAT)

フィールド	説明
OAuth API キー	Box Developer Console の Box クライアント ID 。
OAuth API シークレットです。	Box 開発者コンソールの Box クライアント シークレット 。
スコープ	Box で選択した、オートメーションに必要なスコープです。
JWT オーディエンス	例： https://api.box.com/oauth2/token
JWT の Base64 でエンコードされたキーです。	JWT アプリ構成の Box アプリの Base64 エンコード秘密キー 。
JWT 発行者	JWT のiss要求として使用される Box アプリのクライアント ID。
JWT サブタイプ	目的の偽装ターゲットに基づき 、Enterprise または User である必要があります。
JWT サブジェクト	エンタープライズ ID(サブタイプ = エンタープライズの場合)またはユーザー ID(サブタイプ = ユーザーの場合)。

Box アプリを作成する

UiPath を Box に接続する前に、 Box 開発者コンソールでアプリケーションを作成する必要があります。詳細については、 Box の開発者向けドキュメントをご覧ください。

1. 開発者コンソールを開く
2. [新しいアプリを作成] を選択します
3. 使用する認証の種類に応じて、以下のいずれかを選択します。
   • OAuth 2.0 (ユーザー認証) →認可コードと BYO OAuth に使用されます。
   • クライアント資格情報フローでの OAuth 2.0 →クライアント資格情報フローに使用
   • UiPath IS で PAT に使用される OAuth 2.0 と JWT →

Box アプリを作成したら、以下を収集します。

• クライアント ID
• クライアント シークレット
• アプリのスコープ
• 秘密キー (JWT アプリのみ)
• Enterprise/User ID

重要:

[独自の OAuth 2.0 アプリ (BYOA) を使用する] の場合は、UiPath のコールバック URL を Box アプリに追加します (例: https://cloud.uipath.com/provisioning_/callbackhttps://{baseURL}/provisioning_/callback)。

Box のスコープについて

Box では、「スコープ」と呼ばれる明示的な権限の選択が必要です。次の表に、Box アプリの一般的な定義済みのスコープを示します。

スコープ	説明
root_readonly	ユーザー/アカウントがアクセスできるすべてのコンテンツへの読み取り専用アクセス。
root_readwrite	ファイルとフォルダーへの完全な読み取り/書き込みアクセス権。
manage_groups	Box グループを管理します。
manage_enterprise_properties	エンタープライズのメタデータとプロパティを管理します。
manage_data_retention	保持ポリシーと訴訟ホールドを設定する
sign_requests.readwrite	Box Signリクエストを作成および管理します。
manage_app_users	アプリケーション ユーザーを管理する
manage_managed_users	エンタープライズ管理対象ユーザーを管理する。

Box開発者コンソールには、コネクションの作成時に選択したスコープと同じスコープが反映されている必要があります。スコープについて詳しくは、 Box のドキュメント でスコープをご覧ください。

Boxの秘密鍵を準備する方法

ステップ 1 — 秘密キーをダウンロードする

encrypted_private_keyとパスフレーズを含む Box アプリの JSON ファイルをダウンロードします。

ステップ2—パスフレーズを使用して復号化する

キーが暗号化されている場合は、復号します。

openssl pkcs8 -inform PEM -in private_key.pem -out decrypted_key.pem -passin pass:YOUR_PASSPHRASE

これにより、次の結果が得られます。

-----BEGIN PRIVATE KEY-----
...
-----END PRIVATE KEY-----

ステップ3 - PEMヘッダー/フッターを削除する

次の 2 行を完全に削除します。

-----BEGIN PRIVATE KEY-----
-----END PRIVATE KEY-----

ステップ4—すべての改行と空白を削除する

キーを 1 本の連続した行にし、スペースも改行も含めないようにします。

結果の例: MIIG/wIBADANBgkqhkiG9w0BAQEFAASCBK...

手順 5 — クリーニングされたキーを Base64 エンコードする

単一行キーをエンコードします。

Linux / macOS: echo -n "CLEANED_KEY" | base64

PowerShell: [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("CLEANED_KEY"))

生成されたBase64出力を JWT Base64エンコードキーに貼り付けます。詳細については、Box の認証に関するドキュメントをご覧ください。