메인 콘텐츠로 건너뛰기
지갑 로그인은 세 가지 신분증 인증 방식 중 하나입니다. 사용자는 이미 보유하고 있는 디지털 신원(국가 eID 또는 은행 신원)으로 로그인하며, 해당 제공업체는 서명된 속성 집합을 Didit과 공유합니다. 결과에는 cryptographic 보증 등급이 부여됩니다. 이는 신원 제공업체가 해당 인물을 인증하고 반환된 속성에 서명했음을 의미합니다. 이 등급이 보증하는 내용은 이것이 전부입니다. 다른 두 등급에 비해 우위를 나타내는 순위가 아니며(동일한 요소의 우열이 아니라 서로 다른 증거를 나타냄), 로그인에 소요되는 시간은 지갑 자체의 절차에 따르므로 Didit이 제어하거나 보장하지 않습니다.
가용성은 사용하는 환경에 따라 다릅니다. 아래 표는 프로덕션 가용성을 설명하며, 콘솔은 워크플로를 저장할 때 해당 환경의 실시간 기능 카탈로그를 사용합니다. MitID, BankID Sweden, iDIN, Finnish Trust Network, Smart-ID, Mobile-ID를 사용할 수 있습니다. Estonian ID-card, eParaksts mobile, Personalausweis, OneID, ConnectID는 프로덕션에서 출시 예정 상태로 유지됩니다. Smart-ID는 에스토니아, 라트비아, 리투아니아, 벨기에를 지원하며, Mobile-ID는 에스토니아와 리투아니아를 지원하고, Finnish Trust Network는 핀란드를 지원합니다. 국가별 지원 범위, 구성 및 인증 절차는 Smart-ID 및 Mobile-ID 연동 가이드를 참조하십시오. 출시 예정으로 표시된 지갑은 해당 환경에서 활성화할 수 없습니다.

연동 방식 선택

애플리케이션이 인터페이스 및 인증 단계를 직접 관리하는 경우 디지털 ID 지갑 API를 사용하십시오. 각 지갑에는 전용 시작 endpoint가 있으며, 결과, 폴링, 취소 endpoint는 공유됩니다. 워크플로를 생성할 필요가 없습니다. Didit의 호스팅 지갑 여정, 워크플로 규칙, 구성된 문서 대체 수단을 이용하려면 Sessions API를 사용하십시오. 지갑의 가용성, 필요한 사용자 승인 및 검증된 신원 속성은 두 연동 방식 모두에 적용됩니다.

전제 조건

각 지갑을 사용하려면 아래에 명시된 발급기관에 등록된 유효한 신원과 해당 인증 수단에 대한 접근 권한이 필요합니다. 계정은 요청된 속성을 받을 자격을 갖추어야 하며, 사용자가 속성 공유에 동의해야 합니다. 서명은 발급기관과 반환된 클레임을 검증하지만, 요청된 모든 속성이 존재하거나 최신 상태이거나 귀사의 컴플라이언스 정책에 충분한지 여부를 보증하지는 않습니다. 인물 사진이 없는 지갑에는 셀피 대조가 포함되지 않습니다. 양국 BankID, ConnectID, Estonian ID-card, eParaksts mobile을 포함하여 카탈로그의 전체 25개 지갑 항목이 아래에 나열되어 있습니다. 구성된 문서 대체 수단은 별도의 문서 확인을 실행합니다. 출시일은 보장되지 않습니다. 이들은 신원 지갑입니다. 암호화폐 지갑 스크리닝은 재무적 위험을 확인하기 위해 블록체인 주소를 검사하는 별도의 제품입니다.

요금

