> ## 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.

# Smart-ID 및 Mobile-ID 연동 가이드

> Didit으로 Smart-ID 및 Mobile-ID 신원 인증을 구성하세요. 지원 국가, 비교 코드 인증, 검증된 속성 및 대체 수단 설정 방법을 다룹니다.

Smart-ID 및 Mobile-ID를 사용하면 사용자가 스마트폰에서 요청을 승인하여 신원을 인증할 수 있습니다.
워크플로 없이 자체 애플리케이션에서 직접 인증을 시작하려면 [Smart-ID API](https://docs.didit.me/ko/api-reference/digital-id-wallets/smart-id.md) 또는 [Mobile-ID API](https://docs.didit.me/ko/api-reference/digital-id-wallets/mobile-id.md)를 사용하십시오.
두 방식 모두 Didit의 **신분증 인증** 워크플로 단계 내에서도 실행되며, `cryptographic` 보증 수준을 갖춘 지갑 인증 결과를 반환합니다.
아래에 설명된 호스팅 워크플로 연동의 경우 다른 Didit 워크플로와 동일한 세션 생성 및 webhook 연동을 사용합니다.

> [!NOTE]
>
> **Smart-ID 및 Mobile-ID를 사용할 수 있습니다.**
> Smart-ID는 에스토니아, 라트비아, 리투아니아, 벨기에를 지원합니다.
> Mobile-ID는 에스토니아와 리투아니아를 지원합니다.
> 콘솔에서 각 국가별로 워크플로에서 허용할 지갑을 선택하십시오.
> 전체 목록은 [지갑 적용 범위 및 요금](https://docs.didit.me/ko/core-technology/id-verification/digital-id-wallets.md#요금)을 참조하십시오.

## 국가 및 전제 조건

이 연동은 에스토니아(`EST`), 라트비아(`LVA`), 리투아니아(`LTU`), 벨기에(`BEL`)의 Smart-ID를 지원합니다.
Mobile-ID는 에스토니아(`EST`) 및 리투아니아(`LTU`)를 지원하며, 라트비아에서는 Mobile-ID가 제공되지 않습니다.
이 국가 코드들은 연동된 경로를 설명하는 것이며, 사용자 환경에서 모든 경로가 활성화되어 있음을 보장하는 것은 아닙니다.

Smart-ID의 경우 사용자에게 유효한 적격 Smart-ID 신원, 개인 식별 코드 및 앱에 대한 접근 권한이 있어야 합니다.
Mobile-ID의 경우 사용자에게 유효한 Mobile-ID 신원, 개인 식별 코드 및 연결된 전화번호가 있어야 합니다.
Mobile-ID 전화번호는 국제 형식(에스토니아의 경우 `+372`, 리투아니아의 경우 `+370`)으로 입력하십시오.
선택한 국가는 사용 중인 신원 정보와 일치해야 합니다.

두 방식 모두 인물 사진을 반환하지 않습니다.
워크플로에 셀피가 필요한 경우 해당하는 [라이브니스 감지](https://docs.didit.me/ko/core-technology/liveness/overview.md) 및 [얼굴 대조](https://docs.didit.me/ko/core-technology/face-match/overview.md) 단계를 별도로 구성해 두십시오.

## 사용자가 보게 되는 화면

1. 사용자는 국가를 선택하고 워크플로에서 허용된 지갑 중 **Smart-ID** 또는 **Mobile-ID**를 선택합니다.
2. 인증 세션에서 개인 식별 코드를 요청하며, Mobile-ID의 경우 연결된 전화번호도 요청합니다.
3. 인증 요청이 스마트폰에 도달하는 동안 페이지에 대조 코드가 표시됩니다.
4. 사용자는 스마트폰의 코드가 인증 페이지의 코드와 일치하는지 확인한 후 스마트폰에서 PIN을 입력하여 승인합니다.
5. Didit은 서명된 신원 결과를 검증하고 인증 워크플로를 계속 진행합니다.

신원 입력 양식과 대조 코드 화면은 다른 인증 방식과 동일한 레이아웃을 사용합니다.
화이트 라벨 맞춤 설정이 활성화된 경우 세션의 색상, 타이포그래피, 버튼 스타일 및 고객 로고를 상속받으며 세션의 도메인에 그대로 유지됩니다.
페이지를 새로고침해도 다른 승인 요청을 시작하지 않고 활성 대조 코드가 복원됩니다.

사용자는 인증 페이지에 지갑 PIN을 절대 입력하지 않습니다.
코드가 다르거나 사용자가 직접 요청을 시작하지 않은 경우 요청을 취소해야 합니다.
대조 코드 흐름은 데스크톱 또는 모바일 브라우저에서 모두 작동하며 QR 코드가 필요하지 않습니다.
페이지는 결과를 자동으로 기다리며 취소 옵션을 제공합니다.
스마트폰에서의 승인이 완료된 후에도 신원 및 서명 확인을 통과해야 Didit에서 해당 지갑 인증을 성공한 것으로 처리합니다.

## 워크플로 구성

콘솔에서 워크플로의 **신분증 인증** 노드를 열고 **국가**를 선택한 후 구성할 국가를 엽니다.
**허용된 지갑**에서 사용 가능한 지갑을 선택하고 실패 시 동작 방식을 선택합니다.
새 세션을 생성하기 전에 워크플로를 저장하고 게시하십시오.
전체 콘솔 경로는 [콘솔의 신분증 인증 방식](https://docs.didit.me/ko/console/id-verification-methods.md#smart-id-또는-mobile-id-활성화)을 참조하십시오.

> [!WARNING]
>
> 다음은 `methods` 구성 조각이며 완전한 워크플로 요청이 아닙니다.
> 사용자 환경에서 에스토니아에 대해 `smart_id`와 `mobile_id`가 **모두** `available` 상태로 표시되어 있는 경우에만 사용하십시오.
> 사용할 수 없는 지갑이 포함되어 있으면 전체 워크플로 저장이 거부됩니다.

```json theme={null}
{
  "EST": {
    "document": { "enabled": true },
    "wallet": {
      "enabled": true,
      "providers": ["smart_id", "mobile_id"],
      "on_failure": "fallback_to_document"
    }
  }
}
```

`providers` 배열은 허용 목록입니다. 사용자는 이 목록의 지갑 중에서 선택하며, 배열 순서가 특정 지갑에 대한 우선순위를 정하지 않습니다.
리투아니아의 경우 두 지갑을 모두 사용할 수 있을 때 동일한 지갑 식별자를 사용하여 `LTU`를 설정하십시오.
라트비아 또는 벨기에의 경우 동일한 가용성 확인을 거쳐 `LVA` 또는 `BEL`에 `smart_id`만 사용하십시오.
생략된 국가는 기존의 기본 문서 캡처 동작을 유지합니다.
전체 구성 규약은 [워크플로 기능 구성](https://docs.didit.me/ko/management-api/workflows/feature-configs.md#ocr-/-신분증-인증)을 참조하십시오.

## 검증 결과 확인

[세션 결정 API](https://docs.didit.me/ko/sessions-api/retrieve-session.md) 또는 [webhook 연동](https://docs.didit.me/ko/integration/webhooks.md)을 통해 완료된 세션을 확인할 수 있습니다.
성공한 지갑 확인에서는 `verification_method: "wallet"`, `assurance: "cryptographic"` 및 `wallet_provider: "smart_id"` 또는 `"mobile_id"`가 기록됩니다.
`wallet_verification` 객체는 지갑, 발급 국가, 인증 시간, 보증 수준 및 서명 판정 결과를 식별합니다.
신분증 인증 결과에는 정규화된 `full_name` 및 `date_of_birth` 필드가 표시됩니다.
이 두 지갑의 경우 `wallet_verification.attributes`에는 검증된 신원 정보의 `given_name`, `family_name`, `birthdate`, `personal_code`가 포함됩니다.
발급 국가는 신원 인증 경로를 나타내며, 해당 인물의 국적을 확정하지는 않습니다.
Didit은 서명 판정 결과만 반환하며 원본 서명 어설션 자체는 반환하지 않습니다.
인물 사진이나 지갑 PIN은 반환되지 않습니다.

콘솔에서 세션의 **자격 증명** 카드에 지갑과 검증된 증거가 표시됩니다.
지갑 확인이 성공하면 신분증 인증 단계가 완료되지만, 세션의 최종 결정은 워크플로의 후속 확인 단계들에 따라 결정됩니다.
필드 유형 및 확인 결과와 전체 세션 결정 간의 차이점에 대해서는 [신분증 인증 데이터 모델](https://docs.didit.me/ko/reference/data-models.md#신분증-인증)을 참조하십시오.

## 취소 및 실패 처리

사용자가 인증을 취소하거나 시간 초과가 발생하거나 인증을 완료할 수 없는 경우, Didit은 해당 국가의 `wallet.on_failure` 설정을 적용합니다.
`fallback_to_document`는 해당 국가에서 문서 캡처가 활성화되어 있을 때 이를 시작합니다.
`decline`은 신분증 인증 단계를 거부합니다.
문서 캡처가 비활성화되어 있으면 사용할 수 있는 문서 대체 수단이 없습니다.

완료되고 검증된 지갑 확인에만 지갑 인증 요금이 부과됩니다.
취소되었거나 만료되었거나 실패한 지갑 시도에는 부과되지 않습니다.
완료된 문서 대체 수단은 [문서 인증 요금](https://docs.didit.me/ko/getting-started/pricing.md)에 따른 별도의 확인으로 처리됩니다.
게시된 요율은 [지갑 요금표](https://docs.didit.me/ko/core-technology/id-verification/digital-id-wallets.md#요금)를 참조하세요. 게시된 요율이 없는 수단을 무료로 간주해서는 안 됩니다.

## 프로덕션 전 테스트

제공하려는 각 지갑과 국가를 활성화된 환경에서 테스트하세요.
올바른 지갑이 표시되는지, 대조 코드가 보이는지, 승인 후 워크플로가 계속 진행되는지, 세션 결과에 예상된 지갑 증거가 포함되어 있는지 확인하세요.
또한 취소, 만료 및 선택한 대체 동작도 확인해야 합니다.

샌드박스 시뮬레이션 및 스테이징 테스트는 프로덕션 인증과 다릅니다.
시뮬레이션된 승인은 연동을 확인하는 데 유용하지만 실제 사용자가 프로덕션에서 인증할 수 있음을 증명하지는 않습니다.
출시 전에 콘솔에서 프로덕션 가용성을 확인하고 사용하려는 경로에 대해 승인된 실제 기기 인증을 완료하세요.

## 기타 디지털 신원 지갑

Didit의 [디지털 신분증 지갑 카탈로그](https://docs.didit.me/ko/core-technology/id-verification/digital-id-wallets.md)에는 프로덕션 가용성 및 출시 예정 지갑(이용 가능한 Finnish Trust Network 및 출시 예정인 BankID와 EUDI Wallet 연동 포함)이 포함되어 있습니다.
목록에 포함된 지갑, 게시된 가격 또는 작성 완료된 온보딩 양식 자체가 프로덕션 인증을 활성화하지는 않습니다.
카탈로그 및 해당 환경의 콘솔을 사용하여 현재 활성화할 수 있는 수단을 확인하세요.

[핀란드용 Finnish Trust Network](https://docs.didit.me/ko/core-technology/id-verification/finnish-trust-network.md)도 참조하세요.


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