- Inicio
- Plantillas
- Cambio de autenticación: análisis de riesgos antes del código, auditoría después
Cambio de autenticación: análisis de riesgos antes del código, auditoría después
Última actualización
Cambia código de autenticación con Security-Sensitive Change: análisis de riesgos antes, auditoría de seguridad después, tus pruebas y un control de CI para hallazgos medios.
El código de autenticación falla en silencio: las pruebas pasan y el agujero se entrega. Esta plantilla pone una pasada de seguridad a cada lado de la implementación y endurece el control de publicación para el pull request que produce.
Qué agentes se ejecutan
| Paso | Agente |
|---|---|
| Scope change | Architect |
| Risk analysis | Security Auditor |
| Implement | Builder |
| Audit diff | Security Auditor |
| Validate | Tester |
El Architect delimita el cambio: qué archivos, qué código lo llama, qué tiene que seguir siendo compatible. El análisis de riesgos va antes de cualquier código, así que amenazas como la reutilización de tokens, las condiciones de carrera entre dos renovaciones o las sesiones que sobreviven a una revocación dan forma a la implementación en lugar de descubrirse después. A continuación, el Builder describe las ediciones.
Después del paso Implement, la pasada de código escribe el cambio y tu comando de pruebas se ejecuta sobre él en un sandbox sin conexión. El segundo paso del Security Auditor, Audit diff, y el paso Validate del Tester se ejecutan después. Reciben el diff y el resultado de pruebas registrado: el auditor audita el código tal como se escribió, y el Tester nombra los casos que demuestran que se rechaza un token reutilizado. Luego, la revisión de hallazgos lee el diff real con los dos pasos de seguridad como contexto.
Controles que se aplican
- Hallazgos. Los hallazgos abiertos de gravedad alta o crítica bloquean el pull request hasta que se pasan por triaje; los hallazgos de seguridad también aparecen en Secure → Security.
- Pruebas sobre esta versión. Las pruebas fallidas bloquean. Una edición después de ejecutarse las pruebas reinicia el resultado y la aprobación.
- Aprobación. Aprueba una persona distinta de la que empezó la sesión, cuando el espacio de trabajo tiene otro aprobador. Rechazar siempre está permitido, y un solo rechazo cierra la solicitud.
Bloquea con hallazgos de gravedad media en la CI
En el código de autenticación, un hallazgo de gravedad media merece una conversación antes de fusionar. Baja la gravedad que bloquea en la comprobación de la CI:
curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
-H "Authorization: Bearer $WORKSPACE_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"pullRequestURL\":\"$PR_URL\",\"blockingSeverity\":\"medium\"}" \
| jq -e '.allowed == true'
Las denegaciones enumeran los hallazgos abiertos en blockingFindings. Pasa por triaje cada uno (fixed, won't fix, false positive) desde la lista Findings de la ejecución, o elige Fix para empezar una sesión que lo corrija. Los campos están en la página de la API, y las reglas de revisión, en aprobaciones y políticas.
Para el riesgo de la cadena de suministro en el mismo servicio, combínala con la plantilla de control de SBOM y licencias.
Preguntas frecuentes
¿Esto analiza el repositorio en busca de secretos filtrados o CVE?
No. AI CodeOps no tiene escáner de secretos ni escáner de CVE. El Security Auditor revisa el cambio; mantén tus escáneres actuales en la CI.
¿Puedo aprobar el cambio si empecé yo la sesión?
No mientras otra persona del espacio de trabajo pueda aprobar, salvo que un administrador haya activado «Let the person who launched a change approve it» en Settings. Un equipo sin otro aprobador siempre puede aprobar sus propios cambios. En ambos casos la aprobación se marca como autoaprobada (self-approved).
Relacionado
- Revisión de seguridad y seguimiento de SBOM para código escrito por IA
- Aprobaciones y políticas
- La API
- Servicio en Python: control de SBOM y licencias
- Plantilla de modelo de amenazas para agentes de programación con IA
- CODEOWNERS inicial para repositorios con agentes de programación con IA
- Todas las plantillas