【Box】API連携アプリの承認を利用する時の操作手順と制限事項

Boxで外部ツールや社内開発アプリと連携するには、API連携アプリの承認が必要です。しかし、承認ボタンが押せない、アプリが表示されない、エラーメッセージが出るといった問題が発生することがあります。本記事では、BoxのAPI連携アプリ承認に特化して、操作手順と制限事項を整理します。原因を切り分け、次の行動を決めるための情報を提供します。

Box API連携アプリ承認の基本と制限事項

Boxでは、サードパーティ製アプリや社内開発アプリをAPI経由で利用する際、アプリの承認が必要です。承認は管理コンソールから行われ、アプリごとに設定されたスコープ(ファイルの読み取り、書き込み、管理など)に基づいて権限が付与されます。制限事項としては、次のようなものがあります。

• 承認者権限: アプリ承認を行うには、Box管理コンソールの「アプリ承認」タブにアクセスできる共同管理者権限が必要です。通常のユーザー権限では承認できません。
• アプリの種類: カスタムアプリ(社内開発)と公開アプリ(Boxギャラリー掲載)で承認フローが異なります。カスタムアプリは事前に管理者がアプリ登録を行う必要があります。
• スコープの制限: アプリが要求するスコープが組織のポリシーに合わない場合、管理者が手動で変更できる場合があります。ただし、一部のスコープは必須であり、変更できないものもあります。
• 期限設定: アプリ承認には有効期限を設定できるオプションがあります。期限切れ後は再承認が必要です。
• IP制限: 組織のセキュリティポリシーにより、特定のIPアドレスからのみアプリを利用できるように制限されている場合があります。

アプリ承認の操作手順(管理画面編)

ここでは、Box管理コンソールを使ってAPI連携アプリを承認する具体的な手順を説明します。この操作は共同管理者以上の権限を持つアカウントで行ってください。

1. ブラウザでBox管理コンソールにログインします。URLは https://app.box.com/master です。
2. 左側のメニューから「アプリ」をクリックし、次に「アプリ承認」を選択します。
3. 承認したいアプリの種類に応じて、「カスタムアプリ」タブまたは「公開アプリ」タブを開きます。アプリ一覧が表示されない場合は、検索ボックスにアプリ名を入力してください。
4. 該当アプリの右側にあるアクションボタン(歯車アイコン)をクリックし、「承認」を選択します。または、アプリ名をクリックして詳細画面を開き、「承認」ボタンをクリックします。
5. 承認画面で、アプリに付与するアクセス権限(スコープ)を確認します。必要に応じて、各スコープの「許可」チェックボックスをオン/オフします。ただし、一部のスコープは必須で変更できません。
6. 必要に応じて、承認の有効期限を設定します。期限を設定しない場合は「有効期限なし」を選択してください。
7. 設定内容を確認し、「承認」ボタンをクリックして完了です。承認後、アプリは組織内のユーザーが利用できるようになります。

承認後にアプリが正常に動作しない場合は、アプリの設定やスコープを再確認してください。また、アプリ開発者にAPIキーの再発行を依頼する必要がある場合もあります。

カスタムアプリの事前登録が必要なケース

