AppVeyor 2FA: 인증 앱 설정 방법

AppVeyor는 주로 Windows 프로젝트의 코드를 빌드하고 테스트하는 지속적 통합 서비스입니다. GitHub, Bitbucket, GitLab 버튼이나 AppVeyor 이메일 주소와 비밀번호로 로그인할 수 있습니다. 2단계 인증(2FA)은 두 번째 방식의 로그인에 해당합니다. 이메일/비밀번호 로그인을 보호하며, AppVeyor가 설명하는 방식은 일회용 복구 코드를 대비책으로 둔 인증 앱 코드 하나뿐입니다(AppVeyor). 작업하는 계정이 요구하지 않는 한 선택 사항입니다. 이 가이드는 iPhone의 Authenticator App - Novaz를 사용합니다. 어떤 인증 앱이든 같은 방식으로 작동합니다.

이 가이드를 확인한 방법: AppVeyor 관련 단계는 2FA 도입을 알린 AppVeyor 공식 블로그 글(스크린샷 포함)과 릴리스 노트를 바탕으로 했으며, 2026년 10월 21일에 읽었습니다. 이 글은 2018년 11월에 작성되었고 AppVeyor는 2FA에 관한 더 새로운 도움말 페이지를 공개하지 않았으므로, 그 이후 화면이 바뀌었을 수 있습니다. AppVeyor 계정으로 단계를 테스트하지는 않았습니다. Novaz 관련 단계는 앱 버전 1.0.5에서 확인했습니다.

어떤 버튼으로 로그인하는지가 중요합니다

AppVeyor의 2FA는 이메일과 비밀번호로 로그인할 때만 작동합니다. GitHub, Bitbucket, GitLab, 또는 AppVeyor 화면에서 Visual Studio Team Services라고 부르는 것으로 로그인하면 AppVeyor는 자체 코드를 요청하지 않습니다. 이 로그인의 안전성은 해당 서비스 계정의 안전성에 달려 있으므로, 그곳에서도 2FA를 켜세요(AppVeyor).

인증 앱으로 2FA 켜기

AppVeyor의 발표 글에 나와 있는 단계는 다음과 같습니다(AppVeyor).

1. AppVeyor에 로그인하고 My profile(내 프로필)을 연 다음 Security(보안) 탭을 여세요.
2. Two-Factor authentication (2FA)(2단계 인증(2FA)) 아래에서 Enable 2FA(2FA 활성화)를 클릭하세요.
3. Enable two-factor authentication(2단계 인증 활성화) 페이지가 열립니다. 첫 번째 단계인 Scan this barcode with your auth app(인증 앱으로 이 바코드를 스캔하세요)에 QR 코드가 표시됩니다. Novaz에서 **+**를 탭하고 QR 코드 스캔을 탭한 다음 카메라를 QR 코드에 맞추세요. 페이지가 같은 iPhone에 열려 있다면 스크린샷을 찍고 +, 사진 선택을 탭하세요. 같은 iPhone에서 QR 코드 스캔하기를 참고하세요.
4. 스캔할 수 없다면 QR 코드 아래에 AppVeyor가 텍스트 키를 표시합니다. Novaz에서 +, 키를 직접 입력을 탭하고 서비스에 AppVeyor를, 설정 키에 키를 입력하세요. 2FA 설정 키란 무엇인가요?를 참고하세요.
5. Enter 6-digit code from auth app(인증 앱의 6자리 코드 입력) 아래에 Novaz가 AppVeyor용으로 표시하는 코드를 입력하세요. 설정 화면에 따르면 이 코드는 6자리이며 30초마다 바뀝니다. 이는 키를 직접 입력했을 때 Novaz가 만드는 코드와 같습니다.
6. Save recovery codes(복구 코드 저장) 아래의 코드를 복사한 다음 진행하세요.
7. Enable 2FA를 클릭하세요.

복구 코드를 저장하세요

