Xsolla-logo

Autenticação silenciosaClient-side

get/social/{cross_social_provider_name}/cross_auth

Troque o JWT do usuário no Steam, Xbox ou Epic Games pelo JWT em seu projeto (projectId).

Você receberá o link para redirecionar o usuário para o seu projeto.

Para habilitar a autenticação silenciosa, use a instrução.

Request
path Parameters
cross_social_provider_name
required
string

Nome da plataforma em que o usuário foi autorizado. Pode ser steam, xbox, epicgames.

query Parameters
projectId
required
string <uuid>

ID do projeto Login da Conta de Distribuidor.

login_url
string

URL to redirect the user to after account confirmation, successful authentication, two-factor authentication configuration, or password reset confirmation. Must be identical to the Callback URL specified in the URL block of Publisher Account. For the scenario of a login error, the value should be identical to the the Error callback URL specified in the URL block of Publisher Account. To find the settings, go to Login > your Login project and select the Callback URLs section in the upper block. Required if there are several Callback URLs.

fields
Array of strings non-empty

Lista de parâmetros que devem ser solicitados ao usuário ou rede social adicionalmente e escritos no JWT. Os parâmetros devem ser separados por vírgula. Por exemplo, email.

Quando o email é solicitado e a rede social não respondeu com o valor email:

  • o usuário será solicitado a inserir seu e-mail no formulário correspondente se você integrou Login Widget,
  • o usuário deve ser solicitado a inserir seu e-mail no formulário correspondente de sua própria interface se você integrou a Login API. Por favor, envie o URL deste formulário para o seu Gerente de Sucesso do Cliente.

Depois que o e-mail for inserido, o usuário recebe uma mensagem de confirmação de e-mail. Para desativar a confirmação por e-mail, entre em contato com seu Gerente de Sucesso do Cliente.

session_ticket
string

Session ticket received from the platform encoded according to the Base64 standard.

payload
string

Seus dados personalizados. O valor do parâmetro será retornado na declaração payload do JWT do usuário. Recomenda-se um comprimento máximo inferior a 500 caracteres. Observe que esse parâmetro só estará disponível se você usar um armazenamento de dados de usuário personalizado.

with_logout
string
Default: "0"

Mostra se os valores JWT do usuário existentes devem ser desativados e ativa o valor gerado por essa chamada. Pode ter os seguintes valores:

  • '1' para desativar os valores existentes e ativar um novo,
  • '0' para manter os valores existentes ativados.
app_id
string

Your app ID on the platform. Required if the platform where the user is authorized is Steam.

code
string

Código recebido da plataforma.

is_redirect
boolean
Default: true

Mostra como o servidor Xsolla Login deve responder. Se você definir:

  • valor true, o servidor Xsolla Login retornará o código de resposta 302. URL para redirecionamento de usuário com usuário JWT estará no cabeçalho Location.
  • valor false, o servidor Xsolla Login retorna o código de resposta 200. URL para redirecionamento de usuário com JWT do usuário estará no corpo da resposta.
no_user_creation
boolean
Default: false

Não crie novos usuários se eles ainda não existirem. Os usuários existentes serão autorizados como de costume.

deployment_id
string

The deployment ID that the client is trying to authenticate with. This will impact interactions with other services that require a deployment. If the deployment is not public, only users who have been entitled will be able to log in. For more information on deployments and deployment IDs see Product, Sandbox, and Deployment IDs. Note: You must use this unique identifier to use the Ecommerce APIs, and to request access tokens used by game clients.

Responses
200

OK

302

Redirecionamento

400

Pedido incorreto

404

Não encontrado

422

Entidade não processável

429

Pedidos demais

Request samples
curl --request GET \
  --url 'https://login.xsolla.com/api/social/{cross_social_provider_name}/cross_auth?projectId=SOME_STRING_VALUE&login_url=SOME_STRING_VALUE&fields=SOME_ARRAY_VALUE&session_ticket=SOME_STRING_VALUE&payload=SOME_STRING_VALUE&with_logout=0&app_id=SOME_STRING_VALUE&code=SOME_STRING_VALUE&is_redirect=true&no_user_creation=false&deployment_id=SOME_STRING_VALUE'
Response samples
application/json
{
  • "login_url": "string"
}