Appwrite 2FA: Console 계정에 인증 앱을 설정하는 방법

Appwrite에는 두 가지 다중 인증(MFA)이 있어서 엉뚱한 페이지로 가기 쉽습니다. 하나는 사용자를 위해 직접 만든 앱에 넣는 기능입니다. 다른 하나는 Appwrite Console에 로그인해 조직과 프로젝트를 관리할 때 쓰는 개발자 계정 자체를 보호합니다. 이 가이드는 두 번째에 관한 것입니다(Appwrite). 앱 사용자를 위한 MFA가 필요하다면 Appwrite의 Auth 문서를 참고하세요.

Console 계정의 MFA는 선택 사항입니다. Appwrite 문서는 지원되는 방식으로 인증 앱의 시간 기반 코드(TOTP)를 들고 있으며, 앞으로 더 많은 인증 요소를 추가할 예정이라고 합니다(Appwrite). 아래 단계에서는 iPhone의 Authenticator App - Novaz를 사용합니다. 어떤 인증 앱이든 같은 방식으로 작동합니다.

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

인증 앱으로 MFA 켜기

Appwrite 페이지는 짧으며, 본문과 스크린샷의 레이블이 조금씩 다릅니다. 아래 단계는 둘 다 따릅니다(Appwrite).

1. Appwrite Console에 로그인하세요. 오른쪽 위의 계정 메뉴를 열고 Your account(내 계정)를 선택하세요.
2. 보안 설정으로 이동하세요. Appwrite 스크린샷에서는 왼쪽 목록의 Security(보안)이며, 페이지에 Multi-factor authentication(다중 인증) 카드가 있습니다.
3. Multi-factor authentication 스위치를 켜세요.
4. 인증 앱을 추가하세요. 본문에서는 버튼을 Add authentication factor(인증 요소 추가)라고 부르고, 스크린샷에서는 Authenticator app(인증 앱) 행에 Add(추가) 버튼이 있습니다.
5. Scan QR code(QR 코드 스캔) 창이 열립니다. Novaz에서 **+**를 탭하고 QR 코드 스캔을 탭한 다음 카메라를 코드에 맞추세요. Console이 같은 iPhone에 열려 있다면 스크린샷을 찍고 대신 사진 선택을 사용하세요. 같은 iPhone에서 QR 코드 스캔하기를 참고하세요.
6. 스캔할 수 없다면 같은 창에 복사 버튼과 함께 Manual entry code(수동 입력 코드)가 표시됩니다. Novaz에서 +, 키를 직접 입력을 탭하고 서비스에 Appwrite 같은 이름을 입력한 다음 설정 키에 코드를 붙여 넣으세요. 2FA 설정 키란 무엇인가요?를 참고하세요.
7. Continue(계속)를 선택하고 Novaz의 현재 코드를 입력해 설정을 마치세요.
8. 복구 코드를 저장하세요(다음 섹션).

문서에는 코드가 몇 자리인지, 얼마나 자주 바뀌는지 나와 있지 않습니다. QR 코드는 이 설정을 앱에 전달하므로 스캔하는 편이 더 안전합니다. 키를 직접 입력하면 30초마다 6자리 코드가 만들어집니다.

복구 코드가 유일한 복구 수단입니다

Appwrite는 이 점을 유난히 단호하게 말합니다. 문서는 복구 코드를 “the only way to access your account if you lose access to your authenticator app”(인증 앱에 접근할 수 없게 되었을 때 계정에 접근하는 유일한 방법)이라고 부릅니다(Appwrite). 잠긴 Console 계정을 위한 지원 경로는 설명하지 않습니다.

스크린샷에는 같은 설정 페이지에 View(보기) 버튼이 있는 Recovery codes(복구 코드) 행이 나오므로, 로그인한 상태라면 다시 볼 수 있습니다. 비밀번호 관리자나 인쇄물처럼 휴대폰이 아닌 곳에 사본을 보관하세요. Novaz 백업이 없거나 Appwrite 계정보다 오래된 것이라면 이 코드가 복구 수단입니다. 자세한 내용은 2FA 백업 코드를 참고하세요.

같은 스크린샷에는 계정의 인증된 주소로 일회용 코드를 보내는 Email(이메일)도 인증 요소로 나와 있습니다. 페이지 본문에는 인증 앱만 언급되어 있으므로, 로그인할 때 이메일 코드를 대비책으로 쓸 수 있는지는 문서만으로는 알려 드릴 수 없습니다.

Appwrite가 코드를 거부할 때

Appwrite 문서는 거부된 코드를 다루지 않습니다. 가장 흔한 원인은 iPhone의 시계입니다. 설정 › 일반 › 날짜 및 시간을 열고 자동으로 설정을 켜세요. Novaz도 시계가 15초 이상 어긋나면 알려 줍니다. 키를 직접 입력했다면 전부 복사했는지 확인하세요. 다른 원인은 인증 앱 코드가 작동하지 않나요?를 참고하세요.

휴대폰을 바꿀 때

Appwrite는 MFA를 새 휴대폰으로 옮기는 방법, 인증 앱을 교체하는 방법, MFA를 끄는 방법을 문서화하지 않았습니다. 이런 작업은 이전 휴대폰으로 아직 로그인할 수 있을 때 같은 Multi-factor authentication 카드에서 하세요. Novaz의 iCloud 백업을 켰거나 백업 파일을 내보냈다면 새 휴대폰에서 Appwrite를 복원할 수 있고, 백업이 없다면 새 휴대폰에 새 계정으로 추가해야 합니다. 인증 앱을 새 iPhone으로 옮기는 방법을 참고하세요.

인증 앱을 잃어버렸을 때

복구 코드 중 하나로 로그인한 다음 새 휴대폰에서 인증 앱을 다시 설정하세요. 복구 코드가 없다면 Appwrite 문서에는 계정에 다시 들어갈 다른 방법이 나와 있지 않습니다. 자세한 내용은 인증 앱이 있는 휴대폰을 잃어버리셨나요?를 참고하세요.

Appwrite 공식 도움말

• Multi-factor authentication (Console 계정)
• Multi-factor authentication (Appwrite Auth, 앱 사용자용)
• Security