Alibaba Cloud 인증 오류 해결하기 — NetDrive
OSS 버킷을 마운트할 때 NetDrive가 Alibaba Cloud 자격 증명을 거부하나요? 액세스 키, RAM 권한, 엔드포인트, 버킷 이름을 확인한 뒤 드라이브를 다시 연결하세요.
지난주까지 Alibaba Cloud 버킷을 문제없이 마운트하던 빌드 서버에서 NetDrive가 자격 증명 오류를 표시하고, 드라이브에서 아티팩트를 읽는 야간 작업은 첫 번째 파일에서 실패합니다. 머신에는 아무 변경도 없었습니다. Alibaba Cloud 드라이브 인증이 멈췄다면 원인은 거의 항상 네 가지 중 하나입니다. 액세스 키, 그 뒤에 있는 권한, 엔드포인트, 버킷 이름입니다. 이 가이드는 문제를 가장 빨리 찾을 수 있는 순서로 하나씩 짚어 봅니다.
Alibaba Cloud 드라이브를 되찾으세요
NetDrive 는 Google Drive, OneDrive, S3, SFTP, WebDAV 등을 Windows 와 macOS 에서 일반 드라이브처럼 보이게 합니다 — 동기화도, 전체 다운로드도 없이.
- 마운트 전에 자격 증명을 테스트
- Drive Manager에서 모든 드라이브의 상태 확인
- 마운트 설정을 잃지 않고 다시 연결
무료 체험. 평생 라이선스와 구독 플랜 제공.
바꾸기 전에 오류부터 읽기
Alibaba Cloud 드라이브를 저장하면 NetDrive가 연결을 테스트하고, 자격 증명에 문제가 있으면 새 드라이브 카드 대신 인라인 메시지가 표시됩니다. 이 메시지가 첫 번째 단서입니다. 키가 거부되었다면 Access Key ID나 시크릿이 원인입니다. 권한 관련 거부라면 키 뒤에 있는 RAM 사용자가 원인입니다. 버킷에 아예 연결하지 못한다면 대개 엔드포인트나 버킷 이름이 원인입니다.
필드를 수정하기 전에 어떤 경우인지 먼저 적어 두세요. 여러 항목을 한꺼번에 바꾸면 무엇이 문제를 해결했는지 알 수 없습니다.
확인 1: 액세스 키 쌍
NetDrive는 Access Key ID와 그에 맞는 시크릿을 요구합니다. 가장 흔한 실패 원인은 더 이상 작동하지 않는 키 쌍입니다.
- Alibaba Cloud 콘솔에 로그인하여 해당 키를 소유한 RAM 사용자를 엽니다.
- 키가 아직 목록에 있고 상태가 비활성이 아닌 활성인지 확인합니다.
- 키를 교체했다면 NetDrive에 저장된 이전 키 쌍은 사용할 수 없습니다. 새 키 쌍을 만들고 두 값을 즉시 복사하세요. 시크릿은 한 번만 표시됩니다.
- 새 값을 드라이브 설정에 붙여 넣습니다. 복사할 때 끝에 공백이 딸려오기 쉬우니 확인하세요.
삭제된 RAM 사용자에 속한 키도 비활성화된 키와 똑같이 실패하므로 사용자가 아직 존재하는지 확인하세요.
확인 2: RAM 권한
유효한 키라도 RAM 사용자에게 버킷에 대한 권한이 없으면 거부될 수 있습니다. 일상적인 마운트에는 계정의 루트 키 대신 RAM 사용자를 사용하고, 그 정책이 마운트하려는 특정 버킷에 대한 접근을 허용하는지 확인하세요. 드라이브에 파일을 쓸 일이 있다면 읽기 전용 권한으로는 탐색은 되지만 첫 저장에서 실패합니다.
최근에 정책을 강화했다면 그것이 가장 유력한 원인입니다. 오류가 시작되기 전에 하던 작업과 정책을 비교해 보세요.
확인 3: 엔드포인트와 버킷 이름
Alibaba Cloud 엔드포인트는 리전별로 다릅니다. 예를 들어 항저우는 oss-cn-hangzhou.aliyuncs.com입니다. 한 리전의 버킷은 다른 리전의 엔드포인트에서 응답하지 않으므로, 엉뚱한 프로젝트에서 복사해 붙여 넣으면 인증 실패처럼 보이는 오류가 생깁니다. 콘솔에서 버킷의 Overview 페이지를 열고 거기서 엔드포인트를 복사하세요.
그런 다음 Bucket 필드를 콘솔과 한 글자씩 비교하세요. 버킷 이름은 정확해야 합니다. 한 글자만 틀려도, 또는 버킷을 삭제한 뒤 다른 리전에 다시 만들었어도 잘못된 키와 같은 증상이 나타납니다.
드라이브 다시 연결하기
잘못된 필드를 고쳤다면 다음 순서로 진행하세요.
- NetDrive를 열고 Drive Manager에서 Alibaba Cloud 드라이브를 찾습니다.
- 드라이브 설정을 열어 키, 시크릿, 엔드포인트 또는 버킷을 업데이트합니다.
- Test를 클릭하고 NetDrive가 버킷에 접근할 수 있다고 확인할 때까지 기다립니다.
- 저장한 다음 카드에서 드라이브를 연결합니다.
기존 항목을 수정해도 오류가 사라지지 않으면 드라이브를 제거하고 Add Drive 대화상자에서 콘솔에서 확인한 값으로 다시 추가하세요. 새 항목으로 만들면 오래된 저장 값이 원인에서 제외됩니다.
인증은 통과했는데 마운트가 실패할 때
Test는 성공했는데도 드라이브가 나타나지 않는다면 문제는 자격 증명 단계를 넘어선 것입니다. Windows에서 드라이브 문자가 이미 사용 중인 경우가 흔한 원인이며, Fix Drive Letter Already in Use를 참고하세요. 연결 후 폴더가 비어 있거나 오래된 내용으로 보인다면 Force Folder Refresh에 설명된 수동 새로 고침을 시도해 보세요.
마무리
Alibaba Cloud 인증 오류는 체크리스트로 다루세요. 키, 권한, 엔드포인트, 버킷 순서입니다. 한 번에 하나씩 고치고, 변경할 때마다 Test를 사용하고, Drive Manager에서 다시 연결하세요. 처음 설정하는 전체 과정은 Mount Alibaba Cloud on Windows with NetDrive를 참고하세요. 자매 서비스를 사용한다면 Mount Tencent Cloud on Windows에서 같은 흐름을 다룹니다.
— Steve, NetDrive