본문으로 건너뛰기

Google Play Age Signals v0.0.4 `ageRangeSource` 지원

이제 k-ID는 google-play 플랫폼 연령 신호에 대해 Google Play Age Signals v0.0.4의 ageRangeSource 값을 declarationType으로 받아들입니다.

새로운 기능​

  • google-play 신호의 ageRangeSource. Google Play Age Signals v0.0.4에서는 userStatus가 ageRangeSource로 대체되었습니다. 연령 게이트 및 세션 엔드포인트를 호출할 때 Google Play age signals responses의 ageRangeSource 값을 PlatformAgeSignal의 declarationType으로 제공하세요.
  • 지원이 중단된 userStatus 값도 계속 작동합니다. k-ID는 이전 스키마를 사용하는 스토어를 위해 기존 userStatus 값을 계속 허용하므로, 아직 마이그레이션하지 않은 앱의 신호도 영향을 받지 않습니다.

문서​

이메일 연령 추정 전용 연령 확인 엔드포인트

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

새로운 기능​

  • POST /age-verification/perform-email-age-estimation. 자동 방식 선택을 우회하고 이메일 연령 추정만으로 사용자를 확인합니다. 다른 단일 방식 엔드포인트와 동일한 요청 형식(jurisdiction, subject, criteria 및 선택적 options.redirectUrl / options.locale)을 받으며 id, url, shortUrl을 반환합니다. subject.email 필드는 선택 사항입니다. 생략하면 사용자가 호스팅된 확인 페이지에서 이메일을 입력합니다.
  • 18세 이상 신호. 이메일 연령 추정은 정확한 연령 추정이 아니라 18세 이상 신호입니다. 대상이 18세 이상인지만 확인할 수 있으며 그보다 어린 연령대를 구분할 수 없으므로, 요청 기준을 이 기능에 맞추는 것은 사용자의 책임입니다.
  • 상태 및 결과는 변경되지 않음. 평소와 같이 /age-verification/get-status를 폴링하거나 Verification.Result webhook을 처리하세요.

문서​

Apple iOS "confirmed" 연령 신호 지원

이제 k-ID는 iOS 26.5 이상의 플레이어에 대해 Apple의 confirmed 선언 유형을 확인된 플랫폼 연령 신호로 받아들입니다.

새로운 기능​

  • confirmed는 확인된 Apple 선언 유형입니다. iOS 26.5부터 Apple의 Age Range Service는 selfDeclared, guardianDeclared, confirmed만 반환합니다. confirmed는 신용카드나 정부 발급 ID 같은 정밀 검증 방식으로 연령 범위가 설정되었음을 의미합니다. k-ID는 confirmed를 확인된 것으로 취급하므로 연령 게이트 억제, 확인 임계값 충족, ageVerification 기록이 가능합니다.
  • 지원이 중단된 유형도 계속 작동합니다. Apple은 paymentChecked, governmentIDChecked, guardianPaymentChecked, guardianGovernmentIDChecked의 지원을 중단했습니다. k-ID는 하위 호환성을 위해 이 유형들을 계속 허용하므로 이전 iOS 버전의 신호도 영향을 받지 않습니다.
  • selfDeclared와 guardianDeclared는 미확인으로 유지됩니다. 이들은 연령 확인 요건을 우회하지 않습니다.

문서​

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

모바일에서 k-ID를 가장 잘 통합하는 방법을 명확히 하기 위해 문서를 업데이트했습니다: 연령 게이트와 동의 단계에는 네이티브로 구축한 UX가 플레이어에게 가장 원활한 경험을 제공하며, 연령 확인 및 연령 보증 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을 표시할 때 가로 고정 앱에는 기본 브라우저 방법을 사용하세요

Permanently erase a session with a new flag on /session/delete

/session/delete can now permanently erase a session instead of only revoking it.

What's new​

  • hardDelete on POST /session/delete. Set to true to permanently delete a player session and its embedded consent, scoped to the calling product. Unlike the default revoke (which is internally retained), this physically removes the record and can't be undone.
  • Opt-in per developer. Available only to developers explicitly enabled for hard delete. Setting hardDelete: true without enablement returns FEATURE_DISABLED.
  • Every existing call is unaffected. Omitting hardDelete, or setting it to false, behaves exactly as /session/delete always has: a reversible revoke.
  • In-flight challenges are failed too. Any pending challenge tied to that exact session is set to FAIL, scoped to that session only (other sessions for the same player are untouched).

Documentation​

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

이제 신용카드만을 방식으로 사용하여 연령 확인을 수행하는 전용 엔드포인트 /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를 보고합니다.

문서​

자동 연령 보증 흐름을 위한 리디렉션 URL

이제 /age-gate/check는 자동 연령 보증 챌린지가 완료되면 k-ID가 이동할 리디렉션 URL을 받아들입니다. 이는 iframe 기반 결과 핸들러를 사용할 수 없는 최상위 브라우저 핸드오프(예: k-ID로 이동했다가 돌아오는 모바일 webview)를 위한 것입니다.

