BaaS認証によるショップビルダーを利用する
ショップビルダーをBaaSの認可システムと併用することで、ゲーム内アイテムを販売することができます。この場合の相互作用は次のとおりです:
- ユーザーは、BaaSの認証システムを介してアプリケーションにログインします。
- BaaSサービスは、ユーザーIDを渡してエクソーラサーバーにユーザーJSON Web Token(JWT)を要求します。
- エクソーラサーバーは、ユーザーJWTをBaaSサービスに返します。
- BaaSサービスは、ユーザーJWTをアプリケーションに渡します。
- アプリケーションはユーザーJWTを利用して、APIを使用してエクソーラサーバーと相互作用します。
お知らせ
ユーザー認証のロジックを実装していない場合は、エクソーラログインを統合し、PlayFabやFirebaseにユーザーデータの保存を設定することが可能です。これにより、ログインAPIを使用してユーザーを認証したり、JWTを受信して他のエクソーラ製品のAPIと相互作用することができます。
- パブリッシャーアカウントで、標準のログインプロジェクトをあなたのプロジェクトに接続します。
- サーバーOAuth 2.0クライアントをセットアップします。
- FirebaseとPlayFabの説明に従って、既成の機能をプロジェクトに追加してください。
サーバーOAuth 2.0クライアントをセットアップする
- パブリッシャーアカウントでプロジェクトを開き、プレイヤー > ログインセクションに移動します。
- ログインプロジェクトのパネルでの「構成」をクリックします。
- セキュリティブロックに移動してOAuth 2.0セクションに移動します。
- 「OAuth 2.0を追加」をクリックします。
- OAuth 2.0のリダイレクトURIを指定します。
- サーバー(サーバー・トゥ・サーバー接続)チェックボックスを入ります。
- 「接続」をクリックします。
- クライアントIDと秘密鍵をコピーして保存してください。
Firebaseプロジェクトにクラウド機能を追加する
- Firebaseプロジェクトを初期化します。
- ユーザーJWTの受信機能をインポートして設定します。そこで:
<ProjectID>
はプロジェクトIDで、パブリッシャーアカウントでプロジェクト名の横に表示されます。<LoginID>
は、パブリッシャーアカウントを開き、プレイヤー > ログイン > ダッシュボード > ログインプロジェクトセクションに移動し、ログインプロジェクト名の横にある「IDをコピー」をクリックすることで取得できるログインIDです。<OAuthClientID>
はサーバーOAuth 2.0クライアントをセットアップする時に受信したクライアントIDです。<OAuthSecretKey>
はサーバーOAuth 2.0クライアントをセットアップする時に受信した秘密鍵です。
ユーザーJWTを受信するための機能コード:
Copy
- javascript
1const projectId = "<ProjectID>";
2const loginProjectId = "<LoginID>";
3
4const serverOauthClientId = <OAuthClientID>;
5const serverOauthClientSecret = "<OAuthSecretKey>";
6
7exports.getXsollaLoginToken = functions.https.onCall((data, context) => {
8 if (!context.auth) {
9 throw new functions.https.HttpsError(
10 "failed-precondition",
11 "The function must be called while authenticated."
12 );
13 }
14
15 const postData =
16 `grant_type=client_credentials&client_secret=${serverOauthClientSecret}&client_id=${serverOauthClientId}`;
17
18 const options = {
19 hostname: "login.xsolla.com",
20 port: 443,
21 path: "/api/oauth2/token",
22 method: "POST",
23 headers: {
24 "Content-Type": "application/x-www-form-urlencoded",
25 "Content-Length": postData.length,
26 },
27 };
28
29 return new Promise( (resolve, reject) => {
30 const req = https.request(options, (res) => {
31 if (res.statusCode !== 200) {
32 reject(
33 new functions.https.HttpsError(
34 "internal",
35 "Server token not received"
36 )
37 );
38 }
39 let body = [];
40 res.on("data", (d) => {
41 body.push(d);
42 });
43 res.on("end", () => {
44 try {
45 body = JSON.parse(Buffer.concat(body).toString());
46 } catch (e) {
47 reject(
48 new functions.https.HttpsError(
49 "internal",
50 "Malformed server token response"
51 )
52 );
53 }
54 getClientToken(context.auth.uid, body.access_token, resolve, reject);
55 });
56 });
57 req.on("error", (e) => {
58 reject(new functions.https.HttpsError(
59 "internal",
60 "Internal error while server token flow"
61 ));
62 });
63
64 req.write(postData);
65 req.end();
66 });
67});
68
69// eslint-disable-next-line require-jsdoc
70function getClientToken(userId, serverToken, resolve, reject) {
71 const postData = JSON.stringify(
72 {
73 "server_custom_id": userId,
74 }
75 );
76
77 const path =
78 `/api/users/login/server_custom_id?projectId=${loginProjectId}&publisher_project_id=${projectId}`;
79
80 const options = {
81 hostname: "login.xsolla.com",
82 port: 443,
83 path: path,
84 method: "POST",
85 headers: {
86 "Content-Type": "application/json",
87 "Content-Length": postData.length,
88 "X-Server-Authorization": serverToken,
89 },
90 };
91
92 const req = https.request(options, (res) => {
93 if (res.statusCode !== 200) {
94 reject(
95 new functions.https.HttpsError(
96 "internal",
97 "Client token not received"
98 )
99 );
100 }
101 let body = [];
102 res.on("data", (d) => {
103 body.push(d);
104 });
105 res.on("end", () => {
106 try {
107 body = JSON.parse(Buffer.concat(body).toString());
108 } catch (e) {
109 reject(
110 new functions.https.HttpsError(
111 "internal",
112 "Malformed client token response"
113 )
114 );
115 }
116 resolve({
117 "token": body.token,
118 });
119 });
120 });
121 req.on("error", (e) => {
122 reject(new functions.https.HttpsError(
123 "internal",
124 "Internal error while client token flow"
125 ));
126 });
127
128 req.write(postData);
129 req.end();
130}
- この例のように、機能を実際の使用環境に展開します。
- アプリケーションから機能を呼び出すため、クライアントサイドロジックを追加します。機能名には
getXsollaLoginToken
を指定します。パラメータを渡す必要はありません。 - アプリケーションでは、APIを操作するためのメソッドを自分で実装するか、エクソーラSDKを使用します。
PlayFabプロジェクトにクラウドスクリプトを追加する
- ユーザーJWTを受信するための機能コードを含むJSファイルを作成します。そこで:
<ProjectID>
はプロジェクトIDで、パブリッシャーアカウントでプロジェクト名の横に表示されます。<LoginID>
は、パブリッシャーアカウントを開き、プレイヤー > ログイン > ダッシュボード > ログインプロジェクトセクションに移動し、ログインプロジェクト名の横にある「IDをコピー」をクリックすることで取得できるログインIDです。<OAuthClientID>
はサーバーOAuth 2.0クライアントをセットアップする時に受信したクライアントIDです。<OAuthSecretKey>
はサーバーOAuth 2.0クライアントをセットアップする時に受信した秘密鍵です。
お知らせ
既にプロジェクトでクラウドスクリプトを使用している場合は、ユーザーJWTを受信するための機能をコードの最後に追加してください。
Copy
- javascript
1handlers.GetXsollaLoginToken = function (args) {
2
3 // TODO replace with production credentials
4 const projectId = <ProjectID>;
5 const loginProjectId = "<LoginID>";
6 const serverOauthClientId = <OAuthClientID>;
7 const serverOauthClientSecret = "<OAuthSecretKey>";
8
9 const getServerTokenBody =
10 `grant_type=client_credentials&client_secret=${serverOauthClientSecret}&client_id=${serverOauthClientId}`;
11
12 const serverTokenResponse = JSON.parse(
13 http.request(
14 "https://login.xsolla.com/api/oauth2/token",
15 "post",
16 getServerTokenBody,
17 "application/x-www-form-urlencoded",
18 {})
19 );
20
21 let serverToken = ""
22 if ('access_token' in serverTokenResponse) {
23 serverToken = serverTokenResponse.access_token;
24 } else {
25 return {
26 "error_message": "Server token not received"
27 }
28 }
29
30 const getUserTokenHeaders = {
31 "X-Server-Authorization": serverToken
32 }
33
34 const getUserTokenBody = JSON.stringify(
35 {
36 "server_custom_id": currentPlayerId,
37 }
38 );
39
40 const getUserTokenPath =
41 `/api/users/login/server_custom_id?projectId=${loginProjectId}&publisher_project_id=${projectId}`;
42
43 const userTokenResponse = JSON.parse(
44 http.request(
45 `https://login.xsolla.com${getUserTokenPath}`,
46 "post",
47 getUserTokenBody,
48 "application/json",
49 getUserTokenHeaders)
50 );
51
52 if ('token' in userTokenResponse) {
53 return {
54 "token": userTokenResponse.token
55 }
56 } else {
57 return {
58 "error_message": "User token not received"
59 }
60 }
61}
- PlayFabプロジェクト設定に移動します。
- クラウドスクリプトファイルをアップロードします。
- 使用環境でクラウドスクリプトを実行します。
- アプリケーションから機能を呼び出すため、クライアントサイドロジックを追加します。機能名には
GetXsollaLoginToken
を指定します。パラメータを渡す必要はありません。
ユーザーJWTの受信機能の呼び出し例:
Copy
kotlin
- kotlin
- C#
- C++
1val tokenRequest = PlayFabClientModels.ExecuteCloudScriptRequest()
2tokenRequest.FunctionName = "GetXsollaLoginToken"
3val res = PlayFabClientAPI.ExecuteCloudScript(tokenRequest)
4val result = res.Result.FunctionResult as Map<*, *>
5val token = result["token"]
6val errorMessage = result["error_message"]
1var tokenRequest = new ExecuteCloudScriptRequest{
2 FunctionName = "GetXsollaLoginToken"
3};
4
5PlayFabClientAPI.ExecuteCloudScript(
6 tokenRequest,
7 scriptResult =>
8 {
9 var functionResult = scriptResult.FunctionResult as Dictionary<string, string>;
10 var token = functionResult["token"];
11 },
12 playfabError => { Debug.LogError($"GetXsollaAccessToken error: {playfabError.ErrorMessage}"); });
1void UMyClass::GetXsollaToken()
2{
3 FClientExecuteCloudScriptRequest tokenRequest;
4 tokenRequest.FunctionName = TEXT("GGetXsollaLoginToken");
5
6 UPlayFabClientAPI::FDelegateOnSuccessExecuteCloudScript onSuccess;
7 onSuccess.BindUFunction(this, "OnTokenRecieved");
8
9 UPlayFabClientAPI::FDelegateOnFailurePlayFabError onFailure;
10 onSuccess.BindUFunction(this, "OnError");
11
12 UPlayFabClientAPI::ExecuteCloudScript(tokenRequest, onSuccess, onFailure, nullptr);
13}
14
15void UMyClass::OnTokenRecieved(FClientExecuteCloudScriptResult result, UObject* customData)
16{
17 const FString& token = result.FunctionResult->GetStringField(TEXT("token"));
18
19 // do something with a token
20}
21
22void UMyClass::OnError(FPlayFabError error, UObject* customData)
23{
24 // handle errors
25}
お知らせ
この例では、PlayFab SDKのメソッドを使用してクラウドスクリプトへのリクエストを行います。PlayFab SDKをプロジェクトに追加しなくても、リクエストとレスポンスの処理を自分で実装することができます。
この記事は役に立ちましたか?
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。お役立ちリンク
最終更新日: 2025年10月10日誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。