본문으로 건너뛰기

7개의 게시물개의 게시물이 "age-verification" 태그를 포함

모든 태그 보기

위젯 및 연령 확인을 위한 모바일 통합 안내

모바일에서 k-ID를 통합하는 방법을 명확히 하기 위해 문서를 업데이트했습니다: 연령 게이트와 동의 흐름은 네이티브로 구축하고, 웹 임베드는 연령 확인 URL로 한정하세요.

새로운 기능​

연령 게이트 및 End-to-End 위젯에 대한 모바일 안내​

연령 게이트 및 end-to-end 위젯은 모바일 앱에 권장되지 않습니다. 모바일에서는 사용자 정의 워크플로를 사용하고 CDK UX 가이드라인에 따라 연령 게이트와 동의 UX 요소를 네이티브로 구축하세요.

모바일에서 지원되는 유일한 웹 임베드는 k-ID API가 반환하는 연령 확인 및 연령 보증 URL입니다. 특정 엔드포인트와 챌린지 유형은 모바일 앱 가이드를 참조하세요.

개편된 모바일 앱 가이드​

모바일 앱 가이드는 모바일에서 웹 임베드가 여전히 권장되는 흐름인 연령 확인을 중심으로 재구성되었습니다:

기본 브라우저 방법​

기본 외부 브라우저 방법이 모바일 구현 방법에 문서화되었습니다. 이 방법은 Android(Intent.ACTION_VIEW)와 iOS(UIApplication.open) 모두에서 작동하고, AgeKeys를 완전히 지원하며, redirectUrl 콜백을 통해 앱으로 포커스를 반환합니다.

기기 방향 안내​

연령 확인은 세로 방향에서 가장 잘 작동합니다. 인앱 브라우저 환경은 앱의 방향 고정을 상속하므로, 가로 방향으로 고정된 앱은 기본 외부 브라우저에서 확인 URL을 열어야 합니다. 브라우저는 자체 방향을 관리하므로 사용자가 세로로 회전할 수 있으며, 흐름이 완료되면 redirectUrl 콜백이 사용자를 앱으로 반환합니다.

업데이트된 문서​

다음 단계​

  • 모바일에서 통합하는 경우 사용자 정의 워크플로와 CDK UX 가이드라인을 사용하여 연령 게이트와 동의 UX를 네이티브로 구축하세요
  • 모바일에서는 연령 확인 URL만 임베드하고, 가로 고정 앱에는 기본 브라우저 방법을 사용하세요

신용카드 전용 연령 확인 엔드포인트

이제 신용카드만을 방식으로 사용하여 연령 확인을 수행하는 전용 엔드포인트 /age-verification/perform-credit-card-verification가 제공됩니다. 이는 기존 단일 방식 엔드포인트(ID, AgeKey, ConnectID)와 함께 사용할 수 있습니다.

새로운 기능​

  • POST /age-verification/perform-credit-card-verification. 자동 방식 선택을 우회하고 신용카드만으로 사용자를 확인합니다. 다른 단일 방식 엔드포인트와 동일한 요청 형식(jurisdiction, subject, criteria 및 선택적 options.redirectUrl / options.locale)을 받으며 id, url, shortUrl을 반환합니다.
  • 성인(18세 이상) 보증. 신용카드 확인은 정확한 연령 추정이 아니라 성인 보증 신호입니다. 카드 소유가 성인으로 제한된 관할권에 가장 적합합니다.
  • 상태 및 결과는 변경되지 않음. 평소와 같이 /age-verification/get-status를 폴링하거나 Verification.Result webhook을 처리하세요. 결과는 확인 method로 credit-card를 보고합니다.

문서​

Mock Providers 전환, 확인 방법 순서 지정, COPPA 2026 가이드

오늘 릴리스에서는 두 가지 새로운 Compliance Studio 기능과 COPPA 2026 규칙 개정을 위한 새로운 개발자 가이드를 추가했습니다.