AppVeyor는 설정을 마치는 버튼 바로 옆, 설정 페이지 자체에 복구 코드를 표시합니다. 발표 글에 따르면 각 코드로 휴대폰을 쓸 수 없을 때 2FA 단계를 한 번 통과할 수 있습니다(AppVeyor). 나중에 다시 보거나 새로 만드는 방법은 나와 있지 않으므로, 이 페이지가 유일한 기회라고 생각하세요.

Novaz를 백업하더라도 휴대폰이 없어졌는데 백업이 없거나 오래된 경우에는 이 코드가 로그인할 수단이므로, 비밀번호 관리자나 종이에 적어 휴대폰과 떨어진 곳에 보관하세요. 자세한 내용은 2FA 백업 코드를 참고하세요.

이후 로그인할 때

이메일과 비밀번호를 입력하면 로그인 페이지에 Two-factor authentication(2단계 인증) 패널이 표시됩니다. Authentication code(인증 코드)에 Novaz의 현재 코드를 입력하고 Verify code(코드 확인)를 클릭하세요. 휴대폰이 없다면 같은 필드에 복구 코드 중 하나를 입력할 수 있습니다(AppVeyor).

계정이 2FA를 요구할 때

AppVeyor 계정 관리자는 2FA를 필수로 정할 수 있습니다. 계정 설정의 Security 페이지에 Require two-factor authentication for users accessing this account with email/password(이메일/비밀번호로 이 계정에 접근하는 사용자에게 2단계 인증 요구) 확인란이 있으며, Update settings(설정 업데이트)로 저장합니다. 이메일과 비밀번호로 로그인했지만 아직 2FA가 없다면, 해당 계정의 리소스를 여는 즉시 AppVeyor가 설정 페이지로 보냅니다(AppVeyor).

같은 페이지에 Allowed authentication methods(허용된 인증 방식)가 나열되어 있습니다. GitHub, Bitbucket, GitLab 로그인은 이 확인을 건너뛰므로, 요구 사항이 모든 사람에게 적용되어야 한다면 해당 서비스 자체에서 2FA를 요구하도록 설정할 수 있는 경우가 아닌 한 Email/password(이메일/비밀번호)만 선택해 두라고 AppVeyor는 권합니다. 자체 호스팅 AppVeyor에는 2019년 1월 15일에 출시된 AppVeyor Enterprise 6.3.0에서 같은 기능이 추가되었습니다(AppVeyor).

AppVeyor가 코드를 거부할 때

AppVeyor는 거부된 코드에 관한 안내를 공개하지 않습니다. 흔한 원인은 iPhone의 시계입니다. 설정 › 일반 › 날짜 및 시간을 열고 자동으로 설정을 켜세요. Novaz는 시계가 15초 이상 어긋나면 알려 줍니다. 다른 원인은 인증 앱 코드가 작동하지 않나요?를 참고하세요.

휴대폰을 바꾸거나 잃어버렸을 때, 또는 끌 때

AppVeyor의 2FA 발표 글에는 2FA를 다른 휴대폰으로 옮기는 방법, 끄는 방법, 휴대폰과 복구 코드를 모두 잃어버렸을 때 어떻게 되는지가 나와 있지 않습니다. Novaz의 iCloud 백업이나 백업 파일이 있다면 새 iPhone에서 계정을 복원하고 같은 코드를 계속 쓸 수 있습니다. 백업이 없다면 이전 휴대폰을 처분하기 전에 로그인해서 My profile의 Security 탭에서 2FA를 끄고 다시 설정하는 방법을 찾아보세요. 인증 앱을 새 iPhone으로 옮기는 방법을 참고하세요.

휴대폰이 없어졌다면 복구 코드로 로그인하세요. 복구 코드가 없다면 AppVeyor가 안내하는 연락처는 일반 이메일 지원인 support@appveyor.com뿐입니다. 지원 페이지는 영업일 기준 24시간 안에 답변하는 것을 목표로 하지만, 2FA나 요구하는 증빙에 관해서는 구체적으로 언급하지 않습니다(AppVeyor). 자세한 내용은 인증 앱이 있는 휴대폰을 잃어버리셨나요?를 참고하세요.

AppVeyor 공식 페이지

• 2FA comes to AppVeyor
• AppVeyor Enterprise 6.3.0 release notes
• Support