Box 인증 오류 해결하기 — NetDrive

몇 주간 문제없이 마운트되던 Box 드라이브가 갑자기 빨간색 오류 표시를 보이거나, Mount를 클릭해도 계속 돌기만 하다가 시간 초과됩니다. Box는 OAuth 2.0을 통해 NetDrive와 연결되는데, 백그라운드에서 조용히 갱신되는 브라우저 세션과 달리, 취소되거나 만료된 토큰은 직접 재인증하기 전까지 드라이브를 멈춘 상태로 둡니다. 이 글에서는 가장 흔한 두 가지 원인과 각각의 해결 방법을 다룹니다.

NetDrive로 Windows나 macOS에서 Box 마운트하기

NetDrive 는 Google Drive, OneDrive, S3, SFTP, WebDAV 등을 Windows 와 macOS 에서 일반 드라이브처럼 보이게 합니다 — 동기화도, 전체 다운로드도 없이.

• Windows에서는 네이티브 드라이브 문자로, macOS에서는 볼륨으로 마운트
• 공식 Box API를 통한 OAuth 인증 — 비밀번호를 평문으로 저장하지 않음
• 하나의 드라이브 관리자에서 다른 클라우드 드라이브와 함께 사용 가능

WindowsmacOS

NetDrive 다운로드 →

무료 체험. 평생 라이선스와 구독 플랜 제공.

Box 연결이 끊어지는 이유

NetDrive는 OAuth 2.0을 사용해 Box에 인증합니다. 드라이브를 처음 설정할 때 브라우저 창이 열리고, Box에 로그인해 접근을 승인하면 Box가 액세스 토큰을 반환하며, NetDrive는 이를 저장해 이후 모든 연결에 사용합니다. 이 토큰이 더 이상 작동하지 않는 데는 몇 가지 구체적인 이유가 있습니다.

• 수동 앱 취소. 사용자(또는 Box 관리자)가 Box의 Account Settings → Apps 페이지에서 NetDrive를 승인된 앱 목록에서 제거하면 토큰은 즉시 무효화됩니다.
• 엔터프라이즈 앱 승인 정책. Box 엔터프라이즈 계정은 어떤 서드파티 OAuth 앱이 연결을 허용받는지 제한할 수 있습니다. Box 관리자가 NetDrive를 명시적으로 승인하지 않았다면, 인증 단계가 처음에는 성공하더라도 갱신 시 조용히 차단될 수 있습니다.
• 비밀번호 또는 보안 이벤트. Box 비밀번호 변경이나, Box가 낯선 위치에서의 로그인을 감지한 경우, NetDrive를 포함한 연결된 모든 앱에 대해 재인증이 강제될 수 있습니다.
• 세션 또는 권한 범위 만료. 장기 유효 토큰도 결국은 만료됩니다. 드라이브가 오랫동안 사용되지 않았다면, 저장된 토큰이 단순히 너무 오래돼 사용할 수 없는 상태일 수 있습니다.

1단계 — 네트워크 문제가 아닌 인증 문제인지 확인하기

NetDrive의 드라이브 관리자를 열어 Box 항목을 확인합니다. 인증 실패는 단순히 마운트가 느린 것이 아니라 드라이브가 연결 끊김 또는 오류 상태로 표시됩니다. 토큰을 건드리기 전에 다른 마운트된 드라이브도 함께 실패하는지 확인하세요. Google Drive나 S3도 시간 초과된다면 문제는 Box 인증 자체가 아니라 네트워크나 Box 서비스 장애입니다. Box 드라이브만 영향을 받고 오류 문구에 인증(authentication), 승인(authorization), 자격 증명(credentials) 등이 언급된다면 2단계로 넘어가세요.

2단계 — Box 드라이브 재인증하기

1. 드라이브 목록에서 Select the Box drive를 선택합니다 — 아직 마운트를 시도하지 마세요.
2. 드라이브 목록에서 Open the drive’s Edit panel을 엽니다(항목 옆의 편집 또는 설정 아이콘).
3. 계정 또는 인증 섹션을 찾아 재인증을 실행합니다 — 이렇게 하면 기본 브라우저에서 Box 로그인 페이지가 열립니다.
4. Sign in to Box하고 접근 요청을 다시 승인합니다.
5. 드라이브 설정을 Save한 다음 NetDrive로 돌아갑니다.

Box 로그인 페이지가 열리지 않는다면, 회사 프록시나 방화벽이 기본 브라우저를 차단하고 있는지 확인하고, 다시 시도하기 전에 box.com에 직접 접속할 수 있는지 확인하세요.

3단계 — 드라이브가 마운트되는지 확인하기

드라이브 목록으로 돌아가 Mount를 클릭합니다. 재인증 후 첫 연결에서는 10~15초 정도 기다려 주세요 — NetDrive가 드라이브를 Windows 탐색기나 Finder에 표시하기 전에 Box로부터 새 디렉터리 목록을 받아와야 합니다.

재인증 직후에도 계속 실패한다면 다음 두 가지를 추가로 확인하세요.

• 관리자 승인 대기 중. 관리형 Box 엔터프라이즈 환경이라면 Box 관리자에게 NetDrive가 승인된 서드파티 앱 목록에 있는지 문의하세요. 사용자 수준의 재인증으로는 관리자 수준의 차단을 우회할 수 없습니다.
• macOS의 오래된 자격 증명 캐시. Keychain Access를 열어 Box나 Bdrive 계정과 연결된 항목을 검색하고, 중복되거나 만료된 것처럼 보이는 항목을 삭제한 뒤 2단계를 반복하세요.

Box 연결을 안정적으로 유지하기

드라이브가 마운트되어 정상 작동하면, 완전히 연결을 끊을 의도가 아닌 한 Box의 Apps 목록에서 NetDrive를 취소하지 마세요 — 그렇게 하면 전체 재인증 과정을 다시 거쳐야 합니다. 조직에서 Box를 중앙 관리한다면, Box 보안 정책이 업데이트된 후에도 NetDrive가 승인된 앱 목록에 남아 있는지 IT 부서에 확인을 요청하세요. 이러한 업데이트가 위에서 설명한 오류들의 흔한 발생 원인이기 때문입니다.

각 플랫폼의 초기 설정 방법은 NetDrive로 Windows에서 Box 마운트하기 또는 NetDrive로 macOS에서 Box 마운트하기를 참고하세요. 여러 사람이 하나의 Box 드라이브를 공유하는 팀이라면 NetDrive Team Drive도 확인해 보세요. 개별 자격 증명을 배포하지 않고도 팀원에게 드라이브를 게시할 수 있습니다.

— Casey, NetDrive