Authentification silencieuse

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
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

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&deployment_id=SOME_STRING_VALUE'

Response samples

application/json

{"login_url": "string"
}