{ "meta": { "title": "Lynis | Documentação do ProxMenux", "description": "Instale a versão mais recente do Lynis do repositório oficial CISOfy no GitHub, execute uma auditoria com pontuação de reforço de 0 a 100 e atualize através de git pull. Auditor apenas de leitura: não altera o sistema.", "ogTitle": "Lynis | Documentação do ProxMenux", "ogDescription": "Instale e execute Lynis no Proxmox VE. Instalação do repositório original GitHub, auditoria e atualização." }, "header": { "title": "Lynis", "description": "Clona a versão mais recente do Lynis do repositório oficial CISOfy no GitHub, disponibiliza-a como /usr/local/bin/lynis e oferece auditoria, atualização, reinstalação e desinstalação no menu. O auditor apenas lê e apresenta resultados sem alterar o sistema.", "section": "Segurança" }, "intro": { "title": "O que isto faz", "body": "Instala Lynis, o auditor de segurança de código aberto da CISOfy, do repositório GitHub em /opt/lynis e cria um lançador em /usr/local/bin/lynis para o disponibilizar no PATH. Se detetar uma instalação existente, apresenta um menu de auditoria, atualização, reinstalação ou remoção." }, "manageMenu": { "heading": "Menu de gestão (após a instalação)", "intro": "Uma vez instalado o Lynis, cada invocação subsequente abre o menu de gerenciamento em vez de repetir o instalador. A partir daqui você inicia uma auditoria, atualização via git pull, reinstalar ou desinstalar:", "imageAlt": "Menu de gerenciamento do Lynis com as opções de auditoria, atualização, reinstalação e remoção" }, "whyUpstream": { "heading": "Porquê o repositório oficial GitHub em vez de apt", "intro": "O Debian distribui Lynis através de apt, mas o pacote costuma estar várias versões principais atrás do projeto original. Novos controlos, correções de novos vetores de ataque e recomendações melhoradas chegam primeiro ao GitHub. Lynis é um script shell autónomo, sem compilação nem dependências de instalação além de git; clonar o repositório é o método recomendado pela CISOfy.", "headerSource": "Origem", "headerPath": "Install path", "headerUpdate": "Método de atualização", "headerFresh": "Atualidade da versão", "rows": [ { "sourceRich": "ProxMenux (este programa)", "path": "/opt/lynis/", "update": "git pull (no menu)", "fresh": "Versão mais recente do projeto original" }, { "sourceRich": "Debian apt", "path": "/usr/bin/lynis", "update": "apt upgrade", "fresh": "Muitas vezes meses / anos atrás" } ] }, "install": { "heading": "Como funciona a instalação", "node1Label": "github.com/CISOfy/lynis", "node1Detail": "git clone\n(instale git primeiro, se faltar)", "node2Label": "/opt/lynis/", "node2Detail": "repositório completo\nincluindo o script ./lynis", "node3Label": "/usr/local/bin/lynis", "node3Detail": "lançador:\ncd /opt/lynis && ./lynis $@", "outro": "O lançador é necessário: Lynis precisa de ser executado no próprio diretório porque utiliza caminhos relativos para plugins e perfis. O lançador esconde esse detalhe e permite que lynis audit system funcione a partir de qualquer diretório." }, "detection": { "heading": "Caminhos de detecção", "intro": "Antes de mostrar o menu, o script verifica três locais para decidir se Lynis já está presente:", "items": [ "/usr/local/bin/lynis — invólucro instalado por ProxMenux", "/opt/lynis/lynis — caminho direto (caso o invólucro tenha sido removido)", "/usr/bin/lynis — versão apt-instalada, se o usuário a instalou dessa forma anteriormente" ], "outro": "Se encontrar um destes caminhos, abre o menu de gestão. O script não desinstala Lynis instalado por apt; remove apenas o que gere em /opt/lynis e o respetivo lançador." }, "audit": { "heading": "Executar uma auditoria", "intro": "No menu de gestão escolha Executar auditoria de segurança agora. Equivale a executar:", "code": "lynis audit system --no-colors", "outro": "A auditoria demora de 30 segundos a alguns minutos conforme a dimensão do anfitrião. A saída aparece diretamente no terminal, sem animação de espera. Lynis organiza os controlos por categoria e marca cada teste como [ OK ], [ WARNING ] ou [ SUGGESTION ]. O resumo final apresenta os números principais:", "summary": "================================================================================\n\n Lynis security scan details:\n\n Hardening index : 76 [############ ]\n Tests performed : 247\n Plugins enabled : 0\n\n Components:\n - Firewall [V]\n - Malware scanner [X]\n\n Lynis modules:\n - Compliance status [?]\n - Security audit [V]\n - Vulnerability scan [V]\n\n================================================================================" }, "report": { "heading": "Ler o relatório", "intro": "As duas seções importantes são Avisos (coisas que você deve corrigir em breve) e Sugestão (recomendações para melhorar o endurecimento). Cada item carrega um ID de controle como SSH-7408 — útil ao pesquisar os documentos Lynis para a lógica e a correção.", "headerMarker": "Marcador", "headerMeaning": "Significado", "headerAction": "Ação", "rows": [ { "markerRich": "OK", "meaning": "Passado o teste", "action": "Nada." }, { "markerRich": "WARNING", "meaning": "Problema real, correção recomendada", "action": "Leia a descrição do controle, planeje uma correção" }, { "markerRich": "SUGGESTION", "meaning": "Melhoria do endurecimento disponível", "action": "Aplicar se se encaixa no seu modelo de ameaça" } ], "outro": "Relatório completo e dados legíveis por máquina são escritos para /var/log/lynis.log e /var/log/lynis-report.dat pelo próprio Lynis." }, "pairFail2ban": { "title": "Combinar com Fail2Ban", "body": "SSH-7408 (MaxAuthTries) é uma das advertências mais comuns. Instalar o Fail2Ban da ProxMenux o limpa automaticamente porque o instalador configura o MaxAuthTries=3 como parte da sua etapa de endurecimento do SSH. Corra Lynis novamente depois para confirmar que o aviso se foi." }, "update": { "heading": "Actualizar o Lynis", "body": "No menu, Atualizar Lynis para a versão mais recente executa git pull --quiet em /opt/lynis. Se o diretório existir mas não for uma cópia de trabalho Git, por exemplo após copiar ficheiros manualmente, o script reinstala por completo." }, "reinstall": { "heading": "Reinstalar / desinstalar", "headerAction": "Ação", "headerWhat": "O que ele faz", "rows": [ { "actionRich": "Reinstalar", "whatRich": "Remove /opt/lynis, clona novamente do GitHub e recria o lançador. Utilize se a cópia local estiver danificada." }, { "actionRich": "Remover", "whatRich": "Exclui /opt/lynis e /usr/local/bin/lynis. Os logs em /var/log/lynis* são mantidos (são histórico de auditoria). Um Lynis apt-instalado em /usr/bin/lynis é deixado intocado." } ] }, "cli": { "heading": "Opções CLI úteis", "intro": "Uma vez instalado, Lynis pode ser invocado diretamente de uma shell com opções extras não expostas pelo menu:", "code": "lynis show version # version + build date\nlynis show commands # list every available command\nlynis show details TEST-ID # explain a specific control\nlynis audit system --quick # skip slow tests (e.g. malware scan)\nlynis audit system --pentest # treat host as untrusted (more aggressive)\nlynis update info # check if a newer Lynis is available\n\n# Filter the report log for just the warnings\ngrep \"Warning\" /var/log/lynis.log\n\n# Same, for suggestions only\ngrep \"Suggestion\" /var/log/lynis.log" }, "troubleshoot": { "heading": "Resolução de Problemas", "cloneTitle": "git clone falha durante a instalação", "cloneBody": "O host precisa de acesso à rede e DNS para alcançar github.com. A partir de um console: curl -sI https://github.com e git ls-remote https://github.com/CISOfy/lynis.git irá revelar o erro real (DNS, TLS, proxy, URL repo). Se for necessário um proxy, defina https_proxy no ambiente antes de executar novamente o menu.", "notFoundTitle": "lynis: comando não encontrado após a instalação", "notFoundIntro": "O lançador /usr/local/bin/lynis não foi criado ou foi removido. A solução mais rápida é reinstalar a partir do menu. Correção manual:", "notFoundCode": "cat > /usr/local/bin/lynis <<'EOF'\n#!/bin/bash\ncd /opt/lynis && ./lynis \"$@\"\nEOF\nchmod +x /usr/local/bin/lynis", "sshTitle": "A auditoria mostra \"Warning: Test SSH-7408 — MaxAuthTries set incorrectly\"", "sshIntro": "O servidor SSH permite demasiadas tentativas de autenticação por ligação. Instale o Fail2Ban do ProxMenux (que define o MaxAuthTries=3 automaticamente) ou edite o /etc/ssh/sshd_config à mão:", "sshCode": "sed -i 's/^#?MaxAuthTries.*/MaxAuthTries 3/' /etc/ssh/sshd_config\nsystemctl reload sshd", "scoreTitle": "A pontuação caiu após uma atualização do Proxmox", "scoreBody": "Executar lynis update info primeiro — uma atualização Lynis pode ter adicionado novos controles que sinalizam a configuração existente. Atualizar Lynis do menu, reauditar e abordar as novas descobertas." }, "files": { "heading": "Ficheiros gravados", "code": "/opt/lynis/ # full Lynis git checkout\n/usr/local/bin/lynis # wrapper script (cd + exec)\n/var/log/lynis.log # human-readable audit log (Lynis itself)\n/var/log/lynis-report.dat # machine-readable report (Lynis itself)" }, "sample": { "heading": "Relatório de exemplo", "intro": "O ProxMenux Monitor gera um PDF de várias páginas para cada execução do Lynis no separador Segurança. A primeira página resume a pontuação de reforço, informações do sistema e estado da segurança. As seguintes explicam cada aviso, ordenam sugestões por impacto e incluem o inventário de pacotes utilizado na auditoria.", "imageAlt": "Primeira página do Lynis Security Audit Report PDF — resumo executivo com índice de endurecimento 71/100, bloco de informações do sistema e visão geral da postura de segurança com firewall, scanner de malware e contagem de pacotes instalados", "captionPrefix": "Primeira página de um relatório de amostra. O PDF completo (", "captionLink": "amostra", "captionSuffix": ") continua com advertências detalhadas, sugestões e a lista de pacotes instalados.", "cli": "No lado CLI os mesmos dados estão em /var/log/lynis-report.dat (arquivo plano legível por máquina) e /var/log/lynis.log (o log de execução legível por humanos). O PDF é gerado sob demanda pelo ProxMenux Monitor — executar o lynis a partir da linha de comando não produz um." }, "related": { "heading": "Relacionado", "items": [ { "href": "/docs/monitor/dashboard/security", "label": "ProxMenux Monitor → Guia de segurança", "tail": " — executar a auditoria, procurar relatórios históricos e baixar o PDF diretamente do painel." }, { "href": "/docs/security/fail2ban", "label": "Fail2Ban", "tailRich": " — implementa a proteção SSH à força bruta que Lynis recomenda." }, { "href": "/docs/security", "label": "Visão geral da segurança", "tail": " — voltar ao panorama da secção." } ] } }