암묵인증

작동 방식

암묵인증은 게시 플랫폼(Xbox, Steam, Stone, 및 Mail.ru)을 통해 로그인에서 사용자 자동 인증을 가능하게 합니다.

상호작용 절차:

  1. 사용자가 게임을 시작합니다.
  2. 게임이 SDK를 통해 플랫폼 인증 데이터를 수신합니다.
  3. 게임에서 요청 데이터를 생성하여 엑솔라 로그인 서버로 전송한 후 JWT를 받습니다.
  4. 엑솔라 로그인 서버가 사용자를 인증하고 JWT를 전송합니다.

Note: 엑솔라 런처를 통합한 경우 레시피를 사용하여 플랫폼을 통한 사용자 인증을 진행할 수 있습니다.

소셜 인증뿐만 아니라 암묵인증 동안에도 사용자 이메일을 수집할 수 있습니다. 설정하려면 소셜 인증 동안에 이메일 수집 레시피를 사용하세요.

사용자

이미 로그인을 통합하고 퍼블리싱 플랫폼 계정을 보유한 파트너.

획득 방법

로그인에서 암묵인증 설정 방법:

  1. 게시자 계정에서 암묵인증 설정.
  2. 게임을 배포할 플랫폼을 선택하고 지침을 따릅니다.

암묵인증 설정

  1. 게시자 계정 > 로그인 프로젝트 > SNS 연결 > 게시 플랫폼을 통한 인증으로 이동.
  2. 게시 플랫폼 선택 후 연결/편집 클릭.
  3. 모달 창에서 각 플랫폼에 대한 매개 변수를 설정합니다:
    • Steam:
      1. Application ID — 여러분의 앱 ID (AppID)
      2. Application Secret — 웹 API 키
    • Stone:
      1. Application ID — 여러분의 앱 ID (Stoneport ID)
      2. Application Secret — 비밀 키 (Stoneport Keys)
    • Mail.ru:
      1. Application ID — 여러분의 앱 ID (GMRID)
      2. Application Secret — 비밀 키 (Mail.ru 개발자 프로필에서 찾을 수 있는데 이는 System characteristics 탭 > Secret for api.games.mail/gc.mail.ru에서 찾을 수 있음)
  4. 연결을 클릭.

Note: Xbox의 경우 매개변수 값을 입력할 필요가 없습니다.

Xbox

  1. 세션 티켓 작성 (session_ticket 매개변수)은 사용자 인증 후 플랫폼 데이터에 기반합니다 . 매개변수는 <xid>-<uhs>;<XSTSToken> 템플릿에 기반하여 다음과 같이 생성됩니다:
    • <xid> — Xbox User ID;
    • <uhs> — user hash;
    • <XSTSToken> — Xbox Secure Token Service.
  2. session_ticket 매개변수를 암묵인증 요청(JWT 혹은 OAuth 2.0)에 전달합니다.

Steam

세션 티켓 작성(session_ticket 매개변수)은 사용자 인증 후 플랫폼 데이터에 기반합니다:

  1. 세션 티켓 가져오기.
  2. 암묵인증 요청에 (JWT 혹은 OAuth 2.0) session_ticket 매개변수로 전달.

Stone

session_ticketarea_id 매개변수는 사용자 인증 후 플랫폼으로부터 받을 수 있습니다. 이러한 매개변수를 Silent Authentication 요청에 전달합니다:

Copy
Full screen
Small screen
GET https://login.xsolla.com/api/social/stone/cross_auth?projectId=<project_id>&session_ticket=<session_ticket>&area_id=<area_id>&app_id=<app_id>&login_url=<login_url>

Mail.ru

uidhash 매개변수 (따르는 사용자 ID와 세션티켓 아날로그)는 사용자 인증 후 플랫폼으로부터 받을 수 있습니다. 매개변수를 Silent Authentication 요청에 전달합니다:

Copy
Full screen
Small screen
GET https://login.xsolla.com/api/social/mailru/cross_auth?projectId=<project_id>&uid=<user_id>&hash=<ticket>&fields=email&login_url=<login_url>