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,
.examplearquivos. - 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.
| Resposta | O que faz |
|---|---|
| Iniciar correção | Cria uma tarefa para os achados da decisão em cada projeto. A correção retorna como um pull request. |
| Verificar e corrigir o que é real | A mesma tarefa para afirmações: primeiro verifica cada uma, corrige as reais e deixa uma nota sobre as demais. |
| Abrir atualização | Abre a atualização como trabalho de correção, um pull request por projeto. |
| Ignorar a pasta | Os 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 dias | Oculta-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 hoje | Ele 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.