Integración de Portales Web

Descripción General

La integración web utiliza una librería JavaScript que se ejecuta en el navegador del usuario para recopilar datos del dispositivo y sesión. Estos datos se cifran y se envían junto con las credenciales de inicio de sesión del usuario a tu backend, que luego los reenvía al API de SmartID.

Instalación

Incluye el script del SDK Web de SmartID en tu página de login:

<script src="https://cdn.smartidsuite.ai/sdk/smartid-web-v5.1.min.js"></script>

Integración

La integración web sigue el mismo proceso de dos pasos que la móvil:

1. Recopilar Datos del Dispositivo

Inicializa el SDK de SmartID y recopila datos cifrados del dispositivo:

// Initialize SmartID Web SDK
const smartId = SmartId.getInstance();

smartId
  .getRawData(/* optional */ 'backend_url')
  .onSuccess(function(time, response) {
    // response = encrypted device data string
    // Attach it to the login form submission
    document.getElementById('smartid-data').value = response;
  })
  .onFailure(function(time, message, errorCode) {
    // Log error, send empty data field
    console.error('SmartID error:', message, errorCode);
    document.getElementById('smartid-data').value = '';
  })
  .start();

2. Incluir en Formulario de Login

Agrega un input oculto a tu formulario de login para transportar los datos cifrados:

<form action="/api/login" method="POST">
  <input type="text" name="username" placeholder="Username" />
  <input type="password" name="password" placeholder="Password" />
  <input type="hidden" name="smartid_data" id="smartid-data" />
  <button type="submit">Login</button>
</form>

3. Procesamiento en Backend

Tu backend recibe los datos del formulario incluyendo <code>smartid_data</code> y los reenvía al API de SmartID. Consulta la Referencia API para detalles completos de endpoints, atributos de solicitud y ejemplos.