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

# 신분증 인증 방법 설정 - Didit 콘솔

> Didit 콘솔에서 국가별로 사용할 신분증 인증 방법 3가지를 선택하고, 대체 스위치를 설정하며, 세션이 실제로 사용한 방법을 확인합니다.

[신분증 인증](https://docs.didit.me/ko/core-technology/id-verification/verification-methods.md) 단계에는 **국가** 탭이 있습니다. 여기서 국가별로 사용자가 쓸 수 있는 세 가지 방법을 정하고, 비문서 방법이 성공하지 못했을 때 어떻게 할지 설정합니다. 탭의 모든 설정은 **신분증 인증** 노드의 [`methods`](https://docs.didit.me/ko/management-api/workflows/feature-configs#ocr-/-신분증-인증) 키에 기록됩니다. 콘솔과 Management API는 같은 객체를 보는 두 가지 방식입니다.

## 국가 및 허용된 신원 확인 방법

워크플로를 열고 **신분증 인증** 노드를 선택한 다음 **국가**를 선택합니다. 각 국가 행에는 해당 국가가 허용하는 방법이 표시됩니다. 국가를 선택하면 편집기가 열립니다.

| 항목 | 역할 | 기록되는 설정 |
| - | - | - |
| **문서 촬영** | 촬영한 문서를 허용할지 여부와 해당 국가의 문서 유형, 하위 유형, 촬영 규칙 | `document.enabled`, `documents_allowed` |
| **비문서 조회** | 비문서 조회 제공 여부, 사용자가 응답을 받을 수 있는 시도 횟수, 사진 기반으로 일치한 후 워크플로의 이후 라이브니스 감지 및 얼굴 대조 단계를 건너뛸지 여부 | `id_lookup.enabled`, `id_lookup.max_attempts`, `id_lookup.skip_liveness_and_face_match` |
| **허용된 지갑** | 해당 국가가 제공하는 디지털 ID 지갑. 순위가 아니라 허용 목록이며, 최종 사용자는 체크한 항목 중에서 선택합니다. | `wallet.enabled`, `wallet.providers` |
| **다음과 같은 경우 문서 촬영으로 전환…** | 실패 유형별 전환 옵션 하나씩 | `id_lookup.on_partial_match`, `id_lookup.on_no_match`, `id_lookup.on_provider_error`, `wallet.on_failure` |

국가에 문서 촬영이 없으면 **다음과 같은 경우 문서 촬영으로 전환…** 옵션은 항상 꺼져 있습니다. 대체할 대상이 없기 때문입니다. 이 옵션을 사용하려면 해당 국가의 **문서 촬영**을 켜야 합니다.

사용 가능한 방법을 모두 끈 국가는 저장할 때 거부되며, "사용 설정된 방법이 없어 아무도 여기서 인증할 수 없습니다"라는 메시지가 표시됩니다. 이 설정으로는 누구도 인증할 수 없기 때문입니다.

### 대체 수단으로만 문서 촬영 제공

국가를 열고 **여기서 사용자가 인증하는 방식**을 선택합니다:

| 선택 | 사용자에게 표시되는 내용 |
| - | - |
| **지갑 우선, 실패 시 문서** | 지갑만 표시됩니다(지갑이 선택되지 않은 경우에는 신원 조회). 문서 촬영은 로그인이 취소되거나 시간 초과되거나 실패했을 때, 또는 조회가 일치하지 않을 때에만 제공됩니다. |
| **지갑만, 문서 없음** | 지갑만 표시됩니다(또는 신원 조회). 해당 국가의 문서 촬영은 꺼지며, 완료되지 않은 로그인은 다시 시도할 수 있습니다. 사용자는 "{wallet} 다시 시도" 문구가 있는 지갑 단계에 머무르며, 세션은 사용자가 완료하거나 만료될 때까지 열려 있습니다. |
| **사용자가 지갑 또는 문서 선택** | 지갑 또는 조회 옵션이 문서 촬영과 나란히 표시됩니다. |
| **문서만** | 문서 촬영. 지갑이나 조회는 제공되지 않습니다. |

**지갑 우선**을 선택하면 `document.fallback_only`와, 이에 맞는 대체 전환 옵션(`wallet.on_failure`, 그리고 조회가 활성화된 경우 조회 전환 옵션)이 한 번에 기록됩니다. **지갑만**을 선택하면 `document.enabled`가 `false`로, `wallet.on_failure`가 `retry`로 설정됩니다. 완료되지 않은 로그인은 다시 시도할 수 있으며, 세션은 사용자가 완료하거나 만료될 때까지 열려 있습니다.

이 동작은 모든 국가의 모든 지갑에서 동일합니다. 두 선택 모두 프로덕션 상태인 지갑을 선택하거나 조회를 활성화하기 전까지 사용할 수 없습니다.

**출시 예정**으로 표시된 지갑은 우선 순위를 가질 수 없습니다. 국가의 모든 지갑이 출시 예정이면 문서 촬영이 계속 우선입니다.

국가 목록에는 이 설정을 사용하는 각 국가 아래에 **지갑, 이후 문서 촬영**이 표시되며, 미리보기에는 지갑만 표시됩니다.

같은 설정은 지갑 및 비문서 조회 화면의 **추가 설정** 아래에 **대체 수단으로만 문서 촬영 제공** 전환 옵션으로도 있습니다. 두 컨트롤은 같은 설정을 편집합니다.

### 가용성은 서버가 결정합니다

이 탭은 API가 검증하는 것과 같은 기능 카탈로그를 읽으므로, 플랫폼이 실제로 지원하는 항목만 제시할 수 있습니다:

* 카탈로그가 해당 국가에서 제공하지 않는 방법은 선택 항목으로 표시되지 않습니다.
* 카탈로그에서 **출시 예정**으로 표시한 소스 또는 지갑은 로드맵을 볼 수 있도록 나열되지만, 켤 수는 없습니다.
* 지갑 로그인은 환경별로 켜집니다. 꺼져 있는 동안에는 카탈로그 설정과 관계없이 모든 지갑에 **출시 예정**이 표시됩니다.

### Smart-ID 또는 Mobile-ID 활성화

Smart-ID와 Mobile-ID는 지원되는 국가에서 사용할 수 있습니다. 국가별 지원 범위는 [지갑 카탈로그](https://docs.didit.me/ko/core-technology/id-verification/digital-id-wallets.md)를 참조하십시오. 워크플로를 변경하기 전에 현재 환경에 표시된 사용 가능 여부를 확인하십시오.

1. **워크플로**를 열고, 워크플로를 선택한 다음 워크플로의 **신분증 인증** 노드를 선택하고 **국가**를 엽니다.
2. 국가 편집기를 열고 **허용된 지갑**을 찾습니다.
3. **Smart-ID** 또는 **Mobile-ID**는 사용 가능한 경우에만 선택하고, 대체 수단을 원하면 문서 촬영을 켜 둡니다.
4. 지갑 로그인이 실패했을 때의 동작을 선택한 다음 워크플로를 저장하고 게시합니다.
5. 해당 워크플로로 새 인증 세션을 시작하고, 완료된 세션의 **자격 증명** 카드를 확인합니다.

[Smart-ID 및 Mobile-ID 연동 가이드](https://docs.didit.me/ko/core-technology/id-verification/smart-id-mobile-id.md)에는 지원되는 국가 코드와 사용자에게 표시되는 비교 코드 흐름이 나와 있습니다. 스테이징 또는 샌드박스 테스트가 성공해도 프로덕션에서 지갑이 켜지지는 않습니다.

### 예상 요청과 응답

조회 소스 또는 지갑의 **자세히 보기**를 선택하면 예상되는 요청과 응답이 열립니다. 최종 사용자에게 무엇을 요청하는지 쉬운 말로 보여주고, 소스가 무엇을 반환하는지도 보여줍니다. 각 조회 소스는 정확한 이름으로 표시됩니다. 대부분의 국가에서는 정부 등록부이고, 일부 국가에서는 신용 정보 기관 또는 주민 기록 파일입니다. 출처와 동의 체계를 결정하는 것이 바로 이 이름이기 때문입니다. 최종 사용자는 응답 필드, 소스 이름, 가격을 절대 보지 못합니다.

### 일괄 전환

**전역 설정**은 방법을 지원하는 모든 국가에서 해당 방법을 켜므로, 36개 국가를 하나씩 설정할 필요가 없습니다. 국가별 편집기 설정이 여전히 우선합니다. 방법을 전역으로 켠 뒤, 원하지 않는 특정 국가에서만 끄십시오.

## 탭의 가격

문서 촬영은 건당 \$0.15의 가격을 표시합니다. 비문서 조회는 국가별 가격을 표시하며, 가격 카탈로그에 아직 게시되지 않은 가격은 견적이 아니라 탭에서 플레이스홀더로 표시됩니다. 지갑 행에는 지갑, 적용 범위, 사용 가능 여부가 표시됩니다.

탭에는 각 조회 폴백 스위치의 청구 결과도 명시되어 있으므로, 설정을 저장하기 전에 구성의 비용을 확인할 수 있습니다.

* 응답한 등록부는 조회 건으로 청구됩니다(일치와 불일치 모두 해당). 이후 사용자가 폴백하면 문서 촬영이 그 위에 추가로 청구됩니다.
* 응답하지 않은 조회는 청구되지 않으므로, 장애가 발생해도 비용은 문서 가격만큼만 발생합니다.
* 폴백을 끄면 해당 사용자는 거부되며, 이후 추가 청구는 없습니다.

## 세션 읽기

세션 상세의 **신분증 인증** 블록에는 해당 인증을 생성한 방식을 나타내는 칩과, [보증 수준](https://docs.didit.me/ko/core-technology/id-verification/verification-methods.md#보증-등급)을 나타내는 두 번째 칩이 표시됩니다. 보증 수준 칩은 **문서 / 문서 기반**, **비문서 조회 / 데이터 일치**, 또는 지갑 이름과 **암호화 기반** 중 하나입니다.

> [!NOTE]
>
> 비문서 방식에서 문서 촬영으로 폴백한 세션은 **문서 / 문서 기반** 세션으로 표시됩니다. 해당 신분증 인증의 [`fallback_from`](https://docs.didit.me/ko/reference/data-models#신분증-인증)에는 먼저 시도한 방식과 그 종료 사유(예: `wallet` 및 `cancelled`)가 `action: "fallback_to_document"`와 함께 기록됩니다.

칩 아래에는 각 방식의 증거가 표시됩니다.

* **문서**: 기존과 동일하게. 앞면, 뒷면, 셀피 이미지, 품질 점수, 추출된 필드와 경고가 포함됩니다.
* **비문서 조회**: 비교된 모든 필드를 나열하는 **등록부 대조** 항목이 표시됩니다. 각 필드에는 사용자가 입력한 값, 출처가 보유한 값, 그리고 **일치**, **부분 일치** 또는 **불일치** 결과가 포함됩니다. 출처 이름, 확인 시각, 시도 횟수도 함께 표시됩니다. 응답하지 않은 출처는 필드 판정 대신 오류가 있는 별도 행으로 표시됩니다. 출처가 얼굴 사진을 반환한 경우에는 해당 사진과 사용자의 셀피가 얼굴 점수와 함께 나란히 표시됩니다.
* **지갑**: **자격 증명** 카드가 표시됩니다. 지갑, 발급 기관, 자격 증명 유형, 지갑이 주장한 보증 수준, 인증된 시각, 서명 검증 여부, 지갑이 공유한 속성이 포함됩니다.

출처나 지갑이 얼굴 사진을 공유하지 않는 경우, 패널은 빈 프레임을 남기지 않고 이를 명시합니다. 얼굴 대조할 대상이 없으며, 워크플로에 라이브니스 감지와 얼굴 대조가 포함되어 있다면 이들은 각각 독립된 단계로 실행됩니다.

## 관련 문서

* [신분증 인증 방식](https://docs.didit.me/ko/core-technology/id-verification/verification-methods.md): 세 가지 방식, 폴백, 청구
* [비문서 조회](https://docs.didit.me/ko/core-technology/id-verification/non-doc-lookup.md): 국가별 필드와 동의
* [디지털 ID 지갑](https://docs.didit.me/ko/core-technology/id-verification/digital-id-wallets.md): 지갑별 속성과 보증 수준
* [워크플로](https://docs.didit.me/ko/console/workflows.md): 워크플로 구성 및 게시
* [워크플로 기능 구성](https://docs.didit.me/ko/management-api/workflows/feature-configs.md#ocr-/-신분증-인증): API를 통한 동일한 설정


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