Parse Dmarc

🚀 Parse DMARC

ドメインを使ってメールを送信している相手を監視します。なりすましを検出し、フィッシングを阻止します。

🚀 クイックスタート

ステップ1: DMARCレポートを受信するためのDNSを設定する

これは最も重要なステップです！ これを行わないと、分析するレポートを受信できません。

ドメインのDNSにDMARC TXTレコードを追加します。

Name: _dmarc.yourdomain.com
Type: TXT
Value: v=DMARC1; p=none; rua=mailto:dmarc@yourdomain.com

これの意味:

• p=none - 監視のみ（まだメールをブロックしない）
• rua=mailto:dmarc@yourdomain.com - 集計レポートをこのメールアドレスに送信する

重要: dmarc@yourdomain.com を、自分が管理する実際のメールボックスに置き換えてください。ここに、Gmail、Outlook、YahooなどからDMARCレポートが送信されます。

DNSの例:

• Cloudflare: DNS > レコードの追加 > タイプ: TXT, 名前: _dmarc, 内容: v=DMARC1; p=none; rua=mailto:dmarc@yourdomain.com
• Google Domains: DNS > カスタムレコード > TXT, 名前: _dmarc, データ: v=DMARC1; p=none; rua=mailto:dmarc@yourdomain.com
• AWS Route53: レコードの作成 > タイプ: TXT, 名前: _dmarc.yourdomain.com, 値: "v=DMARC1; p=none; rua=mailto:dmarc@yourdomain.com"

レポートは通常、24～48時間以内に届き始めます。

ステップ2: DockerでParse DMARCを実行する

コンテナを実行します:

docker run -d \
  --name parse-dmarc \
  -p 8080:8080 \
  -e IMAP_HOST=imap.gmail.com \
  -e IMAP_PORT=993 \
  -e IMAP_USERNAME=your-email@gmail.com \
  -e IMAP_PASSWORD=your-app-password \
  -v parse-dmarc:/data \
  meysam81/parse-dmarc

Gmailユーザーの場合: 通常のGmailパスワードではなく、アプリパスワードが必要です。

ダッシュボードにアクセスします: ブラウザで http://localhost:8080 を開きます。

✨ 主な機能

• 📧 任意のIMAPメールボックス（Gmail、Outlookなど）からレポートを自動取得
• 📊 リアルタイム統計を表示する美しいダッシュボード
• 🔍 ドメインとしてメールを送信している相手を正確に把握
• 🔧 簡単なDMARC設定のための組み込みDNSレコードジェネレーター
• 📦 単一のバイナリ - データベースのインストールや複雑な設定が不要
• 🚀 わずか14MBのDockerイメージ
• 🔒 安全なTLSサポート
• 🌙 ダークモードサポート

📦 インストール

Homebrew (macOS/Linux)

brew tap meysam81/tap
brew install parse-dmarc

Docker

docker pull meysam81/parse-dmarc

バイナリダウンロード

リリースページから事前にビルドされたバイナリをダウンロードします。

💻 使用例

基本的な使用法

DMARCレポートを受信するためのDNS設定:

Name: _dmarc.yourdomain.com
Type: TXT
Value: v=DMARC1; p=none; rua=mailto:dmarc@yourdomain.com

DockerでParse DMARCを実行する:

docker run -d \
  --name parse-dmarc \
  -p 8080:8080 \
  -e IMAP_HOST=imap.gmail.com \
  -e IMAP_PORT=993 \
  -e IMAP_USERNAME=your-email@gmail.com \
  -e IMAP_PASSWORD=your-app-password \
  -v parse-dmarc:/data \
  meysam81/parse-dmarc

高度な使用法

コマンドラインオプション

# 一度だけ取得して終了（cronジョブに便利）
docker exec parse-dmarc ./parse-dmarc -fetch-once

# ダッシュボードのみを提供（取得しない）
docker exec parse-dmarc ./parse-dmarc -serve-only

# カスタム取得間隔（秒、デフォルトは300）
docker exec parse-dmarc ./parse-dmarc -fetch-interval=600

📚 詳細ドキュメント

デプロイ方法

プラットフォーム即サービス (PaaS)

