본문으로 건너뛰기

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를 통합하는 방법을 명확히 하기 위해 문서를 업데이트했습니다: 연령 게이트와 동의 흐름은 네이티브로 구축하고, 웹 임베드는 연령 확인 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+ 런칭 전 체크리스트 모두 이제 속도 제한을 명시적으로 언급하고 새 페이지로 연결됩니다.

문서​

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일 시행일 이전에 수행해야 하는 구성 업데이트를 안내합니다.

문서​

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

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

새 기능​

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

문서​

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