✅ 이용 가능은 프로덕션에서 활성화되었음을 의미합니다. ⏳ 출시 예정은 연동 테스트가 시작되었더라도 아직 프로덕션에서 활성화되지 않았음을 의미합니다. 이용 가능한 지갑이 먼저 표시됩니다. 가격 열의 요청 시 제공은 지갑을 이용할 수 있으나 공개된 소매 요율이 없음을 의미하며, 무료 인증을 뜻하지는 않습니다. 아래에 명시된 신원 확인 제품에 대한 Didit의 표준 가격은 완료된 지갑 인증 건당 USD 기준입니다. 명시된 가격에는 지갑 신원 확인이 포함되어 있으며, 별도의 국가 eID 거래 수수료는 추가되지 않습니다. 조직과 합의된 별도 요금이 있는 경우 해당 요금이 우선 적용됩니다. 가격 열의 ‘출시 예정’은 해당 지갑은 출시 예정이며 고객 가격이 아직 공개되지 않았음을 의미합니다. 인증이 무료라는 의미는 아닙니다. 국기는 지갑의 카탈로그 지원 범위를 표시하며, 별도의 이용 가능 여부 열은 현재 활성화할 수 있는지를 나타냅니다. 공개된 가격이 있다고 해서 지갑이 바로 활성화되는 것은 아닙니다. 위의 이용 가능 여부는 프로덕션 카탈로그를 기준으로 합니다. 출시 예정으로 표시된 지갑은 아직 워크플로에서 선택할 수 없으며, 해당 지갑을 이용할 수 있게 되면 이 요율이 적용됩니다.
  • 인증된 지갑 로그인은 워크플로의 신분증 인증 노드당 한 번 또는 독립형 지갑 API를 통한 인증 요청당 한 번 청구됩니다. 반복되는 콜백이나 상태 확인으로 인해 추가 요금이 발생하지는 않습니다.
  • 취소됨, 만료됨, 거부됨 또는 불완전한 로그인에 대해서는 지갑 인증 요금이 부과되지 않습니다.
  • 지갑 가격은 정가 기준이며, 다른 모든 검사와 마찬가지로 요금제 할인이 적용됩니다.
  • 문서 대체 수단은 별도의 검사이며, 문서 인증 요금에 따라 청구됩니다. 완료된 다른 워크플로 기능도 별도로 청구됩니다.
예를 들어 표준 요율 기준 완료된 iDIN 전체 식별 인증 1,000건의 비용은 다른 워크플로 기능을 제외하고 $950입니다. 이는 전체 식별 기준이며, 재로그인 가격이 아닙니다. 위의 BankID 요율은 Norway High 기준이며, 독일 eID 요율은 Personalausweis Profile 2 기준입니다.

사용자가 수행하는 작업

  1. 신분증 단계에서 자신의 국가를 선택하고 허용된 지갑 중 하나를 선택합니다.
  2. 은행이나 정부 포털에 로그인하는 것과 동일한 방식으로 해당 지갑으로 로그인합니다.
  3. 자신의 신원 속성을 공유하는 데 동의합니다.
  4. 인증을 완료하고 돌아옵니다.
동일 기기 로그인은 사용자를 지갑 앱으로 이동시키고, 완료되면 인증 흐름으로 복귀시킵니다. 교차 기기 로그인은 데스크톱 화면에 QR 코드를 표시하고, 사용자는 지갑이 설치된 휴대전화로 이를 스캔합니다. 지갑이 지원하는 경우 두 방식 모두 제공되며, 사용자가 직접 선택합니다. 워크플로에 Smart-ID 또는 Mobile-ID가 활성화되어 있으면 사용자는 인증 페이지에 개인 식별 코드를 입력합니다. Mobile-ID의 경우 신원과 연결된 전화번호도 요청합니다. 페이지에 비교 코드가 표시되며, 사용자는 해당 코드가 일치할 때만 휴대전화에서 승인합니다. 사용자는 휴대전화에 PIN을 입력하며, Didit은 이를 절대 묻지 않습니다. 이 흐름은 QR 코드 없이 데스크톱이나 휴대전화에서 작동합니다. 이용 가능 여부는 라이브 기능 카탈로그에 따라 결정되며, 출시 예정으로 표시된 지갑은 아직 활성화할 수 없습니다. 시작된 로그인은 제한된 시간(기본 10분) 동안 유효합니다. 그 이후에는 사용자가 다시 시작해야 합니다.

