Backblaze B2 인증 오류 해결하기 — NetDrive
버킷으로 제한된 애플리케이션 키, 만료된 키, 잘못 짝지어진 키 쌍 때문에 NetDrive에서 발생하는 Backblaze B2 로그인 실패를 해결하는 방법을 다룹니다.
지난달까지 문제없이 마운트되던 Backblaze B2 드라이브가 갑자기 인증 오류를 던지거나, 완전히 새로 만든 연결이 Backblaze 콘솔에서 그대로 복사해 붙여넣은 자격 증명을 거부하는 경우가 있습니다. 두 경우 모두 계정 자체의 문제라기보다는 B2 애플리케이션 키의 동작 방식에서 비롯되는 경우가 대부분입니다 — B2 키에는 일반적인 아이디·비밀번호 로그인에는 없는 제한 사항과 만료 날짜가 걸려 있기 때문입니다.
Backblaze B2를 드라이브 문자로 마운트
NetDrive 는 Google Drive, OneDrive, S3, SFTP, WebDAV 등을 Windows 와 macOS 에서 일반 드라이브처럼 보이게 합니다 — 동기화도, 전체 다운로드도 없이.
- 대용량 아카이브 파일을 위한 멀티파트 업로드
- 전송 중에도 드라이브가 반응하도록 유지하는 백그라운드 업로드
- Windows, macOS, Linux(실험적)에서 사용 가능
무료 체험. 평생 라이선스와 구독 플랜 제공.
오류를 원인에 매핑하기
Backblaze B2는 버전 3.5.434부터 NetDrive 연결을 지원해왔으며, 인증 실패는 거의 대부분 다음 패턴 중 하나에 해당합니다:
| 증상 | 가장 유력한 원인 |
|---|---|
| 특정 버킷을 지목하는 “Access denied” 또는 “unauthorized” | 애플리케이션 키가 입력한 버킷과 다른 버킷으로 제한되어 있음 |
| 이전까지 잘 작동하던 자격 증명이 갑자기 실패함 | 애플리케이션 키가 만료되었거나 Backblaze 콘솔에서 삭제됨 |
| 복사해 붙여넣은 keyID와 key가 곧바로 거부됨 | 여분의 공백, 잘린 붙여넣기, 또는 여러 키 목록에서 잘못된 키 쌍을 복사함 |
수정 1: 애플리케이션 키의 버킷 제한 확인하기
Backblaze는 계정이 원래의 Master Application Key 외에도 여러 개의 Application Key를 만들 수 있게 해주며, 각 범위 지정 키는 보안을 위해 하나의 버킷으로 제한될 수 있습니다. 이는 올바른 관행입니다 — 하나의 버킷 전용 NetDrive 연결이 계정 전체 권한을 가진 키를 사용해서는 안 되기 때문입니다 — 하지만 이는 NetDrive에 입력하는 버킷 이름이 그 키가 생성된 버킷과 정확히 일치해야 한다는 뜻이기도 하며, 그렇지 않으면 마치 잘못된 자격 증명인 것처럼 보이는 오류로 연결이 실패합니다.
Backblaze B2 콘솔에 로그인해 키의 Allowed Bucket(s) 설정을 확인하세요. 특정 버킷이 지정되어 있다면, 그 이름이 NetDrive의 드라이브 설정에 입력한 버킷 이름과 정확히 일치하는지 확인하세요 — B2 버킷 이름은 대소문자를 구분하므로 대소문자와 하이픈 표기까지 중요합니다.
수정 2: 만료되거나 삭제된 키 재생성하기
B2의 애플리케이션 키는 만료 날짜를 설정해 만들 수 있으며, 그 날짜가 지나면 키는 NetDrive 안에서 아무런 경고 없이 인증을 멈춥니다 — 드라이브가 그냥 더 이상 로그인되지 않는 것입니다. Backblaze 콘솔에서 키를 직접 삭제하거나 취소한 경우에도 동일한 현상이 나타나며, NetDrive 쪽에서 보면 만료와 똑같이 보입니다.
- Backblaze 콘솔에서 새 Application Key를 생성하세요 (또는 기존 키가 만료/삭제로 표시되는지 확인하세요).
- 새 keyID와 applicationKey를 즉시 복사하세요 — Backblaze는 생성 시점에 전체 애플리케이션 키를 단 한 번만 보여줍니다.
- NetDrive에서 Drive Manager를 열고 B2 드라이브를 선택한 뒤 Edit을 클릭해 keyID와 applicationKey 필드를 새 값으로 교체하세요.
- Connect를 클릭해 다시 인증하세요.
수정 3: 복사-붙여넣기 조각 대신 자격 증명을 다시 입력하기
B2 애플리케이션 키는 길고 무작위로 생성된 문자열이기 때문에, 흔한 실패 원인은 키의 일부만 복사하는 것입니다 — 마지막 글자를 놓치는 트리플 클릭이나 의도치 않은 줄바꿈이 포함된 붙여넣기 등이 그렇습니다. Backblaze는 전체 applicationKey를 단 한 번만 보여주므로, 나중에 저장된 복사본을 콘솔과 대조해 검증할 방법이 없습니다.
설정 직후 자격 증명이 실패하는데 버킷 제한과 만료 여부가 모두 문제없다면, 가장 안전한 방법은 잘렸을 가능성이 있는 키를 디버깅하려 하기보다 완전히 새로운 애플리케이션 키를 생성하는 것입니다:
- Backblaze 콘솔에서 기존 키를 삭제하세요.
- 올바른 버킷으로 범위가 지정된 새 Application Key를 생성하세요.
- keyID와 applicationKey를 먼저 일반 텍스트 필드에 붙여넣어 공백이나 줄바꿈이 섞이지 않았는지 확인한 뒤, NetDrive의 연결 필드에 입력하세요.
어떤 방법도 통하지 않을 때
버킷 제한이 일치하고 키도 만료되지 않았는데 새로 생성한 키마저 실패한다면, 계정 자체에 결제 문제나 인증 보류가 걸려 있지 않은지 확인하세요 — B2는 개별 키의 유효성과 무관하게 계정 수준에서 API 호출을 거부할 수 있으며, 이는 NetDrive에서 동일한 일반적인 인증 실패로 나타납니다.
마무리
NetDrive에서 발생하는 대부분의 Backblaze B2 인증 실패는 잘못된 버킷을 가리키는 버킷 제한 키, 만료되거나 삭제된 키, 또는 긴 applicationKey 문자열의 손상된 복사-붙여넣기 중 하나로 귀결됩니다. 이 문제 해결의 바탕이 되는 초기 설정은 Windows에서 NetDrive로 Backblaze B2 마운트하기 또는 macOS에서 NetDrive로 Backblaze B2 마운트하기를 참고하세요. 비슷한 오브젝트 스토리지 설정에서 Amazon S3를 사용한다면, NetDrive에서 S3 Access Denied 오류 해결하기에서 동일한 문제의 IAM 권한 쪽을 다룹니다.
— Kai, NetDrive