본문으로 건너뛰기

15개의 게시물개의 게시물이 "documentation" 태그를 포함

모든 태그 보기

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

모바일에서 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만 임베드하고, 가로 고정 앱에는 기본 브라우저 방법을 사용하세요

자동 연령 보증 흐름을 위한 리디렉션 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일 시행일 이전에 수행해야 하는 구성 업데이트를 안내합니다.

문서​

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

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

새 기능​

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

문서​

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

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

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

새로운 기능​

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

더 알아보기​

플랫폼 연령 시그널 문서

Apple iOS, Google Play, Xbox, Meta Horizon 및 k-ID의 연령 데이터가 k-ID에 어떻게 전달되는지, 연령 게이트를 건너뛸 수 있는 경우, 그리고 검증된 시그널과 검증되지 않은 시그널이 고위험 권한 및 연령 보증과 어떻게 연관되는지 설명하는 플랫폼 연령 시그널에 대한 종단간 문서를 게시했습니다.

새로운 기능​

CDK — 플랫폼 연령 시그널​

  • 플랫폼 연령 시그널 — 빠른 통합 경로, API 맵, 권장 요청 순서, POST /age-gate/check에서 플랫폼 시그널 처리 방식, 지원 플랫폼 및 검증된 선언 유형, 검증됨/검증되지 않음 시그널 동작.
  • 플랫폼 시그널 세부 정보 — 플랫폼별 필드 형태, 각 네이티브 시그널 획득 방법, 엔드포인트별 안내(get-requirements, check, get-default-permissions, session/get, get-platform-age-range, session/upgrade), 유효성 검사, 연령 충돌 및 k-id 시그널 규칙.

개념 및 관련 문서​

  • 연령 시그널 — 플랫폼 연령 시그널이 다른 시그널 유형과 어떻게 맞물리는지, PlatformAgeSignal 통합 세부 정보를 찾을 위치.
  • 고위험 기능을 위한 연령 보증 및 권한 — verifiedAgeThreshold와 연령 게이트에서 검증된 플랫폼 시그널에 대한 상호 연결된 동작.

API 참조(OpenAPI)​

세션 업그레이드, AgeVerification, platformAgeSignal 설명을 위 문서와 일치하도록 검증된 플랫폼 시그널 표현으로 맞추었습니다.

문서​

브라우저 및 기기 호환성

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

새로운 기능​

브라우저 및 기기 호환성​

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

새 문서​