Airbrake 2FA: 인증 앱 설정 방법

Airbrake는 개발자를 위한 오류·성능 모니터링 서비스이므로, 계정에는 앱이 보내는 스택 트레이스와 오류 데이터가 담겨 있습니다. Airbrake의 2단계 인증(2FA)은 QR 코드를 스캔하는 인증 앱이면 무엇이든 작동하며, 현재 모든 요금제에 포함되어 있습니다(Airbrake). 눈에 띄는 점이 두 가지 있습니다. 복구 코드는 설정 중에 한 번만 표시되며 다시 볼 수 없습니다. 그리고 계정 관리자는 계정의 모든 사람에게 2FA를 필수로 지정할 수 있습니다. 이 가이드는 iPhone의 Authenticator App - Novaz를 사용합니다. 어떤 인증 앱이든 같은 방식으로 작동합니다.

이 가이드를 확인한 방법: Airbrake 관련 단계는 Airbrake 자체 문서(스크린샷 포함)를 바탕으로 했으며, 2026년 10월 21일에 읽었습니다. Airbrake가 2단계 인증 페이지를 마지막으로 업데이트한 것은 2021년 10월이며, 일부 스크린샷은 그보다 오래되어 보입니다. Airbrake 계정으로 테스트하지는 않았으므로 레이블이 조금 다를 수 있습니다. Novaz 관련 단계는 앱 버전 1.0.5에서 확인했습니다.

인증 앱으로 2FA 켜기

2FA는 회사 계정이 아니라 내 사용자 프로필의 설정입니다(Airbrake).

1. Airbrake에 로그인하고 프로필 페이지를 여세요. Airbrake 화면의 제목은 Edit profile(프로필 편집)이며, 설정은 Profile(프로필) 탭에 있습니다.
2. Two-factor authentication(2단계 인증) 옆의 Enable(활성화)을 클릭하세요.
3. QR 코드가 있는 Two-factor authentication 패널이 열립니다. Novaz에서 +, QR 코드 스캔을 탭하고 카메라를 화면에 맞추세요. QR 코드가 같은 iPhone에 표시된다면 스크린샷을 찍고 대신 사진 선택을 사용하세요. 같은 iPhone에서 QR 코드 스캔하기를 참고하세요.
4. 스캔할 수 없나요? or manually enter the key(또는 키를 직접 입력) 아래에 Airbrake가 키를 4자씩 묶어 보여 줍니다. Novaz에서 +, 키를 직접 입력을 탭하고, 서비스에 Airbrake 같은 이름을 입력한 다음 설정 키에 키를 입력하세요. 2FA 설정 키란 무엇인가요?를 참고하세요.
5. Novaz의 현재 코드를 6-digit authentication code(6자리 인증 코드) 상자에 입력하고 Enable two-factor authentication(2단계 인증 활성화)을 클릭하세요.
6. 이제 Airbrake에 Two-factor recovery codes(2단계 인증 복구 코드)가 표시됩니다. 코드를 저장한 다음(아래 참고) Finish two-factor setup(2단계 인증 설정 완료)을 클릭하세요.

Finish를 클릭하기 전에 복구 코드를 저장하세요

Airbrake 문서의 복구 코드 화면에는 코드 10개와 함께 다시 볼 수 없다는 경고가 표시됩니다. 같은 경고에는 이 코드 없이 기기를 잃어버리면 “you will lose access to your account”(계정에 접근할 수 없게 됩니다)라는 내용도 있습니다(Airbrake). Airbrake는 비밀번호 관리자에 보관하라고 권합니다.

Novaz는 키를 iPhone에 보관하므로, Novaz 백업(iCloud 백업이나 백업 파일)이 없다면 휴대폰을 잃어버리거나 초기화할 때 Airbrake 키도 함께 사라집니다. 다른 기기의 비밀번호 관리자나 인쇄물처럼 그 휴대폰 없이도 접근할 수 있는 곳에 코드를 복사해 두세요. 나중에 새 세트를 만드는 방법은 Airbrake 문서에 나와 있지 않습니다. 자세한 내용은 2FA 백업 코드를 참고하세요.

이후 로그인

다음 로그인부터 Airbrake는 비밀번호 다음에 Two-factor authentication 페이지를 표시합니다. Novaz의 코드를 6-digit authentication code에 입력하고 Verify(확인)를 클릭하세요. 같은 페이지에는 Remember this browser for 30 days(이 브라우저를 30일 동안 기억) 확인란이 있어 신뢰하는 브라우저에서는 매번 요청하지 않으며, 복구 코드로 로그인하기 위한 Recovery(복구) 링크도 있습니다(Airbrake).

관리자가 2FA를 필수로 지정할 때

관리자는 계정 보안 페이지의 Security(보안) 탭에서 Require all users to have two-factor authentication enabled(모든 사용자에게 2단계 인증 활성화 요구)를 켜고 Save two-factor authentication settings(2단계 인증 설정 저장)를 클릭할 수 있습니다. 이 설정이 켜져 있는 동안 사용자는 2FA를 설정하기 전까지 Airbrake의 어떤 페이지도 열 수 없습니다. 관리자가 이 요구 사항을 다시 끄면 Airbrake가 다른 관리자에게 이메일로 알립니다(Airbrake).

같은 탭에서 모든 사용자에게 GitHub나 SAML 싱글 사인온을 요구할 수도 있습니다. GitHub로 로그인하면 두 번째 단계는 Airbrake의 2FA가 아니라 GitHub 계정 자체의 2FA입니다(Airbrake, Airbrake).

Airbrake가 코드를 거부할 때

Airbrake 문서에는 거부된 코드에 대한 안내가 없습니다. 보통 원인은 iPhone의 시계입니다. 설정 › 일반 › 날짜 및 시간을 열고 자동으로 설정을 켜세요. Novaz는 시계가 15초 이상 어긋나면 경고도 표시합니다. 다른 계정이 아니라 Novaz의 Airbrake 항목을 보고 있는지도 확인하세요. 다른 원인은 인증 앱 코드가 작동하지 않나요?에서 확인하세요.

휴대폰을 바꿀 때

Airbrake는 2FA를 새 휴대폰으로 옮기는 방법도, 끄는 방법도 문서화하지 않았습니다. Novaz의 iCloud 백업이나 백업 파일이 있다면 새 iPhone에서 계정을 복원하고 이 과정을 건너뛸 수 있습니다. 백업이 없다면 새 휴대폰에 Airbrake의 새 QR 코드가 필요합니다. 이전 휴대폰이 아직 작동할 때 프로필 페이지에서 그 방법을 찾아보고, 새 휴대폰의 코드로 로그인할 때까지 이전 휴대폰과 복구 코드를 보관하세요. 인증 앱을 새 iPhone으로 옮기는 방법을 참고하세요.

인증 앱을 잃어버렸을 때

비밀번호로 로그인한 다음 코드 페이지의 Recovery 링크를 따라가 복구 코드 중 하나를 입력하세요(Airbrake). 로그인한 뒤 새 휴대폰으로 2FA를 다시 설정하세요.

코드가 없다면, Airbrake 자체 설정 화면이 경고하듯 계정에 접근할 수 없게 됩니다. 2FA를 해제하는 지원 절차, 요구하는 증빙, 걸리는 시간은 문서에 나와 있지 않습니다. 문서에 연락처로 나와 있는 주소는 support@airbrake.io이므로, 그곳에 문의하세요. 자세한 내용은 인증 앱이 있는 휴대폰을 잃어버리셨나요?를 참고하세요.

Airbrake 공식 도움말

• Two-factor authentication
• Security
• GitHub logins