스크립트를 깨뜨리지 않는 진짜 2단계 인증
알림 내역은 시스템이 무엇을 했고 언제 장애가 났는지 기록한 로그입니다. 비밀번호 하나보다 훨씬 중요한 정보죠.
어떤 인증 앱과도 호환
표준 TOTP를 사용합니다. 이미 쓰고 있는 인증 앱으로 QR 코드를 스캔하고 코드 하나만 확인하면 바로 켜집니다.
웹과 모바일 모두 적용
기본 로그인 후 웹 대시보드와 모바일 앱 모두에 적용되므로, 우회할 수 있는 경로가 없습니다.
믿을 수 있는 복구 코드
설정 시 1회용 복구 코드가 발급되며, 사용 즉시 소진됩니다. 두 로그인이 동시에 시도되어도 같은 코드를 중복으로 쓸 수 없습니다.
자동화는 그대로
API 키는 추가 인증을 요구하지 않습니다. 2단계 인증을 켜기 전과 똑같이 자동화가 계속 동작합니다.
안전한 재등록
새로 등록한 인증 정보는 확인하기 전까지 대기 슬롯에 머뭅니다. 설정이 중간에 끊겨도 본인 계정에서 잠기지 않습니다.
무차별 대입 공격 방어
잘못된 코드를 5번 입력하면 계정이 15분 동안 잠기며, 2단계 인증을 켜거나 끌 때마다 이메일로 알려드립니다.
2분이면 설정 완료
코드 스캔
계정 → 보안을 열고 인증 앱으로 QR 코드를 스캔하세요.
한 번만 확인
6자리 코드를 입력해 확인하세요. 올바른 코드를 입력해야 2단계 인증이 켜집니다.
백업 보관
복구 코드는 인증 앱이 설치된 휴대폰이 아닌 곳에 보관하세요.
켜는 방법
계정 → 보안에서 설정을 시작하세요. 원하는 TOTP 인증 앱으로 스캔할 수 있는 QR 코드와 시크릿이 표시됩니다. 6자리 코드를 하나 입력해 확인하면 그때 비로소 2단계 인증이 켜지고, 복구 코드도 그때 표시됩니다. 복구 코드는 인증 앱이 설치된 휴대폰이 아닌 다른 곳에 보관하세요.
로그인 시 달라지는 점
대시보드와 앱에서 올바른 비밀번호를 입력하면 바로 계정으로 들어가지 않고 코드 입력 화면이 나타납니다. 내부적으로 로그인 엔드포인트는 토큰 대신 짧은 유효기간의 챌린지를 반환하고, 두 번째 요청에서 이 챌린지와 코드를 보내면 실제 세션을 받습니다. 챌린지는 5분 후 만료됩니다.
코드 필드에는 6자리 TOTP 코드나 복구 코드 중 하나를 입력할 수 있으므로, 휴대폰을 잃어버려도 계정이 잠기는 것이 아니라 조금 불편할 뿐입니다.
변하지 않는 것
API 키는 이 기능의 적용 대상이 아닙니다. Token 헤더로 인증하며 추가 인증을 요구하지 않으므로, 가지고 있는 모든 스크립트, 크론 작업, CI 파이프라인이 전과 똑같이 알림을 보냅니다. 서비스마다 API 키를 따로 발급하는 것이 좋은 이유이기도 합니다. 키 하나를 폐기해도 나머지에는 영향이 없습니다.
궁금한 점을 답해드려요
Google Authenticator, 1Password, Authy, Bitwarden 등 QR 코드를 스캔해 6자리 코드를 생성하는 표준 TOTP 앱이라면 모두 사용할 수 있습니다.
아니요. 2단계 인증은 대시보드와 모바일 앱에서 직접 로그인할 때만 적용됩니다. API 키는 Token 헤더로 인증하며 추가 인증을 요구하지 않으므로, 크론 작업, CI 파이프라인, 모니터링 웹훅이 평소처럼 알림을 보낼 수 있습니다.
6자리 코드 대신 복구 코드 중 하나를 입력하세요. 복구 코드는 한 번만 사용할 수 있습니다. 계정 → 보안에서 언제든지 새 복구 코드를 발급받을 수 있으며, 이전 코드는 모두 무효화됩니다.
기존 2단계 인증 설정은 그대로 유지됩니다. 새 시크릿은 대기 슬롯에 저장되었다가 코드를 확인한 후에야 활성 설정을 대체하므로, 설정 도중 탭을 닫아도 계정에서 잠기지 않습니다.
로그인 시 토큰 대신 짧은 유효기간의 챌린지가 반환됩니다. 이 챌린지와 코드를 함께 보내 실제 JWT를 받으면 됩니다. 챌린지는 5분 동안 유효합니다. 코드 필드에는 TOTP 코드 또는 복구 코드를 모두 입력할 수 있습니다.
코드를 5번 연속 잘못 입력하면 계정이 15분 동안 잠기고, 이후 시도는 429 응답을 받습니다. 2단계 인증을 켜거나 끌 때마다 이메일도 받게 됩니다. 본인이 아닌 경우 이메일이 도착했다면 즉시 비밀번호를 변경하세요.