안정적인 신원 확인을 위한 멱등성 API 클라이언트 설계 (KO)

데이터 일관성 보장멱등성 API 호출을 구현하여 신원 확인을 위한 반복된 요청이 여러 개의 충돌하거나 오류가 있는 결과로 이어지지 않도록 보장하고 데이터 무결성을 유지합니다.

네트워크 오류 완화의도하지 않은 부작용 없이 작업을 안전하게 재시도하여 일시적인 네트워크 오류를 원활하게 처리하도록 클라이언트를 설계하여 시스템 복원력을 향상시킵니다.

중복 작업 방지각 요청에 고유한 멱등성 키를 사용하여 API가 재생된 요청을 인식하고 적절하게 응답하도록 허용하여 확인 세션의 이중 처리를 방지합니다.

Didit과의 통합 간소화Didit의 API는 멱등성을 염두에 두고 구축되어 ID 확인, 라이브니스 및 AML 심사에 대한 안정적인 재시도를 자연스럽게 지원하는 개발자 우선 경험을 제공하여 통합 프로세스를 간소화합니다.

분산 시스템과 신원 확인의 과제

오늘날 상호 연결된 디지털 환경에서 신원 확인은 신뢰와 보안의 초석입니다. 새로운 사용자 온보딩부터 AML 규정 준수에 이르기까지 기업은 API 기반 신원 솔루션에 크게 의존합니다. 그러나 분산 시스템의 본질적인 특성(네트워크 지연, 시간 초과 및 일시적인 서비스 사용 불가능성)은 중요한 과제를 제시합니다. ID 확인 검사를 시작하는 것과 같은 작업이 요청이 여러 번 전송되더라도 정확히 한 번 처리되도록 어떻게 보장할 수 있을까요?

신중한 설계 없이는 간단한 네트워크 문제로 인해 클라이언트가 요청을 재시도하여 확인 시스템이 동일한 사용자의 ID 문서 또는 라이브니스 검사를 여러 번 처리할 수 있습니다. 이는 리소스를 낭비할 뿐만 아니라 일관되지 않은 상태를 초래하고 감사를 복잡하게 하며 사용자 경험을 저하시킬 수 있습니다. 여기서 멱등성 개념이 중요해집니다.

멱등성이란 무엇이며 KYC에 왜 중요한가요?

작업은 여러 번 실행해도 한 번 실행하는 것과 동일한 결과를 생성하면 멱등적입니다. API 호출의 맥락에서 멱등성 요청은 동일한 요청 페이로드를 동일한 멱등성 키와 함께 반복적으로 보내면 서버가 한 번만 처리하고, 이후의 동일한 요청은 기본 작업을 다시 실행하지 않고 원래 결과를 반환한다는 것을 의미합니다.

KYC(Know Your Customer) 및 신원 확인 프로세스에서 멱등성은 매우 중요합니다.

• 중복 확인 방지: 사용자가 ID를 확인하려고 시도했지만 네트워크 오류로 인해 시스템이 성공 응답을 받지 못했다고 가정해 봅시다. 멱등성이 없으면 재시도로 인해 두 번째 동일한 ID 확인 세션이 시작되어 중복 작업 및 잠재적인 요금이 발생할 수 있습니다.
• 일관된 상태 보장: AML 심사 검사가 시작되었지만 응답이 손실된 경우, 멱등성 클라이언트를 사용한 재시도는 새로운, 잠재적으로 다른 심사를 트리거하는 대신 원래 심사 상태가 반환되도록 보장합니다.
• 오류 처리 간소화: 개발자는 의도하지 않은 부작용에 대한 두려움 없이 강력한 재시도 로직을 구현할 수 있으므로 통합이 더욱 탄력적이고 디버깅하기 쉬워집니다.

멱등성 API 클라이언트 설계

신원 확인을 위한 멱등성 API 클라이언트를 구축하려면 멱등성 키를 활용해야 합니다. 이는 각 요청에 동반되는 고유한 클라이언트 생성 토큰입니다. 서버는 이 키를 사용하여 특정 기간(예: 24시간) 내에 중복 요청을 감지합니다.

1. 고유한 멱등성 키 생성

수행하는 모든 고유한 논리적 작업(예: 특정 사용자를 위한 새 확인 세션 생성)에 대해 고유한 멱등성 키를 생성합니다. UUID(Universally Unique Identifier)는 이에 대한 훌륭한 선택입니다. 이 키는 멱등적으로 만들려는 특정 작업과 연결되어야 합니다.

예: user_id_123에 대한 새 ID 확인 세션을 시작할 때 idempotency_key_abc를 생성합니다.

