> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alforse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 2단계 인증

> 6자리 인증 앱 코드로 로그인을 보호하고, 회사 전체에 필수로 설정하며, 누군가 기기를 분실했을 때 액세스를 복구합니다.

2단계 인증은 로그인할 때마다 인증 앱의 6자리 시간 기반 코드를 요구합니다. 각자 자신의 앱을 등록하며, 관리자는 회사의 모든 사람에게 등록을 필수로 설정할 수 있습니다.

## 동작 방식

두 가지가 분리되어 있으며 2단계 인증에 대한 대부분의 질문은 이 구분으로 귀결됩니다.

| | 범위 | 제어하는 사람 |
| - | - | - |
| **인증 앱** | 속한 모든 회사에 걸친 사용자 계정 | 본인(등록 및 제거), 관리자가 재설정할 수 있음 |
| **요구사항** | 한 회사 | **설정 → 시스템 → 보안**에서 관리자 |

인증 앱이 있으면 모든 로그인에서 코드를 요구합니다. 회사 요구사항은 인증 앱이 *없는* 사람에게 설정을 강제할지만 결정합니다.

## 인증 앱 설정

Alforse screenshot**계정 → 보안: QR 코드, 복사 가능한 비밀 키, 6칸 검증 필드가 있는 인증 앱 추가 대화상자**

첫 번째 코드가 확인되기 전에는 아무것도 활성화되지 않습니다.

**계정 → 보안**으로 이동하여 \*\*"인증 앱 추가"\*\*를 선택합니다.

Google Authenticator, 1Password, Authy 같은 TOTP 앱으로 QR 코드를 스캔합니다. 스캔할 수 없으면 코드 아래 표시된 비밀 키를 탭하여 복사하고 앱에 직접 입력합니다.

6칸 필드에 앱의 현재 코드를 입력하고 \*\*"검증"\*\*을 선택합니다. 코드가 수락되어야 2단계 인증이 켜집니다. 그 전에 대화상자를 닫으면 아무것도 저장되지 않습니다.

2단계 인증이 켜지는 즉시 Alforse가 확인 이메일을 보냅니다. 직접 실행하지 않은 이메일을 받았다면 즉시 인증 요소를 제거하고 관리자에게 알리십시오.

### 코드를 요구하는 로그인

* **요구함:** 매직 링크, Google, Outlook, 패스키 로그인.
* **요구하지 않음:** [Single Sign-On](https://docs.alforse.com/ko/docs/reference/single-sign-on.md). SSO 세션은 이미 자격 증명 공급자의 MFA를 통과했으므로 Alforse가 자체 코드 화면을 표시하지 않습니다.

### 인증 앱 제거

**계정 → 보안**에서 인증 요소 옆의 휴지통 아이콘을 선택하고 현재 코드를 입력합니다.

## 회사에 2단계 인증 필수화

**설정 → 시스템 → 보안**을 엽니다.

**2단계 인증 적용**(Two-Factor Authentication Enforcement)을 켭니다.

그 후 일어나는 일은 다음과 같습니다.

* 요구사항은 각 사람의 다음 페이지 로드부터 적용됩니다.
* 모든 활성 직원이 변경을 알리는 이메일을 받습니다.
* 인증 앱이 없는 사람에게는 전체 화면 **"인증자 앱 설정"** 안내가 표시됩니다. 같은 QR 및 코드 설정을 완료하거나 로그아웃해야 하며 안내를 건너뛸 수 없습니다.
* **사용자 → 계정**에 각 사람의 **"활성화됨"** 또는 **"설정되지 않음"**을 표시하는 **2단계** 열이 추가됩니다. 이 열은 회사가 2단계 인증을 요구하는 동안에만 표시됩니다.

NOTE

**요구사항은 회사별, 인증 앱은 사람별**

두 회사에 속해 있고 한 회사만 2단계 인증을 요구하는 경우, 해당 회사에 있는 동안에만 등록하라는 안내를 받습니다. 그러나 등록한 후에는 어느 회사를 열든 모든 로그인에서 코드를 요구합니다. 통제된 환경에서는 모든 사람에게 2단계 인증이 필수이며 스위치가 켜진 채로 잠기고, 그곳에서도 SSO 세션은 면제됩니다.

## 분실한 기기 복구

Alforse는 인쇄된 백업 코드를 발급하지 않습니다. 대신 복구는 관리자 작업이므로 모든 재설정이 의도적이며 추적 가능합니다.

사용자를 업데이트할 권한이 있는 관리자가 **사용자 → 계정**을 엽니다.

관리자가 해당 사람의 행 메뉴에서 \*\*"2단계 인증 재설정"\*\*을 선택합니다.

해당 사람이 일반 매직 링크로 로그인하여 새 기기를 등록합니다.

HEADS UP

**재설정은 사람이 속한 모든 회사에 적용됩니다**

인증 앱은 회사 구성원 자격이 아니라 계정에 속하므로 재설정하면 모든 곳에서 제거됩니다. 사용자 관리 권한을 최소 두 사람에게 부여하십시오. 유일한 관리자가 휴대폰을 분실하면 스스로 다시 들어올 방법이 없습니다.

## 2단계 인증이 다루지 않는 것

* **기계 액세스.** [API 키](https://docs.alforse.com/ko/docs/building/api-keys.md)와 연동은 챌린지를 받지 않습니다.
* **현장 PIN 작업자.** 작업자는 공유 단말기에서 PIN으로 접속하며 안내를 받지 않습니다. 2단계 인증은 해당 단말기에 로그인한 사람에게 적용됩니다.
* **사람들이 접근할 수 있는 범위.** 2단계 인증은 누가 로그인하는지를 확인합니다. 로그인한 사람이 열거나 변경할 수 있는 항목을 제한하려면 [권한](https://docs.alforse.com/ko/docs/reference/permissions.md)을 사용하십시오.

## 문제 해결

| 증상 | 원인 | 해결 방법 |
| - | - | - |
| 방금 읽은 코드가 거부됩니다. | 휴대폰 시계가 어긋났거나 사용자가 다른 회사의 항목을 읽고 있습니다. | 휴대폰을 네트워크 시간으로 설정하고 앱 항목 라벨의 회사 이름을 확인하십시오. |
| 누군가 설정 화면에서 멈춰 있습니다. | 회사가 2단계 인증을 강제하는데 해당 사람에게 인증 앱이 없습니다. | 해당 화면에서 설정을 완료하십시오. 휴대폰이 없으면 유일한 다른 선택지는 로그아웃입니다. |
| **사용자 → 계정**에 **2단계** 열이 없습니다. | 회사가 2단계 인증을 요구하지 않습니다. | 적용을 켜면 열이 나타납니다. |
| 관리자가 적용을 끌 수 없습니다. | 회사가 통제된 환경에 있습니다. | 방법이 없습니다. 그곳에서는 2단계 인증이 필수입니다. |
| 패스키 사용자에게 코드를 요구합니다. | 예상된 동작입니다. 패스키는 일반 세션을 생성합니다. | 조치할 필요가 없습니다. SSO 세션만 코드를 건너뜁니다. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.