본문으로 건너뛰기

사용자 정의 워크플로

연령 게이트 및 Verifiable Parental Consent (VPC)에 대한 k-ID 사용자 정의 워크플로는 플레이어가 게임에 액세스할 수 있는지와 어떤 권한을 가지고 있는지 결정하는 여러 단계를 포함합니다.

워크플로 개요​

아래 플로우 차트는 k-ID 엔진 워크플로의 보기를 보여줍니다. API 호출은 워크플로에서 사용되는 지점에서 식별됩니다.

k-ID Workflow

참고: 사용자에 대한 **kuid**가 있는 경우 이를 사용하여 게임에 대한 세션이 있는지 조회할 수 있습니다.

워크플로 단계​

1. 연령 게이트 요구 사항 가져오기​

플레이어의 관할권으로 /age-gate/get-requirements를 호출하여 다음을 결정합니다:

  • 연령 게이트를 표시해야 하는지 여부
  • 허용되는 연령 수집 방법
  • 연령 임계값(디지털 동의 연령, 민사 연령, 최소 연령)
  • 연령 보증이 필요한지 여부

2. 연령 수집(필요한 경우)​

연령 게이트가 필요한 경우(shouldDisplay = true), 관할권에 대해 승인된 방법으로 플레이어의 연령을 수집합니다.

3. 액세스를 위한 연령 확인​

플레이어의 생년월일과 관할권으로 /age-gate/check를 호출하여 다음 단계를 결정합니다:

  • PROHIBITED: 플레이어가 최소 연령 미만 - 액세스 차단
  • CHALLENGE: 플레이어가 부모 동의 필요 - Challenge 생성
  • PASS: 플레이어가 계속 진행 가능 - 세션 생성 또는 반환

4. 동의 Challenge 처리(필요한 경우)​

Challenge가 생성되면:

  • 플레이어에게 Challenge 표시(QR 코드, OTP, 이메일 입력)
  • 신뢰할 수 있는 성인에게 알림(제공된 경우 이메일을 통해)
  • 동의 대기(웹훅 또는 폴링을 통해)
  • 결과 처리(동의가 부여되면 액세스 부여)

5. 세션 가져오기​

동의가 부여되거나 동의가 필요하지 않은 경우 /session/get를 호출하여 세션을 검색하여 플레이어의 권한 및 연령 상태를 가져옵니다.

6. 권한 사용​

각 권한의 enabled 및 managedBy 필드를 기반으로 게임의 기능에 대한 액세스를 제어하는 세션 권한을 사용합니다.

계정 시스템 통합​

일부 스튜디오는 여러 게임에 걸친 공통 계정 시스템을 가지고 있습니다. 이러한 상황에서는 동일한 게시자의 모든 게임에 대해 플레이어가 한 번만 연령을 요청받도록 계정 생성 흐름에서 직접 연령 게이트를 통합하고 Verifiable Parental Consent (VPC)를 처리하는 것이 바람직한 경우가 많습니다.

이러한 유형의 통합을 수행할 때 고려해야 할 몇 가지 중요한 사항이 있습니다:

VPC용 제품 컨텍스트​

게임이 모두 플레이하려면 계정이 필요한 경우 계정 생성 프로세스에서 VPC를 트리거할 수 있습니다. 그러나 동의 요청은 부모가 무엇에 동의하는지 알 수 있도록 게임별로 구체적이어야 합니다. k-ID API는 VPC를 트리거할 때 사용되는 API 키를 기반으로 동의 프로세스 중에 부모에게 제시해야 하는 제품을 결정합니다.

실제로 계정 시스템에 k-ID를 통합하려면 계정 설정 시 계정 생성 프로세스를 트리거한 게임을 결정하고 이를 k-ID API 키에 매핑할 수 있어야 합니다.

kuid를 사용하여 k-ID 세션 액세스​

k-ID는 어떤 형태의 신뢰할 수 있는 성인 동의를 받은 모든 플레이어에 대해 kuid 또는 k-ID 사용자 ID라는 전역 식별자를 노출합니다. kuid는 Session 객체의 속성으로 반환됩니다. 여러 게임에 걸쳐 계정 시스템과 통합할 때 Session에 kuid가 있으면 계정 시스템의 플레이어 신원과 연결해야 합니다. 이를 통해 올바른 제품에 대한 적절한 API 키를 사용하고 kuid만 매개변수로 제공하여 /session/get를 호출하여 모든 k-ID 제품에 대한 k-ID 세션이 있는 경우 검색할 수 있습니다.

여러 제품에 대한 세션 캐싱​

계정 시스템과 통합할 때 여러 제품의 세션이 캐시됩니다. Session 객체는 모두 k-ID 제품 ID를 키로 사용하여 계정 시스템의 맵으로 캐시할 수 있습니다. 플레이어가 새 게임을 플레이하려고 시도하면 Session 객체를 포함하는 맵을 제품 ID로 쿼리할 수 있으며, Session이 이미 있는 경우 플레이어는 추가 신뢰할 수 있는 성인 동의 없이 계속할 수 있습니다.

계정 수준 제품​

k-ID의 계정 시스템 통합을 구성할 때 Compliance Studio에서 각 게임에 대해 하나의 k-ID 제품을 만들고 계정 시스템 자체에 대해 별도의 k-ID 제품을 만드는 것이 일반적입니다. 이것은 모든 게임 또는 계정 자체에 공통되거나 전역적인 권한 및 공개를 나타내는 데 유용합니다.

제품이 계정 시스템에 매핑되면 각 게임에 대해 두 개의 Session 객체가 검색됨을 의미합니다: 하나는 게임에 매핑된 k-ID 제품용이고 다른 하나는 계정 시스템에 매핑된 k-ID 제품용입니다. k-ID API는 API 키로 제품 범위가 지정됩니다. 계정 시스템에 매핑된 k-ID 제품에 액세스하려는지 게임에 매핑된 k-ID 제품에 액세스하려는지에 따라 올바른 API 키를 사용해야 합니다.