Hub documentation

이중 인증(2FA)

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

이중 인증(2FA)

2단계 인증은 두 가지 방법으로 사용자의 신원을 확인하여, 비밀번호가 유출되더라도 권한이 있는 사용자만 계정에 접근할 수 있도록 추가적인 보안을 제공합니다.

2단계 인증을 활성화하면 모든 로그인 시 다음을 제공해야 합니다:

  • 사용자 이름 또는 이메일 & 비밀번호(일반 로그인 자격 증명)
  • 두 번째 단계: 이중 인증 방법 중 하나를 사용합니다:
    • 귀하의 패스키 중 하나
    • 인증 앱에서 생성된 일회용 보안 코드

2단계 인증(2FA) 활성화

2단계 인증은 인증 설정의 “2단계 인증” 섹션에서 관리됩니다. 이 섹션에는 2단계 인증 방법(패스키 및 인증 앱)이 나열되며, 2단계 인증이 활성화된 후에는 복구 코드도 표시됩니다.

2단계 인증을 활성화하려면 먼저 최소 하나의 인증 방법이 필요합니다. “Passkeys” 섹션에서 패스키를 추가하거나 인증기 앱을 설정하세요(아래 참조). 패스키만 있는 경우 “Two-factor authentication” 섹션의 “Turn on”을 클릭하세요. 인증기 앱을 설정하면 2단계 인증이 자동으로 활성화됩니다.

인증 앱 설정

…

Hugging Face Hub에서:

  1. 인증 설정으로 이동하세요
  2. “이중 인증” 섹션에서 “인증 앱” 옆의 “설정”을 클릭합니다

기기(보통은 휴대폰)에서:

  1. 호환되는 애플리케이션을 설치합니다. 예를 들어:
    • Authy
    • Google Authenticator
    • Microsoft Authenticator
    • FreeOTP
  2. 애플리케이션에서 다음 두 가지 방법 중 하나로 새 항목을 추가합니다:
    • Hub 화면에 표시된 코드를 기기의 카메라로 스캔하여 항목을 자동으로 추가합니다
    • 화면에 표시된 설정 키를 입력하여 항목을 수동으로 추가합니다

Hugging Face Hub에서:

  1. Enter the six-digit pin number from your authentication device into “6-digit code from the app”
  2. 저장

올바른 PIN을 입력했고 2단계 인증이 이미 활성화되어 있지 않은 경우, Hub는 복구 코드 목록을 표시합니다. 이를 다운로드하여 안전한 곳에 보관하세요.

로그인할 때마다 30일마다 2FA를 입력하도록 요청됩니다

새 인증 앱으로 전환하려면 “Authenticator app” 옆의 “Reset”을 클릭하세요. 제거하려면 “Remove”를 클릭하세요. 이는 대신 두 번째 단계로 사용할 패스키가 최소 하나 이상 있는 경우에만 가능합니다. 그렇지 않으면 2단계 인증을 끄세요.

패스키 사용

2단계 인증이 켜져 있으면 패스키 중 하나를 두 번째 단계로 사용할 수 있습니다. 인증기 앱이 없으면 마지막 패스키는 삭제할 수 없습니다. 먼저 인증기 앱을 설정하거나 2단계 인증을 끄세요.

복구 코드

2FA를 성공적으로 활성화한 직후, 생성된 복구 코드 모음을 다운로드하도록 요청됩니다. 패스키와 인증 앱에 대한 접근 권한을 모두 잃은 경우, 이 복구 코드 중 하나를 사용하여 계정에 로그인할 수 있습니다.

  • 각 코드는 한 번만 계정에 로그인하는 데 사용할 수 있습니다
  • 코드를 복사하여 출력하거나, 안전한 곳에 보관하도록 다운로드해야 합니다. 다운로드를 선택한 경우 파일 이름은 huggingface-recovery-codes.txt입니다.

복구 코드를 분실했거나 새로운 코드를 생성하려면 Authentication settings 페이지를 사용할 수 있습니다.

2단계 인증 복구 코드 다시 생성

2FA 복구 코드를 다시 생성하려면:

  1. 인증 설정에 액세스하세요
  2. 2FA를 이미 활성화했다면, “2단계 인증” 섹션의 “복구 코드” 옆에 있는 “보기”를 클릭하세요
  3. Recovery 코드 다시 생성을 클릭합니다

2FA 복구 코드를 다시 생성하면 이를 저장하세요. 이전에 생성된 복구 코드는 사용할 수 없습니다.

2단계 인증이 활성화된 상태로 로그인

2FA가 활성화된 상태로 로그인하면 표준 로그인 절차와 거의 동일하게 진행되며, 일부만 다릅니다. 사용자 이름과 비밀번호를 입력한 후 추가 프롬프트가 표시됩니다. 프롬프트가 표시되면 패스키 중 하나를 사용하거나, 일회용 비밀번호 인증기 앱의 PIN을 제공하거나, 복구 코드를 사용하여 로그인 과정을 완료합니다. 여러 방법을 설정한 경우, 프롬프트에서 방법 간을 전환할 수 있습니다.

비밀번호 대신 패스키로 로그인하면 2단계 인증을 요구받지 않습니다.

2단계 인증 비활성화

2FA를 비활성화하려면:

  1. 인증 설정에 액세스하세요
  2. “2단계 인증” 섹션에서 “끄기”를 클릭합니다.

이 작업을 수행하면 인증 앱과 복구 코드가 삭제됩니다. 패스키는 유지되므로 비밀번호 없이 패스키를 사용하여 로그인할 수 있습니다.

복구 옵션

인증 기기에 더 이상 접근할 수 없는 경우에도 계정에 대한 접근을 복구할 수 있습니다:

  • 2단계 인증을 활성화할 때 저장한 경우, 저장된 복구 코드를 사용하세요
  • 이중 인증에 대한 도움 요청

복구 코드 사용

복구 코드를 사용하려면:

  1. Hub 로그인 페이지에서 사용자 이름 또는 이메일과 비밀번호를 입력하세요.
  2. 2단계 인증을 요청받으면 “복구 코드 사용”을 클릭합니다
  3. 복구 코드 중 하나를 입력하세요

복구 코드를 사용한 후에는 다시 사용할 수 없습니다. 저장해 둔 다른 복구 코드는 계속 사용할 수 있습니다.

이중 인증에 대한 도움 요청

비밀번호를 잊으셨거나 2단계 인증 자격 증명을 분실했다면, 지원팀(website@huggingface.co)에 문의하여 계정 접근 권한을 복구할 수 있습니다. SSH 키나 개인 액세스 토큰과 같은 복구 인증 요소를 사용하여 신원을 확인해야 합니다.

Update on GitHub