Polaco 
Inglês Kowal Security Scan é um módulo de segurança avançado para Magento 2 que ajuda a detetar mais rapidamente alterações suspeitas em ficheiros, código malicioso, URL perigosos e injeções em conteúdos da base de dados. Foi concebido para funcionar de forma leve, sem agentes adicionais e sem implementação complexa.
WhatsApp
+48608012047php, phtml, js, html, svg, htaccess e outros suportes de payloads.decode -> execute, callbacks dinâmicos, variable function calls e include/require suspeitos.data: e links perigosos.rule_id, pelo que a configuração da allowlist não depende da descrição textual completa.e-val, base-64_decode, gzin-flate e técnicas semelhantes,data:,O módulo analisa áreas-chave da loja onde os incidentes surgem com mais frequência:
core_config_data,rule_id.rule_id facilitam a manutenção de elevada eficácia sem inundação de falsos alarmes.O módulo inclui documentação de implementação e configuração, e a sua arquitetura suporta o ajuste contínuo de regras e processos de segurança na loja Magento 2.
Garanta a deteção antecipada de incidentes no Magento 2 com Kowal Security Scan.
Kowal_SecurityScanO módulo acrescenta ao Magento 2 uma camada de monitorização de segurança para ficheiros da aplicação, tabelas selecionadas da base de dados, URL suspeitos e análise opcional de incidentes através de OpenAI.
Os relatórios são guardados na tabela kowal_securityscan_report e podem ser enviados por e-mail.
php, phtml, php5, inc,
phar, js, html, htm, svg, htaccess,
token_get_all(),data: e URL suspeitos,
kowal/base disponível,Se o pacote não estiver disponível no repositório Composer predefinido, adicione a origem:
composer config repositories.securityscan vcs https://github.com/kowalco/module-securityscanSe o repositório exigir autorização:
composer config --global --auth github-oauth.github.com composer require kowal/module-securityscanphp bin/magento module:enable Kowal_SecurityScanphp bin/magento setup:upgradephp bin/magento cache:flushEm ambiente de produção, execute os passos padrão de deployment do Magento, de acordo com o seu processo de implementação.
O módulo regista o seu próprio grupo cron securityscan.
kowal_securityscan_filecheck - diariamente às 00:00,kowal_securityscan_malwarecheck - diariamente às 01:00,kowal_securityscan_dbcheck - diariamente às 02:00,kowal_securityscan_cleanup_reports - diariamente às 02:30.Sem o cron Magento em funcionamento, as verificações automáticas não serão executadas.
Para executar manualmente as verificações, utilize:
php bin/magento kowal_securityscan:filecheckphp bin/magento kowal_securityscan:malwarecheckphp bin/magento kowal_securityscan:dbcheckEste é o método recomendado para testar após a instalação e após alterações de configuração.
Caminho da configuração:
Stores -> Configuration -> kowal -> kowal_security
Ativar móduloEndereço de e-mail para relatóriosEndereço de e-mail do remetenteRetenção de relatórios em diasGoogle Safe Browsing API KeyAllowlist de domíniosAllowlist de ficheirosAllowlist de padrões da base de dadosAllowlist de regras de ficheirosAllowlist de regras da base de dadosA secção Análise OpenAI permite expandir os relatórios com avaliação de risco e recomendações de ação.
Campos disponíveis:
Ativar análise AI,OpenAI API Key,Modelo OpenAI,Contexto máximo para AI.Ativar análise AI,OpenAI API Key,gpt-4.1-mini,12000,2000 são elevados para 12000,50000.Se o OpenAI estiver desativado ou faltar a chave, o módulo continua a funcionar e aplica heurísticas locais.
Se preencher Google Safe Browsing API Key, o módulo irá:
A ausência da chave não bloqueia as verificações básicas, apenas desativa esta etapa.
filecheck funciona com base num snapshot guardado em:
var/security_scan_hashes.json
Na primeira execução:
As execuções seguintes reportam alterações do tipo ADDED, MODIFIED e REMOVED.
São ignorados, entre outros:
var/,generated/,vendor/,pub/static/,node_modules/.malwarecheck verifica os ficheiros da aplicação com base em:
rule_id,Exemplos de tipos de deteção:
file.obfuscated_eval_chain,file.command_execution_from_request,file.encoded_payload_blob,file.token.decode_execute_chain,file.token.include_from_request,file.inline_svg_or_event_handler.Nos relatórios, os motivos são apresentados no formato:
[file.encoded_payload_blob] Encoded payload blob detecteddbcheck analisa tabelas Magento selecionadas:
cms_block,cms_page,core_config_data,email_template,newsletter_template,review_detail,catalog_product_entity_text.Exemplos de regras:
db.inline_script_tag,db.html_event_handler,db.external_iframe,db.javascript_uri,db.data_uri_executable,db.embedded_svg_payload,db.javascript_dom_redirect.O conteúdo é previamente normalizado através de:
html_entity_decode,rawurldecode,As allowlists servem para limitar false positives sem desativar todo o módulo.
Campo: kowal_security/general/allowlisted_domains
Formato:
cdn.example.comstatic.example.orgEfeito:
Campo: kowal_security/general/allowlisted_file_patterns
Formato:
app/code/Vendor/Module/Test/*pub/media/custom.jsEfeito: os ficheiros correspondentes ao padrão são totalmente ignorados pela verificação de malware. Esta definição tem um alcance alargado.
Campo: kowal_security/general/allowlisted_db_patterns
Formato:
trusted-inline-widgetdata:image/svg+xmlEfeito: um registo da base de dados que contenha esse fragmento é ignorado pela verificação DB. Esta definição
também tem um alcance alargado.
4. Allowlist de regras de ficheiros
Campo: kowal_security/general/allowlisted_file_rules
Formato preferido:
caminho_ou_glob | rule_id
Exemplo:
app/code/Vendor/Module/* | file.encoded_payload_blobpub/media/custom.js | file.javascript_redirect_or_rewrite
Compatibilidade retroativa:
- as entradas antigas pela etiqueta completa da regra continuam a funcionar,
- as novas entradas devem utilizar
rule_id.
Efeito: apenas a regra indicada é silenciada para o caminho indicado, e o restante scan desse ficheiro continua a
funcionar.
5. Allowlist de regras da base de dados
Campo: kowal_security/general/allowlisted_db_rules
Formato preferido:
tabela_ou_* | rule_id
Exemplo:
cms_block | db.inline_script_tag* | db.fetch_or_xhr_loader
Efeito: apenas a regra indicada é silenciada, e as restantes continuam ativas para esse registo ou tabela.
Relatórios
Os relatórios podem conter:
- lista de deteções,
- avaliação de risco,
- indicadores e recomendações,
- candidatos a allowlist após verificação manual,
- configuração allowlist normalizada em JSON.
Sugestões de allowlist nos relatórios
A secção do relatório pode conter entradas do tipo:
- cms_block | db.inline_script_tag | certeza=MEDIUM | alcance=LOW- app/code/Vendor/Module/* | file.encoded_payload_blob | certeza=MEDIUM | alcance=LOW- data:image/svg+xml,
Interpretação:
alcance=LOW - candidato mais seguro,alcance=HIGH - silenciamento alargado, apenas após verificação rigorosa,certeza=MEDIUM/HIGH - candidato à configuração mais previsível,certeza=LOW - exige cautela.
Exportação JSON
O relatório inclui também a secção Configuração allowlist normalizada (JSON). Trata-se de um
conjunto de valores pronto e sem duplicados para copiar para a configuração.
Forma de utilização recomendada
- execute manualmente as três verificações após a instalação,
- trate o primeiro
filecheck como a criação do snapshot,
- analise os relatórios e confirme quais as deteções reais,
- para false positives, utilize primeiro
allowlisted_file_rules e
allowlisted_db_rules,
- só quando necessário utilize
allowlisted_domains, allowlisted_file_patterns e
allowlisted_db_patterns,
- após alterar a configuração, execute novamente a verificação CLI adequada e confirme o resultado.
Notas operacionais
filecheck na primeira execução ainda não reporta alterações como incidente,- o módulo funciona sem OpenAI e sem Safe Browsing, mas com menor profundidade de análise,
allowlisted_file_patterns e allowlisted_db_patterns têm impacto alargado e
devem ser usados com moderação,
- o formato preferido para allowlists de regras é
rule_id, não a etiqueta textual completa.
Expandimos o módulo Kowal_SecurityScan com novas funcionalidades relacionadas com a análise de ameaças e a administração de relatórios.
