DMARC报告查看器 - 开源项目使用指南

DMARC报告查看器 - 开源项目使用指南

dmarcts-report-viewerDMARC Report Tool for use with rddmarc or dmarcts-report-parser (formerly imap-dmarcts)项目地址:https://gitcode.com/gh_mirrors/dm/dmarcts-report-viewer

1. 项目目录结构及介绍

此开源项目名为 dmarcts-report-viewer，位于 GitHub，用于通过John Levine的rddmarc脚本或dmarcts-report-parser工具解析后的DMARC记录展示。下面简要介绍其主要目录结构：

• 根目录 包含了项目的核心代码和配置文件。
  • dmarcts-report-viewer.php: 主入口文件，用于启动应用并显示报告列表。
  • dmarcts-report-viewer-config.php: 配置文件，存放数据库连接详情及其他应用配置。
  • dmarcts-report-viewer.js: 前端JavaScript配置文件，定义界面行为如报告列表的高度等。
  • default.css, dusk2dawn.css: 样式表，用于前端样式控制。
  • 其他如.gitignore, LICENSE, README.md等标准Git仓库文件。
  • 子目录 如sample可能包含配置文件的示例副本。

2. 项目的启动文件介绍

• dmarcts-report-viewer.php 这是应用程序的主要执行文件，用户通过访问这个PHP脚本来启动DMARC报告查看器。它负责加载数据、渲染UI，并提供与数据库中存储的DMARC报告交互的能力。当你在浏览器中直接访问这个文件时，系统将呈现一个报告列表视图，允许用户查看和分析已解析的DMARC报告。

3. 项目的配置文件介绍

配置文件：dmarcts-report-viewer-config.php

该文件是用来定制项目运行环境的基础设置，涉及数据库连接和其他重要参数。需要编辑的关键配置项包括：

• $dbtype 数据库类型，默认为MySQL，支持mysql或pgsql（PostgreSQL）。
• $dbhost, $dbname, $dbuser, $dbpass, $dbport: 分别代表数据库主机名、数据库名称、用户名、密码以及可选的数据库端口号。
• $cssfile: 指定前端使用的CSS样式表，默认为default.css。
• $default_hostlookup: 控制是否进行域名解析，1表示开启，关闭可以加速处理过程，尤其是在大量不再存在的邮件服务器上。
• $default_sort: 报告列表的默认排序方式，1为升序(ASC)，0为降序 DESC。

JavaScript配置：dmarcts-report-viewer.js

此外，前端体验可通过修改此JavaScript文件中的配置来调整，例如：

• default_reportlist_height: 报告列表的高度，作为浏览器窗口高度的百分比，不带百分号标记。

确保在部署前根据实际需求修改这些配置选项，以确保项目能够正确连接到数据库并符合你的使用场景。完成配置后，通过Web服务器访问dmarcts-report-viewer.php即可开始利用此工具分析DMARC报告。

dmarcts-report-viewerDMARC Report Tool for use with rddmarc or dmarcts-report-parser (formerly imap-dmarcts)项目地址:https://gitcode.com/gh_mirrors/dm/dmarcts-report-viewer