Google Cloud Storage 인증 오류 해결 — NetDrive

KaiJunior Engineer

NetDrive에서 Google Cloud Storage에 로그인되지 않거나 버킷이 보이지 않나요? IAM 역할, 해제된 Google 접근 권한, 오래된 자격 증명을 확인한 뒤 드라이브를 다시 연결하세요.

렌더 노드 한 대가 몇 주째 Google Cloud Storage 버킷의 G:\를 읽어 왔는데, 오늘 아침 드라이브가 다시 연결되지 않습니다. 또는 새 팀원이 NetDrive에 버킷을 추가하고 로그인까지 성공했는데 목록이 비어 있습니다. 둘 다 NetDrive의 결함처럼 보이지만, 대개 원인은 Google 쪽에 있습니다. 로그인한 계정에 허용된 작업이 무엇인지, 또는 NetDrive가 가진 인증을 Google이 여전히 인정하는지의 문제입니다.

NetDrive drive manager showing Google Drive, S3 and pCloud mounted as drive letters

Mounted clouds appearing as native drives in Windows File Explorer

GCS 버킷을 마운트한 상태로 안정적으로 사용

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

Google Cloud Storage 버킷을 드라이브 문자 또는 볼륨으로 마운트
Drive Manager에서 모든 드라이브의 연결 상태 확인
마운트 지점을 바꾸지 않고 드라이브 재연결

WindowsmacOS

NetDrive 다운로드 →

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

먼저 증상을 구분하세요

GCS 인증 문제는 두 가지로 나뉘며, 해결 방법이 서로 다릅니다.

로그인 자체가 실패하거나 거부됨. 드라이브에 인증 오류가 표시되거나 브라우저 로그인이 끝나지 않습니다. 해제된 권한 부여, Google 계정의 비밀번호 또는 보안 변경, 오래된 저장 자격 증명을 의심하세요.
로그인은 되지만 버킷이 보이지 않거나 접근이 거부됨. Google은 계정을 받아들였지만 그 계정에 버킷 권한이 없는 경우입니다. NetDrive가 아니라 IAM의 문제입니다.

무엇이든 바꾸기 전에 어느 쪽인지 확인하세요. 드라이브를 다시 연결해도 없는 IAM 역할이 생기지 않고, IAM을 고쳐도 해제된 인증은 복구되지 않습니다.

연결된 드라이브의 상태를 보여 주는 NetDrive Drive Manager

확인 1: 버킷에 대한 계정의 역할

Google Cloud 콘솔에서 버킷을 소유한 프로젝트를 열고, 로그인에 사용한 계정의 IAM 역할을 확인하세요. Windows용 Google Cloud Storage 설정 가이드에서 다룬 것처럼 읽기 전용 접근에는 Storage Object Viewer로 충분하고, 쓰기에는 Storage Object Admin이 필요합니다.

다음 두 가지 상황에서 자주 막힙니다.

계정이 프로젝트에는 역할이 있지만 특정 버킷에는 없거나, 버킷이 자체 접근 설정을 사용합니다.
드라이브를 처음 설정한 뒤 누군가 역할을 바꿔서, 지난달에는 되던 쓰기가 지금은 실패합니다.

로그인에 성공했는데 NetDrive가 버킷을 하나도 표시하지 않는다면 가장 먼저 여기를 보세요. 무인 운영 머신에는 마운트가 특정인의 로그인에 의존하지 않도록 전용 서비스 계정을 사용하세요.

확인 2: Google 계정 자체의 상태

비밀번호 변경, 의심스러운 로그인 감지로 인한 강제 로그아웃, 연결된 앱 검토 같은 일이 기존 인증을 무효로 만들 수 있습니다. 브라우저에서 Google 계정에 로그인해 서드파티 접근 설정을 확인하세요. NetDrive 항목이 없다면 접근 권한이 해제된 것이며, 다시 연결하면 해결됩니다.

드라이브 인증을 갱신한 뒤 마운트 상태 확인

NetDrive에서 드라이브 다시 연결

다시 연결하면 저장된 자격 증명이 새 인증으로 교체됩니다. 마운트 지점과 나머지 드라이브 설정은 그대로 유지됩니다.

NetDrive를 열고 Drive Manager에서 Google Cloud Storage 드라이브를 찾습니다.
드라이브 설정을 열어 re-authenticate 또는 reconnect를 선택합니다.
브라우저에서 Google 로그인을 마치고 접근을 승인합니다.
Test를 클릭해 NetDrive가 버킷에 도달할 수 있는지 확인합니다.
Drive Manager에서 드라이브를 다시 마운트합니다.

그래도 오류가 사라지지 않으면 Drive Manager에서 드라이브를 제거한 뒤 다시 추가하세요. 손상된 인증을 갱신하는 대신 완전히 새로운 인증을 받게 됩니다.

인증이 문제가 아닐 때

Test가 통과하는데 이후 파일이 이상해 보인다면 원인은 로그인 이후 단계로 넘어간 것입니다. 폴더 목록이 오래된 것처럼 보이면 수동 새로 고침으로 해결됩니다. NetDrive에서 폴더 강제 새로 고침을 참고하세요. 쓰기에서만 실패한다면 위의 IAM 역할로 돌아가세요.

마무리

NetDrive의 GCS 인증 오류는 대부분 NetDrive가 아니라 Google 쪽에서 옵니다. 버킷을 포함하지 않는 역할, 또는 Google이 더 이상 인정하지 않는 인증입니다. 증상을 구분하고, 역할을 확인하고, 계정 상태를 점검한 뒤 Drive Manager에서 다시 연결하세요. 다른 프로바이더의 비슷한 로그인 문제는 Azure File Storage 인증 오류 해결과 Backblaze B2 인증 오류 해결을 참고하세요.

— Kai, NetDrive