Ir para o conteúdo

Instalação

O PEART roda como três processos: a superfície interna (peart), o portal do cliente (peart-portal) e um sidecar de renderização de PDF. Esta seção os instala num host Linux, direto no sistema operacional ou por container.

A instalação direta vem primeiro, e é a escolha certa para um host endurecido ou auditado. O caminho por container vem em seguida, e é plenamente suportado.

O formato de uma instalação

  • peart serve a superfície interna que o pentester usa, detém a chave mestra de cifragem, e lê e escreve o banco e o diretório de evidências.
  • peart-portal serve a superfície que o cliente usa, roda como usuário separado, abre a conexão primária com o banco em modo somente leitura, escreve apenas a sessão e a declaração de correção do cliente por uma segunda conexão estreita, e nunca toca na chave nem nas evidências.
  • O sidecar de renderização transforma o HTML do relatório em PDF, e roda sem rede e sem acesso ao banco, à chave ou às evidências. O isolamento de rede dele é um controle de segurança, não uma conveniência.

Fazer uma vez, na ordem

A lista abaixo é por assunto, para consulta. Uma instalação endurecida, de ponta a ponta é o mesmo material como sequência, para um host com systemd e sem container: a ordem, e os lugares em que o passo certo na hora errada equivale a não dar o passo.

O caminho por esta seção

  1. Pré-requisitos e plataformas
  2. Instalação direta, colocar os binários no host.
  3. Primeira execução e configuração, o arquivo de config e os caminhos.
  4. Rodar como serviço (systemd), as units, incluindo o isolamento do sidecar.
  5. TLS e proxy reverso.
  6. Diretório de dados e backups, incluindo exportar a chave mestra.
  7. Verificar a instalação, assinaturas e o SBOM.

A instalação por container é uma alternativa aos passos 2 a 5. Não existe credencial padrão em nenhum dos caminhos: no primeiro acesso o PEART exige que você crie o administrador e inscreva o segundo fator.