지갑 허용 목록

wallet.providers는 특정 국가에서 제공할 수 있는 지갑 목록입니다. 이는 순위가 아니며, 전달하는 순서에는 아무런 의미가 없고 저장 시 카탈로그 순서로 정규화되며, 최종 사용자는 허용된 지갑 중에서 선택합니다. 한 국가에서 지갑 하나만 활성화하든 모든 지갑을 활성화하든 선택은 사용자의 몫입니다. API는 카탈로그에서 해당 국가에 제공하지 않는 지갑이나 아직 출시 예정 상태인 지갑을 활성화하는 워크플로를 거부합니다.
아래에 나열된 모든 지갑의 속성 목록에는 서명된 증명이 포함되어 있습니다. Didit은 해당 서명을 검증하고 그 결과를 세션의 wallet_verification.signature_valid에 보고합니다. 증명 자체는 반환되지 않으므로 가져오거나 저장할 참조가 없습니다. 세션에서 열에는 각 속성에 대해 둘 중 어떤 것이 제공되는지 명시되어 있습니다.

지원되는 지갑

현재 이용 가능한 지갑은 MitID, BankID Sweden, iDIN, Finnish Trust Network, Smart-ID, Mobile-ID입니다. iDIN은 네덜란드에서 전체 신원 확인에 이용할 수 있습니다. Smart-ID 및 Mobile-ID는 아래 카탈로그에 나열된 국가에서 이용할 수 있습니다. Smart-ID 및 Mobile-ID의 지원 국가 및 요청되는 입력 항목은 구현된 연동 방식을 반영하며, 프로덕션 환경에서의 제공 여부는 별도로 제어됩니다. 구현된 Smart-ID 및 Mobile-ID 경로에 대해서는 연동 가이드를 참조하십시오.
가용성은 이 문서에서 수동으로 관리되지 않고 기능 카탈로그를 통해 제공됩니다. 출시 예정은 콘솔에 지갑이 표시되지만 아직 활성화할 수 없음을 의미하며, 확정된 일정은 제공되지 않습니다.

에스토니아 ID 카드 및 eParaksts mobile

두 방식 모두 지갑 카탈로그에 연동되어 있으나, 프로덕션 환경에서는 출시 예정 상태로 유지됩니다. 프로덕션 카탈로그에서 사용 가능으로 표시될 때까지 프로덕션 워크플로에서 활성화할 수 없습니다. API 식별자는 에스토니아(EST)의 경우 idcard_ee, 라트비아(LVA)의 경우 eparaksts_mobile입니다. 두 방식 모두 이용 가능해지면 완료된 인증 건당 $0.55의 요금이 부과되며, 요금이 공개되어 있다고 해서 프로덕션 액세스가 바로 활성화되는 것은 아닙니다.
  • 에스토니아 ID 카드: 사용자가 스마트카드 리더기가 연결된 컴퓨터의 브라우저에서 진행하며, 카드 소프트웨어를 통해 카드와 PIN으로 인증합니다.
  • eParaksts mobile: 사용자가 신원 로그인 서비스로 이동하여 활성화된 eParaksts mobile 계정으로 승인합니다. 데스크톱 사용자는 QR 코드를 스캔하여 휴대전화에서 계속 진행할 수 있으며, 휴대전화 사용자는 바로 진행합니다.
두 방식 모두 Didit의 공통 지갑 선택, 핸드오프 및 복귀 플로우를 사용합니다. 사용자는 인증 PIN을 신원 서비스 또는 카드 소프트웨어에만 입력하며, Didit 양식에는 절대 입력하지 않습니다. 인증 후 Didit은 서명된 신원 속성을 검증하고 구성된 워크플로를 계속 진행합니다. 취소되거나 실패하면 워크플로에 구성된 문서 폴백 또는 거부 작업이 수행됩니다.
화이트 라벨은 Didit 인증 화면에 적용됩니다. 이 두 방식의 외부 인증 화면에는 해당 서비스의 브랜딩이 그대로 유지됩니다. 맞춤 로고, 서비스 이름 및 화이트 라벨 스타일링은 이러한 외부 화면에 전달되지 않습니다.

