Documentação

Decisões

O módulo Segurança organiza os itens pendentes em decisões, já respondidas pelo CoRoid, em três pilhas. Você verifica as respostas e as aplica pilha por pilha.

O módulo Segurança pode identificar muitos itens: um pacote vulnerável mencionado em seis avisos de segurança, ou um scanner de segredos que detecta a mesma senha de exemplo em cinquenta arquivos de documentação. Você não decide sobre cada achado individualmente. O módulo Segurança os organiza em decisões: cada achado aberto que recebe uma resposta definida. O CoRoid já respondeu a cada um deles. Você verifica essas respostas, altera as incorretas e as aplica pilha por pilha.

A aba Decisões do módulo Segurança fica entre Visão geral e Projetos. Sua contagem indica quantas decisões são urgentes.

O que constitui uma decisão

  • Um pacote, em todos os seus projetos: "hono → 4.13.16 em 2 projetos" é uma única decisão, independentemente de quantos avisos de segurança essa atualização corrija.
  • Uma pasta com código de teste ou ferramentas: tudo o que estiver dentro de e2e/ ou de uma ferramenta de codificação .opencode/, independentemente do tipo de achado ou da gravidade atribuída pelo scanner.
  • Exemplos de um mesmo tipo: credenciais escritas intencionalmente na documentação, palavras em catálogos de tradução, dados de exemplo, .example arquivos.
  • Uma regra em um serviço: "Controle de acesso quebrado em apps/api-admin". Afirmações sem confirmação independente constituem uma decisão à parte das ocorrências confirmadas.
  • Uma regra de segredo no código de um projeto.

Um achado cuja correção já está em andamento não faz parte de nenhuma decisão. Ele é listado nas pilhas ("CoRoid já está trabalhando em mais 2") e reaparece apenas se a correção falhar. Um achado ocultado por uma exceção também não faz parte de nenhuma decisão.

Três pilhas

  • Urgente: itens explorados em algum lugar, críticos ou com prazo de correção vencido no que você implanta. Trabalhe neles primeiro.
  • Deve ser feito: itens que fazem parte do que você implanta, mas com prazo de correção não vencido. Podem esperar alguns dias.
  • Limpeza: código de teste, ferramentas, exemplos e afirmações de baixa gravidade, independentemente da sua severidade. Na maioria dos casos, são ruídos e são respondidos em bloco.

Cada pilha mostra quantas decisões restam, quanto tempo elas levam para serem resolvidas e uma barra indicando o que foi respondido hoje.

A resposta do CoRoid

Cada decisão traz a resposta do CoRoid, com Certamente ou Provavelmente e uma linha explicando o motivo. Abra uma decisão para ler toda a justificativa, onde estão os achados e todas as respostas com suas ações.

Quando apenas uma pessoa pode avaliar, como para saber se uma credencial no seu código é real, a decisão não tem resposta e indica Precisa da sua intervenção. O processo de aplicação ignora essa decisão até que você a escolha.

Avaliando a partir do código

Uma decisão sobre uma credencial ou um achado de código é aberta com Onde está: cada localização, com as linhas ao redor como estavam no commit em que o scanner as detectou, a linha sinalizada marcada e, para um repositório GitHub, Abrir no GitHub, que abre essa linha naquele commit. Você não precisa de um editor ou de fazer checkout para decidir.

A própria credencial nunca sai da cópia do seu repositório feita pelo CoRoid. Todos os valores que parecem ser credenciais nas linhas exibidas são ocultados, e o módulo Segurança informa apenas seu comprimento e aparência:

  • uma palavra padrão comum, do tipo usado em configurações locais (changeme, postgres);
  • parecida com aleatória, como geralmente são chaves ou senhas reais;
  • texto legível, como uma frase-senha.

Na maioria dos casos, o que define a decisão permanece visível: a variável à qual ela é atribuída, o host em uma string de conexão, se a linha é um comentário e referências como ${DB_PASSWORD} que não possuem valor.

Se um arquivo foi excluído após o scanner detectar a credencial, o local indicará isso. A exclusão de um arquivo não remove a credencial do histórico do repositório: quem puder ler o repositório ainda a encontrará nos commits anteriores. Se for real, faça a rotação.

RespostaO que faz
Iniciar correçãoCria uma tarefa para os achados da decisão em cada projeto. A correção retorna como um pull request.
Verificar e corrigir o que é realA mesma tarefa para afirmações: primeiro verifica cada uma, corrige as reais e deixa uma nota sobre as demais.
Abrir atualizaçãoAbre a atualização como trabalho de correção, um pull request por projeto.
Ignorar a pastaOs achados nessa pasta deixam de ser contabilizados, tanto agora quanto em scans futuros. É possível desfazer essa ação.
Não é segredo.Fecha as descobertas e o scanner de segredos aprende com sua resposta.
Não é um problema...Os marca como falsos positivos, com seu motivo registrado no histórico deles.
Aceitar por 90 diasOculta-os por 90 dias ou até que a gravidade deles aumente.
Sim, rotacione-o.Arquiva a lista de verificação de rotação. A descoberta é fechada quando você confirma que o valor antigo não funciona mais.
Sim, já foi rotacionado.Fecha-os com sua confirmação.
Encaminhe para um administrador...Move-o para a lista de outro proprietário ou administrador, com sua nota.
Ignorar por hojeEle retornará amanhã, no mesmo lugar.

Quando você altera uma resposta, a Segurança oferece a mesma resposta para as decisões semelhantes: "Mais 1 decisão parecida... Mesma resposta".

Aplicar um lote

Aplicar Aplica todas as respostas prontas no lote. Uma mensagem indica quais tarefas foram iniciadas (elas aparecem na Factory) e oferece Desfazer. Respostas dadas hoje Lista suas respostas. Você pode reverter aquelas cujos registros permitem: exceções, vereditos, ignorações e encaminhamentos. O trabalho iniciado é interrompido na Factory, não aqui.

Quando o modo Urgente terminar, a Segurança informará quantas decisões restam e quantas já passaram da data de correção, e então oferecerá Parar por hoje ou Continuar.

O teclado também funciona: ↑ e ↓ navegam entre as decisões, Enter abre uma, 1 a 9 selecionam uma resposta e ⌘ Enter aplica.

Na Factory

Da Factory Precisa de você mantém uma linha de Segurança enquanto uma decisão é urgente: "5 decisões urgentes · cerca de 2 min · 32 no total". Iniciar abre Decisões. Uma decisão que não pode esperar tem sua própria linha: um pacote explorado, uma descoberta crítica confirmada ou uma credencial que uma pessoa confirmou ser real no que você implanta.

Quando nada é urgente, a linha sai de Precisa de você e uma linha indica quantas decisões podem aguardar sua próxima sessão.

Quem responde

Proprietários e administradores respondem às decisões. Membros as leem junto com as evidências. As ferramentas MCP e Chat do CoRoid listam as mesmas decisões (list_security_needs). Veja Segurança via MCP e Chat.