For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegação principal
Theme

Sugestões

Permissões

Codex Security

Segurança cibernética

Painel da API
Experimente o ChatGPT

Guia rápido do plugin Codex Security

Instale o plugin Codex Security, execute sua primeira varredura somente leitura e confira o resultado no Codex.

Instale o plugin Codex Security, execute uma varredura padrão em um repositório local e examine os problemas identificados. A varredura preserva o código-fonte e salva um relatório com evidências e orientações para corrigir os problemas.

Esta página explica como usar o plugin Codex Security no aplicativo para desktop ou na CLI do Codex. Para examinar um repositório do GitHub conectado ao Codex Cloud, instale o plugin Codex Security Cloud, disponível separadamente no marketplace de plugins. Consulte o guia de configuração na nuvem.

Instalar o plugin

  1. Abra o Codex no aplicativo ChatGPT para desktop.

  2. Abra Plug-ins e procure por Codex Security, ou use o botão abaixo.

    Instalar o plugin Codex Security

  3. Confirme que o plugin está ativado e abra Segurança na barra lateral.

Se a mensagem “Desativado pelo administrador” aparecer durante a instalação em um espaço de trabalho gerenciado, peça ao proprietário do espaço de trabalho que verifique o acesso aos plugins. Se você usa uma conta pessoal, consulte o guia de solução de problemas com plugins e aplicativos.

Se Segurança não aparecer na barra lateral do aplicativo para desktop, confirme que Codex está selecionado e que o plugin está ativado. Se necessário, atualize o aplicativo e o plugin. Verifique também se o administrador do espaço de trabalho permite o uso do plugin.

Verificar versões e atualizações

Consulte o histórico de alterações do plugin antes de iniciar uma varredura demorada. Para gerenciar a instalação, abra Plug-ins no aplicativo para desktop ou digite /plugins na CLI do Codex. Consulte o guia de plugins para saber mais. Depois de atualizar o plugin, inicie um novo chat para carregar as habilidades e ferramentas do plugin. Na CLI do Codex, digite /new.

O Codex e o plugin Codex Security têm versões independentes. Na CLI do Codex, use os comandos a seguir para verificar a versão do host e as versões dos plugins instalados.

codex --version
codex plugin list --json

Localize o Codex Security na lista installed. Anote as versões do Codex e do plugin ao iniciar uma varredura para poder informá-las caso precise relatar uma falha.

O pacote independente @openai/codex-security inclui seu próprio plugin. Atualizar esse pacote não atualiza o plugin do marketplace usado no Codex. Para instalar o pacote e verificar a versão, consulte o guia rápido da CLI.

Para usar o Amazon Bedrock, configure o host do Codex conforme o guia do Amazon Bedrock para o Codex. O pacote independente usa as configurações de provedor da CLI do Codex Security, que são separadas das configurações do host.

Executar a primeira varredura

Para obter a melhor qualidade na varredura, use gpt-5.6-sol com o esforço de raciocínio xhigh.

Escolha um repositório e configure a nova varredura de segurança antes de iniciá-la.

  1. Abra a configuração da varredura

    Selecione Segurança na barra lateral, abra Varreduras e selecione + Varredura.

  2. Escolha a base de código e a área da varredura

    Selecione um repositório existente ou use outra pasta. Escolha Base de código, mantenha a opção Varredura profunda desativada e selecione o repositório inteiro ou uma única pasta. Confirme que a branch e a revisão correspondem ao código que você deseja examinar.

  3. Adicione contexto de segurança

    Escolha o modelo e o esforço de raciocínio. Abra Contexto adicional apenas se precisar descrever um vetor de ataque, uma área sensível do ponto de vista da segurança ou algum detalhe do repositório que deva orientar a análise.

    Ative o contexto adicional para descrever vetores de ataque, indicar áreas prioritárias e fornecer orientações de segurança relevantes.

  4. Inicie a varredura

    Selecione Iniciar varredura e acompanhe as etapas no painel de Segurança. Selecione Ver atividade para examinar a tarefa do Codex que executa a varredura.

  5. Confira o resultado

    Abra a varredura concluída para examinar os problemas identificados, a cobertura e os artefatos disponíveis no relatório. Use Problemas identificados para consultar os problemas encontrados em diferentes varreduras ou Repositórios para ver o histórico de varreduras de um repositório.

    Confira os resultados da varredura, os problemas identificados e a cobertura no painel de Segurança.

Interpretar o resultado

Primeiro, confira o alvo da varredura e a revisão do código. Depois, veja quais áreas foram analisadas e quais ficaram para depois. Mesmo uma varredura concluída pode ter lacunas de cobertura. Uma análise que não identificou problemas não descarta necessariamente todas as vulnerabilidades.

Abra um dos problemas identificados. Examine as evidências no código-fonte, os pré-requisitos para o atacante, a validação realizada e as incertezas que restam. A validação pode se basear na análise do código-fonte sem executar um teste que reproduza o problema. Use o método e as evidências registrados para decidir se o problema se aplica ao seu sistema.

O que a varredura gera

No aplicativo para desktop, as varreduras concluídas ficam em Varreduras. Na CLI do Codex, acesse o diretório da varredura indicado na conversa. Abra report.md para ler o resultado. Você também pode solicitar relatórios detalhados de vulnerabilidades em findings/ e propostas de alterações no projeto para reforçar a segurança em hardening/.

O diretório também contém scan-manifest.json, findings.json e coverage.json para uso com ferramentas e automações. Ao compartilhar ou arquivar os resultados, mantenha o diretório inteiro para que os links do relatório continuem funcionando.

Escolher o próximo fluxo de trabalho

Para conhecer outros modos de varredura e fluxos de trabalho, volte à visão geral do Codex Security.