OAuth 2.0는 수명이 긴 토큰을 사용하는 대신 장기간 권한 부여(갱신 토큰)를 위해 수명이 짧은 토큰을 사용합니다. 갱신 토큰을 사용하면 사용자는 사용자 이름과 비밀번호 재입력을 하지 않고도 연장된 시간 동안 내 애플리케이션에 머물 수 있습니다. 이는 사용자 인증 데이터를 손상할 위험을 제거합니다.

권한 부여를 위한 OAuth 2.0 설정:

• 사용자 이름 또는 이메일 및 암호를 통해
• SNS를 통해
• Steam을 통해

옵션이 활성화 된 경우, 사용자 등록과 인증은 Register new user 및 JWT auth by username and password API 호출을 호출함으로 수행됩니다. Login & Account System 자산은 OAuth 2.0 권한 부여에 대하여 JWT 토큰 권한 부여와 같은 메소드를 제공합니다. 장면에서 엔진이 처음으로 개체를 초기화하면 Awake 메소드가 호출됩니다. 메소드는 현재 갱신 토큰의 만료를 확인합니다.

OAuth 2.0 권한 부여 구성:

1. 게시자 계정에서 로그인 프로젝트를 위한 OAuth 2.0 인증 설정을 합니다.
2. Unity 프로젝트에 자산 설정을 합니다.

관리자 페이지에서 로그인 프로젝트를 위한 OAuth 2.0 인증 설정

1. 게시자 계정으로 이동합니다.
2. 측면 메뉴에서로그인을 클릭합니다.
3. 로그인 프로젝트 창에서구성을 클릭합니다.
4. 보안 블록으로 이동해 OAuth 2.0 섹션을 선택합니다.
5. OAuth 2.0 추가를 클릭합니다.
6. OAuth 2.0 리디렉션 URI을 지정하고 연결을 클릭합니다.
7. 클라이언트 ID를 복사 및 저장합니다.

Unity 프로젝트에 자산 설정

1. Unity 프로젝트로 이동하세요.
2. 메인 메뉴에서 Window > Xsolla > Edit Settings를 클릭하세요.
3. Inspector 창에서:
   1. Authorization method 필드에서, OAuth2.0을 선택합니다.
   2. OAuth2.0 client ID 필드에서 게시자 계정에서OAuth 2.0을 설정할 때 받은 클라이언트 ID를 지정합니다.

갱신 토큰을 사용하려면 Login & Account System 자산에서 다음 메소드를 구현합니다.

• IsOAuthTokenRefreshInProgress — true를 토큰 갱신 프로세스 동안에 반환하고, 그렇지 않은 경우에는 false를 반환합니다.
• ExchangeCodeToToken — 유효한 JWT에 대하여 사용자 인증 코드를 교환합니다.

GetSocialNetworkAuthUrl 메소드에서 찾은 oauthState 인수는 OAuth 2.0 인증 중에 추가 사용자 검증에 사용됩니다. 이 인수는 발생 가능한 CSRF 공격을 완화하기 위해 사용됩니다.

Game Commerce 및 Cross-Buy 자산을 자체 로그인 시스템과 통합할 수 있습니다. 이를 수행하려면 페이 스테이션 액세스 토큰을 통해 애플리케이션에서 사용자 인증을 구현합니다.

자체 권한 부여 시스템 사용 시의 엑솔라 서버와의 상호 작용 흐름:

1. 클라이언트가 귀하의 서버에 인증 요청을 전송합니다.
2. 귀하의 서버가 사용자에게 권한을 부여하고 페이 스테이션 액세스 토큰을 받기 위해 엑솔라 서버에 요청을 전송합니다.
3. 엑솔라가 페이 스테이션 액세스 토큰을 반환합니다.
4. 귀하의 서버가 클라이언트에게 페이 스테이션 액세스 토큰을 전달합니다.
5. SDK 메서드가 받은 페이 스테이션 액세스 토큰을 권한 부여 토큰으로 사용하여 인게임 스토어를 열고, 결제 작업을 수행하고, 인벤토리를 관리합니다.

