Como integrar autenticação de usuário via Xsolla ID

Como funciona

Você pode adicionar a autenticação de usuários com Xsolla ID — a plataforma de identidade compartilhada, proporcionando acesso contínuo aos produtos da Xsolla.

Os métodos de autenticação disponíveis dependem das configurações do seu projeto. O Xsolla ID pode ser usado apenas se a autenticação via Xsolla Wallet estiver desativada (ela está desativada por padrão em novos projetos). Após ser desativada, a autenticação do Xsolla Wallet é removida permanentemente. Para reativá-la, entre em contato com seu Gerente de Sucesso do Cliente ou envie um e-mail para [email protected].

A imagem acima mostra uma das opções para o widget de login. Você pode personalizar o widget.

Você pode implementar um dos seguintes cenários de usuário:

Abrir a página de autenticação do Xsolla ID em uma janela modal ao pressionar no botão Log in with Xsolla no widget de login:
1. O usuário pressiona o botão Log in with Xsolla no widget de login.
2. O usuário é redirecionado para a página de autenticação do Xsolla ID que abre em uma janela modal.
3. O usuário completa o processo de autenticação na página de autenticação do Xsolla ID.
4. O usuário é redirecionado para o URL especificado no campo URL de retorno de chamada na Conta de Distribuidor.
Redirecionar para a página de autenticação do Xsolla ID ao pressionar no botão Log in with Xsolla no widget de login:
1. O usuário pressiona o botão Log in with Xsolla no widget de login.
2. O usuário é redirecionado para a tela de autenticação do Xsolla ID que abre na mesma janela.
3. O usuário completa o processo de autenticação no Xsolla ID.
4. O usuário é redirecionado para a página cujo URL está especificado no campo URL de retorno de chamada na Conta de Distribuidor.
Redirecionar para a página de autenticação do Xsolla ID em uma janela pop-up ao pressionar em um botão no seu site:
1. O usuário pressiona em um botão no seu site.
2. O usuário é redirecionado para a página de autenticação do Xsolla ID que abre em uma janela pop-up.
3. O usuário completa o processo de autenticação na página de autenticação do Xsolla ID.
4. O usuário é redirecionado para a página cujo URL está especificado no campo URL de retorno de chamada na Conta de Distribuidor.

Você pode implementar um dos seguintes cenários de usuário:

Abrir a página de autenticação do Xsolla ID em uma janela modal ao pressionar no botão Log in with Xsolla no widget de login:
1. O usuário pressiona o botão Log in with Xsolla no widget de login.
2. O usuário é redirecionado para a página de autenticação do Xsolla ID que abre em uma janela modal.
3. O usuário completa o processo de autenticação na página de autenticação do Xsolla ID.
4. O usuário é redirecionado para o URL especificado no campo URL de retorno de chamada na sua conta.
Redirecionar para a página de autenticação do Xsolla ID ao pressionar no botão Log in with Xsolla no widget de login:
1. O usuário pressiona o botão Log in with Xsolla no widget de login.
2. O usuário é redirecionado para a tela de autenticação do Xsolla ID que abre na mesma janela.
3. O usuário completa o processo de autenticação no Xsolla ID.
4. O usuário é redirecionado para a página cujo URL está especificado no campo URL de retorno de chamada na sua conta.
Redirecionar para a página de autenticação do Xsolla ID em uma janela pop-up ao pressionar em um botão no seu site:
1. O usuário pressiona em um botão no seu site.
2. O usuário é redirecionado para a página de autenticação do Xsolla ID que abre em uma janela pop-up.
3. O usuário completa o processo de autenticação na página de autenticação do Xsolla ID.
4. O usuário é redirecionado para a página cujo URL está especificado no campo URL de retorno de chamada na sua conta.

Você pode implementar um dos seguintes cenários de usuário:

