Middleware de Express.js para Verificación Dinámica de Identidad (ES)

Verificación Dinámica con Express.jsImplementa un middleware de Express.js para orquestar decisiones de verificación de identidad en tiempo real, adaptando flujos de trabajo según el contexto del usuario o el riesgo de la transacción utilizando la API de Didit.

Aprovecha la Arquitectura Modular de DiditLa plataforma de identidad abierta y modular de Didit permite a los desarrolladores integrar fácilmente verificaciones específicas como Verificación de ID, Prueba de Vida y Detección de AML en su middleware.

Automatiza la Confianza con Soluciones Nativas de IAUtiliza las capacidades nativas de IA de Didit para la toma de decisiones inteligentes, reduciendo la revisión manual y agilizando los procesos de cumplimiento para un sistema más eficiente y seguro.

Integración Perfecta y KYC Básico GratuitoDidit ofrece un enfoque centrado en el desarrollador con APIs claras, un entorno de pruebas instantáneo y KYC Básico Gratuito, lo que facilita la creación e implementación de lógica de verificación sofisticada dentro de tus aplicaciones Express.js.

La Necesidad de la Verificación Dinámica de Identidad

En el panorama digital actual, los procesos estáticos de verificación de identidad ya no son suficientes. Las empresas necesitan la flexibilidad para adaptar sus requisitos de KYC (Conoce a tu Cliente) y AML (Anti-Lavado de Dinero) basados en varios factores, como la ubicación del usuario, el valor de la transacción, el perfil de riesgo o incluso el servicio específico al que se accede. Por ejemplo, una transacción de bajo valor podría requerir solo una verificación básica de correo electrónico, mientras que una operación financiera de alto valor exige un escaneo completo de documentos de identidad, una verificación de prueba de vida y una detección de AML. Construir un middleware de Express.js proporciona una forma elegante y eficiente de incrustar estas capacidades dinámicas de toma de decisiones directamente en el ciclo de solicitud-respuesta de tu aplicación.

Este enfoque dinámico permite una experiencia de usuario más consciente de la fricción. En lugar de someter a cada usuario al proceso de verificación más estricto, puedes adaptar el recorrido, solicitando más información solo cuando sea necesario. Esto no solo mejora las tasas de conversión, sino que también aumenta la seguridad al enfocar los recursos donde más se necesitan. La implementación de esto requiere una plataforma robusta de verificación de identidad, y Didit, con su diseño modular y API-first, es perfectamente adecuada para dicha integración.

Diseñando tu Middleware de Verificación en Express.js

Una función de middleware de Express.js tiene acceso a los objetos de solicitud y respuesta, y a la siguiente función de middleware en el ciclo de solicitud-respuesta de la aplicación. Esto lo convierte en un lugar ideal para interceptar solicitudes, realizar comprobaciones de identidad y modificar el flujo en función de los resultados. Aquí hay un esquema conceptual de cómo podría funcionar dicho middleware:

1. Interceptar Solicitud: El middleware intercepta una solicitud entrante a una ruta protegida (por ejemplo, una ruta para iniciar una transacción de alto valor).
2. Extraer Contexto: Extrae información relevante de la solicitud, como el ID de usuario, la dirección IP, la acción solicitada o el monto de la transacción.
3. Evaluar Riesgo/Política: Basado en este contexto, el middleware determina el nivel de verificación requerido. Esto podría implicar la verificación de perfiles de usuario internos, puntuaciones de riesgo en tiempo real o reglas de negocio predefinidas.
4. Iniciar Sesión de Didit: Si se necesita verificación, el middleware realiza una llamada a la API de Didit para crear una nueva sesión de verificación. La herramienta didit_create_session de Didit es perfecta para esto, permitiéndote especificar un workflow_id que corresponde a los pasos de verificación deseados (por ejemplo, Verificación de ID, Prueba de Vida Pasiva y Activa, Detección de AML).
5. Redirigir o Incrustar: Didit devuelve una URL de verificación única. El middleware puede entonces redirigir al usuario a esta URL o, para una experiencia más integrada, incrustar el flujo de verificación de Didit dentro de un iframe en tu sitio.
6. Manejar Callbacks de Webhook: La plataforma de Didit envía actualizaciones en tiempo real a través de webhooks a medida que el usuario avanza en la verificación y cuando se toma la decisión final. Tu backend necesita un endpoint separado para recibir y procesar estos webhooks, actualizando el estado de verificación del usuario en tu base de datos.
7. Permitir o Denegar Acceso: Una vez que el webhook confirma la verificación exitosa, se puede otorgar acceso al usuario al recurso protegido. Si la verificación falla, se deniega el acceso.

Esta orquestación dinámica te permite definir recorridos de verificación complejos sin codificar cada decisión en la lógica de tu aplicación. La arquitectura modular de Didit significa que puedes intercambiar o agregar fácilmente nuevos pasos de verificación (por ejemplo, Prueba de Domicilio o Estimación de Edad) a tus flujos de trabajo en la Consola de Negocios sin cambiar el código de tu aplicación.

Implementación Práctica con la API de Didit

Consideremos un ejemplo simplificado de un middleware de Express.js que inicia una sesión de verificación de Didit. Primero, asegúrate de tener una clave API de Didit. La usarás para autenticar tus solicitudes.

const express = require('express');
const axios = require('axios');
const app = express();

