Boxの認証エラーを修正する方法 — NetDrive

読了目安 6 分 troubleshooting box
Casey
CaseyProduct Manager
NetDriveのBoxドライブがエラー状態のままマウントできませんか?Boxのトークンが失効する理由と、数分で再認証する方法を解説します。

数週間問題なくマウントできていたBoxドライブが突然赤いエラー表示になったり、Mount をクリックしても読み込みが続いてタイムアウトしたりすることがあります。BoxはOAuth 2.0でNetDriveと接続しており、バックグラウンドで静かに更新されるブラウザセッションとは異なり、失効または期限切れのトークンは手動で再認証するまでドライブが動かなくなります。ここでは最も一般的な2つの原因と、それぞれの解決方法を説明します。

NetDrive drive manager showing Google Drive, S3 and pCloud mounted as drive lettersMounted clouds appearing as native drives in Windows File Explorer

NetDriveでWindowsまたはmacOSにBoxをマウント

NetDrive を使えば Google Drive、OneDrive、S3、SFTP、WebDAV などが Windows と macOS でネイティブドライブとして表示されます — 同期も、まるごとダウンロードも不要です。

  • WindowsではネイティブのドライブレターとしてmacOSではボリュームとしてマウント
  • 公式Box API経由のOAuth認証 — パスワードを平文で保存しない
  • 1つのドライブマネージャーで他のクラウドドライブと併用可能
WindowsmacOS
NetDriveをダウンロード →

無料トライアル。永久ライセンスとサブスクリプションプランあり。

Box接続が切れる理由

NetDriveはOAuth 2.0を使ってBoxに対して認証を行います。ドライブを初めて設定する際にブラウザウィンドウが開き、Boxにサインインしてアクセスを許可すると、BoxがアクセストークンをNetDriveに返し、以降の接続のたびに提示されます。このトークンは、いくつかの特定の理由で動作しなくなります。

  • 手動でのアプリ取り消し。 あなた(またはBox管理者)がBoxのAccount Settings → Appsページを開き、認証済みアプリの一覧からNetDriveを削除した場合、トークンは即座に無効になります。
  • エンタープライズアプリ承認ポリシー。 Boxのエンタープライズアカウントでは、接続を許可するサードパーティOAuthアプリを制限できます。Box管理者がNetDriveを明示的に承認していない場合、認証は一度は成功しても更新時に黙って拒否されることがあります。
  • パスワードまたはセキュリティイベント。 Boxのパスワード変更や、見慣れない場所からのログインをBoxが検知すると、NetDriveを含む接続済みの全アプリで再認証が強制されることがあります。
  • セッションまたはスコープの期限切れ。 長期間有効なトークンでも、いずれは期限が切れます。ドライブが長い間アイドル状態だった場合、保存済みのトークンが単純に古くなりすぎている可能性があります。

切断されたエントリを含む、複数のクラウドドライブがドライブレターとしてマウントされているNetDriveのドライブマネージャー

ステップ1 — 認証の問題かネットワークの問題かを確認する

NetDriveのドライブマネージャーを開き、Boxのエントリを確認します。認証エラーの場合、単にマウントが遅いのではなく、ドライブが切断状態またはエラー状態として表示されます。トークンに手を付ける前に、他のマウント済みドライブも失敗していないか確認してください。Google DriveやS3もタイムアウトしている場合、問題はネットワークかBoxのサービス障害であり、Boxの認証そのものではありません。Boxドライブだけが影響を受けていて、エラー文言が認証(authentication)、認可(authorization)、資格情報(credentials)に言及している場合は、ステップ2に進んでください。

ステップ2 — Boxドライブを再認証する

  1. ドライブ一覧でBoxドライブを選択します — まだマウントを試みないでください。
  2. ドライブ一覧からドライブのEdit画面を開きます(エントリの横にある編集または設定アイコン)。
  3. アカウントまたは認証のセクションを見つけ、再認証を実行します — これによりデフォルトブラウザでBoxのログインページが開きます。
  4. Boxにサインインし、アクセス要求を再度承認します。
  5. ドライブ設定を保存し、NetDriveに戻ります。

Boxのログインページが開かない場合は、企業のプロキシやファイアウォールがデフォルトブラウザをブロックしていないか確認し、再試行の前にbox.comに直接アクセスできることを確認してください。

ステップ3 — ドライブがマウントされることを確認する

ドライブ一覧に戻り、Mountをクリックします。再認証後の最初の接続では10〜15秒ほど待ってください — NetDriveがWindowsエクスプローラーやFinderにドライブを表示する前に、Boxから新しいディレクトリ一覧を取得する必要があります。

再認証直後もまだ失敗する場合は、さらに次の2点を確認してください。

  • 管理者承認待ち。 管理されたBoxエンタープライズ環境では、NetDriveが承認済みサードパーティアプリ一覧に含まれているかをBox管理者に確認してください。ユーザーレベルの再認証では、管理者レベルのブロックを上書きできません。
  • macOSでの古い資格情報キャッシュ。 Keychain Accessを開き、Boxまたはあなたのbdriveアカウントに紐づくエントリを検索し、重複していたり期限切れに見えるものを削除してから、ステップ2を繰り返してください。

Box接続を安定させ続けるには

ドライブがマウントされて正常に動作するようになったら、本当に接続を解除したい場合を除き、BoxのAppsリストからNetDriveを取り消さないようにしてください — 取り消すと、再認証フロー全体をやり直すことになります。組織でBoxを一元管理している場合は、Boxのセキュリティポリシー更新後もNetDriveが承認済みアプリ一覧に残っているかをIT部門に確認してもらってください。こうした更新は、上記のエラーの一般的な原因となるためです。

各プラットフォームでの初期設定については、NetDriveでWindowsにBoxをマウントするまたはNetDriveでmacOSにBoxをマウントするをご覧ください。1つのBoxドライブを複数人で共有するチームは、個々の資格情報を配布せずにドライブを公開できるNetDrive Team Driveもあわせてご確認ください。

— Casey, NetDrive