プロバイダー	デプロイ	注意事項
Railway		初心者におすすめ
Render		無料プランあり
Koyeb		グローバルエッジデプロイメント。 /data をボリュームとして手動でマウントします。
Zeabur		アジア太平洋地域最適化
Northflank		開発者向け

セルフホスト

プロバイダー	デプロイ	注意事項
CapRover		セルフホスト型PaaS
Coolify		オープンソースのHeroku代替品
Dokploy		セルフホスト型デプロイメントプラットフォーム
Docker		どこでも実行可能

インフラストラクチャ

⚠️ 重要提示

すべてのデプロイにはIMAP資格情報が必要です。Gmail、Outlook、またはその他のメールプロバイダーの設定の詳細については、構成オプションを参照してください。

構成オプション

一般的なプロバイダーのIMAP設定

Gmail:

{
  "host": "imap.gmail.com",
  "port": 993,
  "username": "your-email@gmail.com",
  "password": "your-app-password",
  "use_tls": true
}

アプリパスワードが必要です。

Outlook/Office 365:

{
  "host": "outlook.office365.com",
  "port": 993,
  "username": "your-email@outlook.com",
  "password": "your-password",
  "use_tls": true
}

汎用IMAP: ほとんどのプロバイダーはTLSでポート 993 を使用します。プロバイダーのドキュメントを確認してください。

APIエンドポイント

• GET /api/statistics - ダッシュボードの統計情報
• GET /api/reports - レポートのリスト（ページネーションあり）
• GET /api/reports/:id - 詳細なレポートビュー
• GET /api/top-sources - 上位の送信元IPアドレス
• GET /metrics - Prometheusメトリクスエンドポイント

🔧 技術詳細

PrometheusメトリクスとGrafanaの統合

Parse DMARCには、監視とアラート用の本番環境対応のPrometheusメトリクスが含まれています。メトリクスはデフォルトで有効になっており、/metrics で公開されます。

利用可能なメトリクス

ビルド情報

レポート処理

IMAP接続

DMARC統計

ドメイン/組織別メトリクス

認証結果

HTTPサーバー

Goランタイム（組み込み）

標準のGoランタイムメトリクスも公開されています。

• go_goroutines - ゴルーチンの数
• go_memstats_* - メモリ統計
• go_gc_* - ガベージコレクションメトリクス
• process_* - プロセスメトリクス（CPU、メモリ、ファイルディスクリプタ）

メトリクスの無効化

メトリクスエンドポイントを無効にするには:

# コマンドライン
./parse-dmarc --metrics=false

# 環境変数
export PARSE_DMARC_METRICS=false

# Docker
docker run -e PARSE_DMARC_METRICS=false meysam81/parse-dmarc

Prometheusの設定

prometheus.yml にParse DMARCを追加します。

scrape_configs:
  - job_name: "parse-dmarc"
    static_configs:
      - targets: ["parse-dmarc:8080"]
    scrape_interval: 30s
    metrics_path: /metrics

KubernetesでServiceMonitor（Prometheus Operator）を使用する場合:

apiVersion: monitoring.coreos.com/v1
kind: ServiceMonitor
metadata:
  name: parse-dmarc
  labels:
    app: parse-dmarc
spec:
  selector:
    matchLabels:
      app: parse-dmarc
  endpoints:
    - port: http
      path: /metrics
      interval: 30s

Grafanaダッシュボード

本番環境対応のGrafanaダッシュボードが grafana/dashboard.json に含まれています。

手動でインポートする

1. Grafanaで、Dashboards > Import に移動します。
2. grafana/dashboard.json をアップロードするか、その内容を貼り付けます。
3. Prometheusデータソースを選択します。
4. Importをクリックします。

自動的にプロビジョニングする（本番環境でおすすめ）

# ダッシュボードをGrafanaのダッシュボードディレクトリにコピー
cp grafana/dashboard.json /var/lib/grafana/dashboards/parse-dmarc/

# プロビジョニング設定をコピー
cp grafana/provisioning.yaml /etc/grafana/provisioning/dashboards/parse-dmarc.yaml

# Grafanaを再起動するか、変更を検出するのを待ちます
systemctl restart grafana-server

ダッシュボードの変数

ダッシュボードのセクション

例のGrafanaパネル

準拠率ゲージ:

parse_dmarc_dmarc_compliance_rate

