Box の認証

OAuth 2.0 またはその他のサポートされている認証の種類を使用して Automation Suite で UiPath を Box に接続し、Box アプリで必要なリダイレクト URI を構成します。

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

認証の種類	説明	最適な用途
独自の OAuth 2.0 アプリ (BYOA) を使用する	UiPath のコールバック URL で独自の OAuth アプリを使用します。	独自のBoxアプリとキーを管理する顧客。
個人用アクセス トークン (PAT)	Box JWT 秘密鍵と enterprise/user ID を使用します。	エンタープライズ レベルのサーバー間連携。アプリ専用または企業全体のアクセスでユーザーの操作を介さないアクセスが必要

認証の種類の詳細

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

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

重要:

Box アプリでこのリダイレクト URI を構成します: https://{yourDomain}/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 に使用されます。
   • UiPath IS で PAT に使用される OAuth 2.0 と JWT →

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

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

重要:

[独自の OAuth 2.0 アプリ (BYOA) を使用する] で、UiPath のコールバック URL ( https://{yourDomain}/provisioning_/callbackを Box アプリに追加します。

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 の認証に関するドキュメントをご覧ください。

Box コネクションを追加する

1. 左側のレールから [Integration Service] を選択します。
2. [ コネクタ] のリストから [Box] を選択します。検索バーで検索して、表示されるコネクタの数を絞ることもできます。
3. [ Box に接続] を選択します。
4. これで、コネクションのページに移動します。
5. 必要な資格情報を入力します。
6. [接続] を選択します。

権限

アカウントが Box にアクセスまたは接続できるようにする必要があります。 そうでない場合は、管理者に連絡して、必要なアクセス権を要求してください。

Box アカウントにアクセスすると、UiPath for Box で以下の操作を実行できます。

• Box に格納されているすべてのファイルやフォルダーの読み込み
• Box に格納されているすべてのファイルやフォルダーの読み込みおよび書き込み
• グループの管理
• エンタープライズ プロパティの管理
• 保持ポリシーの管理
• 連携の有効化
• 署名リクエストの管理
• アプリのユーザーの管理
• ユーザーの管理
• 請求可能な Box 署名リクエストを生成します。

詳細については、 Box の認証に関するドキュメントをご覧ください。