Abrir a página de autenticação do Xsolla ID em uma janela modal ao pressionar no botão Log in with Xsolla no widget de login:
1. O usuário pressiona o botão Log in with Xsolla no widget de login.
2. O usuário é redirecionado para a página de autenticação do Xsolla ID que abre em uma janela modal.
3. O usuário completa o processo de autenticação na página de autenticação do Xsolla ID.
4. O usuário é redirecionado para o URL especificado no campo URL de retorno de chamada na sua conta.
Redirecionar para a página de autenticação do Xsolla ID ao pressionar no botão Log in with Xsolla no widget de login:
1. O usuário pressiona o botão Log in with Xsolla no widget de login.
2. O usuário é redirecionado para a tela de autenticação do Xsolla ID que abre na mesma janela.
3. O usuário completa o processo de autenticação no Xsolla ID.
4. O usuário é redirecionado para a página cujo URL está especificado no campo URL de retorno de chamada na sua conta.
Redirecionar para a página de autenticação do Xsolla ID em uma janela pop-up ao pressionar em um botão no seu site:
1. O usuário pressiona em um botão no seu site.
2. O usuário é redirecionado para a página de autenticação do Xsolla ID que abre em uma janela pop-up.
3. O usuário completa o processo de autenticação na página de autenticação do Xsolla ID.
4. O usuário é redirecionado para a página cujo URL está especificado no campo URL de retorno de chamada na sua conta.

Você pode implementar um dos seguintes cenários de usuário:

Abrir a página de autenticação do Xsolla ID em uma janela modal ao pressionar no botão Log in with Xsolla no widget de login:
1. O usuário pressiona o botão Log in with Xsolla no widget de login.
2. O usuário é redirecionado para a página de autenticação do Xsolla ID que abre em uma janela modal.
3. O usuário completa o processo de autenticação na página de autenticação do Xsolla ID.
4. O usuário é redirecionado para o URL especificado no campo URL de retorno de chamada na sua conta.
Redirecionar para a página de autenticação do Xsolla ID ao pressionar no botão Log in with Xsolla no widget de login:
1. O usuário pressiona o botão Log in with Xsolla no widget de login.
2. O usuário é redirecionado para a tela de autenticação do Xsolla ID que abre na mesma janela.
3. O usuário completa o processo de autenticação no Xsolla ID.
4. O usuário é redirecionado para a página cujo URL está especificado no campo URL de retorno de chamada na sua conta.
Redirecionar para a página de autenticação do Xsolla ID em uma janela pop-up ao pressionar em um botão no seu site:
1. O usuário pressiona em um botão no seu site.
2. O usuário é redirecionado para a página de autenticação do Xsolla ID que abre em uma janela pop-up.
3. O usuário completa o processo de autenticação na página de autenticação do Xsolla ID.
4. O usuário é redirecionado para a página cujo URL está especificado no campo URL de retorno de chamada na sua conta.

Você pode implementar um dos seguintes cenários de usuário:

Abrir a página de autenticação do Xsolla ID em uma janela modal ao pressionar no botão Log in with Xsolla no widget de login:
1. O usuário pressiona o botão Log in with Xsolla no widget de login.
2. O usuário é redirecionado para a página de autenticação do Xsolla ID que abre em uma janela modal.
3. O usuário completa o processo de autenticação na página de autenticação do Xsolla ID.
4. O usuário é redirecionado para o URL especificado no campo URL de retorno de chamada na sua conta.
Redirecionar para a página de autenticação do Xsolla ID ao pressionar no botão Log in with Xsolla no widget de login:
1. O usuário pressiona o botão Log in with Xsolla no widget de login.
2. O usuário é redirecionado para a tela de autenticação do Xsolla ID que abre na mesma janela.
3. O usuário completa o processo de autenticação no Xsolla ID.
4. O usuário é redirecionado para a página cujo URL está especificado no campo URL de retorno de chamada na sua conta.
Redirecionar para a página de autenticação do Xsolla ID em uma janela pop-up ao pressionar em um botão no seu site:
1. O usuário pressiona em um botão no seu site.
2. O usuário é redirecionado para a página de autenticação do Xsolla ID que abre em uma janela pop-up.
3. O usuário completa o processo de autenticação na página de autenticação do Xsolla ID.
4. O usuário é redirecionado para a página cujo URL está especificado no campo URL de retorno de chamada na sua conta.

Como obter

Para integrar o login social via Xsolla ID:

Integre o widget de login.
Habilite a Xsolla como uma rede social.
Implemente a obtenção do token de autorização do usuário.

Adicione o Xsolla Login widget à sua aplicação — ele fornece uma interface de autenticação de usuário pronta.

No seu projeto na Conta de Distribuidor, acesse a seção Jogadores > Login.

Abra seu projeto na conta e acesse a seção Players > Login.

Abra seu projeto na conta e acesse a seção Players > Login.

