본문으로 건너뛰기

2개의 게시물개의 게시물이 "permissions" 태그를 포함

모든 태그 보기

플랫폼 연령 시그널 문서

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 설명을 위 문서와 일치하도록 검증된 플랫폼 시그널 표현으로 맞추었습니다.

문서

새로운 세션 및 권한 가이드 및 문서 업데이트

세션 및 권한 관리를 위한 포괄적인 가이드를 추가하고 중요한 설명을 추가하여 핵심 개념 문서를 업데이트했습니다.

새로운 기능

새로운 가이드: 세션 및 권한 관리

새로운 빠른 시작 가이드를 추가했습니다: 세션 및 권한 관리. 이 가이드는 다음에 대한 단계별 지침을 제공합니다:

  • Webhook 및 세션 비교를 사용한 권한 변경 감지
  • 세션 삭제 및 취소 처리
  • 플레이어에게 권한 변경 사항 전달
  • 권한 업그레이드 흐름 구현
  • Challenge가 세션과 어떻게 관련되는지 이해

이 가이드는 부모가 설정을 수정하거나 플레이어가 연령 상승하는 등 시간이 지나면서 권한 변경에 대응해야 하는 통합에 필수적입니다.

문서 업데이트

세션 문서

세션 개념 페이지에 중요한 설명을 추가했습니다:

  • 세션 ID 지속성: 플레이어는 프로덕트당 정확히 하나의 세션을 가집니다. 세션 ID는 권한 변경을 통해 유지되지만, 세션이 취소되고 동의 흐름이 다시 완료되면 새로운 세션 ID가 생성됩니다.
  • 세션 삭제 동작: 삭제된 세션은 오류 코드 NOT_FOUND로 HTTP 400을 반환합니다(404가 아님). 이것은 의도적인 것입니다—삭제된 세션은 존재하지 않았던 것처럼 처리해야 합니다.
  • 연령 상승 변경: 연령 상승 이벤트는 Webhook 알림을 트리거하지 않습니다. 이러한 변경 사항을 감지하려면 세션 비교를 사용해야 합니다.

권한 문서

권한 개념 페이지를 다음 내용으로 강화했습니다:

  • managedBy 필드 변경: managedBy가 시간이 지나면서 변경될 수 있음을 명확히 했습니다(예: 플레이어가 연령 상승할 때 GUARDIAN에서 PLAYER로).
  • 플레이어 관리 권한: 플레이어가 /session/upgrade API를 통해 PLAYER 관리 권한을 활성화하도록 요청하면 Challenge를 생성하지 않고 자동으로 활성화됩니다.
  • 권한 업그레이드 콘텐츠: 권한 업그레이드 문서를 더 쉽게 찾을 수 있도록 권한 페이지에 통합했습니다.

변경 사항

통합된 문서

  • 권한 업그레이드 개념 페이지를권한 페이지에 통합했습니다. 모든 참조를 새 위치로 업데이트했습니다.

다음 단계

  • 새로운세션 및 권한 관리 가이드를 검토하세요
  • 통합이 세션 삭제를 올바르게 처리하는지 확인하세요(NOT_FOUND로 HTTP 400)

이러한 업데이트에 대한 질문이 있거나 통합에 대한 지원이 필요한 경우 지원 팀에 문의하세요.