# 이중 인증(2FA)

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

2단계 인증을 활성화하면 모든 로그인 시 다음을 제공해야 합니다:
- 사용자 이름 또는 이메일 & 비밀번호(일반 로그인 자격 증명)
- … 두 번째 단계로, 이중 인증 방법 중 하나를 사용하세요:
    - 귀하의 [패스키](./security-passkeys) 중 하나
    - 인증 앱에서 생성된 일회용 보안 코드

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

2단계 인증은 [인증 설정](https://hf.co/settings/authentication)의 "2단계 인증" 섹션에서 관리됩니다. 이 섹션에는 2단계 인증 방법(패스키 및 인증 앱)이 나열되며, 2단계 인증이 활성화된 후에는 복구 코드도 표시됩니다.

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

    
    

### 인증 앱 설정

…

Hugging Face Hub에서:
1. [인증 설정](https://hf.co/settings/authentication)으로 이동하세요
2. Two-factor authentication 섹션에서 Authenticator app 옆의 Set up을(를) 클릭합니다.

기기(보통은 휴대폰)에서:
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는 복구 코드 목록을 표시합니다. 이를 다운로드하여 안전한 곳에 보관하세요.

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

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

### 패스키 사용

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

    
    

## 복구 코드

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

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

    
    

복구 코드를 분실했거나 새로운 코드를 생성하려면 [Authentication settings](https://hf.co/settings/authentication) 페이지를 사용할 수 있습니다.

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

2FA 복구 코드를 다시 생성하려면:
1. [인증 설정](https://hf.co/settings/authentication)에 액세스하세요
2. 2FA를 이미 활성화했다면, 2단계 인증 섹션의 복구 코드 옆에 있는 보기를 클릭하세요
3. Recovery 코드 다시 생성을 클릭합니다

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

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

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

비밀번호 대신 [패스키로 로그인](./security-passkeys#sign-in-with-a-passkey)하면 2단계 인증을 요구하지 않습니다.

    
    

    
    

## 2단계 인증 비활성화

2FA를 비활성화하려면:
1. [인증 설정](https://hf.co/settings/authentication)에 액세스하세요
2. "이중 인증" 섹션에서 "끄기"를 클릭합니다.

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

## 복구 옵션

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

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

### 복구 코드 사용

복구 코드를 사용하려면:
1. [Hub 로그인 페이지](https://hf.co/login)에서 사용자 이름 또는 이메일과 비밀번호를 입력하세요.
2. 2단계 인증을 요청받으면 "복구 코드 사용"을 클릭합니다
3. 복구 코드 중 하나를 입력하세요

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

### 이중 인증에 대한 도움 요청

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