DOCKER HUB 계정 가이드

Docker Hub 2단계 인증 설정 방법

2단계 인증은 Docker Hub를 포함한 개인 Docker 계정을 보호합니다. 설정 전에 이메일 인증을 완료하고 계정 비밀번호를 준비하세요. 발급되는 복구 코드 하나를 안전하게 보관하세요.

Docker 계정 설정 열기

  1. Docker에 로그인하고 프로필 사진을 클릭한 뒤 Account settings → 2FA를 선택하세요.
  2. 비밀번호를 확인하세요.
  3. 계속하기 전에 복구 코드를 복사하거나 다운로드 또는 인쇄하세요. 휴대폰과 별도로 안전하게 보관하세요.

Sign In에 Docker 추가하기

iPhone에서 코드를 생성하는 저희 인증 앱 Sign In을 사용할 수 있습니다.

  1. 다른 화면에 설정 QR 코드를 띄운 상태에서 Sign In을 열고 Add → Scan QR Code를 탭하세요.
  2. 코드를 스캔하고 계정 정보를 확인한 다음 Add Account를 탭하세요.
  3. Docker의 Authentication code 필드에 현재 6자리 코드를 입력한 후 Enable 2FA를 선택하세요.

수동 설정을 위해 Docker의 Text Code 탭을 열거나 스캔을 위해 QR Code 탭을 사용하세요. Sign In에서 Add → Enter Setup Key를 선택하고, Service를 Docker로, Account를 본인 계정 이름으로 설정한 다음, 비밀 키를 Key에 붙여넣고 Add Account를 탭하세요. 이 키는 다른 사람에게 공개하지 마세요.

인증 앱을 사용할 수 없는 경우

비밀번호를 입력한 뒤 I’ve lost my authentication device를 선택하세요. 복구 코드를 입력하고 Verify를 선택하세요.

이 과정을 마치면 해당 복구 코드는 다시 사용할 수 없으며 2단계 인증도 해제됩니다. 계정에 다시 접근할 수 있게 되면 즉시 새 기기로 인증을 설정하고 새 복구 코드를 저장하세요. 인증 앱과 복구 코드를 모두 잃어버렸다면 Docker 지원팀에 문의하세요.

아직 계정에 접근할 수 있다면 2단계 인증 설정의 Generate new code에서 잃어버린 복구 코드를 새 코드로 바꿀 수 있습니다.

명령줄 및 자동화에서 인증하기

2단계 인증을 켠 뒤 Docker CLI, 스크립트, CI에서 인증 정보가 필요하면 개인 액세스 토큰을 사용하세요. Docker의 토큰 문서를 따르고 해당 작업에 필요한 권한만 부여하세요.

조직의 SSO는 이 개인 계정 설정과 별도로 관리됩니다.

인증 코드가 작동하지 않을 때

Sign In에 저장된 Docker 항목이 지금 로그인하려는 계정과 일치하는지 확인하세요. 새 코드가 표시될 때까지 기다렸다가 코드가 바뀌기 전에 입력하세요. 새 코드도 계속 거부되면 iPhone의 날짜 및 시간이 자동으로 설정되어 있는지 확인하세요.

문제를 해결하는 동안 이미 로그인된 기기나 브라우저에서 로그아웃하지 말고 복구 정보도 준비해 두세요. Sign In에 계정을 추가하는 것만으로 설정이 완료되지는 않습니다. 해당 서비스에서 코드가 승인되고 2단계 인증이 활성화되었다는 확인을 받아야 합니다.

공식 도움말