Security Hooks

Hooks de segurança são instalados automaticamente em ~/.copilot/hooks/ para monitoramento em tempo real.

Arquitetura

~/.copilot/hooks/
├── security-hooks.json        # Config de hooks
├── security-pre-tool.js       # PreToolUse hook
├── security-post-tool.js      # PostToolUse hook
├── security-session-start.js  # SessionStart hook
├── security-stop.js           # Stop hook
├── security-user-prompt.js    # UserPromptSubmit hook
└── hook-log-helper.js         # Helper para logging JSONL

Eventos monitorados

Hook	Quando dispara	O que faz
PreToolUse	Antes de executar uma tool	Verifica se a tool é potencialmente perigosa
PostToolUse	Após execução de uma tool	Loga o resultado e detecta padrões suspeitos
SessionStart	Início de sessão Copilot	Registra início da sessão
Stop	Fim de sessão	Gera sumário de atividade
UserPromptSubmit	User envia prompt	Detecta prompts com intenção maliciosa

Activity Log

Todas as ações dos hooks são registradas em formato JSONL (JSON Lines):

{"timestamp":"2026-04-22T08:00:00.000Z","event":"PreToolUse","tool":"run_in_terminal","severity":"medium"}

Visualize na sidebar: Security Check → Hook Activity

Threshold de Severidade

Configure security-check.hookSeverityThreshold para controlar o nível de alerta:

• critical — Só alertas críticos
• high — Critical + high
• medium — Critical + high + medium (default)
• low — Quase tudo
• info — Tudo

Desativando hooks

Para desativar a instalação automática:

{
  "security-check.installGlobalHooks": false
}

WARNING

Desativar hooks remove o monitoramento em tempo real. Os hooks não afetam a performance do Copilot — são event-driven e assíncronos.