ActiveState 2FA: 인증 앱 설정 방법

ActiveState Platform 계정은 런타임을 빌드하고, 명령줄에서 State Tool을 사용하고, 조직의 비공개 프로젝트에 접근할 때 로그인하는 계정입니다. ActiveState는 비밀번호로 로그인하는 계정에 2단계 인증(2FA)을 선택 사항으로 제공합니다. 문서에 나온 방법은 인증 앱의 6자리 코드 하나이며, 2FA를 필수로 하지는 않습니다. ActiveState 문서는 Google Authenticator와 Authy를 예로 들지만 QR 코드를 읽는 비슷한 앱이면 어떤 것이든 된다고 설명합니다(ActiveState). 이 가이드는 iPhone의 Authenticator App - Novaz를 사용합니다. 어떤 인증 앱이든 같은 방식으로 작동합니다.

이 가이드를 확인한 방법: ActiveState 관련 단계는 아래에 링크한 ActiveState 자체 문서를 바탕으로 했으며, 2026년 10월 21일에 읽었습니다. ActiveState 계정으로 테스트하지는 않았으므로 레이블이 조금 다를 수 있습니다. Novaz 관련 단계는 앱 버전 1.0.5에서 확인했습니다.

시작하기 전에: 로그인 방식이 중요합니다

ActiveState 계정은 이메일 주소와 비밀번호로 만들 수도 있고, GitHub 계정으로 만들 수도 있습니다(ActiveState). 여기서 설명하는 2FA는 ActiveState 자체 기능으로, ActiveState 비밀번호와 함께 쓰입니다. GitHub로 로그인할 때도 적용되는지는 ActiveState 문서에 나와 있지 않습니다. 이 경우에는 GitHub 자체 보안 설정이 로그인을 보호합니다.

회사는 ActiveState 지원팀이나 계정 관리자를 통해 Platform을 자체 싱글 사인온에 연결할 수도 있습니다. 조직에서 그렇게 했다면 2FA가 어떻게 적용되는지 IT팀에 문의하세요.

인증 앱으로 2FA 켜기

ActiveState 문서의 단계는 다음과 같습니다(ActiveState).

1. ActiveState Platform에 로그인하세요. 오른쪽 위의 사용자 이름이 표시된 메뉴를 열고 Account Settings(계정 설정)를 선택하세요.
2. Two-factor Authentication(2단계 인증)을 클릭한 다음 Enable(활성화)을 클릭하세요.
3. ActiveState에 QR 코드가 표시됩니다. Novaz에서 +, QR 코드 스캔을 탭하고 카메라를 QR 코드에 맞추세요. QR 코드가 iPhone 자체 화면에 표시된다면 스크린샷을 찍고 +, 사진 선택을 탭하세요. 같은 iPhone에서 QR 코드 스캔하기를 참고하세요.
4. Novaz의 6자리 코드를 텍스트 상자에 입력하고 Confirm(확인)을 클릭하세요.

코드가 받아들여지면 2FA가 켜집니다.

ActiveState 문서는 QR 코드 스캔만 설명하며, 대신 입력할 수 있는 텍스트 키는 언급하지 않습니다. 키가 보인다면 Novaz에서 +, 키를 직접 입력을 탭하고 설정 키 필드에 넣으세요. 2FA 설정 키란 무엇인가요?를 참고하세요.

ActiveState가 코드를 요청할 때

ActiveState에 따르면 2FA를 켠 뒤에는 로그인할 때마다 비밀번호와 앱의 현재 코드가 필요합니다. 기기를 신뢰해 코드 입력을 건너뛰는 방법은 문서에 나와 있지 않습니다(ActiveState).

State Tool

state auth를 실행하면 브라우저에서 Platform 로그인 페이지가 열리므로, 평소처럼 거기서 코드를 입력합니다(ActiveState). 대신 사용자 이름과 비밀번호를 명령줄 플래그로 넣어 로그인한다면, 명령어 참조 문서에 앱의 코드를 넣는 --totp 플래그가 있으며 이 플래그는 사용자 이름·비밀번호 플래그와 함께 써야만 작동합니다(ActiveState).