時間経過に伴うメッセージ数:

rate(parse_dmarc_dmarc_messages_total[5m])

ドメインごとの準拠率:

parse_dmarc_dmarc_compliance_rate_by_domain

SPF/DKIM合格率:

# SPF合格率
parse_dmarc_dmarc_spf_results{result="pass"} / ignoring(result) sum(parse_dmarc_dmarc_spf_results) * 100

# DKIM合格率
parse_dmarc_dmarc_dkim_results{result="pass"} / ignoring(result) sum(parse_dmarc_dmarc_dkim_results) * 100

取得成功率:

1 - (rate(parse_dmarc_reports_fetch_errors_total[1h]) / rate(parse_dmarc_reports_fetch_cycles_total[1h]))

IMAP接続の健全性:

rate(parse_dmarc_imap_connections_total{status="success"}[5m]) /
(rate(parse_dmarc_imap_connections_total{status="success"}[5m]) + rate(parse_dmarc_imap_connections_total{status="error"}[5m]))

HTTPリクエストのレイテンシー (p95):

histogram_quantile(0.95, rate(parse_dmarc_http_request_duration_seconds_bucket[5m]))

組織ごとのレポート数:

topk(10, parse_dmarc_dmarc_reports_by_org)

アラートルール

例のPrometheusアラートルール:

groups:
  - name: parse-dmarc
    rules:
      - alert: DMARCComplianceLow
        expr: parse_dmarc_dmarc_compliance_rate < 90
        for: 1h
        labels:
          severity: warning
        annotations:
          summary: "DMARC準拠率が90%を下回っています"
          description: "現在の準拠率: {{ $value }}%"

      - alert: DMARCFetchFailures
        expr: rate(parse_dmarc_reports_fetch_errors_total[15m]) > 0
        for: 30m
        labels:
          severity: critical
        annotations:
          summary: "Parse DMARCの取得失敗が検出されました"
          description: "IMAPの取得操作が失敗しています"

      - alert: IMAPConnectionErrors
        expr: rate(parse_dmarc_imap_connections_total{status="error"}[5m]) > 0
        for: 10m
        labels:
          severity: warning
        annotations:
          summary: "IMAP接続エラーが検出されました"
          description: "IMAPの資格情報とサーバーの接続性を確認してください"

      - alert: NoRecentFetch
        expr: time() - parse_dmarc_reports_last_fetch_timestamp_seconds > 600
        for: 5m
        labels:
          severity: warning
        annotations:
          summary: "最近のDMARCレポートの取得がありません"
          description: "最後の取得は {{ humanizeDuration $value }} 前でした"

Docker ComposeでPrometheusとGrafanaを使用する

完全な監視スタック:

version: "3.8"

services:
  parse-dmarc:
    image: meysam81/parse-dmarc
    ports:
      - "8080:8080"
    volumes:
      - ./config.json:/app/config.json
      - ./data:/data

  prometheus:
    image: prom/prometheus
    ports:
      - "9090:9090"
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml
    command:
      - "--config.file=/etc/prometheus/prometheus.yml"

  grafana:
    image: grafana/grafana
    ports:
      - "3000:3000"
    environment:
      - GF_SECURITY_ADMIN_PASSWORD=admin
    volumes:
      - grafana-data:/var/lib/grafana

volumes:
  grafana-data:

prometheus.yml:

global:
  scrape_interval: 15s

scrape_configs:
  - job_name: "parse-dmarc"
    static_configs:
      - targets: ["parse-dmarc:8080"]

アクセス方法:

• Parse DMARCダッシュボード: http://localhost:8080
• Prometheus: http://localhost:9090
• Grafana: http://localhost:3000 (admin/admin)

なぜParse DMARC vs ParseDMARC?

このプロジェクトは ParseDMARC に触発されていますが、シンプルさを重視して構築されています。

• 単一の14MBバイナリ vs Python + Elasticsearch + Kibanaスタック
• 組み込みダッシュボード vs 外部の可視化ツール
• SQLite vs Elasticsearch（JVM不要）
• 依存関係なし vs 複雑な設定

📄 ライセンス

Apache-2.0 - 詳細は LICENSE を参照してください。

このプロジェクトが役に立ったら、スターをつけてください！ ⭐