Unity용 SDK / 사용자 정의 ID를 사용하여 인증
 문서로 돌아가기

Unity용 SDK

  • 통합 가이드

  • 데모 프로젝트

  • 인증

  • 카탈로그

  • 구독

  • 프로모션

  • 아이템 구매

  • 플레이어 인벤토리

  • 사용자 계정 및 특성

  • 애플리케이션 빌드 가이드

  • 문제 해결


  • 사용자 정의 ID를 사용하여 인증

    사용자 정의 ID(서버에서 생성한 사용자 ID)를 통해 엑솔라 측에서 사용자를 인증할 수 있습니다.

    이 인증 옵션으로 수행할 수 있는 작업:

    사용자 정의 ID를 사용하여 사용자를 인증하려면 애플리케이션의 백엔드에서 사용자 정의 ID로 인증 API 호출을 구현해야 합니다. 이 호출은 결제 및 인벤토리 관리용 SDK 메소드에서 인증 토큰으로 사용할 수 있는 사용자 JWT(JSON Web Token)를 반환합니다.

    알림
    사용자가 자신의 ID를 사용하여 처음으로 인증을 완료하면 엑솔라 측에 새 계정이 자동으로 생성됩니다.
    활성 사용자 세션을 종료하려면 OAuthLogout SDK 메소드를 사용하세요.
    SDK 참조 문서
    SDK 메소드 및 해당 매개변수에 대해 알아봅니다.

    방법

    저희가 제공하는 방법 안내서에서 고급 설정에 대해 자세히 알아보세요.

    독자적인 인증 시스템 사용 방법

    SDK를 독자적인 인증 시스템과 통합할 수 있습니다. 이렇게 하기 위해, 사용자 정의 ID(자신의 서버에서 생성한 사용자 ID)를 사용하는 사용자 인증을 구현하여 인게임 스토어를 열고, 결제를 처리하고, 인벤토리를 관리합니다.

    독자적인 인증 시스템을 사용할 경우의 엑솔라 서버와의 상호 작용 흐름:

    1. 클라이언트가 귀하의 서버로 인증 요청을 전송합니다.
    2. 귀하의 서버는 사용자를 인증하여 사용자 정의 ID를 전달하는 사용자 JSON 웹 토큰(JWT)를 수신합니다.
    3. 엑솔라 서버가 사용자 JWT를 반환합니다.
    4. 귀하의 서버가 클라이언트에 사용자 JWT를 전달합니다.
    5. SDK 메소드가 인증 토큰 대신 수신한 사용자 JWT를 사용하여 인게임 스토어를 열고, 결제를 처리하고, 인벤토리를 관리합니다.

    독자적인 인증 시스템을 엑솔라 제품에 사용하는 방법:

    1. 게시자 계정에서 OAuth 2.0 클라이언트를 설정합니다.
    2. 서버 JWT 가져오기를 구현합니다.
    3. 사용자JWT 가져오기를 구현합니다.
    4. 사용자 JWT를 사용하여 인게임 스토어, 구매, 인벤토리 관련 작업을 수행하는 로직을 구현합니다.

    알림
    PlayFab 또는 Firebase 인증 시스템을 사용하는 경우 엑솔라에서 미리 만들어 제공하는 BaaS용 확장을 사용하여 사용자 JWT를 가져오세요.

    서버 OAuth 2.0 클라이언트 설정

    1. 게시자 계정에서 프로젝트를 열고 로그인 섹션으로 이동합니다.
    2. 로그인 프로젝트의 패널에서 구성을 클릭합니다.
    3. 보안 블록으로 이동한 후 OAuth 2.0 섹션을 선택합니다.
    4. OAuth 2.0 추가를 클릭합니다.
    5. OAuth 2.0 리디렉션 URI를 지정합니다.
    6. 서버(서버 간 연결) 상자를 선택 표시합니다.
    7. 연결을 클릭합니다.
    8. 클라이언트 ID와 비밀 키를 복사하여 저장합니다.

    서버 JWT 가져오기

    애플리케이션의 백엔드에서 JWT 생성 API 호출을 사용하여 서버 JWT를 가져오는 메소드를 구현합니다. 요청에 포함해야 하는 매개변수:

    알림
    서버 JWT는 59분 동안 유효합니다.

    사용자 JWT 가져오기

    애플리케이션의 백엔드에서 사용자 정의 ID로 인증 API 호출을 사용하여 사용자 JWT를 가져오는 메소드를 구현합니다. 요청에 X-Server-Authorization: <server_JWT> 헤더를 포함해야 하며, 여기서 <server_JWT>이전 단계에서 입수한 서버 JWT입니다.

    알림
    사용자 JWT는 24시간 동안 유효합니다. 이를 변경하려면 계정 관리자 혹은 integration@xsolla.com으로 이메일을 보내어 문의하세요.

    사용자 JWT 사용

    인게임 스토어를 열고, 결제를 처리하고, 인벤토리를 관리하려면 SDK 메소드를 사용합니다. SDK 메소드를 사용할 경우 사용자 JWT를 Token.Instance 속성으로 전달합니다.

    다음 튜토리얼에는 토큰 사용 예시가 포함되어 있습니다.

    만료 후 새 사용자 JWT를 수신하는 로직을 구현합니다. 새 토큰을 백그라운드 모드에서 수신하여 사용자가 애플리케이션에 다시 로그인하지 않아도 되게 할 것을 권장합니다.

    이 기사가 도움이 되었나요?
    감사합니다!
    개선해야 할 점이 있을까요? 메시지
    유감입니다
    이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
    의견을 보내 주셔서 감사드립니다!
    메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
    숨기기

    유용한 링크

    마지막 업데이트: 2022년 9월 13일

    오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.

    문제 보고
    콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
    후속 조치를 위해 이메일을 제공해 주세요
    의견을 보내 주셔서 감사드립니다!