カスタムアプリ(社内アプリ)の場合、アプリ承認の前に、アプリ自体をBoxに登録する必要があります。登録は開発者がBox開発者コンソール(https://developer.box.com)から行います。登録後、管理コンソールの「カスタムアプリ」タブに表示されます。表示されない場合は、アプリのクライアントIDが正しいか、管理者が適切な権限を持っているか確認してください。

ユーザーが承認できない原因の切り分け方

アプリ承認で問題が発生した場合、原因を切り分けるために以下の点を順に確認してください。

• 権限の確認: ログインしているアカウントが共同管理者権限を持っているか確認します。通常のユーザーでは承認ボタンが表示されません。管理者に権限付与を依頼するか、管理者自身が操作してください。
• アプリの表示確認: アプリが「カスタムアプリ」または「公開アプリ」の適切なタブに表示されているか確認します。表示されない場合、アプリが組織にまだ追加されていない可能性があります。公開アプリはBoxギャラリーからインストールが必要な場合があります。カスタムアプリは開発者が登録を完了しているか確認してください。
• 承認ボタンの状態: 承認ボタンがグレーアウトしている場合、そのアプリがすでに承認済みまたは却下済みである可能性があります。一覧でステータスを確認してください。また、アプリが「必須承認」設定になっている場合は、別の管理者が承認する必要があるかもしれません。
• エラーメッセージの確認: エラーメッセージが表示される場合は、その内容をメモしてください。「このアプリは承認できません」というメッセージは、スコープの競合や組織ポリシーによる制限を示していることが多いです。
• ブラウザのキャッシュクリア: まれにブラウザのキャッシュが原因で管理画面の表示が正しく更新されないことがあります。シークレットウィンドウで試すか、キャッシュをクリアして再度ログインしてみてください。

管理者向け:アプリ承認設定の確認ポイント

管理者がアプリ承認に関する設定を確認する際のポイントをまとめます。これらの設定は管理コンソールの「アプリ」→「アプリ設定」で変更できます。

• アプリ承認の必須化: 「すべてのアプリを承認制にする」設定が有効になっているか確認します。無効の場合、ユーザーは管理者承認なしでアプリを利用できてしまいます。セキュリティ強化のために有効を推奨します。
• 許可リスト: 特定のアプリのみを自動承認する許可リストが設定されている場合、リストにないアプリは承認できません。新しいアプリを追加するには、許可リストを編集する必要があります。
• 承認期限: アプリ承認にデフォルトの有効期限を設定している場合、期限切れのアプリは利用不可になります。定期的な再承認が必要な場合は、ユーザーに周知してください。
• 管理者のみ承認: 「管理者のみアプリを承認できる」設定が有効の場合、一般の共同管理者では承認できません。この設定は通常、セキュリティ要件が高い組織で使用されます。
• APIスコープの制限: アプリが要求するスコープを制限するポリシーが設定されていないか確認します。過度に広いスコープを要求するアプリはブロックされることがあります。

比較表:アプリタイプ別の承認フロー

失敗パターンとよくある質問

失敗パターン

• 承認ボタンが押せない(グレーアウト): 原因は主に権限不足。共同管理者権限がないか、アプリがすでに承認済み/却下済み。ステータスを確認し、必要なら上位管理者に依頼。
• アプリが一覧に表示されない: カスタムアプリの場合は開発者が未登録、公開アプリの場合はまだインストールされていない。適切なタブを確認し、公開アプリはギャラリーから追加する。
• 承認後もアプリが使えない: アプリのAPIキーが無効、またはスコープ不足。アプリ開発者に連絡してAPIキーを再発行してもらい、スコープを再確認する。
• 「このアプリは承認できません」エラー: 組織ポリシーで禁止されているスコープを含む場合。管理者にポリシーを確認してもらい、代替アプリを検討する。

よくある質問

Q: 一度承認したアプリの承認を取り消すには?

管理コンソールの「アプリ承認」で該当アプリを選択し、アクションメニューから「承認を取り消す」をクリックします。取り消し後、ユーザーはそのアプリを利用できなくなります。

Q: 承認済みのアプリが突然使えなくなった。何が原因?

考えられる原因として、承認の有効期限切れ、アプリの更新によるスコープ変更、組織ポリシーの変更などがあります。管理コンソールでアプリのステータスを確認し、必要に応じて再承認してください。

Q: 一般ユーザーがアプリを追加しようとすると「管理者に連絡してください」と表示される。

これは「すべてのアプリを承認制にする」設定が有効であることを示します。ユーザーは管理者にアプリ承認を依頼する必要があります。管理者は管理コンソールから該当アプリを承認してください。

Q: アプリ承認の操作を監査ログで確認できますか?

はい。Box管理コンソールの「監査ログ」から、アプリ承認に関するイベント(承認、却下、取り消しなど)を確認できます。不正な承認操作の追跡に役立ちます。

まとめ

BoxのAPI連携アプリ承認で困った場合は、まず自分が適切な権限を持っているか、アプリが正しく表示されているかを確認してください。カスタムアプリと公開アプリでは承認フローが異なるため、アプリの種類に応じた手順を踏む必要があります。管理者向けの設定では、承認の必須化や許可リスト、スコープ制限など、組織のセキュリティポリシーに合わせた調整が可能です。問題が解決しない場合は、エラーメッセージや監査ログをもとに、Boxサポートや社内のシステム管理者に相談することをおすすめします。