CI/CD 파이프라인에는 ACTIVESTATE_API_KEY 환경 변수에 저장한 API 키를 ActiveState가 권장하며, 이 키는 state export new-api-key로 만들 수 있습니다(ActiveState). 이렇게 하면 빌드 서버에 휴대폰의 코드가 필요 없습니다.

문서에 백업 코드 없음

ActiveState 문서에는 백업 코드나 복구 코드에 대한 언급이 없으며, 두 번째 2FA 방법도 나와 있지 않습니다. Novaz는 키를 iPhone에 보관하므로, 설정 › 백업에서 iCloud 백업을 켜거나 백업 파일을 내보내지 않는 한 ActiveState 코드는 그 iPhone에서만 나옵니다. iPhone을 잘 관리하고, 필요해지기 전에 아래 복구 섹션을 읽어 두세요. 일반적인 배경 정보는 2FA 백업 코드를 참고하세요.

ActiveState가 코드를 거부할 때

ActiveState 문서는 거부된 코드를 다루지 않습니다. 가장 흔한 원인은 iPhone의 시계입니다. 설정 › 일반 › 날짜 및 시간을 열고 자동으로 설정을 켜세요. Novaz는 시계가 15초 이상 어긋나면 경고도 표시합니다. 코드가 바뀌기 전에 입력하는지도 확인하세요. 다른 원인은 인증 앱 코드가 작동하지 않나요?에서 확인하세요.

휴대폰을 바꿀 때

ActiveState는 2FA를 새 휴대폰으로 옮기는 방법을 설명하지 않습니다. 문서에 나온 단계로 가능한 방법은 이렇습니다. 이전 휴대폰이 아직 있을 때 코드로 로그인하고, Account Settings › Two-factor Authentication에서 2FA를 끈 다음, 다시 켜서 새 휴대폰으로 새 QR 코드를 스캔하세요. Novaz의 iCloud 백업이나 백업 파일이 있다면 대신 새 iPhone에서 계정을 복원할 수 있습니다. 백업이 없다면 이 방법을 쓰세요. 인증 앱을 새 iPhone으로 옮기는 방법을 참고하세요.

인증 앱을 잃어버렸을 때

코드가 있는 휴대폰을 잃어버렸을 때 무엇을 해야 하는지 ActiveState 문서는 설명하지 않습니다. 지원팀이 어떤 증빙을 요구하는지, 재설정에 얼마나 걸리는지도 나와 있지 않습니다. 2FA를 직접 끄려면 먼저 코드로 로그인해야 하므로, 휴대폰이 없어진 뒤에는 도움이 되지 않습니다(ActiveState). 비밀번호 재설정에도 기대하지 마세요. ActiveState의 비밀번호 페이지에는 재설정하면 2FA가 꺼진다는 말이 없습니다(ActiveState).

ActiveState가 계정 관련 문의처로 안내하는 주소는 support@activestate.com이며, 예를 들어 계정 이메일 주소를 변경할 때 이 주소를 씁니다(ActiveState). 계정에 등록된 이메일로 이 주소에 연락하세요. 바로 취할 조치는 인증 앱이 있는 휴대폰을 잃어버리셨나요?를 참고하세요.

2FA 끄기

코드를 받을 수 있는 동안에는 언제든 2FA를 끌 수 있습니다. 코드로 로그인하고, 사용자 이름 메뉴에서 Account Settings를 열고, Two-factor Authentication, Disable(비활성화)을 차례로 클릭하세요. 다음 로그인부터 ActiveState가 코드를 요청하지 않습니다(ActiveState). Novaz에서 ActiveState 계정을 열고 계정 삭제를 탭하세요.

ActiveState 공식 도움말

• Configure SSO and 2FA
• Create an account
• Authentication
• Command Reference
• Use the State Tool in Your CI/CD Environments
• Password Management
• Manage Your Account