Abra seu projeto na conta e acesse a seção Players > Login.

No projeto na conta, acesse a seção Other tools > Login.

Selecione Configure no painel de um projeto de Login.
Acesse o bloco Authentication e selecione Social login.
Selecione Xsolla na lista de redes sociais.

Pressione o ícone ⚙ e selecione Connect.
Configure um dos cenários de usuário:

Autenticação na mesma janela

Para redirecionar o usuário para a página de autenticação do Xsolla ID após ele pressionar no botão Log in with Xsolla no widget de login:

Acesse a seção Authentication e selecione Callback URLs.
No campo Callback URL, insira o URL para redirecionar o usuário após a autenticação.
No parâmetro callbackUrl do código do widget de login, passe o URL para redirecionar o usuário após a autenticação.

Exemplo de código do Widget:

Copy

Full screen

Small screen

1import { Widget } from '@xsolla/login-sdk';
2const xl = new Widget({
3  projectId: '[Login ID]',
4  preferredLocale: 'en_US',
5  callbackUrl: '[Your Callback URL]',
6});

Autenticação em janela pop-up

Para redirecionar o usuário para a página de autenticação do Xsolla ID em uma janela pop-up após ele pressionar em um botão no seu site:

Na página de navegação, acesse a seção Authentication e selecione Callback URLs.
Certifique-se de que o seguinte URL está adicionado na seção Callback URL: https://login.xsolla.com/api/social/oauth2/callback.
No código do widget de login, passe o valor true no parâmetro babkaLoginPopup, e passe o URL para redirecionar o usuário após a autenticação no parâmetro callbackUrl.

Exemplo de código do Widget:

Copy

Full screen

Small screen

1import { Widget } from '@xsolla/login-sdk';
2const xl = new Widget({
3  projectId: '[Login ID]',
4  preferredLocale: 'en_US',
5  babkaLoginPopup: true,
6  callbackUrl: '[Your Callback URL]',
7});

Adicione o botão que abre a página de autenticação do Xsolla ID ao seu site.

Exemplo de código do botão Log in with Xsolla:

Copy

Full screen

Small screen

1<div id="xl_auth"></div>
2<button onclick="xl.open()">Log in with Xsolla</button>

Para redirecionar o usuário para a página de autenticação do Xsolla ID em uma janela modal após ele pressionar no botão Log in with Xsolla no widget de login:

Acesse a seção Authentication e selecione Callback URLs.
No campo Callback URL, insira o URL para redirecionar o usuário após a autenticação.
No código do widget de login, passe o valor popup no parâmetro babkaLoginFlow, e passe o URL para redirecionar o usuário após a autenticação no parâmetro callbackUrl.

Exemplo de código do Widget:

Copy

Full screen

Small screen

1import { Widget } from '@xsolla/login-sdk';
2const xl = new Widget({
3  projectId: '[Login ID]',
4  preferredLocale: 'en_US',
5  babkaLoginFlow: "popup",
6  callbackUrl: '[Your Callback URL]',
7});

Obtenção do token de autorização do usuário

Após a autorização no lado do Xsolla ID, o usuário será redirecionado para o URL especificado no parâmetro callbackUrl. O token de autorização do usuário é passado no parâmetro token.

Para incorporar o token JWT OAuth do Xsolla ID no token JWT do Xsolla Login:

No seu projeto na Conta de Distribuidor, acesse a seção Jogadores > Login.

Abra seu projeto na conta e acesse a seção Players > Login.

Abra seu projeto na conta e acesse a seção Players > Login.

Abra seu projeto na conta e acesse a seção Players > Login.

No projeto na conta, acesse a seção Other tools > Login.

Selecione Configure no painel de um projeto de Login.
Acesse o bloco Authentication e selecione Social login.
Ative a opção Social login.
Selecione Save changes.

Obrigado pelo seu feedback!

Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.

Última atualização: 7 de Outubro de 2026

Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.

Conteúdos

Como funciona
Como obter
Integração do widget de login
Habilitação da Xsolla como rede social
Obtenção do token de autorização do usuário

Relatar um problema

Nós sempre avaliamos nossos conteúdos. Seu feedback nos ajuda a melhorá-los.

Forneça um e-mail para que possamos responder

Obrigado pelo seu feedback!

Não conseguimos enviar seu feedback

Tente novamente mais tarde ou contate-nos via [email protected].