API를 통해 이 지갑 사용하기

두 방식 모두 workflow_id 없이 독립형 API 인증도 지원합니다. 독립형 API와 워크플로의 프로덕션 가용성은 동일하므로, 사용자에게 해당 방식을 제공하기 전에 GET /v3/id-verification/wallets/를 확인하십시오. x-api-key는 백엔드에 안전하게 보관하고, 애플리케이션 설정의 allowed_return_hosts에 반환 호스트를 등록하십시오. 인증을 시작할 때 해당 호스트의 HTTPS return_url을 전송하십시오. 시작 응답은 request_id와 사용자의 브라우저를 위한 wallet_verification.next_action.url을 반환합니다. 사용자가 카드나 앱으로 인증할 수 있도록 해당 URL로 리디렉션하십시오. 사용자가 복귀한 후 백엔드에서 GET /v3/id-verification/wallets/verifications/{request_id}/를 호출하여 검증된 결과를 확인하거나, 서명된 status.updated webhook을 처리하십시오. 브라우저 리디렉션만으로는 성공적인 인증의 증거로 간주하지 마십시오. 두 연동 옵션 모두 동일한 가격 및 완료된 인증 기준 결제 규칙이 적용됩니다.

Google Wallet

Google Wallet을 사용하면 W3C Digital Credentials API를 통해 사용자가 휴대전화에서 정부가 보증하는 신분증을 귀하의 페이지나 앱과 공유할 수 있습니다. 프로덕션 및 샌드박스 환경 모두에서 이용 가능합니다. 샌드박스 애플리케이션은 별도의 등록이 필요하지 않습니다. 각 프로덕션 애플리케이션은 Google Wallet을 사용하기 전에 한 번 등록해야 합니다. 콘솔에서 신분증 인증 단계를 열고 지원 국가의 Google Wallet 행을 찾아 Google에 등록을 선택한 뒤 약 1분 정도 소요되는 일회성 설정을 완료하십시오. 사용자가 신분증을 공유할 때 Google에 귀하의 이름과 로고가 표시됩니다. 애플리케이션이 등록되기 전까지는 Google Wallet을 활성화한 워크플로 저장이 “Register this application with Google before enabling Google Wallet.”이라는 메시지와 함께 거부됩니다. Google Wallet 외에도 동일한 OpenID4VP 요청을 지원하고 호환 가능한 신분증(ID 패스 또는 모바일 운전면허증)을 보유한 다른 Android 지갑도 응답할 수 있으므로, 고객의 최종 사용자에게는 이 옵션이 Verify with digital ID로 표시됩니다.
  • 국가: 미국, 영국, 브라질, 싱가포르, 대만.
  • 자격 증명: 여권으로 생성된 Google Wallet ID 패스 및 지원되는 미국 주의 모바일 운전면허증.
  • 반환 항목: 이름, 생년월일, 문서 번호, 문서 만료일, 발급 국가 및 발급 기관, ID 패스의 경우 국적. 결과에는 자격 증명에 대한 signature_valid 판정도 포함됩니다. 인물 사진은 공유되지 않습니다.
  • 개인정보 보호: Didit은 필요한 필드만 요청하며, 해당 필드만 지갑에서 외부로 전송됩니다. 사용자는 자신의 기기에 있는 Google Wallet에서 공유를 직접 승인합니다.
