Boxコネクタ > Boxの接続 > Boxへの接続

Boxへの接続

Boxに接続するようにBoxの接続プロパティを設定してみましょう。

始める前に

開始する前に、BoxアカウントのOAuthを設定する必要があります。

OAuthを設定する場合は、redirect_URIパラメータを指定します。Boxは、Box接続の認証URLで渡されたredirect_uriパラメータが、アプリケーション用に設定されたリダイレクトURIと一致することを確認します。

Box接続を設定する場合は、接続でアクセストークンを自動生成するか、手動でトークンを生成するかを選択することができます。トークン生成プロセスを自分で処理する場合は、BoxでOAuthの設定時に、アクセストークンと、認証タイプ、クライアントID、クライアントシークレットを手動で生成することができます。

BoxにアクセスするためのOAuthの設定方法の詳細については、Boxのマニュアルを参照してください。

次のビデオでは、Box接続の設定時にOAuthアクセストークンを自動生成する方法について説明します。

接続の詳細

次の表に、基本接続プロパティを示します。

財産	説明
接続名	接続の名前。各接続名は組織内で一意である必要があります。接続名には、英数字、スペース、および次の特殊文字を含めることができます。_ .+ -, 最大長は255文字です。
説明	接続の説明。最大長は4000文字です。
シークレットコンテナの使用	組織に対して設定されているSecrets Managerにこの接続の機密資格情報を保存します。このプロパティは、組織にSecrets Managerが設定されている場合にのみ表示されます。接続でシークレットコンテナを有効にすると、Secure AgentがSecrets Managerからどの資格情報を取得するかを選択できます。このオプションを無効にした場合、資格情報は組織の設定方法に応じてリポジトリまたはローカルSecure Agentに保存されます。注: この接続を使用してプッシュダウンまたはプロキシサービスを介してデータアクセスポリシーを適用する場合、シークレットコンテナ設定オプションを使用することはできません。 Secrets Managerを設定および使用する方法については、Secrets manager configurationを参照してください。
ランタイム環境	タスクを実行するランタイム環境の名前。 Secure Agent、ホステッドエージェント、サーバーレスランタイム環境、またはエラスティックランタイム環境を選択します。ホステッドエージェントは、詳細モードのマッピングには適用されません。ランタイム環境の設定および使用方法の詳細については、Administratorのヘルプにある「ランタイム環境」を参照してください。
アクセストークンタイプ	エンドポイントサーバー内のリソースへのアクセスを認証および承認するためのアクセストークン。次のオプションから選択できます。 - 自動生成。［トークンの取得］をクリックすると、Boxは接続でアクセストークンを自動生成します。 - 手動。BoxアカウントからOAuthの詳細を取得し、接続に詳細を手動で入力します。デフォルトは［自動生成］です。

アクセストークンの自動生成

デフォルトでは、接続が自動生成されるように選択されています。

次の表に、Boxからアクセストークンを自動生成するために必要なプロパティとアクション、およびその説明を示します。

プロパティ

説明

OAuthアクセストークン

Boxによって生成されるアクセストークン。

［トークンの取得］をクリックすると、アクセストークンがBoxによって生成され、このフィールドが自動的に入力されます。

詳細については、OAuthアクセストークンの生成を参照してください。視覚的なプレゼンテーションについては、Generating the access token videoを確認してください。

手動でのアクセストークンの生成

OAuthプロパティを手動で入力するには、［アクセストークンタイプ］で［手動］を選択し、必要なプロパティを入力します。

次の表に、Boxに手動で接続する必要があるOAuthプロパティとその説明を示します。

プロパティ	説明
アクセストークン	手動で生成したOAuthアクセストークンの値をBoxに入力します。
クライアントID	Boxでアプリケーション登録プロセス中にクライアントに発行されるクライアント識別子。
クライアントシークレット	Boxでアプリケーション登録プロセス中にクライアントに発行されるクライアントシークレットキー。
認証タイプ	Boxに接続する認証タイプ。文字列refresh_tokenを入力します。
更新トークン	リフレッシュトークンの値を入力します。アクセストークンの有効期限が切れた場合は、リフレッシュトークンを使用して新しいアクセストークンを生成できます。注: 手動アクセストークンタイプを使用しており、更新トークンの有効期限が切れた場合は、接続プロパティを再入力する必要があります。

詳細設定

次の表に、詳細接続のプロパティを示します。

プロパティ	説明
URI要求パラメータ	Box内のファイルまたはフォルダを検索するためのパラメータ。検索文字列は以下の書式で指定します。 query=search_string;content_types=<name\|description\|file_content\|comments\|tags;limit=<number>;offset=<number> 例えば、「generate」という語を含むオブジェクトを検索するには、query=generate;content_types=name;limit=0;offset=0という文字列を入力します。ワイルドカード文字を使用し、語句または複数のクエリ文字列を二重引用符で囲むことで、検索条件を絞り込むことができます。詳細については、「URI要求パラメータ」を参照してください。
ソースファイルのパス	このプロパティは、Box接続には適用されません。
ターゲットファイルのパス	オプション。BoxからオブジェクトをダウンロードできるSecure Agentマシン上のディレクトリ。ファイルまたはフォルダを特定のディレクトリにダウンロードするためのパスを入力します。デフォルトでは、Secure AgentマシンのルートディレクトリにすべてのBoxオブジェクトがダウンロードされます。
応答フォルダのパス	このプロパティは、Box接続には適用されません。
［BoxファイルIDまたはBoxフォルダID］	データの読み取りまたは書き込み先となる、Box内のファイルまたはフォルダのファイルIDまたはフォルダID。ファイルIDまたはフォルダIDは、ファイルまたはフォルダのBox URLから取得することができます。例えば、Boxの［レポート］フォルダのURLはhttps://app.box.com/folder/50016834230です URLの50016834230は、レポートのフォルダIDです。注: この値は、BoxでCSVファイルの読み取りまたは書き込みを行うときに上書きすることができます。