mirror of
https://github.com/gutmensch/docker-dmarc-report.git
synced 2025-12-29 16:15:55 +00:00
chore(build): add github action
* update documentation * fix report parser option and defaults * fixes #28 * fixes #31
This commit is contained in:
45
.github/workflows/docker-image.yml
vendored
Normal file
45
.github/workflows/docker-image.yml
vendored
Normal file
@@ -0,0 +1,45 @@
|
||||
name: Docker Image CI
|
||||
|
||||
on:
|
||||
push:
|
||||
branches:
|
||||
- master
|
||||
tags:
|
||||
- "v*"
|
||||
pull_request:
|
||||
branches:
|
||||
- master
|
||||
|
||||
jobs:
|
||||
build-and-release:
|
||||
runs-on: ubuntu-latest
|
||||
|
||||
steps:
|
||||
- uses: actions/checkout@v3
|
||||
|
||||
- name: Docker meta
|
||||
id: meta
|
||||
uses: docker/metadata-action@v4
|
||||
with:
|
||||
images: gutmensch/dmarc-report
|
||||
flavor: latest=true
|
||||
tags: |
|
||||
type=ref,event=branch
|
||||
type=ref,event=pr
|
||||
type=semver,pattern={{version}}
|
||||
|
||||
- name: Login to DockerHub
|
||||
if: github.ref_type == 'tag'
|
||||
uses: docker/login-action@v2
|
||||
with:
|
||||
username: ${{ secrets.DOCKERHUB_USERNAME }}
|
||||
password: ${{ secrets.DOCKERHUB_TOKEN }}
|
||||
|
||||
- name: Build and push
|
||||
uses: docker/build-push-action@v3
|
||||
with:
|
||||
context: .
|
||||
file: Dockerfile
|
||||
push: ${{ github.ref_type == 'tag' }}
|
||||
tags: ${{ steps.meta.outputs.tags }}
|
||||
labels: ${{ steps.meta.outputs.labels }}
|
||||
43
README.md
43
README.md
@@ -5,37 +5,47 @@ This image is intended to combine a dmarc report parser (see https://github.com/
|
||||
It fetches dmarc report mails regularly from an IMAP server, stores them into a MySQL DB and visualizes them via Webserver/PHP module.
|
||||
|
||||
## Howto
|
||||
1. Create a _dmarc.example.com TXT DNS record for your domain, containg an IMAP postbox, e.g.
|
||||
```
|
||||
|
||||
1. Create a \_dmarc.example.com TXT DNS record for your domain, containg an IMAP postbox, e.g.
|
||||
|
||||
```bash
|
||||
17:18 $ dig TXT _dmarc.schumann.link +short
|
||||
"v=DMARC1\; p=quarantine\; fo=1\; rua=mailto:dmarc@schumann.link\; ruf=mailto:dmarc@schumann.link\; adkim=s\; aspf=s\;"
|
||||
```
|
||||
2. Create a MySQL Database and a user for this service
|
||||
3. Run this docker image with below mentioned env vars
|
||||
4. Access port 80 on the container (or 443) or put it behind a reverse proxy to view reports
|
||||
```
|
||||
|
||||
1. Create a MySQL Database and a user for this service
|
||||
|
||||
1. Run this docker image with below mentioned env vars
|
||||
|
||||
1. Access port 80 on the container (or 443) or put it behind a reverse proxy to view reports
|
||||
|
||||
```bash
|
||||
docker pull gutmensch/dmarc-report
|
||||
docker run -e ... -ti gutmensch/dmarc-report
|
||||
```
|
||||
|
||||
New dmarc reports will be fetched every 15 minutes past the hour, every hour. Therefore it can take up to one hour for the first report to be fetched.
|
||||
|
||||
## Versions for last build latest and docker image tag 1.3
|
||||
dmarcts report viewer: 2022-08-10
|
||||
## Versions for last build latest and docker image tag 1.4
|
||||
|
||||
dmarcts report parser: 2022-08-10
|
||||
dmarcts report viewer: 2023-01-07
|
||||
|
||||
dmarcts report parser: 2023-01-07
|
||||
|
||||
CAUTION: The old gutmensch/dmarc-report:latest image (older alpine, php5, etc.) is available still as gutmensch/dmarc-report:0.5. The current latest (and 1.0) uses the latest alpine version, newer MySQL client libraries, newer OpenSSL, etc. and improves compatibilitiy with MySQL 8+.
|
||||
|
||||
## Frontend Screenshot
|
||||
|
||||

|
||||
|
||||
## Sample docker compose / Environment variables
|
||||
|
||||
The variables should be self-explanatory. Make sure to create the IMAP folders before the cron job runs!
|
||||
|
||||
**docker-compose.yml**
|
||||
|
||||
```yaml
|
||||
version: '3.6'
|
||||
version: "3.6"
|
||||
|
||||
services:
|
||||
dmarc-report:
|
||||
@@ -71,17 +81,22 @@ services:
|
||||
```
|
||||
|
||||
## Optional extended configuration
|
||||
|
||||
Use SSL instead of default TLS. Set both to 0 to turn off encryption. (not recommended)
|
||||
|
||||
```yaml
|
||||
- "PARSER_IMAP_SSL=1"
|
||||
- "PARSER_IMAP_TLS=0"
|
||||
```
|
||||
|
||||
Ignore ERROR: message_string() issue experienced with Exchange Online.
|
||||
|
||||
```yaml
|
||||
- "PARSER_IMAP_IGNORE_ERROR=1"
|
||||
```
|
||||
Parser and Viewer support Postgres now too (default is mysql)
|
||||
```yaml
|
||||
- "REPORT_DB_TYPE=pgsql"
|
||||
```
|
||||
|
||||
Parser and Viewer support Postgres now too (default is mysql)
|
||||
|
||||
```yaml
|
||||
- "REPORT_DB_TYPE=Pg"
|
||||
```
|
||||
|
||||
@@ -12,8 +12,8 @@ $dbname = $ENV{'REPORT_DB_NAME'};
|
||||
$dbuser = $ENV{'REPORT_DB_USER'};
|
||||
$dbpass = $ENV{'REPORT_DB_PASS'};
|
||||
$dbhost = $ENV{'REPORT_DB_HOST'}; # Set the hostname if we can't connect to the local socket.
|
||||
$dbport = $ENV{'REPORT_DB_PORT'} || 3306;
|
||||
$dbtype = $ENV{'REPORT_DB_TYPE'} || 'mysql';
|
||||
$dbport = $ENV{'REPORT_DB_PORT'} // 3306;
|
||||
$dbtype = $ENV{'REPORT_DB_TYPE'} // 'mysql';
|
||||
|
||||
if(exists $ENV{PARSER_IMAP_SERVER_WITH_PORT} && defined $ENV{PARSER_IMAP_SERVER_WITH_PORT}) {
|
||||
my @server_attr = split ':', $ENV{PARSER_IMAP_SERVER_WITH_PORT};
|
||||
@@ -41,12 +41,12 @@ $imapmovefolder = $ENV{'PARSER_IMAP_MOVE_FOLDER'};
|
||||
$imapmovefoldererr = $ENV{'PARSER_IMAP_MOVE_FOLDER_ERR'};
|
||||
|
||||
# maximum size of XML files to store in database, long files can cause transaction aborts
|
||||
$maxsize_xml = 50000;
|
||||
$maxsize_xml = $ENV{'PARSER_XML_MAXSIZE'} // 50000;
|
||||
# store XML as base64 encopded gzip in database (save space, harder usable)
|
||||
$compress_xml = 0;
|
||||
$compress_xml = $ENV{'PARSER_XML_COMPRESS'} // 0;
|
||||
|
||||
# if there was an error during file processing (message does not contain XML or ZIP parts,
|
||||
# or a database error) the parser reports an error and does not delete the file, even if
|
||||
# delete_reports is set (or --delete is given). Deletion can be enforced by delete_failed,
|
||||
# however not for database errors.
|
||||
$delete_failed = 0;
|
||||
$delete_failed = $ENV{'PARSER_DELETE_FAILED'} // 0;
|
||||
|
||||
Reference in New Issue
Block a user