Hub documentation
이중 인증(2FA)
이중 인증(2FA)
2단계 인증은 두 가지 방법으로 사용자의 신원을 확인하여, 비밀번호가 유출되더라도 권한이 있는 사용자만 계정에 접근할 수 있도록 추가적인 보안을 제공합니다.
2단계 인증을 활성화하면 모든 로그인 시 다음을 제공해야 합니다:
- 사용자 이름 또는 이메일 & 비밀번호(일반 로그인 자격 증명)
- 두 번째 단계: 이중 인증 방법 중 하나를 사용합니다:
- 귀하의 패스키 중 하나
- 인증 앱에서 생성된 일회용 보안 코드
2단계 인증(2FA) 활성화
2단계 인증은 인증 설정의 “2단계 인증” 섹션에서 관리됩니다. 이 섹션에는 2단계 인증 방법(패스키 및 인증 앱)이 나열되며, 2단계 인증이 활성화된 후에는 복구 코드도 표시됩니다.
2단계 인증을 활성화하려면 먼저 최소 하나의 인증 방법이 필요합니다. “Passkeys” 섹션에서 패스키를 추가하거나 인증기 앱을 설정하세요(아래 참조). 패스키만 있는 경우 “Two-factor authentication” 섹션의 “Turn on”을 클릭하세요. 인증기 앱을 설정하면 2단계 인증이 자동으로 활성화됩니다.

인증 앱 설정
…
Hugging Face Hub에서:
- 인증 설정으로 이동하세요
- “이중 인증” 섹션에서 “인증 앱” 옆의 “설정”을 클릭합니다
기기(보통은 휴대폰)에서:
- 호환되는 애플리케이션을 설치합니다. 예를 들어:
- Authy
- Google Authenticator
- Microsoft Authenticator
- FreeOTP
- 애플리케이션에서 다음 두 가지 방법 중 하나로 새 항목을 추가합니다:
- Hub 화면에 표시된 코드를 기기의 카메라로 스캔하여 항목을 자동으로 추가합니다
- 화면에 표시된 설정 키를 입력하여 항목을 수동으로 추가합니다
Hugging Face Hub에서:
- Enter the six-digit pin number from your authentication device into “6-digit code from the app”
- 저장

올바른 PIN을 입력했고 2단계 인증이 이미 활성화되어 있지 않은 경우, Hub는 복구 코드 목록을 표시합니다. 이를 다운로드하여 안전한 곳에 보관하세요.
로그인할 때마다 30일마다 2FA를 입력하도록 요청됩니다
새 인증 앱으로 전환하려면 “Authenticator app” 옆의 “Reset”을 클릭하세요. 제거하려면 “Remove”를 클릭하세요. 이는 대신 두 번째 단계로 사용할 패스키가 최소 하나 이상 있는 경우에만 가능합니다. 그렇지 않으면 2단계 인증을 끄세요.
패스키 사용
2단계 인증이 켜져 있으면 패스키 중 하나를 두 번째 단계로 사용할 수 있습니다. 인증기 앱이 없으면 마지막 패스키는 삭제할 수 없습니다. 먼저 인증기 앱을 설정하거나 2단계 인증을 끄세요.

복구 코드
2FA를 성공적으로 활성화한 직후, 생성된 복구 코드 모음을 다운로드하도록 요청됩니다. 패스키와 인증 앱에 대한 접근 권한을 모두 잃은 경우, 이 복구 코드 중 하나를 사용하여 계정에 로그인할 수 있습니다.
- 각 코드는 한 번만 계정에 로그인하는 데 사용할 수 있습니다
- 코드를 복사하여 출력하거나, 안전한 곳에 보관하도록 다운로드해야 합니다. 다운로드를 선택한 경우 파일 이름은 huggingface-recovery-codes.txt입니다.

복구 코드를 분실했거나 새로운 코드를 생성하려면 Authentication settings 페이지를 사용할 수 있습니다.
2단계 인증 복구 코드 다시 생성
2FA 복구 코드를 다시 생성하려면:
- 인증 설정에 액세스하세요
- 2FA를 이미 활성화했다면, “2단계 인증” 섹션의 “복구 코드” 옆에 있는 “보기”를 클릭하세요
- Recovery 코드 다시 생성을 클릭합니다
2FA 복구 코드를 다시 생성하면 이를 저장하세요. 이전에 생성된 복구 코드는 사용할 수 없습니다.
2단계 인증이 활성화된 상태로 로그인
2FA가 활성화된 상태로 로그인하면 표준 로그인 절차와 거의 동일하게 진행되며, 일부만 다릅니다. 사용자 이름과 비밀번호를 입력한 후 추가 프롬프트가 표시됩니다. 프롬프트가 표시되면 패스키 중 하나를 사용하거나, 일회용 비밀번호 인증기 앱의 PIN을 제공하거나, 복구 코드를 사용하여 로그인 과정을 완료합니다. 여러 방법을 설정한 경우, 프롬프트에서 방법 간을 전환할 수 있습니다.
비밀번호 대신 패스키로 로그인하면 2단계 인증을 요구받지 않습니다.


2단계 인증 비활성화
2FA를 비활성화하려면:
- 인증 설정에 액세스하세요
- “2단계 인증” 섹션에서 “끄기”를 클릭합니다.
이 작업을 수행하면 인증 앱과 복구 코드가 삭제됩니다. 패스키는 유지되므로 비밀번호 없이 패스키를 사용하여 로그인할 수 있습니다.
복구 옵션
인증 기기에 더 이상 접근할 수 없는 경우에도 계정에 대한 접근을 복구할 수 있습니다:
- 2단계 인증을 활성화할 때 저장한 경우, 저장된 복구 코드를 사용하세요
- 이중 인증에 대한 도움 요청
복구 코드 사용
복구 코드를 사용하려면:
- Hub 로그인 페이지에서 사용자 이름 또는 이메일과 비밀번호를 입력하세요.
- 2단계 인증을 요청받으면 “복구 코드 사용”을 클릭합니다
- 복구 코드 중 하나를 입력하세요
복구 코드를 사용한 후에는 다시 사용할 수 없습니다. 저장해 둔 다른 복구 코드는 계속 사용할 수 있습니다.
이중 인증에 대한 도움 요청
비밀번호를 잊으셨거나 2단계 인증 자격 증명을 분실했다면, 지원팀(website@huggingface.co)에 문의하여 계정 접근 권한을 복구할 수 있습니다. SSH 키나 개인 액세스 토큰과 같은 복구 인증 요소를 사용하여 신원을 확인해야 합니다.
Update on GitHub