새로운 기능​

  • Mock Providers / Real Providers 전환. 테스트 모드에서 실행 중인 확인 흐름에 Mock Providers(기본값)와 Real Providers 사이를 전환하는 TEST MODE 툴바가 표시됩니다. Mock Providers는 내장 시뮬레이터를 제공하여 페르소나 제출(Adult, Teen, Child 또는 Passes / Fails Age Check), 사용자 지정 연령 범위나 생년월일 입력, Inconclusive 또는 Fraudulent 실패 시뮬레이션을 지원합니다. 제출은 실제 제공업체와 동일한 서버 경로로 흐르므로 웹훅, 세션, DOM 이벤트가 동일하게 동작합니다.
  • 확인 방법 순서 지정. Assurance and Verification 탭에서 활성화된 각 방식에 드래그 핸들이 생겼습니다. 방식을 드래그하여 Family Connect 위젯에서 사용자에게 표시되는 순서를 변경하고, Reset to default order로 k-ID 기본 순서로 복원하며, Market Specific Rules를 통해 시장별로 다른 순서를 적용할 수 있습니다.
  • 새로운 Compliance Guides 섹션. 규정 준수 플레이북을 위한 새로운 최상위 문서 섹션이 오늘 2026 COPPA 규칙 개정과 함께 공개됩니다. 이 가이드는 COPPA 적용을 받는 사업자가 2026년 4월 22일 시행일 이전에 수행해야 하는 구성 업데이트를 안내합니다.

문서​

확인 방법을 폴백으로 구성할 수 있음

제품의 각 확인 방법을 사용·사용 안 함 외에 대체 수단만으로도 설정할 수 있습니다.

새 기능​

  • 대체 수단만: 이 설정이면 해당 확인 방법은 사용자가 다른 확인 방법을 시도한 뒤, 그 시도가 연령 신호를 만들지 못한 경우(연령 판정이 확정되지 않은 경우)에만 제공됩니다. 처음 목록에는 나타나지 않습니다.
  • 활용: 가벼운 수단으로 결과를 얻지 못했을 때만 더 강하거나 대체 수단을 제공하고, 처음부터 모든 선택지를 보여 주지 않을 수 있습니다.

문서​

  • 성인 확인: 방법별 사용, 사용 안 함 및 대체 수단만 설정
  • 확인 방법: 확인 동작 개요 및 대체 수단만 안내

연령 확인 API 응답의 짧은 URL 필드

연령 확인 생성 응답(POST /age-verification/perform-access-age-verification 및 기타 perform-* 연령 확인 엔드포인트)에 이제 id, **url**과 함께 **shortUrl**이 포함됩니다.

새로운 기능​

  • 짧은 링크: shortUrl은 전체 url과 동일한 확인 경험으로 리다이렉트하는 더 짧은 링크입니다. 쿼리 문자열이 길어 부적합할 때(예: QR 코드, 사용자가 다른 기기에서 확인을 마치는 경우) 사용하세요.
  • 전체 URL은 그대로: 세션 JWT는 여전히 전체 url의 token 쿼리 매개변수에 있습니다. 해당 URL을 임의로 짧게 만들거나 다시 만들지 마세요.
  • 불투명한 값: shortUrl은 불투명한 문자열로 취급하고, 반환된 그대로 표시·인코딩하세요. 경로나 쿼리 레이아웃은 나중에 바뀔 수 있으므로 고정 형식에 의존하지 마세요.

더 알아보기​

브라우저 및 기기 호환성

연령 확인 플로우에서 지원되는 브라우저와 기기를 빠르게 확인할 수 있도록 새로운 브라우저 및 기기 호환성 페이지를 문서에 추가했습니다.

새로운 기능​

브라우저 및 기기 호환성​

새 페이지에는 데스크톱 및 모바일의 최소 브라우저 버전, 그리고 임베디드 브라우저(iOS의 ASWebAuthenticationSession, Android의 Chrome Custom Tabs) 요구 사항이 안내되어 있습니다. 이를 통해 모든 인증 프로바이더의 호환성 요구 사항을 단일 참조로 통합했습니다.

새 문서​

확인 URL 유효 기간 및 get-status 문서

연령 확인 문서를 업데이트하여 URL 유효 기간, 만료된 URL 처리, 상태 확인 방법을 추가했습니다.

새로운 기능​

  • URL 유효 기간: 확인 URL은 생성 후 2주 동안 유효합니다. 만료 시간은 JWT의 token 쿼리 매개변수에 있으며, 표준 exp 클레임으로 URL이 아직 유효한지 확인할 수 있습니다.
  • 만료된 URL: 저장한 확인 ID로 /age-verification/get-status를 호출하세요. 확인을 찾을 수 없으면 새로 만드세요.
  • URL 없이 상태 확인: 확인 ID로 get-status를 호출하면 언제든 상태를 확인할 수 있습니다(URL 만료 후 또는 웹훅을 받지 못한 경우 등).
  • 보존 기간: 2주 이상 PENDING 상태로 남은 확인은 삭제되며 get-status에서 반환되지 않습니다.

업데이트된 문서​