리디렉션이 없습니다. 사용자는 브라우저 또는 Android 자체 지갑 프롬프트에서 확인하며, 데스크톱 브라우저는 지갑이 휴대전화에 있을 때 자체 QR 코드를 표시합니다. 인증은 귀하의 페이지 또는 앱에서 요청되므로 API 연동에는 페이지의 HTTPS 오리진이 필요합니다. Sessions API의 호스팅 플로우는 이를 지원하는 브라우저 및 기기에서만 이 방식을 제공하며, 그렇지 않은 경우에는 문서 폴백을 유지합니다. 자체 페이지 내에서 호스팅 플로우를 표시할 때는 Web SDK 0.5.1 이상을 사용하거나, iframe의 allow 속성에 digital-credentials-get을 추가하십시오. 이것이 없으면 브라우저가 iframe 내부에서 지갑 요청을 거부합니다.

기타 출시 예정 지갑

ConnectID(호주)는 샌드박스 테스트용으로 연동되어 있으며 지갑 카탈로그에 connectid로 표시됩니다. 사용자는 ConnectID 선택기에서 참여 테스트 은행을 선택하고, 해당 은행으로 로그인한 후 공유 요청을 검토합니다. 초기 신원 번들은 인증용 거래 참조와 함께 이름, 성, 생년월일을 요청합니다. 주소, 전화번호, 이메일 주소, 계좌 잔액 또는 거래 내역은 요청하지 않습니다. 공유 안내에는 Didit과 검증된 신원을 제공받는 기업이 명시됩니다. 은행 로그인 자격 증명은 은행에만 유지됩니다. 프로덕션 액세스는 계속 출시 예정이며, 샌드박스 테스트가 프로덕션 신원 인증을 활성화하지는 않습니다. 활성화하기 전에 승인된 프로덕션 사용 사례, 고객 온보딩, 필수 약관 및 인증이 완료되어야 합니다. 표에서 출시 예정으로 표시된 다른 지갑들도 프로덕션 환경에서는 계속 사용할 수 없습니다. 출시일은 보장되지 않습니다.

보증 수준

지갑이 eIDAS 보증 수준(low, substantial 또는 high)을 제공하는 경우, Didit은 결과에 실제로 주장된 수준을 기록합니다. ConnectID와 같이 지정된 eIDAS 수준이 없는 지갑은 지정되지 않음으로 표시되며, 해당 연동이 eIDAS 보증 주장을 의미하지는 않습니다. 지갑이 요청된 수준보다 낮은 수준을 반환하면 묵묵히 수준을 낮추는 대신 로그인이 실패합니다. 컴플라이언스 규칙이 이에 의존하는 경우 세션의 wallet_verification.level_of_assurance를 확인하십시오.

지갑별 레퍼런스

MitID

mitid · 사용 가능 Didit에 입력되는 정보: 이름 · 생년월일 · CPR 가명 (가명화됨)

BankID

bankid_se · 사용 가능 Didit에 입력되는 정보: 이름 · 개인 식별 번호

iDIN

idin · 사용 가능 Didit에 입력되는 정보: 이름 · 생년월일 · 주소

Finnish Trust Network

ftn · 사용 가능 Didit에 입력되는 정보: 이름 · 개인 식별 코드

Google Wallet

google_wallet · 사용 가능 Didit에 입력하는 정보: Didit에 입력되는 신원 정보 없음

Smart-ID

smart_id · 사용 가능 Didit에 입력하는 정보: 개인식별번호

Mobile-ID

mobile_id · 사용 가능 Didit에 입력하는 정보: 개인식별번호 · Mobile-ID 전화번호

BankID

bankid_no · 출시 예정 Didit에 입력하는 정보: 이름 · 생년월일 · 국민식별번호

Vipps

vipps · 출시 예정 Didit에 입력된 정보: 성명 · 생년월일 · 국가 식별 번호

Buypass ID

buypass · 출시 예정 Didit에 입력된 정보: 성명 · 생년월일 · 국가 식별 번호

itsme

itsme · 출시 예정 Didit에 입력된 정보: 성명 · 생년월일 · 국가 등록 번호

Personalausweis

personalausweis · 출시 예정 Didit에 입력된 정보: 성명 · 생년월일 · 국적 · 주소

Freja eID

frejaid · 출시 예정 Didit에 입력된 정보: 성명 · 생년월일 · 개인 번호

