Skip to content

About

Documentação operacional do Morpheus (mapeamento de componentes/dependências para SCA/DAST)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

22 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

morpheus-ops

Repositório de documentação operacional/segurança do morpheus-beta: principalmente o inventário completo de componentes/versões usados para operar o sistema.

Por quê um repo separado

Um mapeamento detalhado de versões exatas de cada dependência, imagem Docker e serviço de infraestrutura não tem relação direta com o código/produto do morpheus-beta; mantê-lo num repo à parte facilita achar e manter esse tipo de documentação sem misturar com o desenvolvimento da aplicação.

Nota: este repositório é público. O inventário abaixo lista versões exatas de cada dependência/imagem em uso, o que facilita a busca por CVEs conhecidas contra o stack; tenha isso em mente antes de usá-lo como fonte para decisões de segurança sem cruzar com o estado real (versões mudam a cada pnpm install/deploy).

Inventário de componentes

reports/component-inventory.md é gerado automaticamente: nunca editado à mão. Cobre:

  • Runtime/plataforma (Node, pnpm)
  • Imagens Docker base (todas as stages dos Dockerfiles)
  • Serviços de infraestrutura do docker-compose (ex. PostgreSQL)
  • Dependências de cada workspace (@morpheus/api, @morpheus/web, @morpheus/database, @morpheus/config), com a versão resolvida (não o range do package.json)

Gerar/atualizar

Requer um checkout local de morpheus-beta com pnpm install já rodado (o script lê versões resolvidas via pnpm -r list).

# a partir da raiz deste repo, usa ../morpheus-beta por padrão
node scripts/generate-component-inventory.mjs

# ou apontando pra outro caminho
node scripts/generate-component-inventory.mjs /caminho/pro/morpheus-beta

Rodar de novo sempre antes de pedir uma avaliação de upgrade/downgrade ou definir uma janela de manutenção: o documento reflete o estado do checkout no momento em que foi gerado, não se atualiza sozinho.

Uso pretendido

Com o inventário atualizado, é possível pedir uma avaliação (upgrades/downgrades disponíveis, CVEs conhecidas, o que entraria numa janela de manutenção) tendo o documento como contexto. Preparação de terreno para integrar futuramente uma ferramenta de SCA real (ex. Dependabot) e, mais adiante, DAST.

Log de revisão de vulnerabilidades

reports/vulnerability-log.md, diferente do inventário, é mantido à mão, um bloco por janela semanal de revisão dos alertas do Dependabot: o que foi encontrado, como foi classificado por risco, o que foi mesclado e o que ficou para a próxima janela. O processo (fluxograma, camadas de risco, válvula de escape para critical) está documentado em docs/security.md, no repositório morpheus-beta.

About

Documentação operacional do Morpheus (mapeamento de componentes/dependências para SCA/DAST)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages