Back to flin
flin

Guards y middleware de seguridad personalizados

Cómo los desarrolladores de FLIN crean guards y middleware de seguridad personalizados para control de acceso específico de la aplicación -- guards de email verificado, verificaciones de suscripción, restricciones de IP y registro de auditoría.

Juste A. Gnimavo (Thales) & Claude | March 26, 2026 3 min flin
EN/ FR/ ES
flinrust

Los nueve guards integrados de FLIN cubren los patrones de control de acceso más comunes: autenticación, roles, limitación de tasa, CSRF, claves API, listas blancas de IP, restricciones de tiempo, propiedad de recursos y filtrado de métodos. Pero las aplicaciones reales tienen requisitos de seguridad específicos del dominio que ningún framework puede anticipar de antemano.

Una aplicación SaaS necesita verificar niveles de suscripción. Una plataforma educativa necesita verificar el estado de inscripción. Una aplicación financiera necesita registro de auditoría en cada mutación. Un sistema multi-tenant necesita asegurar que los usuarios solo accedan a los datos de su propio tenant.

La sintaxis guard_definition de FLIN y el sistema de middleware permiten a los desarrolladores crear estas capas de seguridad personalizadas con la misma API declarativa que los guards integrados.

Definición de guards personalizados

La palabra clave guard_definition crea un nuevo tipo de guard que puede usarse en cualquier lugar donde se usen los guards integrados:

flin// Definir un guard personalizado
guard_definition verified_email {
    user = request.user
    if user == none || !user.emailVerified {
        return response {
            status: 403
            body: { error: "Email verification required" }
        }
    }
}

Use el guard personalizado exactamente como un guard integrado:

flinguard auth
guard verified_email

route POST {
    // Solo usuarios autenticados con email verificado llegan aquí
}

Guards personalizados parametrizados

Los guards personalizados pueden aceptar parámetros para comportamiento configurable:

flinguard_definition subscription(required_plan) {
    user = request.user
    if user == none {
        return response {
            status: 401
            body: { error: "Authentication required" }
        }
    }

    plan_levels = { "free": 0, "starter": 1, "pro": 2, "enterprise": 3 }
    user_level = plan_levels[user.plan] || 0
    required_level = plan_levels[required_plan] || 0

    if user_level < required_level {
        return response {
            status: 403
            body: {
                error: "This feature requires the " + required_plan + " plan",
                current_plan: user.plan,
                required_plan: required_plan,
                upgrade_url: "/pricing"
            }
        }
    }
}

// Uso
guard auth
guard subscription("pro")

route POST {
    // Solo usuarios pro y enterprise
}

Composición de guards

Los guards personalizados se componen naturalmente con los guards integrados usando lógica AND:

flin// Seguridad máxima para operaciones financieras
guard auth
guard role("accountant", "admin")
guard verified_email
guard subscription("enterprise")
guard tenant_member
guard rate_limit(10, 60)
guard time("08:00", "18:00")

route POST {
    // Este endpoint requiere:
    // 1. Autenticación
    // 2. Rol de contador o administrador
    // 3. Dirección de email verificada
    // 4. Suscripción enterprise
    // 5. Membresía de tenant
    // 6. Dentro del límite de tasa
    // 7. Durante horario laboral
}

Siete guards, siete líneas. Cada uno se evalúa en orden. Si alguno falla, la solicitud es rechazada con el código de estado y mensaje de error apropiados.

Esto concluye el Arco 10 -- las funciones de seguridad de FLIN. Diez artículos cubriendo cobertura OWASP Top 10, hashing de contraseñas Argon2, autenticación JWT, limitación de tasa, cabeceras de seguridad, 2FA, OAuth2, WhatsApp OTP, validación de entrada, pruebas de seguridad y guards personalizados. En el Arco 11, entramos en la parte más innovadora de FLIN: el motor de IA e intenciones, donde el lenguaje natural se encuentra con las consultas de base de datos.


Esta es la Parte 115 de la serie "Cómo construimos FLIN", que documenta cómo un CEO en Abidjan y un CTO de IA diseñaron y construyeron un lenguaje de programación desde cero.

Navegación de la serie: - [114] 75 pruebas de seguridad: cómo verificamos todo - [115] Guards y middleware de seguridad personalizados (estás aquí) - [116] El motor de intenciones: consultas de base de datos en lenguaje natural - [117] Búsqueda semántica y almacenamiento vectorial

Share this article:

Responses

Write a response
0/2000
Loading responses...

Related Articles

Thales & Claude deblo

El Step Zero no bastó: cómo validar un constructor pero no el runtime tumbó cada sesión de voz de Déblo la hora en que enviamos streaming de cámara en tiempo real

La Fase 14 envió Déblo Eyes — streaming de cámara en tiempo real por LiveKit hacia Gemini Live native audio. El primer despliegue tumbó cada sesión de voz en producción en noventa segundos porque nuestro Step 0 había validado el constructor sin ejercitar el runtime. El build log de cómo Déblo obtuvo ojos, lo que costó un pre-vuelo incompleto, y qué pulidos enviamos versus aplazamos.

33 min May 20, 2026
debloclaude-opus-4.7claude-codegemini-live +25
Thales & Claude deblo

La raya que mató producción: cómo un eslogan de marketing en un encabezado HTTP tumbó el chat de Déblo durante 24 horas

Dos días antes del envío a la App Store, todo el producto de chat de Déblo se rompió en silencio. Sin spinner, sin toast, sin error en la UI — solo aire muerto. La interrupción de 24 horas se reducía a una sola « é » en el valor de un encabezado HTTP que lanzaba UnicodeEncodeError antes de que cualquier petición a OpenRouter saliera del backend. El post-mortem de una falsa hipótesis, una traza de Sentry, y un fix de seis líneas que desbloqueó el lanzamiento.

29 min May 19, 2026
debloclaude-opus-4.7claude-codeincident +19
Thales & Claude deblo

Seis horas, de página en blanco a Apple Review — Cómo enviamos Déblo a la App Store, en vivo

Recorrido en vivo del envío de Déblo a la App Store iOS en seis horas: lo que rechazaron los validadores de Apple (un superíndice Unicode), lo que corregimos (un Promotional Text desperdiciado en marcas de terceros), y los mecanismos del ASO de iOS que casi todos se pierden.

30 min May 13, 2026
debloclaude-opus-4.7claude-codeapp-store +16