2. 요청에 멱등성 키 포함

멱등성을 지원하는 대부분의 API는 특정 헤더(종종 Idempotency-Key) 또는 요청 본문 내의 필드를 예상합니다. 클라이언트가 모든 관련 요청, 특히 리소스를 생성하거나 수정하는 요청에 이 키를 일관되게 포함하도록 보장합니다.

3. 강력한 재시도 로직 구현

일시적인 오류(예: 5xx 서버 오류, 네트워크 시간 초과)가 발생하면 클라이언트는 동일한 멱등성 키를 사용하여 요청을 재시도해야 합니다. 지터가 있는 지수 백오프는 재시도 간격을 두고 서버에 과부하가 걸리는 것을 방지하는 일반적인 전략입니다.

Didit의 비즈니스 콘솔용 '세션 생성' API를 고려해 보세요. API를 통해 확인 링크를 생성하는 경우 /v3/session/에 POST 요청을 보낼 수 있습니다. 이 요청이 시간 초과되면 동일한 멱등성 키로 다시 시도할 수 있습니다. Didit API는 키를 인식하고 세션이 이미 성공적으로 생성된 경우 기존 세부 정보를 반환하여 중복을 방지합니다. 이는 Didit의 ID 확인 및 수동 및 능동 라이브니스 검사와 같은 제품에 중요합니다.

4. 멱등성 키 저장 및 관리

클라이언트 애플리케이션은 작업 상태와 함께 멱등성 키를 저장해야 합니다. 이렇게 하면 재시도가 필요한 경우 올바른 키를 검색할 수 있습니다. 초기 요청과 잠재적인 재시도 사이에 애플리케이션이 충돌하거나 다시 시작될 수 있는 경우 키가 영구적으로 저장되도록 보장합니다.

멱등성을 넘어: 웹훅으로 신뢰성 향상

멱등성은 재시도를 효과적으로 처리하지만, 진정으로 신뢰할 수 있는 시스템은 웹훅도 통합합니다. 예를 들어 Didit은 사용자가 확인 흐름을 진행하고 최종 결과가 준비되면 구성된 웹훅 URL로 자동 업데이트를 보냅니다. 이 푸시 기반 알림 시스템은 API를 폴링할 필요성을 줄이고 시스템 복원력을 더욱 향상시켜 확정적인 상태 업데이트를 제공함으로써 멱등성을 보완합니다.

멱등성 클라이언트를 웹훅 알림과 결합하면 매우 견고한 통합을 달성할 수 있습니다. 클라이언트는 요청을 안전하게 재시도할 수 있으며, 초기 API 응답이 손실되더라도 AML 심사 및 모니터링 및 주소 증명과 같은 제품에 대한 확인 결과에 대한 실시간 업데이트를 시스템이 수신합니다.

Didit이 도움이 되는 방법

Didit은 견고성과 개발자 경험을 우선시하는 기업을 위한 매우 신뢰할 수 있고 멱등적인 통합을 지원하도록 처음부터 설계되었습니다. 당사의 AI 기반 플랫폼은 모듈식 아키텍처를 제공하여 확인 워크플로를 쉽게 구성할 수 있으며, 당사 API는 멱등성을 염두에 두고 구축되었습니다.

Didit의 ID 확인, 수동 및 능동 라이브니스, 1:1 얼굴 매치 또는 AML 심사를 위한 세션을 생성할 때 당사 시스템은 이러한 생성 요청의 멱등성을 본질적으로 처리합니다. 이는 개발 팀이 핵심 제품 구축에 집중할 수 있도록 하여 세션 생성 호출을 재시도해도 의도하지 않은 중복 확인이나 잘못된 요금이 발생하지 않도록 합니다. 개발자 우선 접근 방식에 대한 Didit의 약속에는 탄력적인 재시도 메커니즘 구현을 단순화하는 포괄적인 문서와 깔끔한 API 제공이 포함됩니다. 또한 Didit의 무료 핵심 KYC를 통해 선불 비용 없이 이러한 견고한 솔루션을 구현할 수 있으며, 성공적인 확인당 비용을 지불합니다. 설정 비용 없는 모델과 AI 기반 기능은 신원 확인 프로세스가 신뢰할 수 있을 뿐만 아니라 효율적이고 확장 가능하도록 보장합니다.

시작할 준비가 되셨나요?

Didit의 작동 방식을 볼 준비가 되셨나요? 오늘 무료 데모를 받으세요.

Didit의 무료 티어로 무료로 신원 확인을 시작하세요.