Administración del módulo Compliance
Active evaluaciones de marcos, revise brechas, cree y vincule reglas, registre attestations y exporte evidencias.
El módulo Compliance muestra qué controles técnicos de una instalación AIFW puede probar y cuáles no. Lee la configuración actual de reglas, evalúa marcos seleccionados, registra brechas y attestations, y genera informes de evidencias.
El módulo es independiente del motor de reglas: el motor aplica políticas al tráfico; Compliance evalúa esa configuración e informa del resultado. Una brecha no es una decisión de tráfico.
El módulo Compliance no es asesoramiento legal, certificación ni sustituto de controles organizativos. Consulte fuentes primarias y confirme la aplicabilidad con especialistas cualificados.
Activar el módulo#
Abra AI Firewall -> Agent Config -> Compliance. La sección aparece cuando el módulo está habilitado. Si está apagado, no se ejecutan evaluaciones ni trabajos programados y se oculta la navegación Compliance.
| Ajuste | Predeterminado | Significado |
|---|---|---|
| Enable the compliance module (ai_fw_compliance_enabled) | Off | Activa o desactiva evaluaciones y generación de evidencias. |
| Frameworks (compliance_frameworks_enabled) | Ninguno | Marcos seleccionados, guardados como lista separada por comas. |
| Report schedule (compliance_report_schedule) | weekly | off, daily, weekly o monthly. |
| Assessment interval (minutes) | 1440 | Frecuencia programada; rango 15 a 10080 minutos. |
| Evidence retention (days) | Según despliegue | Retención de informes; UI acepta 30 a 3650 días. |
| Raise drift events | Según despliegue | Registra cambios de reglas que afectan a controles evaluados. |
| Attestation expiry (days) | Según despliegue | Vigencia de una attestation manual; rango 1 a 3650 días. |
La página Settings enlaza a Compliance, donde se revisan postura y evidencias.
Revisar Compliance#
Tras activar el módulo, abra Compliance en la barra lateral. La página muestra marcos administrados, controles evaluados, brechas abiertas y puntuación de postura, o Not measured antes de la primera evaluación.
Use Run assessment para evaluar el alcance seleccionado. Los estados vacíos son explícitos; una página vacía no equivale a pasar la evaluación.
Administrar marcos y controles#
La tabla de marcos muestra estado, número de controles, brechas y puntuación. Use Enable o Disable para cambiar qué marcos se administran.
La tabla de controles se puede filtrar por:
| Filtro | Uso |
|---|---|
| Status | Ver controles conformes, brechas, resultados desconocidos y otros estados. |
| Severity | Priorizar controles de mayor impacto. |
| Mandatory | Separar controles obligatorios de controles de apoyo. |
Cada control muestra requisito, severidad, estado, regla asociada, attestation y evidencia. Una regla ausente o deshabilitada se informa como brecha, no como aprobado.
Crear y vincular una regla#
Cuando un marco seleccionado ofrece un rule pack, elija Control y Template, introduzca Pattern or keywords y seleccione Create and link. El módulo propone dirección, acción y severidad. La regla se crea habilitada y vinculada; revise el patrón antes de usarlo en producción.
Registrar una attestation#
Algunas obligaciones requieren una decisión humana identificada o actividad organizativa. Cuando el control admita attestation, use Attest y describa la base de la declaración. Se registra quién la hizo, fecha de expiración y nota opcional. Use Withdraw cuando deje de ser válida. Attestations vencidas o retiradas no cuentan como controles probados.
Interpretar resultados#
| Resultado | Significado |
|---|---|
| Compliant | El control configurado satisface las comprobaciones. |
| Unknown | No se pudo verificar la configuración o cobertura de identidad. |
| GapMissing | Falta la regla o control esperado. |
| GapDisabled | La regla existe, pero está deshabilitada. |
| GapMisconfigured | La regla no coincide con la configuración esperada. |
| AttestationExpired | La attestation humana requerida venció. |
Una regla existente pero desactivada es una brecha. Un inventario ilegible produce unknown, no inventario vacío.
Evidencias y drift#
Los informes de evidencia se guardan por marco y pueden exportarse como JSON o CSV. Incluyen estado de controles, estado de reglas, ajustes pertinentes, retención e inventario; no incluyen contenido de prompts ni respuestas.
Con Raise drift events, los cambios en reglas asociadas registran control afectado, cambio y actor. Tras resolver drift, ejecute otra evaluación.
Requisito previo de identidad A2A#
Los controles por identidad requieren tráfico de agente autenticado. Si a2a_auth_mode está off, Compliance indica el requisito y marca esos controles como UNKNOWN, no conformes. Habilite A2A authentication en AI Firewall -> Agent Config -> Access & Identity.