Xsolla-logo

Autenticación silenciosaClient-side

get/social/{cross_social_provider_name}/cross_auth

Cambia el JWT del usuario de Steam, Xbox o Epic Games por el JWT de su proyecto (projectId).

Obtendrá el enlace para redirigir al usuario a su proyecto.

Para habilitar la autenticación silenciosa, utilice la instrucción.

Request
path Parameters
cross_social_provider_name
required
string

Nombre de la plataforma en la que el usuario está autorizado. Puede ser steam, xbox o epicgames.

query Parameters
projectId
required
string <uuid>

ID del proyecto de Login procedente de Cuenta del editor.

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 adicionales que deben solicitarse al usuario o a la red social y escribirse en el JWT. Los parámetros deben ir separados por una coma. Por ejemplo, email.

Cuando se solicita el email y la red social no responde con el valor email:

  • se pedirá al usuario que introduzca su correo electrónico en el formulario correspondiente si ha integrado el Widget de Login,
  • se pedirá al usuario que introduzca su correo electrónico en el formulario correspondiente de su propia interfaz si ha integrado Login API. Envíe la URL de este formulario a su gestor del éxito del cliente.

Una vez introducido el correo electrónico, el usuario recibe un mensaje de confirmación por correo electrónico. Para deshabilitar la confirmación mediante correo electrónico, contacte con su gestor del éxito del cliente.

session_ticket
string

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

payload
string

Sus datos personalizados. El valor del parámetro será devuelto en la notificación payload del user JWT (JWT de usuario). Longitud máxima recomendada inferior a 500 caracteres. Tenga en cuenta que este parámetro únicamente está disponible si usa un almacenamiento de datos de usuario personalizado.

with_logout
string
Default: "0"

Indica si se desactivan los valores del JWT de usuario existentes y si se activa el valor generado por esta llamada. Puede tener los siguientes valores:

  • "1" para desactivar los valores existentes y activar uno nuevo,
  • "0" para mantener activados los valores existentes.
app_id
string

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

code
string

Código recibido de la plataforma.

is_redirect
boolean
Default: true

Muestra cómo debe responder el servidor de Xsolla Login. Si establece: valor

  • true, el servidor de Xsolla Login devuelve el código de respuesta 302. URL para el redireccionamiento de usuario con JWT de usuario estará en el encabezado Location.Valor
  • false, el servidor de Xsolla Login devuelve el código de respuesta 200. La URL para el redireccionamiento de usuario con el JWT usuario aparecerá en el cuerpo de la respuesta.
no_user_creation
boolean
Default: false

No cree nuevos usuarios si aún no existen. Los usuarios existentes serán autorizados como de costumbre

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

ACEPTAR

302

Redireccionamiento

400

Bad Request (Solicitud errónea)

404

Not Found (No encontrado)

422

Unprocessable Entity (Entidad no procesable)

429

Too Many Requests (Demasiadas solicitudes)

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