Almacenamiento personalizado

Si utiliza el almacenamiento personalizado, tendrá acceso a:

• registro de usuario
• autenticación mediante nombre de usuario y contraseña
• autenticación sin contraseña mediante número de teléfono
• autenticación mediante redes sociales
• restablecimiento de contraseña de usuario

Flujo de interacción

Puede utilizar el widget de inicio de sesión (Login) o su aplicación, que usa las llamadas Login API como un cliente. El flujo de interacción entre el cliente y el servidor de Xsolla Login es el siguiente:

1. El cliente envía solicitudes al servidor de Xsolla Login. El formato de las solicitudes se describe en los puntos finales JWT, y Password.
2. El servidor de Xsolla Login envía solicitudes a su servidor. Siga las instrucciones para validar las solicitudes.
3. El servidor de Xsolla Login procesa una respuesta de su servidor y devuelve los resultados al cliente.
4. El cliente procesa la respuesta.

• Como cualquier objeto JSON.

• Como una matriz de objetos con atributos de usuario. Los objetos deben tener la siguiente estructura:

Registro de usuarios

1. El cliente envía la solicitud Register new user al servidor de Xsolla Login.
2. El servidor de Xsolla Login envía una solicitud a la URL de nuevo usuario. La respuesta debe tener el formato descrito en este flujo de integración. En la respuesta, se puede especificar una lista de atributos de usuario o cualquier objeto JSON necesario. El objeto JSON que proporcione en la respuesta se registra en el campo partner_data del JWT del usuario.

POST https://your.hostname/your_registration_uri HTTP/1.1
Authorization: Bearer {JWT}
Content-Type: application/json

{
  "email":"j.smith@email.com",
  "password":"123456",
  "username":"j.smith@email.com"
}

curl --request POST \
  --url 'https://your.hostname/your_registration_uri' \
  --header 'authorization: bearer_JWT' \
  --header 'content-type: application/json' \
  --data '{"email":"j.smith@email.com","password":"123456","username":"j.smith@email.com"}'

Ejemplo de respuesta con atributos de usuario:

{
    "attributes": [
      {
        "attr_type": "server",
        "key": "company",
        "permission": "private",
        "value": "facebook-promo"
      },
      {
        "attr_type": "server",
        "key": "custom-id",
        "permission": "private",
        "value": 48582
      }
    ]
}

Ejemplo de respuesta con un objeto JSON:

{ "region": "Asia",
  "type": "new"
}

3. Los datos del usuario se escriben en la base de datos de Xsolla, mientras que el email se marca como sin confirmar. El usuario recibirá un correo electrónico de confirmación de cuenta.
4. Si ha integrado el widget de Login, el usuario será redirigido a la página con el siguiente mensaje: Por favor, confirma tu cuenta siguiendo las instrucciones que enviamos a {email}.
5. Si el registro del usuario no se realiza correctamente, puede proporcionar un mensaje de error que se mostrará en el widget de autenticación. Para ello, en la respuesta a la solicitud de creación de usuario, transmita un objeto de error con los siguientes detalles:
   • en el parámetro de code, especifique 011-002.
   • En el parámetro de description, facilite el texto del mensaje de error.

{
  "error": {
    "code": "011-002",
    "description": "<string>"
  }
}

Autenticación mediante nombre de usuario y contraseña

1. El cliente envía la solicitud Auth by username and password al servidor de Xsolla Login.
2. El servidor de Xsolla Login envía una solicitud a la URL de verificación de usuario. La respuesta debe tener el formato descrito en este flujo de integración. En la respuesta, se puede especificar una lista de atributos de usuario o cualquier objeto JSON necesario. El objeto JSON que proporcione en la respuesta se registra en el campo partner_data del JWT del usuario.

POST https://your.hostname/your_authentication_uri HTTP/1.1
Authorization: Bearer {JWT}
Content-Type: application/json

{
  "email":"j.smith@email.com",
  "password":"123456",
  "username":"j.smith@email.com"
}

curl --request POST \
  --url 'https://your.hostname/your_authentication_uri' \
  --header 'authorization: bearer_JWT' \
  --header 'content-type: application/json' \
  --data '{"email":"j.smith@email.com","password":"123456","username":"j.smith@email.com"}'

Ejemplo de respuesta con atributos de usuario:

{
    "attributes": [
      {
        "attr_type": "server",
        "key": "company",
        "permission": "private",
        "value": "facebook-promo"
      },
      {
        "attr_type": "server",
        "key": "custom-id",
        "permission": "private",
        "value": 48582
      }
    ]
}

Ejemplo de respuesta con un objeto JSON:

{ "region": "Asia",
  "type": "new"
}

3. El servidor de Xsolla Login genera un JWT de usuario.
4. El usuario es redirigido a login_url con un parámetro de consulta token. El parámetro token contiene el JWT de usuario.

Autenticación sin contraseña mediante número de teléfono

1. El cliente abre un formulario de autenticación para que el usuario pueda introducir su número de teléfono.
2. El usuario introduce su número de teléfono.
3. El cliente envía la solicitud Start auth by phone number al servidor de Xsolla Login.
4. El cliente muestra un campo para que el usuario pueda rellenar el código de verificación.
5. El usuario introduce el código de verificación recibido.
6. El cliente envía la solicitud Complete auth by phone number al servidor de Xsolla Login.
7. Si se trata de la primera autorización del usuario, el servidor de Xsolla Login envía una solicitud a la URL de inicio de sesión sin contraseña vía teléfono. La respuesta debe tener el formato descrito en este flujo de integración. En la respuesta, se puede especificar una lista de atributos de usuario o cualquier objeto JSON necesario. El objeto JSON que proporcione en la respuesta se registra en el campo partner_data del JWT del usuario.