페이 스테이션 액세스 토큰 받기

애플리케이션의 백 엔드에서 HTTP POST 요청을 사용하여 페이 스테이션 액세스 토큰 받기 메서드를 구현하세요.

엑솔라 API는기본 HTTP 인증을 사용합니다. 요청은 반드시 Authorization: Basic <your_authorization_basic_key> 헤더를 포함해야 하며, 여기서 조건은 <your_authorization_basic_key>가 Base64 표준에 따라 엔코딩된 merchant_id:api_key 입니다. 게시자 계정에서 확인할 수 있는 매개 변숫값:

• merchant_id용은 프로젝트 설정 > 웹훅 > 판매자 ID 섹션으로 이동합니다.
• api_key용은 회사 설정 > API 키 섹션으로 이동합니다.

HTTP 요청:

POST https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/token

Headers:
  Authorization: Basic <your_authorization_basic_key>
Content-Type: application/json

Body:
  {
  "purchase": {
    "virtual_currency": {
      "quantity": 100
    },
    "virtual_items": {
      "items": [
        {
          "amount": 1,
          "sku": "SKU01"
        }
      ]
    }
  },
  "settings": {
    "currency": "USD",
    "language": "en",
    "project_id": 16184,
    "ui": {
      "components": {
        "virtual_currency": {
          "custom_amount": true
        }
      },
      "desktop": {
        "virtual_item_list": {
          "button_with_price": true,
          "layout": "list"
        }
      },
      "size": "medium"
    }
  },
  "user": {
    "country": {
      "allow_modify": true,
      "value": "US"
    },
    "age": 19,
    "email": {
      "value": "john.smith@mail.com"
    },
    "id": {
      "value": "user_2"
    },
    "name": {
      "value": "John Smith"
    }
  }
}

curl --request POST \
  --url https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/token \
  --header 'authorization: Basic <your_authorization_basic_key>' \
  --header 'content-type: application/json' \
  --data '{"user":{"id":{"value":"user_2"},"name":{"value":"John Smith"},"age":19,"email":{"value":"john.smith@mail.com"},"country":{"value":"US","allow_modify":true}},"settings":{"project_id":16184,"currency":"USD","language":"en","ui":{"size":"medium","desktop":{"virtual_item_list":{"layout":"list","button_with_price":true}},"components":{"virtual_currency":{"custom_amount":true}}}},"purchase":{"virtual_currency":{"quantity":100},"virtual_items":{"items":[{"sku":"SKU01","amount":1}]}}}'

<?php

$client = new http\Client;
$request = new http\Client\Request;

$body = new http\Message\Body;
$body->append('{"user":{"id":{"value":"user_2"},"name":{"value":"John Smith"},"age":19,"email":{"value":"john.smith@mail.com"},"country":{"value":"US","allow_modify":true}},"settings":{"project_id":16184,"currency":"USD","language":"en","ui":{"size":"medium","desktop":{"virtual_item_list":{"layout":"list","button_with_price":true}},"components":{"virtual_currency":{"custom_amount":true}}}},"purchase":{"virtual_currency":{"quantity":100},"virtual_items":{"items":[{"sku":"SKU01","amount":1}]}}}');

$request->setRequestUrl('https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/token');
$request->setRequestMethod('POST');
$request->setBody($body);

$request->setHeaders(array(
  'authorization' => 'Basic <your_authorization_basic_key>',
  'content-type' => 'application/json'
));

$client->enqueue($request)->send();
$response = $client->getResponse();

echo $response->getBody();

