Executar uma análise de segurança aprofundada

Uma análise aprofundada executa várias análises padrão independentes no mesmo repositório ou pasta e combina as respetivas constatações. Use-a quando pretender uma revisão repetida e puder acomodar o tempo de execução e o consumo de tokens adicionais.

Comece com uma análise padrão para verificar se o âmbito e o contexto de segurança correspondem ao seu objetivo. A revisão repetida pode encontrar problemas que passaram despercebidos numa revisão anterior, mas não garante uma deteção completa nem resultados idênticos entre execuções.

Escolher entre análises padrão e aprofundadas

Iniciar a análise aprofundada

Para obter a melhor qualidade de análise, use gpt-5.6-sol com um esforço de raciocínio de xhigh.

1. Abra Segurança > Análises e selecione + Análise.
2. Escolha um repositório ou pasta, selecione Base de código e ative Análise aprofundada. A análise revê a totalidade do repositório ou da pasta selecionados.
3. Escolha o modelo e o esforço de raciocínio. Adicione contexto sobre o modelo de ameaças ou a implementação em Contexto adicional.
4. Selecione Iniciar análise.

Também pode iniciá-la a partir de uma conversa do Codex:

Use $codex-security:deep-security-scan to run a deep security scan of this repository.

Para um componente, substitua "this repository" pelo caminho da respetiva pasta.

Os processos de análise aprofundada herdam as definições de modelo e raciocínio selecionadas. Cada processo executa uma análise padrão completa, e o Codex Security agrega os resultados concluídos. Acompanhe a análise guardada em Análises, ou selecione Ver atividade para inspecionar a respetiva tarefa do Codex. Defina os limites de execução antes de começar se precisar de limitar a simultaneidade ou a duração.

Rever o resultado

As análises aprofundadas utilizam os mesmos detalhes de análise guardados e o mesmo diretório completo de análise que as análises padrão. Abra a análise concluída em Análises ou reveja as suas deteções em Deteções. O ficheiro report.md gerado contém ligações para relatórios detalhados de vulnerabilidades ou orientações de reforço estrutural quando solicita esses resultados. Mantenha os diretórios findings/ e hardening/ referenciados junto do relatório ao partilhar ou arquivar o resultado.

Reveja o resumo da cobertura antes das deteções. Mesmo uma análise aprofundada tem limites, por isso verifique as superfícies adiadas e as lacunas de comprovação restantes antes de tirar uma conclusão. Para uma deteção que aceite, prossiga com Corrigir e verificar uma deteção.

Para rever um pull request, commit, intervalo de branches ou patch local, utilize Rever alterações de código. As análises aprofundadas não aceitam alvos diff.

Configurar o tempo de execução da análise aprofundada

Para controlar a simultaneidade e a duração de uma análise aprofundada, crie ou edite ~/.codex/codex-security/config.toml. Se definir CODEX_HOME, utilize $CODEX_HOME/codex-security/config.toml em alternativa.

Por exemplo, este perfil executa uma análise mais curta com simultaneidade limitada:

[deep_scan]
workers = 2
subagents = 0
stop_after_no_new = 3
max_discovery_runs = 10
max_time_hours = 1.5

Valores inferiores podem reduzir o tempo da análise e a utilização de tokens, mas podem não detetar algumas conclusões. As alterações de configuração aplicam-se a novas análises aprofundadas, não às que já estão em curso.

Quando o limite de tempo expira, o Codex Security interrompe os workers inacabados, mantém os resultados das análises concluídas e agrega-os no relatório final. Se nenhum worker concluir a revisão do código-fonte antes do prazo, o relatório regista uma cobertura parcial.

A definição max_time_hours requer a versão 0.1.19 ou posterior do plugin. Consulte o registo de alterações do plugin para obter detalhes da versão.