본문으로 건너뛰기
Novaz Authenticator받기

balena 2FA: balenaCloud에 인증 앱 설정하는 방법

작성: Novaz 팀 · 업데이트: 2026년 11월 6일
Novaz 단계는 버전 1.0.5에서 확인함

영어 가이드를 번역한 글입니다. 서비스 웹사이트의 버튼과 메뉴는 한국어로 표시될 때 이름이 조금 다를 수 있습니다.

이 페이지의 내용
  1. 인증 앱으로 2FA 켜기
  2. balena가 코드를 요청할 때
  3. 복구 코드를 보관하세요
  4. balena가 코드를 거부할 때
  5. 휴대폰을 바꿀 때
  6. 인증 앱을 잃어버렸을 때
  7. 2FA 끄기
  8. balena 공식 도움말

balenaCloud 계정은 연결된 기기 플릿을 제어합니다. 기기에서 실행되는 코드, 기기에 대한 SSH 접근, 그리고 이 모든 것을 바꿀 수 있는 API 키까지 관리합니다. 그래서 비밀번호 이상의 보호가 필요합니다. balena의 2단계 인증(2FA)은 선택 사항이며, 인증 앱의 시간 기반 코드(TOTP)라는 한 가지 방법을 사용합니다. 문서에는 문자 메시지 옵션이 없습니다(balena, balena). 이 가이드는 iPhone의 Authenticator App - Novaz를 사용하지만, 어떤 인증 앱이든 같은 방식으로 작동합니다.

이 가이드를 확인한 방법: balena 관련 단계는 아래에 링크한 balena의 문서를 바탕으로 했으며, 2026년 10월 21일에 읽었습니다. 계정에 접근할 수 없는 경우에 대해서는 balena 공식 포럼의 balena 팀 답변도 읽었습니다. balenaCloud 계정으로는 아무것도 테스트하지 않았으므로 레이블이 조금 다를 수 있습니다. Novaz 관련 단계는 앱 버전 1.0.5에서 확인했습니다.

인증 앱으로 2FA 켜기

balena의 계정 문서에 나와 있는 단계는 다음과 같습니다(balena).

  1. balenaCloud 대시보드에 로그인하세요. 오른쪽 위의 프로필을 클릭하고 Preferences(환경설정) 페이지를 여세요.
  2. Two-factor Authentication(2단계 인증) 탭을 열고 Enable two-factor authentication(2단계 인증 사용)을 클릭하세요.
  3. balena에 QR 코드와 Pairing code(페어링 코드) 필드가 표시됩니다. Novaz에서 **+**를 탭하고 QR 코드 스캔을 탭한 다음 카메라를 모니터의 코드에 맞추세요. 대시보드가 같은 iPhone에 열려 있다면 스크린샷을 찍고 +, 사진 선택을 탭하세요. 같은 iPhone에서 QR 코드 스캔하기를 참고하세요.
  4. Novaz의 6자리 코드를 Pairing code에 입력하세요.
  5. 그러면 balena가 복구 코드를 보여 줍니다. 다운로드해서 안전한 곳에 보관한 다음 OK(확인)를 클릭하세요.

문서에 따르면 2FA는 페어링이 성공해야만 켜지므로, 중간에 그만두더라도 계정에 접근할 수 없게 되지는 않습니다.

balena 문서에는 스캔 대신 입력할 수 있는 텍스트 키가 언급되어 있지 않으며, 코드가 얼마나 자주 바뀌는지도 나와 있지 않습니다. QR 코드를 스캔하세요. QR 코드가 코드 설정을 앱에 전달합니다. 키를 찾아 키를 직접 입력으로 입력하면 Novaz는 30초마다 6자리 코드로 간주합니다. 2FA 설정 키란 무엇인가요?를 참고하세요.

balena가 확인한 앱 목록에는 Google Authenticator, Authy, 1Password가 있습니다. Novaz는 목록에 없지만 같은 표준 TOTP 코드를 만듭니다.

SAML로 로그인하는 경우