POST https://your.hostname/your_phone_authentication_uri HTTP/1.1
Authorization: Bearer {JWT}
Content-Type: application/json

{
  "login": "+12025550140",
  "type": "phone"
}

curl --request POST \
  --url 'https://your.hostname/your_phone_authentication_uri' \
  --header 'authorization: bearer_JWT' \
  --header 'content-type: application/json' \
  --data '{"login":"+12025550140","type":"phone"}'

Ejemplo de respuesta con atributos de usuario:

{
    "attributes": [
      {
        "attr_type": "server",
        "key": "company",
        "permission": "private",
        "value": "facebook-promo"
      },
      {
        "attr_type": "server",
        "key": "custom-id",
        "permission": "private",
        "value": 48582
      }
    ]
}

Ejemplo de respuesta con un objeto JSON:

{ "region": "Asia",
  "type": "new"
}

Autenticación sin contraseña con correo electrónico

1. El cliente abre un formulario de autenticación para que el usuario pueda introducir su correo electrónico.
2. El usuario introduce su correo electrónico.
3. El cliente envía la solicitud Start auth by email al servidor de Xsolla Login.
4. El cliente muestra un campo para que el usuario pueda rellenar el código de verificación.
5. El usuario introduce el código de verificación recibido.
6. El cliente envía la solicitud Complete auth by email al servidor de Xsolla Login.
7. Si se trata de la primera autorización del usuario, el servidor de Xsolla Login envía una solicitud a la URL de inicio de sesión sin contraseña vía correo electrónico. La respuesta debe tener el formato descrito en este flujo de integración. En la respuesta, se puede especificar una lista de atributos de usuario o cualquier objeto JSON necesario. El objeto JSON que proporcione en la respuesta se registra en el campo partner_data del JWT del usuario.

POST https://your.hostname/your_email_authentication_uri HTTP/1.1
Authorization: Bearer {JWT}
Content-Type: application/json

{
  "email": "user@mail.com",
  "type": "email"
}

curl --request POST \
  --url 'https://your.hostname/your_email_authentication_uri' \
  --header 'authorization: bearer_JWT' \
  --header 'content-type: application/json' \
  --data '{"email": "user@mail.com","type": "email"}'

Ejemplo de respuesta con atributos de usuario:

{
    "attributes": [
      {
        "attr_type": "server",
        "key": "company",
        "permission": "private",
        "value": "facebook-promo"
      },
      {
        "attr_type": "server",
        "key": "custom-id",
        "permission": "private",
        "value": 48582
      }
    ]
}

Ejemplo de respuesta con un objeto JSON:

{ "region": "Asia",
  "type": "new"
}

Autenticación mediante redes sociales

Para obtener los datos del usuario al autenticarse a través de redes sociales, especifique la URL de inicio de sesión mediante red social en la configuración de su proyecto de Login en Cuenta del editor (sección User database > Storage > Custom storage). A esta URL se envía una solicitud con los datos recibidos de la red social.

Flujo de autenticación:

1. El cliente envía la solicitud Auth via social network al servidor de Xsolla Login.
2. El usuario inicia sesión en una red social.
3. El servidor de Xsolla Login procesa los datos de usuario recibidos de la red social y envía una solicitud a URL de inicio de sesión mediante red social. La respuesta debe tener el formato descrito en el escenario. En la respuesta, se puede especificar una lista de atributos de usuario o cualquier objeto JSON necesario. El objeto JSON que proporcione en la respuesta se registra en el campo partner_data del JWT del usuario.

{
  "exp": 1573635020,
  "iat": 1573634600,
  "iss": "https://login.xsolla.com",
  "request_type": "gateway_request",
  "xsolla_login_project_id": "00000000-0000-0000-0000-000000000000",
  "sub": "00000000-0000-0000-0000-000000000000",
  "email": "example@test.com",
  "username": "Smith707",
  "provider": "google",
  "id": "123",
}

Ejemplo de respuesta de URL de nuevo usuario:

POST https://your.hostname/your_social_authentication_uri HTTP/1.1
Authorization: Bearer {JWT}
Content-Type: application/json

{}

curl --request POST \
  --url 'https://your.hostname/your_social_authentication_uri' \
  --header 'authorization: bearer_JWT' \
  --header 'content-type: application/json'

Ejemplo de respuesta con atributos de usuario:

{
    "attributes": [
      {
        "attr_type": "server",
        "key": "company",
        "permission": "private",
        "value": "facebook-promo"
      },
      {
        "attr_type": "server",
        "key": "custom-id",
        "permission": "private",
        "value": 48582
      }
    ]
}

Ejemplo de respuesta con un objeto JSON:

{ "region": "Asia",
  "type": "new"
}

Restablecimiento de contraseña de usuario

1. El cliente envía la solicitud Reset password al servidor de Xsolla Login.
2. El servidor de Xsolla Login envía al usuario un correo electrónico de confirmación de restablecimiento de contraseña.
3. Tras confirmar el restablecimiento de contraseña en el correo electrónico, se redirige al usuario a la página donde puede introducir una nueva contraseña.
4. El usuario introduce una nueva contraseña.
5. El servidor de Xsolla Login envía una solicitud a la URL de restablecimiento de contraseña.

Ejemplo de respuesta de URL de nuevo usuario:

POST https://your.hostname/your_reset_uri HTTP/1.1
Authorization: Bearer {JWT}
Content-Type: application/json

{
  "username": "john@gmail.com",
  "fields": {
    "password": "NewPa$$word1"
  }
}

curl --request POST \
  --url 'https://your.hostname/your_reset_uri' \
  --header 'authorization: bearer_JWT' \
  --header 'content-type: application/json' \
  --data '{"email":"john@gmail.com","fields":{"password":"NewPa$$word1"}}'

Seguir leyendo