Verificación del Lado del Servidor

Siempre verifique el Nonce de SilentShield en su servidor. Las verificaciones solo del lado del cliente pueden ser evadidas por bots.

¿Por Qué del Lado del Servidor?

El Widget se ejecuta en el navegador e inyecta un Nonce en los formularios. Un bot podría omitir el Widget y enviar el formulario directamente. La verificación del lado del servidor asegura que el Nonce fue emitido y verificado legítimamente por SilentShield.

Endpoint de la API

Method

POST

URL

https://api.silentshield.io/api/v1/captcha/verify-nonce

Headers

X-Api-Key: YOUR_API_KEY Content-Type: application/json

Body

{ "nonce": "the-nonce-from-the-form" }

Formato de Respuesta

{
  "verdict": "human",
  "score": 0.92,
  "difficulty": "pass",
  "challenge_required": false
}

human

human — Es muy probable que el usuario sea humano. Procese el formulario.

suspicious

suspicious — El usuario podría ser un bot. Considere verificaciones adicionales.

bot

bot — Alta confianza de que es un bot. Rechace el formulario.

Lógica Recomendada

En la mayoría de los casos, verifique el campo verdict:

if verdict == "bot":
    reject the submission (403)
elif verdict == "suspicious":
    optionally require additional verification
else:
    process the form normally

Manejo de Errores

Si la API de SilentShield no es accesible (tiempo de espera agotado, error 5xx), decida su estrategia:

Fail Open

Fail open — Aceptar el formulario (mejor experiencia de usuario, menos seguro)

Fail Closed

Fail closed — Rechazar el formulario (más seguro, peor experiencia de usuario)