회사의 Single Sign-On을 사용하는데 2FA를 켜려고 할 때마다 오류가 난다면, balena는 로그아웃했다가 다시 로그인한 후 바로 다시 시도하라고 제안합니다(balena).

balena가 코드를 요청할 때

설정을 마치면 다음 로그인부터 사용자 이름과 비밀번호를 입력한 후 앱의 코드를 요청합니다(balena). 문서에는 기억된 기기나 신뢰할 수 있는 기기에 관한 언급이 없습니다.

명령줄에서 balena login은 이메일, 비밀번호, 2FA 코드를 받거나, 대시보드에서 CLI를 승인하게 하거나, 세션 토큰이나 API 키를 받습니다(balena). API 키는 취소하지 않는 한 만료되지 않으며 사용자의 모든 권한을 가지므로(balena) 복구 코드처럼 철저히 지키세요.

복구 코드를 보관하세요

balena가 문서로 안내하는 백업은 복구 코드뿐입니다. 휴대폰이 없어졌는데 Novaz 백업이 없거나, balena를 추가하기 전에 만든 백업만 있을 때 다시 들어가는 방법입니다. 휴대폰과 떨어진 곳, 비밀번호 관리자나 종이에 보관하세요. 자세한 내용은 2FA 백업 코드를 참고하세요.

balena가 코드를 거부할 때

balena 문서에 따르면 앱의 카운트다운이 끝나면 코드가 더 이상 작동하지 않으므로, 코드가 표시되어 있는 동안 입력하세요. 새 코드가 계속 실패한다면 iPhone의 시계를 확인하세요. 설정 › 일반 › 날짜 및 시간 › 자동으로 설정. Novaz는 시계가 15초 이상 어긋나면 알려 줍니다. 다른 원인은 인증 앱 코드가 작동하지 않나요?에 있습니다.

휴대폰을 바꿀 때

balena 문서에는 2FA를 새 휴대폰으로 옮기는 방법이 없습니다. 문서에 나온 단계는 2FA를 껐다가 다시 켜는 것입니다. 이전 휴대폰이 아직 있을 때 2FA를 끈 다음, 다시 켜고 새 iPhone으로 새 QR 코드를 스캔하세요. Novaz의 iCloud 백업을 켰거나 백업 파일을 저장했다면 새 iPhone에서 복원하는 것이 더 간단하며, 코드가 계속 작동합니다. 인증 앱을 새 iPhone으로 옮기는 방법을 참고하세요.

인증 앱을 잃어버렸을 때

복구 코드 중 하나로 로그인하세요. 복구 코드가 없으면 balena 문서에는 직접 해결할 방법이 없습니다. 문서에 안내된 도움 창구는 balena 포럼의 제품 지원 섹션입니다(balena).

2023년 포럼 스레드에서 포럼 운영자로 등록된 사람을 포함한 balena 팀의 답변이 절차를 설명했습니다. 복구 코드는 계정 소유자임을 증명하는 가장 빠른 방법입니다. 복구 코드가 없으면 balena는 balenaCloud 계정에 추가한 SSH 키의 개인 키를 갖고 있는지 확인합니다. balena가 주는 문자열에 서명하고, 그 결과를 공개 게시물이 아닌 비공개로 balena 팀원에게 보냅니다. 서명이 확인되면 balena가 2FA를 해제하므로 비밀번호만으로 로그인할 수 있습니다(balena forums). 이는 문서가 아닌 포럼 답변에서 나온 내용이며, balena는 얼마나 걸리는지 밝히지 않습니다. 기기에 SSH를 사용한다면 그 키를 보관하세요. 자세한 내용은 인증 앱이 있는 휴대폰을 잃어버리셨나요?를 참고하세요.

2FA 끄기

환경설정의 Two-factor Authentication 탭으로 돌아가 Disable two-factor authentication(2단계 인증 사용 안 함)을 클릭하세요. balena가 먼저 계정 비밀번호를 요청합니다(balena). GitHub나 Google로 가입해 비밀번호를 설정한 적이 없다면 같은 페이지의 Account details(계정 세부 정보) 탭에서 추가할 수 있습니다.

balena 공식 도움말

가이드 더 보기: 스마트 홈 및 기기