Vercel 계정은 프로덕션에 배포하고, API 키와 데이터베이스 URL 같은 프로젝트의 환경 변수를 보관하며, 내 도메인이 무엇을 보여 줄지 정합니다. 내 비밀번호로 로그인한 사람은 이 모두를 바꿀 수 있습니다. 2FA를 켜면 Vercel이 인증 앱의 6자리 코드도 요구하며, 팀은 이를 멤버 자격 조건으로 정할 수 있습니다. 2FA를 강제하는 팀은 2FA가 없는 멤버를 차단합니다.
Vercel에서 2단계 인증 켜기
Vercel은 인증 앱과 패스키(보안 키나 컴퓨터의 지문 로그인 등) 두 가지 방법을 제공합니다. 아래 단계는 인증 앱을 설정하며, 패스키는 함께 추가할 수 있습니다.
- 컴퓨터에서 Vercel에 로그인합니다.
- 계정 설정을 열고 ‘Authentication’(인증)을 선택합니다. vercel.com/account/settings/authentication으로 바로 이동해도 됩니다.
- ‘Two-Factor Authentication’(2단계 인증) 섹션에서 스위치를 켜 2FA를 활성화합니다.
- 방법으로 인증 앱을 선택합니다.
- Vercel에 QR 코드가 표시되면 그 페이지를 열어 둔 채 아래 설명대로 확장 프로그램에 추가하거나, Vercel이 보여 주는 키를 복사해 수동으로 입력합니다. 그런 다음 확장 프로그램의 6자리 코드를 입력해 확인합니다.
Authenticator에 Vercel 추가하기
- Chrome Web Store에서 2FA Authenticator – OTP 인증기를 설치하고 툴바에 고정해 두면 클릭 한 번으로 아이콘을 열 수 있습니다.
- QR 코드가 표시된 Vercel 페이지는 그대로 열어 둡니다. Authenticator 아이콘을 클릭한 다음 ‘계정 추가’ → ‘QR 코드’ → ‘화면에서 QR 스캔’을 선택합니다.
- 목록에 계정이 추가되고 30초마다 바뀌는 6자리 코드가 표시됩니다. 원하면 이름을 바꿔도 됩니다. 이름은 나만 보는 표시입니다.
- Vercel 페이지로 돌아가 현재 코드를 확인 입력란에 입력합니다. 곧 만료될 것 같으면 다음 코드를 기다리세요.
- Vercel에서 2단계 인증이 켜졌다고 알려 줍니다. 이제부터 로그인할 때마다 코드를 요구하니, 확장 프로그램 아이콘을 클릭해 복사하세요.
QR 코드가 없거나 스캔되지 않나요? Vercel 설정 화면에서 키를 직접 입력하는 옵션을 찾아 키를 복사한 다음, 확장 프로그램에서 ‘계정 추가’ → ‘수동 입력’ → ‘비밀 키’로 추가하세요.
Chrome에 2FA Authenticator – OTP 인증기 설치 — 무료Vercel 복구 코드 보관하기
2FA 설정이 끝나면 Vercel이 복구 코드를 저장하라고 안내합니다. 이 컴퓨터가 아닌 곳에 보관하세요. 인증 앱을 잃어버렸을 때 계정에 들어가게 해 주는 것이 바로 이 코드입니다. 각 코드는 한 번만 쓸 수 있으며, 같은 Authentication 설정에서 언제든 새 세트를 생성할 수 있습니다.
코드가 인식되지 않나요?
가장 흔한 원인은 QR 코드가 바뀐 것입니다. 웹사이트는 설정 페이지를 새로 고치거나 다시 열 때마다 새 QR 코드를 만들기 때문에, 먼저 추가한 계정은 더 이상 맞지 않습니다. 설정을 처음부터 다시 시작하고, 지금 화면에 있는 QR 코드를 추가한 뒤 그 코드를 바로 입력하세요. 같은 웹사이트 항목이 두 개인가요? 가장 최근 것을 쓰세요. 다른 원인: 코드가 거부되는 이유.
키를 직접 입력하셨나요? 키를 TOTP 코드 생성기에 붙여 넣고 나온 코드를 확장 프로그램의 코드와 비교합니다. 다르다면 키가 잘못 복사된 것이니 계정을 다시 추가하세요.
자주 묻는 질문
- 휴대폰 없이 Vercel 2FA를 쓸 수 있나요?
- 네. Vercel은 Google Authenticator를 예로 들지만, 표준 시간 기반 코드를 만드는 앱이라면 무엇이든 작동합니다. Authenticator 확장 프로그램도 마찬가지로, 설정 페이지의 QR 코드를 바로 읽고 Chrome에서 코드를 만듭니다. Vercel이 제공하는 다른 방법은 컴퓨터의 패스키입니다.
- 인증 앱을 사용할 수 없게 되면 어떻게 하나요?
- 2단계 인증 화면에서 복구 코드 중 하나를 쓰거나, 패스키를 추가해 두었다면 패스키를 쓰세요. 그런 다음 인증 앱을 다시 설정하고 새 코드를 저장하세요. 둘 다 없다면 Vercel에 계정 복구를 요청해야 하며, 내 계정임을 증명해야 합니다.
- Vercel 팀이 2FA를 강제합니다. 무엇이 달라지나요?
- 내 계정에 2FA를 켜기 전까지는 팀의 리소스를 열 수 없고, 팀용 빌드가 실패하며, 내 계정에 연결된 CI 토큰도 작동하지 않습니다. 팀 대시보드에 들어가면 Vercel이 설정하라고 안내하며, 켜고 나면 모든 것이 다시 작동합니다. 서비스 계정과 봇에도 2FA가 필요합니다.
- Vercel에서 코드가 틀렸다고 나오는 이유는 무엇인가요?
- 대개 QR 코드가 바뀌었기 때문입니다. 설정을 닫았거나 다시 시작했다면 Vercel이 새 QR 코드를 만들었으므로, 먼저 추가한 계정은 더 이상 맞지 않습니다. 확장 프로그램에서 삭제하고 지금 화면에 있는 QR 코드를 추가한 뒤 그 코드를 바로 입력하세요. Vercel 항목이 두 개라면 가장 최근 것을 쓰세요.
로그인 화면에서 클릭 한 번으로 코드를
Authenticator는 2FA 코드를 브라우저 안, 내 기기에만 보관합니다. 무료로 사용할 수 있고 오픈 소스이며, 계정도 휴대폰도 필요 없습니다. 로컬 백업과 선택형 비밀번호 보호가 기본으로 들어 있습니다.
Chrome에 2FA Authenticator – OTP 인증기 설치 — 무료