Ingresar con Crafy Account

1. Crear un Cliente de inicio de sesión

Sigue estos pasos:

1. Ingresa a tu Panel de creación de Clientes de inicio de sesión.
2. Rellena el formulario con los datos del nuevo Cliente de inicio de sesión.
   • Nombre: es un identificador alfanumérico del Cliente.
   • Título: es el título del Cliente que se mostrará a los usuarios cuando inicien sesión.
   • Enlace: es el enlace a tu aplicación.
3. Ingresa a tu Panel de Clientes de inicio de sesión.
4. Busca el Cliente de inicio de sesión que creaste y haz click en el botón "Ver credenciales".
5. En esa ventana encontrarás las credenciales del Cliente de inicio de sesión. Las utilizarás en los próximos pasos.

2. Envía al usuario a iniciar sesión

Sigue estos pasos:

1. Utiliza las credenciales de tu Cliente de inicio de sesión (creadas en el paso anterior) para llamar al método create_login_token de la API de Crafy Account.
2. Redirige al usuario a la login_url que obtuviste como respuesta de la API. Si lo deseas, puedes mostrar un botón al usuario para que haga click y lo dirija a la login_url; a continuación tienes el código HTML para generar el botón:

Botón de inicio de sesión

Reemplaza {login_url} por la login_url generada anteriormente

<div crafy-account-login-button="{login_url}"></div> <script src="https://account.chijete.com/r/crafyAccountResources/crafyAccountLoginButton.js"></script>

Así se verá tu botón:

3. Procesa la respuesta del servidor de Crafy Account

Después de enviar al usuario a Crafy Account mediante la login_url, este volverá a tu aplicación, a la redirection_url que especificaste cuando llamaste al método create_login_token de la API (en el paso anterior).
Tu redirection_url recibirá un parámetro query como respuesta del servidor de Crafy Account.
Este parámetro será "session_id_token" (si el usuario inició sesión con éxito) o "access_denied" (si el usuario rechazó el inicio de sesión).

Posibles parámetros query recibidos en redirection_url

• session_id_token
  • Se envía si el usuario inició sesión con éxito en tu Cliente de inicio de sesión.
  • Contiene el Session ID Token de la Sesión de usuario. Más información.
  • ¿Qué sigue? Guarda el Session ID Token recibido para usarlo en el siguiente paso.
• access_denied
  • Se envía si el usuario rechazó el inicio de sesión en tu Cliente de inicio de sesión.
  • Contiene el Login Token generado en el paso 2.
  • ¿Qué sigue? Muestra un error al usuario y ofrécele iniciar sesión nuevamente.

4. Obtén las Credenciales de la Sesión de usuario

Sigue estos pasos:

1. Utiliza las credenciales de tu Cliente de inicio de sesión y el session_id_token obtenido en el paso anterior para llamar al método get_login de la API de Crafy Account.
2. Guarda las Credenciales de la Sesión de usuario devueltas por el método get_login. Estas credenciales representan la autorización del usuario para que tu Cliente de inicio de sesión acceda a su cuenta.
3. En el futuro, para comprobar si la sesión sigue siendo válida, vuelve a llamar al método get_login de la API con el session_id_token guardado. Si la sesión ya no es válida, este método devolverá un error.

5. Usa las credenciales para acceder a la cuenta del usuario

Sigue estos pasos:

1. Utiliza las credenciales de tu Cliente de inicio de sesión y las Credenciales de la Sesión de usuario obtenidas en el paso anterior para llamar al método get_logued_user_data de la API de Crafy Account.
2. El método de la API responderá con la información del usuario que inició sesión, como por ejemplo, su nombre y correo electrónico.
3. Debes usar el mismo procedimiento para acceder al resto de los métodos de la API que requieran Credenciales de la Sesión de usuario.
4. Recuerda que las Credenciales de la Sesión de usuario son válidas temporalmente y expirarán en el futuro. Cuando esto suceda, deberás repetir el proceso desde el paso 2 para obtener unas nuevas Credenciales de la Sesión de usuario.