Xsolla-logo

Authentification silencieuseClient-side

get/social/{cross_social_provider_name}/cross_auth

Échange le JWT utilisateur Steam, Xbox ou Epic Games contre le JWT de votre projet (projectId).

Vous obtiendrez le lien de redirection utilisateur vers votre projet.

Pour activer l'authentification silencieuse, utilisez les instructions.

Request
path Parameters
cross_social_provider_name
required
string

Nom de la plateforme pour laquelle l'utilisateur est autorisé. Valeurs possibles : steam, xbox, epicgames.

query Parameters
projectId
required
string <uuid>

ID de projet de connexion issu du Compte éditeur.

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

Liste des paramètres qui doivent être demandés à l'utilisateur ou au réseau social et inscrits dans le JWT. Les paramètres doivent être séparés par une virgule. Par exemple, email.

Lorsque email est demandé et que le réseau social ne renvoie pas la valeur email :

  • l'utilisateur est invité à saisir une adresse e-mail dans le formulaire correspondant si vous avez intégré le widget Login.
  • l'utilisateur est invité à saisir une adresse e-mail dans le formulaire correspondant de votre propre interface si vous avez intégré Login API. Envoyez l'URL de ce formulaire à votre responsable de la réussite client.

Une fois l'adresse e-mail saisie, l'utilisateur reçoit un message de confirmation par e-mail. Pour désactiver la confirmation par e-mail, contactez votre responsable de la réussite client.

session_ticket
string

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

payload
string

Vos données personnalisées. La valeur du paramètre sera renvoyée dans la revendication payload du JWT utilisateur. La longueur maximale recommandée est de moins de 500 caractères. Notez que ce paramètre n'est disponible qu'avec un stockage de données utilisateur personnalisé.

with_logout
string
Default: "0"

Indique s'il faut désactiver les valeurs existantes du JWT utilisateur et activer celles générées par cet appel. Valeurs possibles :

  • 1 : pour désactiver les valeurs existantes et en activer une nouvelle ;
  • 0 : pour garder les valeurs existantes activées.
app_id
string

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

code
string

Code reçu de la plateforme.

is_redirect
boolean
Default: true

Indique comment le serveur Xsolla Login doit répondre. Valeurs possibles :

  • true : le serveur Xsolla Login renvoie le code de réponse 302. L'URL de redirection utilisateur contenant le JWT utilisateur est présente dans l'en-tête Location.
  • false : le serveur Xsolla Login renvoie le code de réponse 200. L'URL de redirection utilisateur contenant le JWT utilisateur est dans le corps de la réponse.
no_user_creation
boolean
Default: false

Ne crée pas de nouveau compte si l'utilisateur n'existe pas encore. Les utilisateurs existants seront autorisés comme d'habitude

Responses
200

OK

302

Redirection

400

Bad Request

404

Not Found

422

Unprocessable Entity

429

Too Many Requests

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'
Response samples
application/json
{
  • "login_url": "string"
}