인증 앱 등록하기
- 프로필 사진 메뉴를 열고 Edit profile을 선택하세요.
- Access → Password and authentication을 선택하세요.
- One-time password authenticator 아래에서 Register authenticator를 선택하세요.
Sign In에 GitLab 추가하기
iPhone에서 코드를 생성하는 저희 인증 앱 Sign In을 사용할 수 있습니다.
- 다른 화면에 설정 QR 코드를 띄운 상태에서 Sign In을 열고 Add → Scan QR Code를 탭하세요.
- 코드를 스캔하고 계정 정보를 확인한 다음 Add Account를 탭하세요.
- GitLab에 현재 비밀번호와 6자리 코드를 입력한 다음 Register with two-factor app을 선택하세요. 복구 코드를 다운로드하세요.
GitLab은 QR 코드뿐만 아니라 수동 입력을 위한 설정 정보도 제공합니다. Sign In에서 Add → Enter Setup Key를 선택하고, Service에 GitLab, Account에 계정 이름을 입력하고 Key에 비밀 키를 붙여넣은 뒤 Add Account를 탭하세요. 이 키는 다른 사람에게 공개하지 마세요.
복구 코드 저장하기
gitlab-recovery-codes.txt 파일을 휴대폰과 별도로 안전하게 보관하세요. 각 코드는 한 번만 사용할 수 있습니다. 인증 앱 코드를 요구하는 화면에서 Recover your account를 선택하면 복구 코드를 사용할 수 있습니다.
복구 코드도 사용할 수 없다면 이용 중인 GitLab 서버에 맞는 계정 복구 안내를 확인하세요. 휴대폰을 바꾸기 전에 복구 수단을 준비해 두세요.
Git 및 조직 요구 사항
2단계 인증을 켠 뒤 HTTPS로 Git을 사용하거나 API에 접근할 때는 비밀번호 대신 개인 액세스 토큰을 사용하세요. 그룹이나 서버 정책에 따라 2단계 인증이 필수일 수 있습니다. 호환되는 WebAuthn 기기를 다른 인증 수단으로 사용할 수도 있습니다.
인증 코드가 작동하지 않을 때
Sign In에 저장된 GitLab 항목이 지금 로그인하려는 계정과 일치하는지 확인하세요. 새 코드가 표시될 때까지 기다렸다가 코드가 바뀌기 전에 입력하세요. 새 코드도 계속 거부되면 iPhone의 날짜 및 시간이 자동으로 설정되어 있는지 확인하세요.
문제를 해결하는 동안 이미 로그인된 기기나 브라우저에서 로그아웃하지 말고 복구 정보도 준비해 두세요. Sign In에 계정을 추가하는 것만으로 설정이 완료되지는 않습니다. 해당 서비스에서 코드가 승인되고 2단계 인증이 활성화되었다는 확인을 받아야 합니다.