Documentação

Modelos de ameaças

O modelo de ameaças editável Coroid cria rascunhos para cada projeto a partir do código, explica como suas edições são mantidas e como as atualizações são propostas.

Um modelo de ameaças indica onde um projeto pode ser atacado e o que é mais crítico em caso de ataque. A Segurança armazena um modelo por projeto em Segurança → Modelos de ameaças, criado a partir do código e editado pela sua equipe.

O rascunho

Coroid gera a primeira versão lendo o branch padrão, sem um modelo AI, portanto o rascunho não tem custo. Ele é executado em um dos seus slots de agente, assim como outras varreduras. Ele analisa JavaScript, TypeScript e Python e identifica:

  • Pontos de entrada: rotas e manipuladores HTTP, operações OpenAPI, consumidores de fila e comandos de linha de comando;
  • Onde a confiança muda: middlewares de autenticação e outras fronteiras;
  • Dados sensíveis: onde configurações e segredos são lidos (apenas os nomes, nunca os valores);
  • gravações que não têm verificação de autenticação.

O modelo possui cinco seções: Pontos de entrada, Onde a confiança muda, Dados sensíveis, O que é mais crítico e Suas observações. O rascunho também lista o que não foi possível ler e o motivo: um arquivo muito grande ou ilegível, uma linguagem ainda não suportada ou um limite atingido.

Suas edições são mantidas

Cada entrada registra quem a escreveu. Coroid nunca sobrescreve o que uma pessoa escreveu.

Semanalmente, e sempre que um proprietário ou administrador escolher Ler o código novamente, Coroid lê o código novamente. Ele não altera o modelo. Em vez disso, propõe mudanças: entradas para adicionar, atualizar ou remover. Proprietários e administradores as aceitam em uma nova versão ou as rejeitam; uma mudança rejeitada não é proposta novamente.

Quando uma mudança é aceita, Coroid ignora tudo o que já não se aplica: uma entrada que uma pessoa alterou desde então, uma que já existe ou uma que desapareceu. Ele informa o que ignorou. Coroid propõe remover apenas o que seu próprio rascunho escreveu, e somente após uma leitura que abrange todo o código. Seu texto permanece; apenas o que Coroid encontrou no código é alterado.

Versões

A versão 1 é o rascunho. Cada proposta ou edição aceita gera uma nova versão, e o histórico mostra quem fez o quê: rascunhado a partir do código, editado por uma pessoa, atualização do Coroid adicionada por uma pessoa ou importado das Configurações.

Quem pode alterá-lo

Todos que podem visualizar um projeto podem ler seu modelo de ameaças. Proprietários e administradores o editam, aceitam ou rejeitam propostas e solicitam que Coroid leia o código novamente.

Como é utilizado

A auditoria de segurança lê o modelo de ameaças para decidir quais arquivos ler primeiro: o código nos caminhos de alto impacto e pontos de entrada do modelo vem antes do restante.

Portabilidade das Configurações

O modelo de ameaças mais recente de cada projeto faz parte do pacote de configurações da organização. Seu histórico e propostas pendentes permanecem onde estão. Veja Portabilidade das Configurações.