Conecte Signup Protection a su proceso de registro.

Antes de empezar

Necesita una cuenta de Emvero con el correo confirmado, una página de registro HTTPS que pueda editar y un paso en el servidor que se ejecute antes de dar acceso a la cuenta nueva. Si usa autenticación alojada o un creador de formularios, compruebe que permite añadir los scripts del navegador y ejecutar una comprobación propia en el servidor en ese punto.

También necesita créditos suficientes para la reserva máxima de la comprobación. Las señales evaluadas cuestan 5 créditos; la verificación del correo se cobra por separado. Un token inutilizable o un resultado de señales no disponible cuesta 0 por la parte de señales, pero debe haber saldo suficiente para la reserva al empezar la operación. Consulte los precios.

Para conocer los casos de uso y las funciones del producto, consulte la presentación de Signup Protection.

1. Active la conexión y cree una clave de página

Abra Signup Protection en su cuenta y active la conexión. Espere a que muestre el estado ready y cree una clave de página para el origen HTTPS de su página de registro.

Un origen contiene el protocolo, el nombre del host y un puerto opcional, como https://signup.example.com. No incluye ruta ni parámetros de consulta. La clave de página pública se usa en el navegador; una clave de API secreta independiente autoriza las comprobaciones desde el servidor.

En la cuenta encontrará los datos de conexión y el fragmento de código para el navegador. La guía de instalación explica los orígenes, el archivo de script con versión y la configuración de Content-Security-Policy.

2. Recoja el token cuando el formulario se haga visible

Instale el script del token y el script de comprobación del navegador que se sirve por separado. Añada un campo oculto para el token dentro del formulario de registro. Empiece la recogida cuando el formulario se haga visible, después de obtener el consentimiento que corresponda. Si el formulario está en un diálogo, empiece al abrirlo.

Escriba el token recibido en el campo oculto para que el formulario lo envíe al servidor. Si completar el formulario lleva mucho tiempo, renueve el token antes de que caduque y actualice el campo. Esperar al envío para recoger el primer token puede hacer que un registro normal parezca inusualmente rápido.

Las instrucciones de instalación en el navegador incluyen los archivos actuales, el código de inicialización y el funcionamiento de la renovación.

3. Compruebe el envío desde el servidor

Lea el token enviado en el código del servidor que gestiona el registro. Reenvíe la dirección IP, el User-Agent y los Client Hints que recibió realmente el servidor, de acuerdo con su configuración de proxies de confianza. Omita los datos de comparación que no estén disponibles.

Elija la ruta que corresponda a su proceso de verificación del correo:

Ruta	Cuándo usarla	Qué devuelve
POST /v1/signup-checks	Emvero debe comprobar la dirección de correo y la visita juntas.	El resultado del correo, los hallazgos de la visita y una acción recomendada combinada.
POST /v1/signup-signals	Su aplicación comprueba el correo por separado o usa otro proveedor.	Hallazgos de la visita y una acción basada solo en las señales.

Ambas rutas necesitan la clave de API secreta en el servidor. La ruta de solo señales no acepta email ni variant. En una comprobación combinada, variant selecciona la profundidad de verificación del correo: full o domain. Una comprobación de dominio no puede demostrar que exista un buzón concreto.

La guía de la API de Signup Protection contiene ejemplos de peticiones, campos y autenticación.

4. Aplique la acción recomendada antes de dar acceso

En una respuesta combinada, lea la action del nivel superior. El campo anidado email.action describe solo la verificación del correo y puede ser distinto cuando un hallazgo de la visita exige confirmación.

Acción recomendada	Siguiente paso de su aplicación
allow	Continuar según sus reglas de registro y acceso.
allow_with_email_confirmation	Enviar el mensaje de confirmación y exigir que se complete antes de dar el acceso correspondiente.
reject	Gestionar el rechazo de la dirección en el formulario de registro. Esta acción procede de la verificación del correo.

Las señales de visita pueden exigir confirmación; nunca recomiendan el rechazo por sí solas. Los hallazgos de VPN, Tor, proxy y alojamiento son informativos por defecto. Su aplicación gestiona los mensajes de confirmación y las reglas de acceso.

La referencia de códigos de señales explica cada hallazgo y sus acciones por defecto.

5. Gestione la falta de datos y los resultados pendientes

Estos resultados necesitan un tratamiento distinto:

Resultado	Significado y siguiente paso
Token ausente o inutilizable	No se puede evaluar la visita a través de ese token. Las señales devuelven token_unusable y exigen confirmación cuando el resultado del correo permitiría el registro.
Servicio de señales no disponible	signals.status es unavailable. La acción combinada sigue el resultado del correo; la acción de solo señales es allow, sin evaluación de la visita. Aplique su política para interrupciones del servicio.
Verificación del correo pendiente	La acción combinada exige confirmación mientras el correo esté pendiente. Recupere la comprobación guardada después de email.retry_after_ms; la visita no se evalúa de nuevo.

Un script bloqueado puede dejar el formulario sin token. Es un caso distinto de la falta de disponibilidad del servicio de señales. También puede haber una comparación del navegador sin evaluar aunque el resultado global de señales sea evaluated.

En los reintentos por problemas de transmisión, mantenga el mismo Idempotency-Key y cuerpo para la operación original. Consulte las comprobaciones pendientes y la idempotencia para conocer el funcionamiento completo.

6. Verifique el proceso de registro completo

Envíe un registro de prueba desde su propio origen HTTPS permitido y a través de su servidor. Examine el resultado guardado y compruebe que:

• el formulario incluye un token y el servidor reenvía los datos disponibles de la petición;
• el resultado muestra signals.status: evaluated;
• la aplicación aplica la acción del nivel superior antes de dar el acceso correspondiente;
• la confirmación y el tratamiento de los resultados no disponibles siguen las reglas elegidas.

Una conexión lista, una clave de página o tráfico del navegador registrado no demuestran que este proceso funcione. Una comprobación evaluada confirma la evaluación; aún debe verificar cómo responde la aplicación al resultado.

Consulte la política de privacidad y la información de seguridad al planificar la recogida, la conservación y la eliminación. Emvero procesa los datos de visita en su propia infraestructura de la UE; el plazo de 30 días para los resultados de señales no se aplica a todas las observaciones de conexiones ni a las estadísticas.