UAE PASS

uae_pass · 출시 예정 Didit에 입력되는 정보: 성명 · 에미레이트 ID 번호 · 국적 · 증명사진

gov.br

govbr · 출시 예정 Didit에 입력되는 정보: 성명 · CPF

OneID

oneid · 출시 예정 Didit에 입력되는 정보: 성명 · 생년월일

GOV.UK Wallet

govuk_wallet · 출시 예정 Didit에 입력되는 정보: 성명 · 생년월일 · 증명사진

에스토니아 ID 카드

idcard_ee · 출시 예정 Didit에 입력되는 정보: 성명 · 생년월일 · 개인 식별 코드

eParaksts mobile

eparaksts_mobile · 출시 예정 Didit에 입력된 정보: 성명 · 생년월일 · 개인 식별 코드

Bank iD

bankid_cz · 출시 예정 Didit에 입력된 정보: 성명 · 생년월일

MojeID

mojeid · 출시 예정 Didit에 입력된 정보: 성명 · 생년월일

Diia

diia · 출시 예정 Didit에 입력된 정보: 성명 · 생년월일 · 인물 사진

FranceConnect

franceconnect · 출시 예정 Didit에 입력된 정보: 성명 · 생년월일

Auðkenni

audkenni · 출시 예정 Didit에 입력하는 정보: 성명 · Kennitala

ConnectID

connectid · 출시 예정 Didit에 입력하는 정보: Didit에 신원 세부 정보가 입력되지 않음

EUDI Wallet

eudi · 출시 예정 Didit에 입력되는 정보: PID - 개인 식별 데이터

실패 및 대체 수단

verified 이외의 모든 결과는 해당 국가의 wallet.on_failure 스위치를 따릅니다. fallback_to_document는 사용자를 문서 캡처로 전환하고, decline은 신분증 인증 거부 상태로 세션을 종료합니다. 해당 국가에 문서 캡처가 비활성화되어 있는 경우 대체할 수단이 없으므로 fallback_to_document 설정이라도 거부 처리됩니다. 지갑 로그인에 실패한 경우에만 문서 캡처를 표시하려면 문서 캡처를 대체 수단으로만 제공을 참조하세요. 완료된 로그인에 대해서만 비용이 청구됩니다. 중단된, 취소된, 시간 초과된 및 실패한 로그인에는 비용이 청구되지 않습니다.

세션에 기록되는 정보

attributes에는 검증된 지갑 클레임이 포함되며, 해당 필드명은 지갑마다 다릅니다. 정규화된 신원 필드를 확인하려면 신분증 인증 결과의 full_name 및 date_of_birth를 사용하세요. 지갑별 표에는 이러한 정규화된 필드와 지갑 고유의 속성이 구분되어 있습니다. portrait는 사진을 공유하는 지갑에 대해서만 제공됩니다. signature_valid는 지갑이 반환한 서명된 어설션을 검증한 결과입니다. 로그인이 완료되면 true가 됩니다. 검증되지 않은 어설션은 로그인을 실패 처리하며, 승인된 결과를 생성하는 대신 wallet.on_failure 설정을 따릅니다. 전체 필드 유형은 신분증 인증 데이터 모델에서 확인할 수 있습니다.

지갑 구성

이 구성 예시는 선택한 국가에서 환경의 카탈로그에 선택한 모든 지갑이 available로 표시되어 있는 경우에만 사용해야 하는 구성 조각입니다. 이용할 수 없는 지갑을 전달하면 동일한 요청 내의 다른 방식을 포함하여 워크플로 저장 전체가 거부됩니다. Smart-ID 및 Mobile-ID 예시는 연동 가이드를 참조하세요.
wallet.enabled가 true인 경우 지갑을 하나 이상 활성화해야 하며, 그렇지 않으면 저장이 거부됩니다. 전체 레퍼런스는 워크플로 기능 구성에서 확인할 수 있습니다.

관련 문서

마지막 수정일 2026년 11월 7일