Use o Shop Builder com autorização BaaS
Você pode usar o Shop Builder com o sistema de autorização BaaS para vender itens no jogo. Nesse caso, a interação é a seguinte:
- O usuário efetua o login em seu aplicativo por meio do sistema de autorização BaaS.
- O serviço BaaS solicita o JSON Web Token (JWT) do usuário aos servidores Xsolla passando o ID do usuário.
- Os servidores Xsolla retornam o JWT do usuário para o serviço BaaS.
- O serviço BaaS passa o JWT do usuário para o aplicativo.
- O aplicativo usa o JWT do usuário para interagir com os servidores Xsolla usando a API.
Observação
Se você não tiver implementado a lógica para autorização do usuário, você poderá integrar o Xsolla Login e configurar o armazenamento de dados do usuário no PlayFab ou no Firebase. Isso permite que você use a API Login para autenticar usuários e receber JWTs para interagir com as APIs de outros produtos Xsolla.
- na Conta de Distribuidor, conecte o projeto Login padrão ao seu projeto.
- Configure um cliente do servidor OAuth 2.0.
- Adicione funções prontas ao seu projeto seguindo as instruções para Firebase e PlayFab.
Configure o cliente OAuth 2.0 do servidor
- Abra seu projeto na Conta de Distribuidor e vá para a seção Login.
- Clique em Configure no painel de um projeto Login.
- Vá para o bloco Security e selecione a seção OAuth 2.0.
- Clique em Add OAuth 2.0.
- Especifique os URLs de redirecionamento OAuth 2.0.
- Marque a caixa Server (server-to-server connection).
- Clique em Connect.
- Copie e salve o ID do cliente e chave secreta.
Adicione a Cloud Function ao projeto Firebase
- Inicialize seu projeto Firebase.
- Importe e configure a função de recebimento para o usuário JWT, onde:
<ProjectID>é a ID do projeto e pode ser encontrada em sua Conta de Distribuidor ao lado do nome do seu projeto.<LoginID>é o ID de Login que pode ser obtido abrindo a Conta de Distribuidor. Vá para a seção Login > Dashboard > Seu projeto Login e clique em Copy ID próximo ao nome do projeto de login.<OAuthClientID>é o ID do cliente recebido quando você configurou o cliente do servidor OAuth 2.0.<OAuthSecretKey>é a chave secreta que foi recebida ao configurar o cliente do servidor OAuth 2.0.
Código de função para receber o usuário 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" +
17 `&client_secret=${serverOauthClientSecret}`+
18 `&client_id=${serverOauthClientId}`;
19
20 const options = {
21 hostname: "login.xsolla.com",
22 port: 443,
23 path: "/api/oauth2/token",
24 method: "POST",
25 headers: {
26 "Content-Type": "application/x-www-form-urlencoded",
27 "Content-Length": postData.length,
28 },
29 };
30
31 return new Promise( (resolve, reject) => {
32 const req = https.request(options, (res) => {
33 if (res.statusCode !== 200) {
34 reject(
35 new functions.https.HttpsError(
36 "internal",
37 "Server token not received"
38 )
39 );
40 }
41 let body = [];
42 res.on("data", (d) => {
43 body.push(d);
44 });
45 res.on("end", () => {
46 try {
47 body = JSON.parse(Buffer.concat(body).toString());
48 } catch (e) {
49 reject(
50 new functions.https.HttpsError(
51 "internal",
52 "Malformed server token response"
53 )
54 );
55 }
56 getClientToken(context.auth.uid, body.access_token, resolve, reject);
57 });
58 });
59 req.on("error", (e) => {
60 reject(new functions.https.HttpsError(
61 "internal",
62 "Internal error while server token flow"
63 ));
64 });
65
66 req.write(postData);
67 req.end();
68 });
69});
70
71// eslint-disable-next-line require-jsdoc
72function getClientToken(userId, serverToken, resolve, reject) {
73 const postData = JSON.stringify(
74 {
75 "server_custom_id": userId,
76 }
77 );
78
79 const path =
80 "/api/users/login/server_custom_id?" +
81 `projectId=${loginProjectId}&` +
82 `publisher_project_id=${projectId}`;
83
84 const options = {
85 hostname: "login.xsolla.com",
86 port: 443,
87 path: path,
88 method: "POST",
89 headers: {
90 "Content-Type": "application/json",
91 "Content-Length": postData.length,
92 "X-Server-Authorization": serverToken,
93 },
94 };
95
96 const req = https.request(options, (res) => {
97 if (res.statusCode !== 200) {
98 reject(
99 new functions.https.HttpsError(
100 "internal",
101 "Client token not received"
102 )
103 );
104 }
105 let body = [];
106 res.on("data", (d) => {
107 body.push(d);
108 });
109 res.on("end", () => {
110 try {
111 body = JSON.parse(Buffer.concat(body).toString());
112 } catch (e) {
113 reject(
114 new functions.https.HttpsError(
115 "internal",
116 "Malformed client token response"
117 )
118 );
119 }
120 resolve({
121 "token": body.token,
122 });
123 });
124 });
125 req.on("error", (e) => {
126 reject(new functions.https.HttpsError(
127 "internal",
128 "Internal error while client token flow"
129 ));
130 });
131
132 req.write(postData);
133 req.end();
134}
- Mobilize a função a um ambiente de produção conforme este exemplo.
- Adicione a lógica no lado do cliente para chamar a função do seu aplicativo. Especifique
getXsollaLoginTokencomo o nome da função. Não é necessário passar parâmetros. - No aplicativo, implemente métodos para trabalhar com a API você mesmo ou use os SDKs Xsolla.
Adicione o Cloud Script ao projeto PlayFab
- Crie um arquivo JS com o código de função para receber o usuário JWT, onde:
<ProjectID>é o ID do projeto e pode ser encontrado em sua Conta do Publisher ao lado do nome do seu projeto.<LoginID>é o ID de login que pode ser obtido abrindo a Conta do Publicador, vá para a seção Login > Dashboard > Seu projeto Login e clique em Copy ID ao lado do nome do projeto de login.<OAuthClientID>é o ID do cliente recebido quando você configura o cliente OAuth 2.0 do servidor.<OAuthSecretKey>é a chave secreta que é recebida quando você configura o cliente OAuth 2.0 do servidor.
Observação
Se você já estiver usando Cloud Scripts em seu projeto, adicione a função para receber o usuário JWT ao final do código.
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" +
11 `&client_secret=${serverOauthClientSecret}` +
12 `&client_id=${serverOauthClientId}`;
13
14 const serverTokenResponse = JSON.parse(
15 http.request(
16 "https://login.xsolla.com/api/oauth2/token",
17 "post",
18 getServerTokenBody,
19 "application/x-www-form-urlencoded",
20 {})
21 );
22
23 let serverToken = ""
24 if ('access_token' in serverTokenResponse) {
25 serverToken = serverTokenResponse.access_token;
26 } else {
27 return {
28 "error_message": "Server token not received"
29 }
30 }
31
32 const getUserTokenHeaders = {
33 "X-Server-Authorization": serverToken
34 }
35
36 const getUserTokenBody = JSON.stringify(
37 {
38 "server_custom_id": currentPlayerId,
39 }
40 );
41
42 const getUserTokenPath =
43 "/api/users/login/server_custom_id?" +
44 `projectId=${loginProjectId}&` +
45 `publisher_project_id=${projectId}`;
46
47 const userTokenResponse = JSON.parse(
48 http.request(
49 "https://login.xsolla.com" + getUserTokenPath,
50 "post",
51 getUserTokenBody,
52 "application/json",
53 getUserTokenHeaders)
54 );
55
56 if ('token' in userTokenResponse) {
57 return {
58 "token": userTokenResponse.token
59 }
60 } else {
61 return {
62 "error_message": "User token not received"
63 }
64 }
65}
- Vá para as configurações do projeto PlayFab.
- Carregue o arquivo do Cloud Script.
- Execute o Cloud Script em um ambiente de produção.
- Adicione a lógica do lado do cliente para chamar uma função do seu aplicativo. Especifique
GetXsollaLoginTokencomo o nome da função. Não é necessário passar parâmetros.
Exemplo de chamada da função de recebimento para o JWT do usuário:
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}
Observação
Neste exemplo, usamos os métodos PlayFab SDK para fazer uma solicitação ao Cloud Script. Você mesmo pode implementar o processamento de solicitação e resposta sem adicionar o SDK do PlayFab ao seu projeto.
- No aplicativo, implemente métodos para trabalhar com a API você mesmo ou use SDKs Xsolla.
Este artigo foi útil?
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.Links úteis
Última atualização: 2 de Abril de 2025Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.
