Documentación técnica

Integración del SDK de Boris Sentinel AI

Esta guía resume los pasos esenciales para integrar el SDK en tus formularios. Está pensada para desarrolladores que trabajan con PHP u otros backends compatibles con HTTP/JSON.

1. Incluir el script en tu página

Agrega el siguiente script en el <head> o antes de cerrar el <body> de la página que contiene tu formulario:

<script
  src="https://sentinel.boristech.ai/js/boris-sentinel-sdk.min.js"
  data-sitekey="TU_SITE_KEY"
  data-api="https://sentinel.boristech.ai/api/analyze.php"
  data-badge="corner"
  data-toasts="1">
</script>

El atributo data-sitekey identifica a tu sitio dentro de Boris Sentinel AI. El endpoint de data-api apunta al análisis inicial (Analyze).

2. Marcar tu formulario para que sea protegido

Puedes marcar tu formulario con un atributo de data o una clase específica para indicar al SDK que debe protegerlo. Un ejemplo básico:

<form id="contactForm" class="bt-form" data-boris-sentinel="1" method="post" action="/procesar_form.php">
  <input type="text" name="nombre" placeholder="Tu nombre" required>
  <input type="email" name="email" placeholder="Tu correo" required>
  <textarea name="mensaje" placeholder="Tu mensaje" required></textarea>
  <button type="submit">Enviar</button>
</form>

El SDK detectará este formulario, inyectará los datos de análisis necesarios y disparará la llamada al endpoint de Analyze antes de enviar los datos definitivos a tu backend.

3. Verificación en tu backend (PHP)

En tu archivo procesar_form.php, debes validar la respuesta de verificación (Verify) antes de procesar definitivamente el formulario:

$verifyResponse = json_decode($respuestaJsonDeSentinel, true);

if (!$verifyResponse['ok']) {
    // Bloquear o marcar como sospechoso
    // Mostrar mensaje genérico al usuario
    exit('No se pudo validar tu envío. Intenta de nuevo.');
}

$score  = $verifyResponse['score'] ?? 0;
$reason = $verifyResponse['reason'] ?? '';

// Según tu criterio de negocio:
if ($score < 20) {
    // Muy sospechoso: rechazar
} elseif ($score < 60) {
    // Riesgo medio: podrías marcar para revisión manual
} else {
    // Tráfico legítimo: procesar normalmente
}

La implementación exacta puede variar según tu arquitectura. Lo importante es que la decisión final se tome en tu servidor, usando los datos que devuelve el motor de Boris Sentinel AI.

Para guías más detalladas (manejo de errores, logging avanzado, integración con paneles de monitoreo), puedes escribirnos a contacto@boristech.ai.