// Reemplaza con tu clave API de Didit y ID de flujo de trabajo reales
const DIDIT_API_KEY = 'YOUR_DIDIT_API_KEY';
const HIGH_RISK_WORKFLOW_ID = 'YOUR_HIGH_RISK_WORKFLOW_ID'; // ej., ID + Liveness + AML
const LOW_RISK_WORKFLOW_ID = 'YOUR_LOW_RISK_WORKFLOW_ID';   // ej., Email + Teléfono

// Función simulada para determinar el riesgo basándose en datos del usuario
const assessRisk = (userId, transactionAmount) => {
    // En una aplicación real, esto implicaría una lógica más sofisticada
    if (transactionAmount > 1000 || userId === 'high_risk_user_id') {
        return 'HIGH';
    }
    return 'LOW';
};

const dynamicVerificationMiddleware = async (req, res, next) => {
    const userId = req.user.id; // Asumiendo que el ID de usuario está disponible desde la sesión/autenticación
    const transactionAmount = req.body.amount; // Asumiendo que el monto está en el cuerpo de la solicitud

    const riskLevel = assessRisk(userId, transactionAmount);
    let workflowIdToUse;

    if (riskLevel === 'HIGH') {
        console.log(`Usuario ${userId} identificado como de ALTO riesgo. Iniciando verificación de alto riesgo.`);
        workflowIdToUse = HIGH_RISK_WORKFLOW_ID;
    } else {
        console.log(`Usuario ${userId} identificado como de BAJO riesgo. Iniciando verificación de bajo riesgo.`);
        workflowIdToUse = LOW_RISK_WORKFLOW_ID;
    }

    try {
        const response = await axios.post(
            'https://verification.didit.me/v3/session/',
            {
                workflow_id: workflowIdToUse,
                vendor_data: userId, // Vincula la sesión a tu ID de usuario interno
                callback: 'https://your-app.com/didit/webhook-handler' // Tu endpoint de webhook
            },
            {
                headers: {
                    'x-api-key': DIDIT_API_KEY,
                    'Content-Type': 'application/json'
                }
            }
        );

        const verificationUrl = response.data.url;
        console.log(`URL de verificación para el usuario ${userId}: ${verificationUrl}`);

        // Redirige al usuario a la página de verificación alojada por Didit
        return res.redirect(verificationUrl);

        // Alternativamente, envía la URL de vuelta al cliente para integración frontend (ej., iframe)
        // return res.status(402).json({ message: 'Verificación requerida', verificationUrl });

    } catch (error) {
        console.error('Error al crear la sesión de Didit:', error.response ? error.response.data : error.message);
        return res.status(500).send('Servicio de verificación no disponible.');
    }
};

// Ruta protegida de ejemplo
app.post('/api/perform-transaction', dynamicVerificationMiddleware, (req, res) => {
    // Este código solo se ejecutará si dynamicVerificationMiddleware lo permite (ej., después de que un webhook confirme la verificación)
    res.send('¡Transacción exitosa!');
});

app.listen(3000, () => console.log('Servidor ejecutándose en el puerto 3000'));

Este ejemplo demuestra cómo seleccionar dinámicamente un flujo de trabajo de Didit basado en la evaluación de riesgos e iniciar una sesión. Recuerda que la decisión real de proceder con la transacción debe tomarse después de que el webhook de Didit confirme el resultado de la verificación.

Cómo Ayuda Didit

Didit está en una posición única para capacitar a los desarrolladores a construir soluciones dinámicas de verificación de identidad. Nuestra plataforma nativa de IA y centrada en el desarrollador proporciona los bloques de construcción que necesitas:

• Identidad Modular: La arquitectura abierta y modular de Didit te permite componer flujos de trabajo de verificación con comprobaciones específicas como Verificación de ID (OCR, MRZ, códigos de barras), Prueba de Vida Pasiva y Activa, Coincidencia Facial 1:1, Detección y Monitoreo de AML, Prueba de Domicilio y Estimación de Edad. Combina estos en flujos de trabajo personalizados en nuestra Consola de Negocios sin código, cada uno con un workflow_id único que tu middleware puede llamar dinámicamente.
• Flujos de Trabajo Orquestados: Define recorridos de verificación complejos con lógica condicional y múltiples pasos, todo gestionado por Didit, reduciendo la carga sobre tu aplicación.
• Experiencia Centrada en el Desarrollador: Con APIs limpias, un entorno de pruebas instantáneo y documentación completa, integrar Didit en tu aplicación Express.js es sencillo. Puedes generar enlaces de verificación a través de una simple llamada a la API, como se demostró anteriormente.
• Automatización sobre Revisión Manual: Las capacidades nativas de IA de Didit automatizan la toma de decisiones para un alto porcentaje de verificaciones, reduciendo significativamente la necesidad de revisión manual y acelerando el proceso de incorporación.
• KYC Básico Gratuito: Comienza con funciones esenciales de verificación de identidad sin costos iniciales, lo que te permite probar y escalar tus estrategias de verificación dinámica de manera efectiva.

Ya sea que necesites verificar la edad para una aplicación, asegurar el cumplimiento para servicios financieros o prevenir el fraude con biometría avanzada, el conjunto completo de productos de Didit y las opciones de integración flexibles lo convierten en el socio ideal para construir una verificación de identidad dinámica y robusta en tus aplicaciones Express.js.

¿Listo para Empezar?

¿Listo para ver Didit en acción? Obtén una demostración gratuita hoy mismo.

Comienza a verificar identidades gratis con el nivel gratuito de Didit.