David Abutbul
b37162a33d
* feat(i18n): add multilingual wiki scaffolding, language switcher, and translation QA pipeline * docs(readme): adopt picoclaw-style multilingual link bar * fix(i18n): repair localized index links and tighten partial-pair QA * ci(i18n): fail on broken markdown links in README/wiki * ci(i18n): add changed-files mode for markdown link checks * i18n(de): use local Argos MT to fill untranslated German sections * i18n(es,fr): fill untranslated sections via local Argos workflow * i18n(ja): fill untranslated sections with scoped local Argos pass * i18n(ko): fill untranslated sections with scoped local Argos pass * fix(i18n): address review feedback --------- Co-authored-by: David Abutbul <David.a@prompt.security>
4.7 KiB
Seguridad
Resumen del modelo de seguridad
- ClawSec protege tanto la distribución de contenido (artefactos firmados) como el comportamiento en runtime (advisory gating, monitoreo de integridad).
- Las anclas de confianza son claves públicas fijadas en el repo y verificadas contra outputs generados por workflows.
- Los consumidores runtime usan por defecto un modelo verification-first, con flags de bypass explícitos solo para migración.
Controles criptográficos
| Control | Mecanismo | Ubicación |
Silencio.
| Autenticidad del feed | Firmas detached Ed25519 (feed.json.sig) | Workflows de advisories + librerías de verificación del consumidor. |
| Integridad de artefactos | Manifiestos de checksum SHA-256 (checksums.json) | Workflows de release de skill y deploy de pages. |
| Consistencia de claves | Comparación de fingerprint entre docs + PEM canónicos | scripts/ci/verify_signing_key_consistency.sh. |
| Acción de verificación de firma | Acción compuesta de sign+verify en CI | .github/actions/sign-and-verify/action.yml. |
Controles de enforcement en runtime
| Control | Componente | Efecto |
Silencio.
| Advisory hook gating | clawsec-advisory-guardian | Alertas y guía cautelosa según advisories coincidentes. |
| Instalador con doble confirmación | guarded_skill_install.mjs | Sale con código 42 hasta recibir confirmación explícita en advisories coincidentes. |
| Extensión de reputación | clawsec-clawhub-checker | Scoring de riesgo adicional antes de instalar. |
| Signature gate en NanoClaw | skill-signature-handler.ts + herramienta MCP | Bloquea instalaciones de paquetes manipulados/no firmados por política. |
| Monitor de baseline de integridad | soul-guardian + monitor de integridad NanoClaw | Detección de drift, cuarentena, restauración e historial auditable. |
Controles de cadena de suministro y CI
- CI ejecuta Trivy, npm audit, CodeQL y Scorecard.
- Los checks locales pre-push pueden ejecutar
gitleaks detectsigitleaksestá instalado. - Los workflows de release validan existencia de SBOM antes de empaquetar.
- El workflow de deploy verifica el fingerprint de la signing key generada contra material de clave canónico.
- La documentación de release incluye comandos de verificación manual para consumidores downstream.
Playbooks de incidentes y rotación
wiki/security-signing-runbook.mddefine generación de claves, custodia, rotación y fases de incidentes.wiki/migration-signed-feed.mddefine enforcement por etapas y niveles de rollback.- Los paths de rollback priorizan preservar publicación firmada cuando sea posible y limitar temporalmente cualquier bypass.
Snippets de ejemplo
# verificar fingerprint de la clave pública canónica
openssl pkey -pubin -in clawsec-signing-public.pem -outform DER | shasum -a 256
# ejecutar guardrail de consistencia de claves usado en CI
./scripts/ci/verify_signing_key_consistency.sh
Tradeoffs de seguridad conocidos
- El modo de compatibilidad sin firma reduce garantía y debe deshabilitarse cuando termine la migración.
- Algunos paths de deploy toleran assets de checksums legacy sin firma por compatibilidad retroactiva.
- Los checks de reputación dependen de output de tooling externo y pueden incluir falsos positivos/negativos heurísticos.
- Los scripts locales heredan confianza del entorno; un shell local comprometido aún puede subvertir flujos del operador.
Oportunidades de hardening
- Eliminar flags de compatibilidad unsigned tras estabilizar migración.
- Expandir verificación determinista de checksum/firma para todos los archivos release espejados.
- Añadir tests explícitos para escenarios de falla de firma a nivel workflow.
- Aumentar telemetría runtime para fallas en fetch/verify de advisories y simplificar triage de incidentes.
Notas de actualización
- 2026-04-27: Traducción inicial al español de
wiki/security.md. - 2026-02-26: Referencias de signing y migración movidas desde
docs/raíz a páginas operativas enwiki/.
Referencias de código
SECURITY.mdwiki/security-signing-runbook.mdwiki/migration-signed-feed.mdscripts/ci/verify_signing_key_consistency.sh.github/actions/sign-and-verify/action.yml.github/workflows/poll-nvd-cves.yml.github/workflows/community-advisory.yml.github/workflows/skill-release.yml.github/workflows/deploy-pages.ymlskills/clawsec-suite/hooks/clawsec-advisory-guardian/lib/feed.mjsskills/clawsec-suite/scripts/guarded_skill_install.mjsskills/clawsec-clawhub-checker/scripts/enhanced_guarded_install.mjsskills/soul-guardian/scripts/soul_guardian.pyskills/clawsec-nanoclaw/host-services/skill-signature-handler.tsskills/clawsec-nanoclaw/guardian/integrity-monitor.ts