var client = new RestClient("https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/token");
var request = new RestRequest(Method.POST);
request.AddHeader("authorization", "Basic <your_authorization_basic_key>");
request.AddHeader("content-type", "application/json");
request.AddParameter("application/json", "{\"user\":{\"id\":{\"value\":\"user_2\"},\"name\":{\"value\":\"John Smith\"},\"age\":19,\"email\":{\"value\":\"john.smith@mail.com\"},\"country\":{\"value\":\"US\",\"allow_modify\":true}},\"settings\":{\"project_id\":16184,\"currency\":\"USD\",\"language\":\"en\",\"ui\":{\"size\":\"medium\",\"desktop\":{\"virtual_item_list\":{\"layout\":\"list\",\"button_with_price\":true}},\"components\":{\"virtual_currency\":{\"custom_amount\":true}}}},\"purchase\":{\"virtual_currency\":{\"quantity\":100},\"virtual_items\":{\"items\":[{\"sku\":\"SKU01\",\"amount\":1}]}}}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

import http.client

conn = http.client.HTTPSConnection("api.xsolla.com")

payload = "{\"user\":{\"id\":{\"value\":\"user_2\"},\"name\":{\"value\":\"John Smith\"},\"age\":19,\"email\":{\"value\":\"john.smith@mail.com\"},\"country\":{\"value\":\"US\",\"allow_modify\":true}},\"settings\":{\"project_id\":16184,\"currency\":\"USD\",\"language\":\"en\",\"ui\":{\"size\":\"medium\",\"desktop\":{\"virtual_item_list\":{\"layout\":\"list\",\"button_with_price\":true}},\"components\":{\"virtual_currency\":{\"custom_amount\":true}}}},\"purchase\":{\"virtual_currency\":{\"quantity\":100},\"virtual_items\":{\"items\":[{\"sku\":\"SKU01\",\"amount\":1}]}}}"

headers = {
    'content-type': "application/json",
    'authorization': "Basic <your_authorization_basic_key>"
    }

conn.request("POST", "/merchant/v2/merchants/{merchant_id}/token", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

require 'uri'
require 'net/http'

url = URI("https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/token")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(url)
request["content-type"] = 'application/json'
request["authorization"] = 'Basic <your_authorization_basic_key>'
request.body = "{\"user\":{\"id\":{\"value\":\"user_2\"},\"name\":{\"value\":\"John Smith\"},\"age\":19,\"email\":{\"value\":\"john.smith@mail.com\"},\"country\":{\"value\":\"US\",\"allow_modify\":true}},\"settings\":{\"project_id\":16184,\"currency\":\"USD\",\"language\":\"en\",\"ui\":{\"size\":\"medium\",\"desktop\":{\"virtual_item_list\":{\"layout\":\"list\",\"button_with_price\":true}},\"components\":{\"virtual_currency\":{\"custom_amount\":true}}}},\"purchase\":{\"virtual_currency\":{\"quantity\":100},\"virtual_items\":{\"items\":[{\"sku\":\"SKU01\",\"amount\":1}]}}}"

response = http.request(request)
puts response.read_body

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"user\":{\"id\":{\"value\":\"user_2\"},\"name\":{\"value\":\"John Smith\"},\"age\":19,\"email\":{\"value\":\"john.smith@mail.com\"},\"country\":{\"value\":\"US\",\"allow_modify\":true}},\"settings\":{\"project_id\":16184,\"currency\":\"USD\",\"language\":\"en\",\"ui\":{\"size\":\"medium\",\"desktop\":{\"virtual_item_list\":{\"layout\":\"list\",\"button_with_price\":true}},\"components\":{\"virtual_currency\":{\"custom_amount\":true}}}},\"purchase\":{\"virtual_currency\":{\"quantity\":100},\"virtual_items\":{\"items\":[{\"sku\":\"SKU01\",\"amount\":1}]}}}");
Request request = new Request.Builder()
  .url("https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/token")
  .post(body)
  .addHeader("content-type", "application/json")
  .addHeader("authorization", "Basic <your_authorization_basic_key>")
  .build();

Response response = client.newCall(request).execute();

var data = JSON.stringify({
  "user": {
    "id": {
      "value": "user_2"
    },
    "name": {
      "value": "John Smith"
    },
    "age": 19, 
    "email": {
      "value": "john.smith@mail.com"
    },
    "country": {
      "value": "US",
      "allow_modify": true
    }
  },
  "settings": {
    "project_id": 16184,
    "currency": "USD",
    "language": "en",
    "ui": {
      "size": "medium",
      "desktop": {
        "virtual_item_list": {
          "layout": "list",
          "button_with_price": true
        }
      },
      "components": {
        "virtual_currency": {
          "custom_amount": true
        }
      }
    }
  },
  "purchase": {
    "virtual_currency": {
      "quantity": 100
    },
    "virtual_items": {
      "items": [
        {
          "sku": "SKU01",
          "amount": 1
        }
      ]
    }
  }
});

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/token");
xhr.setRequestHeader("content-type", "application/json");
xhr.setRequestHeader("authorization", "Basic <your_authorization_basic_key>");

xhr.send(data);

토큰을 받으려면 전달해야 하는 요청 본문의 매개 변수:

요청 및 응답 예시를 API 참조에서 확인하세요.

사용자 JWT 사용

인게임 스토어 열기, 결제하기, 인벤토리 관리에 페이 스테이션 액세스 토큰을 사용하려면 이를 SDK 메서드의 XsollaLogin.Instance.Token 및 XsollaStore.Instance.Token 속성에 전달합니다.

튜토리얼에서 권한 부여 토큰 사용 예시를 참고하세요.

• 실질 화폐용 가상 아이템 판매
• 인게임 재화용 가상 아이템 판매
• 가상 화폐 잔액 표시
• 인벤토리에 아이템 표시

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

기본 인증은 모바일 기기에서 구성된 SNS 계정을 통해 사용자가 여러분의 애플리케이션에 로그인할 수 있게 합니다.

사용자가 처음 로그인하면, SNS 애플리케이션은 실행된 다음 사용자 인증 권한을 요청합니다. 그후에는 인증이 자동으로 사용자에게 아무것도 요구하지 않고 자동으로 수행됩니다.

현재 SDK가 다음 SNS를 통한 기본 인증을 구현했습니다.

• Google
• Facebook
• WeChat
• QQ

기본 인증 구성 방법:

1. Android용 Unity 프로젝트 빌드를 생성합니다.
2. 개발자 계정에서 SNS용 애플리케이션 구성 방법:
   1. Facebook을 통한 인증:
      1. 등록하고 새 애플리케이션을 만듭니다.
      2. Facebook 개발자 계정에서 애플리케이션 페이지를 설정합니다.
   2. Google을 통한 인증은 Google API 콘솔에서 프로젝트를 설정합니다.
   3. WeChat을 통한 인증:
      1. 등록하고 새 애플리케이션을 만듭니다.
      2. 검토용 애플리케이션을 제출합니다.
   4. QQ를 통한 인증:
      1. 등록하고 새 애플리케이션을 만듭니다.
      2. 검토용 애플리케이션을 제출합니다.

3. 엑솔라 측에서 SNS를 통한 인증 설정 방법:
   1. Facebook 및 Google은 게시자 계정에서 SNS 연결을 설정합니다.
   2. WeChat 및 QQ는 계정 관리자에게 문의합니다.
4. Unity 프로젝트용 자산을 설정합니다.

Android용 Unity 프로젝트 빌드 생성

1. Unity 프로젝트로 이동하십시오.
2. 메인 메뉴에서 File > Build settings를 클릭하십시오.
3. Platform 패널에서 Android를 클릭하십시오.
4. Build를 클릭하십시오.
5. 해쉬 키가 형성되었는지 확인하십시오:
   1. 메인 메뉴에서 Window > Xsolla > Edit Settings를 클릭하십시오.
   2. Android debug hash key 필드에서 해쉬 키가 표시되는지 확인하십시오.

추가 고유 인증 구성을 위해서는 다음이 필요합니다.

• Package Name는 Inspector 창에서 찾을 수 있는데 이는Android 플랫폼을 File > Build settings에서 선택한 이후입니다.
• Android class name는 Window > Xsolla > Edit Settings > Inspector > Android class name에서 찾을 수 있습니다.
• Android debug hash key는 Window > Xsolla > Edit Settings > Inspector > Android debug hash key에서 찾을 수 있습니다.

Facebook 개발자 계정의 어플리케이션 페이지 설정

1. Facebook 개발자 계정의 프로젝트 설정으로 이동합니다.
2. 설정 > 기본으로 이동합니다.
3. 플랫폼 추가를 클릭하고 Android를 선택합니다.
4. Unity 프로젝트의 Package Name을 Google Play 패키지 이름 필드에서 지정합니다.
5. Unity 프로젝트의 Android class name 을 클래스 이름 필드에서 지정합니다.
6. Unity 프로젝트의 Android debug hash key 를 키 해시 필드에서 지정합니다.
7. 변경 내용 저장을 클릭합니다.

추가 고유 인증 구성을 위해서는 설정 > 기본 섹션의 프로젝트 설정에 있는 앱 ID와 앱 시크릿 코드가 필요합니다.

Google API 콘솔에서 프로젝트 설정

1. Google API 콘솔로 이동합니다.
2. 새 프로젝트를 클릭합니다.
3. 프로젝트 이름과 위치를 지정하고 저장을 클릭합니다.
4. 만든 프로젝트로 이동하여 OAuth 동의 화면을 측면 메뉴에서 클릭합니다.
5. 외부 옵션을 선택하고 생성을 클릭합니다.
6. 필요한 매개 변수를 지정하고 저장을 클릭합니다.
7. 측면 메뉴에서 자격 증명을 클릭합니다.
8. Unity 애플리케이션용 OAuth 2.0 클라이언트 생성 방법:

1. 1. 자격 증명 생성을 클릭하고 OAuth 클라이언트 ID를 선택합니다.
   2. Android를 애플리케이션 유형 필드에서 지정합니다.
   3. 이름을 지정합니다.
   4. Unity 프로젝트의 Package Name을 패키지 이름 필드에서 지정합니다.
   5. Unity 프로젝트의 Android debug hash key를 SHA-1 인증 지문 필드에서 지정합니다.
   6. 생성을 클릭합니다.
   7. 확인을 클릭합니다.

9. 웹 애플리케이션용 OAuth 2.0 클라이언트 생성 방법:
   1. 자격 증명 생성을 클릭하고 OAuth 클라이언트 ID를 선택합니다.
   2. 웹 애플리케이션을 애플리케이션 유형 필드에서 지정합니다.
   3. 이름을 지정합니다.
   4. URI 추가를 권한이 부여된 리디렉션 URI 섹션에서 클릭하고 https://login.xsolla.com/api/social/oauth2/callback URI을 지정합니다.
   5. 생성을 클릭합니다.
   6. 확인을 클릭합니다.

추가 고유 인증 구성을 위해서는 웹 어플리케이션의 클라이언트 ID 설정에서 Client ID와 Client Secret가 필요합니다.

엑솔라 관리자 페이지에서 로그인 프로젝트용 SNS 설정

1. 게시자 계정에서 프로젝트를 엽니다.
2. 로그인을 사이드 메뉴에서 클릭하고 로그인 프로젝트 > 나의 로그인 프로젝트 > SNS 연결로 이동합니다.
3. Facebook을 통해 인증 설정 방법:

1. 1. 편집을 Facebook 패널에서 클릭하고 상태를 연결 끊김으로 변경합니다.
   2. Facebook 개발자 계정의 앱 ID를 애플리케이션 ID 필드에서 지정합니다.
   3. Facebook 개발자 계정의 앱 암호를 애플리케이션 암호 필드에서 지정합니다.
   4. 연결을 클릭합니다.

4. Google을 통한 인증 설정 방법:
   1. 편집을 Google 패널에서 클릭하고 상태를 연결 끊김으로 변경합니다.
   2. Google API 콘솔의 웹 애플리케이션용 클라이언트 ID를 애플리케이션 ID 필드에서 지정합니다.
   3. Google API 콘솔의 웹 애플리케이션용 클라이언트 암호를 애플리케이션 암호 필드에서 지정합니다.
   4. 연결을 클릭합니다.

Unity 프로젝트에 대한 자산 설정

1. Unity 프로젝트로 이동합니다.
2. Window > Xsolla > Edit Settings를 메인 메뉴에서 클릭합니다.
3. 애플리케이션 ID 지정:
   1. Facebook App ID 필드의 Facebook 개발자 계정에서 앱 ID를 지정합니다.
   2. Google server ID 필드의 Google API 콘솔에서 웹 애플리케이션용 클라이언트 ID를 지정합니다.
   3. WeChat App ID의 WeChat 애플리케이션 설정에서 AppID를 지정합니다.
   4. QQ App ID의 QQ 애플리케이션 설정에서 AppID를 지정합니다.

   이 기사가 도움이 되었나요?

   감사합니다!

   개선해야 할 점이 있을까요? 메시지 전송

   유감입니다

   이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지 전송

   의견을 보내 주셔서 감사드립니다!

   메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
   숨기기

네이티브 인증을 사용하면 플레이어가 설치된 Steam 애플리케이션을 통해 여러분의 애플리케이션으로 진입할 수 있습니다.

네이티브 인증 설정 방법:

1. 게시자 계정에서 Steam을 통한 암묵 인증 설정.
2. Unity 프로젝트 구성.
3. 이벤트 처리 구성.
4. Steam을 통한 인증 확인.

내 Unity 프로젝트 구성하기

1. 수동 생성steam_appid.txt으로 파일을 만들고 Steam의 할당 ID를 거기에 입력합니다. 그리고, 이 파일을 여러분 프로젝트의 Assets 카탈로그

2. Unity 프로젝트를 엽니다.
3. 메인 윈도우에서 Window > Xsolla > Edit Settings로 이동합니다.
4. Inspector 창에서:
   1. Use Steam authorization 박스를.
   2. Steam App ID 필드에서 확인하고, 여러분 애플리케이션의 Steam ID를 명시합니다. 이 값은 steam_appid.txt 파일의 값과 같아야 합니다.

이벤트 처리 구성하기

Steam을 통해 사용자를 인증하려면, session ticket을 SteamAuth 메소드를 통해 받아야 합니다. 받은 값은 RequestTokenBy 메소드 호출 시 전달합니다. 그 결과로, API호출 시 쓰이는 토큰을 얻게 됩니다.

Steam을 통한 인증 확인

1. 단독 플랫폼을 위한 Unity 프로젝트 빌드 생성.
2. Steam 실행 후 로그인.
3. 내 애플리케이션 실행. 만약 모든 것이 정상이면 Steam 팝업 창이 나타납니다.

토큰 무효화를 통해 여러분 애플리케이션 상의 사용자 인증 데이터의 보안을 개선할 수 있습니다. 옵션을 사용하는 경우, 매번 사용자 인증 시마다 새로운 토큰이 무효화 될 기존 토큰을 대체하게 됩니다.

SDK 사용 시, 기존 토큰의 무효화 및 신규 토큰의 생성은 Auth by username and password 및 Auth via social network API 호출을 호출하여 이루어지게 되는데, with_logout 매개변수 값이 1 인 경우에 한합니다.

Unity 프로젝트에서의 토큰 무효화 방법:

1. 메인 메뉴에서Window > Xsolla > Edit Settings로 이동.
2. Inspector 창에서, Enable JWT invalidation 체크박스를 활성화합니다.

엑솔라 런처를 사용하여 여러분의 애플리케이션을 사용자에게 전달하고 업데이트할 수 있습니다. 런처는 인증 도구를 내장하고 있습니다. 사용자 이름과 비밀번호의 재입력을 피하기 위하여 런처를 통하여 여러분 애플리케이션에서 인증하도록 설정하세요.

함께 작업하기 위한 SDK와 런처를 설정

1. 런처 설정은 게시자 계정에서 합니다.

2. 런처 UI 맞춤 설정.

3. 런처 권한 부여 로직을 귀하의 애플리케이션에서 구현합니다.
4. 런처 설치 파일 및 빌드 아카이브를 생성합니다.
5. 애플리케이션 빌드를 생성합니다.
6. 엑솔라 업데이트 서버에 애플리케이션 빌드를 업로드합니다.

런처를 통해 인증용 로직 구현하기

런처를 통한 애플리케이션의 권한 부여 절차:

1. 런처에서 사용자가 권한을 부여받습니다.
2. 사용자가 애플리케이션을 설치하고 실행합니다.
3. 런처가 애플리케이션을 실행하고 사용자 매개 변수를 명령 줄을 통해 전달합니다. 권한 부여 토큰이 xsolla-login-token 매개 변수에서 전달됩니다.
4. 애플리케이션이 명령 줄 매개 변수를 처리하고 토큰을 얻습니다. 토큰 처리 스크립트 예시는 데모 프로젝트에서 볼 수 있습니다.
5. 애플리케이션인 받은 토큰의 유효성을 검사합니다. 토큰 유효성 검사 스크립트 예시는 프데모 프로젝트에서 볼 수 있습니다.
6. 애플리케이션이 권한 부여 페이지를 표시하지 않고 자동으로 사용자에게 권한을 부여합니다. 사용자 권한 부여 스크립트 예시는 데모 프로젝트에서 볼 수 있습니다.

애플리케이션 빌드 만들기

1. Unity 프로젝트로 이동합니다.
2. Window > Xsolla > Edit Settings을 메인 메뉴에서 클릭합니다. Inspector 창에서:
   1. Project ID 필드에서 프로젝트 ID를 지정하는데, 이는 게시자 계정 > 프로젝트 설정 > 프로젝트 ID에서 찾을 수 있습니다.
   2. Login ID 필드에서 로그인 ID를 지정하는데, 이는 게시자 계정 > 런처 > 일반 설정 > 인증에서 찾을 수 있습니다.

3. 토큰이 처리되고 있는 사용자 권한 부여 장면을 실행합니다.
4. 메인 메뉴에서 File > Build settings을 클릭한 다음 Add Open Scenes을 클릭합니다. 권한 부여 장면이 목록에 첫 번째로 추가되었는지 확인합니다.
5. Build를 클릭합니다.
6. 팝업 창에서 완료된 빌드가 위치할 디렉터리로 가는 경로를 지정합니다.

장치 ID 인증은 사용자가 모바일 장치에서 등록 데이터를 입력하지 않고 애플리케이션 사용을 시작할 수 있게 합니다. 애플리케이션에 사용자가 처음으로 장치 ID를 사용하여 로그인할 때 새로운 계정이 자동으로 생성되고 사용자는 사용자 이름, 이메일 주소 또는 다른 데이터를 입력하지 않아도 됩니다.

장치 ID를 이용하여 하나 이상의 장치에서 백그라운드 모드로 사용자 인증을 구현할 수 있습니다. 이 기능을 사용하려면 사용자는 장치 ID를 외부 계정에 연결해야 합니다.

SDK는 Android 및 iOS에서 모바일 장치 ID를 통한 인증을 지원합니다.

장치 ID 가져오기

장치 ID는 플랫폼에 의해 생성되며 모바일 장치에 설치된 애플리케이션에서 사용할 수 있습니다. SDK는 플랫폼 API를 사용하여 플랫폼값을 가져온 다음, 이 값을 엑솔라 API를 사용하여 여러 기능을 수행하는 데에 사용합니다.

iOS 장치 ID는 UIDevice.identifierForVendor 속성에서 전달됩니다. 표준 Unity 메서드 SystemInfo.deviceUniqueIdentifier는 ID 확인에 사용됩니다.

Android 장치 ID는 android.provider.Settings.Secure.ANDROID_ID 상수에서 전달됩니다. SDK는 자체 논리를 사용하여 ID를 확인합니다. 이는, 표준 Unity 메서드가 Android 장치 ID를 엑솔라 API 호출에 적합하지 않은 MD5 해시로 반환하기 때문입니다.

SDK 메소드

SDK는 다음 기능용 메서드를 구현합니다.

인증

계정 업그레이드

장치 관리