새로운 기능​

  • options.playerAgeAssurance.redirectUrl. /age-gate/check에 http(s) URL 또는 커스텀 스킴 모바일 딥링크(예: myapp://age-gate/return)를 전달합니다. 플레이어가 CHALLENGE_AGE_GATE_AGE_ASSURANCE 흐름을 완료하거나 닫으면, k-ID는 해당 URL에 challengeId, productId, sessionId(PASS인 경우), status(PASS 또는 FAIL)를 쿼리 파라미터로 추가하여 리디렉션합니다. URL의 기존 쿼리 파라미터는 유지됩니다.
  • 범위. 이 옵션은 CHALLENGE_AGE_GATE_AGE_ASSURANCE에만 적용됩니다. CHALLENGE_PARENTAL_CONSENT는 영향을 받지 않으며 계속 신뢰할 수 있는 성인 흐름을 통해 반환됩니다.
  • 결과는 서버 측에서 확인하세요. 리디렉션 쿼리 파라미터는 UX 힌트입니다. 액세스를 허용하기 전에 Challenge.StateChange webhook 또는 /challenge/get-status를 신뢰할 수 있는 정보 원본으로 취급하세요.

문서​

AI 코딩 에이전트용 공식 k-ID Agent Skills 번들

k-ID가 공식 Agent Skills 번들을 공개합니다 — k-ID가 지원하는 모든 관할 구역 요건(미국 COPPA, EU GDPR-Kids, 영국 AADC, 영국 온라인 안전법, 브라질 ECA Digital, 호주 온라인 안전법 / 소셜 미디어 최소 연령 등)에 대해 AI 코딩 에이전트에게 k-ID를 올바르게 통합하는 방법을 알려주는, 작고 조합 가능한 지시 팩입니다. Claude Code, Cursor, OpenAI Codex, GitHub Copilot, Gemini CLI를 비롯한 35개 이상의 AI 코딩 도구에서 동작합니다.

새로운 점​

  • 8개의 초점화된 스킬이 k-ID 통합 영역을 종단간으로 다룹니다: 연령 게이트, 부모 동의, 연령 확인 및 연령 보증(고위험 권한을 위한 verifiedAgeThreshold 흐름 포함), 세션 및 권한, 웹훅, 그리고 서버 신뢰 경계와 모바일/네이티브를 위한 횡단 보조 스킬까지.
  • 관할 구역 횡단 설계. 동일한 스킬로 COPPA, GDPR-Kids, 영국 AADC, 영국 OSA, 브라질 ECA Digital, 호주 온라인 안전법에 대한 통합을 구동합니다 — 관할 구역별 동작은 클라이언트 코드에서 분기시키지 않고 Compliance Studio에서 서버 측 구성으로 제어됩니다.
  • 원클릭 설치: Claude Code는 플러그인 마켓플레이스로 한 번에, 다른 호환 도구는 한 줄의 git clone으로 도입할 수 있습니다.
  • 오픈 표준 — 스킬은 Agent Skills 사양을 따르며, 특정 벤더에 구애받지 않고 모든 호환 에이전트에서 사용할 수 있습니다.
  • 문서 우선 계약 — 스킬은 통합 패턴과 알려진 함정만을 인코딩하며, API 형식은 이 문서 사이트에 링크되므로 API와 어긋날 일이 없습니다.

시작하기​

더 알아보기​

AI 제품 빠른 시작 가이드

AI 특화 제품을 위한 새로운 빠른 시작 가이드가 추가되었으며, Compliance Studio 참조에 AI 권한 카테고리가 함께 게시되었습니다.

새로운 기능​

  • AI 제품 빠른 시작. AI 제품의 엔드투엔드 통합을 안내합니다: Compliance Studio에서 AI 권한 구성, 부모 동의 수집, AI 기능 게이팅, 권한 변경 대응.
  • AI 권한 카테고리. 권한 참조에 AI 카테고리와 7개의 권한이 추가되었습니다: ai-chat, ai-media-generation, ai-voice-mode, ai-memory, ai-companion-chatbot, ai-media-upload, ai-model-training.

문서​

속도 제한 문서

k-ID API 및 사용자 대상 연령 확인과 보호자 동의 흐름의 기본 속도 제한이 이제 전용 페이지에 문서화되었습니다.

새로운 기능​

  • API 속도 제한. k-ID API 호출은 제품별로 제한됩니다: 라이브 모드 500 RPS, 테스트 모드 10 RPS. 제한을 초과하는 요청은 HTTP 429 Too Many Requests를 반환합니다.
  • 연령 확인 및 보호자 동의 흐름 속도 제한. 사용자 대상 흐름은 제품별로 제한됩니다: 라이브 모드 100 RPS, 테스트 모드 20 RPS. 제한에 도달하면 사용자에게 잠시 기다렸다가 다시 시도하라는 흐름 내 오류가 표시됩니다(서버에는 429가 표시되지 않습니다).
  • 제한 상향 요청. 이 값들은 기본값입니다. 제품에 더 높은 용량이 필요한 경우 k-ID 담당자에게 문의하세요.
  • 런칭 전 체크리스트 업데이트. 라이브 모드의 상한은 테스트 모드보다 훨씬 높기 때문에, CDK 및 AgeKit+ 런칭 전 체크리스트 모두 이제 속도 제한을 명시적으로 언급하고 새 페이지로 연결됩니다.

문서​