DMARC4all/ai_usage.html at main · ToppyMicroServices/DMARC4all · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
<!doctype html>
<!--
  Copyright 2026 ToppyMicroServices OÜ

  Licensed under the Apache License, Version 2.0 (the "License");
  you may not use this file except in compliance with the License.
  You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.
-->
<html lang="en" data-i18n-page="ai" data-default-lang="en">
<head>
  <meta charset="utf-8">
  <meta http-equiv="Content-Security-Policy" content="default-src 'self'; base-uri 'none'; object-src 'none'; frame-ancestors 'none'; form-action 'self'; script-src 'self'; script-src-attr 'none'; style-src 'self' 'unsafe-inline'; font-src 'self'; img-src 'self' https: data:; connect-src 'self' https:;">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <meta name="theme-color" content="#0d1b2a">
  <title>AI & Machine Access | DMARC4all</title>
  <meta name="description" content="Machine-readable access to DMARC4all: llms.txt, a versioned diagnosis JSON format, JSON Schema, safety boundaries, and citation guidance.">
  <meta name="robots" content="index,follow,max-image-preview:large">
  <link rel="canonical" href="https://dmarc4all.toppymicros.com/ai_usage.html">
  <link rel="alternate" type="text/plain" href="https://dmarc4all.toppymicros.com/llms.txt" title="DMARC4all LLM index">
  <meta property="og:type" content="article">
  <meta property="og:site_name" content="DMARC4all">
  <meta property="og:title" content="AI & Machine Access | DMARC4all">
  <meta property="og:description" content="Versioned, machine-readable DMARC4all reports with explicit safety and interpretation boundaries.">
  <meta property="og:url" content="https://dmarc4all.toppymicros.com/ai_usage.html">
  <meta property="og:image" content="https://dmarc4all.toppymicros.com/apple-touch-icon.png">
  <meta name="twitter:card" content="summary">
  <meta name="twitter:title" content="AI & Machine Access | DMARC4all">
  <meta name="twitter:description" content="Versioned, machine-readable DMARC4all reports with explicit safety and interpretation boundaries.">
  <meta name="twitter:image" content="https://dmarc4all.toppymicros.com/apple-touch-icon.png">
  <link rel="icon" type="image/png" sizes="180x180" href="apple-touch-icon.png">
  <link rel="icon" href="favicon.ico">
  <link rel="apple-touch-icon" sizes="180x180" href="apple-touch-icon.png">
  <link rel="manifest" href="manifest.webmanifest?v=2">
  <link rel="stylesheet" href="assets/fonts/fonts.css">
  <link rel="stylesheet" href="styles.css?v=13">
  <script defer src="vendor/dompurify.min.js"></script>
  <script defer src="i18n/document_pages.js?v=5"></script>
  <script defer src="document_i18n.js?v=4"></script>
  <script id="seo-schema" type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "TechArticle",
      "headline": "AI & Machine Access for DMARC4all",
      "url": "https://dmarc4all.toppymicros.com/ai_usage.html",
      "description": "Machine-readable access, report schema, and safe-use guidance for DMARC4all.",
      "author": {
        "@type": "Organization",
        "name": "ToppyMicroServices"
      }
    }
  </script>
</head>
<body>
  <div class="shell">
    <div class="brandbar" aria-label="ToppyMicroServices">
      <a href="index.html" style="display:flex; align-items:center; gap:10px; color:inherit; text-decoration:none;">
        <img src="apple-touch-icon.png" alt="ToppyMicroServices">
        <span class="brand-name">ToppyMicroServices</span>
      </a>
      <div class="brand-actions">
        <nav class="lang-switch" aria-label="Language">
          <button type="button" class="lang-btn" data-lang-choice="ja" title="日本語" aria-label="日本語">JA</button>
          <button type="button" class="lang-btn" data-lang-choice="en" title="English" aria-label="English">EN</button>
          <button type="button" class="lang-btn" data-lang-choice="es" title="Español" aria-label="Español">ES</button>
          <button type="button" class="lang-btn" data-lang-choice="de" title="Deutsch" aria-label="Deutsch">DE</button>
          <button type="button" class="lang-btn" data-lang-choice="ko" title="한국어" aria-label="한국어">KO</button>
          <button type="button" class="lang-btn" data-lang-choice="vi" title="Tiếng Việt" aria-label="Tiếng Việt">VI</button>
          <button type="button" class="lang-btn" data-lang-choice="th" title="ไทย" aria-label="ไทย">TH</button>
          <button type="button" class="lang-btn" data-lang-choice="km" title="ភាសាខ្មែរ" aria-label="ភាសាខ្មែរ">KM</button>
          <button type="button" class="lang-btn" data-lang-choice="my" title="မြန်မာ" aria-label="မြန်မာ">MY</button>
          <button type="button" class="lang-btn" data-lang-choice="id" title="Bahasa Indonesia" aria-label="Bahasa Indonesia">ID</button>
          <button type="button" class="lang-btn" data-lang-choice="et" title="Eesti" aria-label="Eesti">ET</button>
          <button type="button" class="lang-btn" data-lang-choice="zh" title="中文" aria-label="中文">ZH</button>
          <button type="button" class="lang-btn" data-lang-choice="ru" title="Русский" aria-label="Русский">RU</button>
          <button type="button" class="lang-btn" data-lang-choice="bn" title="বাংলা" aria-label="বাংলা">BN</button>
        </nav>
        <a class="brand-github" href="https://github.com/ToppyMicroServices/DMARC4all" target="_blank" rel="noopener">GitHub</a>
      </div>
    </div>

    <main class="hero document-page">
      <p class="pill" data-doc-i18n="pill">AI & Machine Access</p>
      <h1 data-doc-i18n="title">Stable evidence for humans and AI agents</h1>
      <p class="tagline" data-doc-i18n="tagline">DMARC4all publishes a curated LLM index and a versioned JSON report contract so tools can interpret a diagnosis without scraping presentation HTML.</p>

      <section class="guide-grid mt-12">
        <article class="card p-16 guide-card">
          <div class="action-kicker" data-doc-i18n="discover.kicker">Discover</div>
          <h2 data-doc-i18n="discover.title">LLM-readable context</h2>
          <p data-doc-i18n-html="discover.body"><a href="llms.txt"><span class="mono mono-inline">/llms.txt</span></a> is the concise map. <a href="llms-full.txt"><span class="mono mono-inline">/llms-full.txt</span></a> adds field semantics, readiness states, limitations, and safe agent behavior.</p>
        </article>
        <article class="card p-16 guide-card">
          <div class="action-kicker" data-doc-i18n="interpret.kicker">Interpret</div>
          <h2 data-doc-i18n="interpret.title">Versioned JSON contract</h2>
          <p data-doc-i18n-html="interpret.body">The diagnosis page exports <span class="mono mono-inline">dmarc4all-diagnosis</span> JSON. Version <span class="mono mono-inline">1.3.0</span> excludes rendering HTML and separates summary, observations, remediation, evidence, limitations, and errors.</p>
        </article>
        <article class="card p-16 guide-card">
          <div class="action-kicker" data-doc-i18n="validate.kicker">Validate</div>
          <h2 data-doc-i18n="validate.title">Schema and example</h2>
          <p data-doc-i18n-html="validate.body">Use the <a href="schemas/diagnosis-result-1.3.0.schema.json">versioned JSON Schema 2020-12 document</a> to validate current exports and the <a href="examples/diagnosis-result.example.json">example report</a> to test consumers.</p>
        </article>
        <article class="card p-16 guide-card">
          <div class="action-kicker" data-doc-i18n="boundary.kicker">Current boundary</div>
          <h2 data-doc-i18n="boundary.title">Browser export, not a public API</h2>
          <p data-doc-i18n="boundary.body">Diagnostics currently run in the browser. DMARC4all does not yet expose a public server API or MCP endpoint. Agents can read the documentation and consume a JSON report exported by the operator.</p>
        </article>
      </section>

      <section class="card p-16 mt-12">
        <h2 data-doc-i18n="safe.title">Safe automation contract</h2>
        <ol class="list">
          <li data-doc-i18n="safe.li1">Confirm that the operator manages the domain or has explicit permission to test it.</li>
          <li data-doc-i18n-html="safe.li2">Read <span class="mono mono-inline">scope.externalReferenceChecks</span>, <span class="mono mono-inline">scope.limitations</span>, and <span class="mono mono-inline">errors</span> before interpreting the score.</li>
          <li data-doc-i18n-html="safe.li3">Check <span class="mono mono-inline">summary.enforcementReadinessApplicable</span> first. When it is true, use <span class="mono mono-inline">summary.enforcementReadiness.decision</span> as the primary readiness decision; it is triage, not approval to change DNS. When false, readiness is not applicable.</li>
          <li data-doc-i18n="safe.li4">Compare current and suggested values, then confirm the authorized sender inventory and provider requirements.</li>
          <li data-doc-i18n="safe.li5">Verify representative message headers and recent DMARC aggregate reports before moving to quarantine or reject.</li>
          <li data-doc-i18n="safe.li6">Require human approval and a rollback plan before applying any DNS change.</li>
        </ol>
      </section>

      <section class="card p-16 mt-12">
        <h2 data-doc-i18n="policy.title">Interpretation policy</h2>
        <p data-doc-i18n="policy.p1">AI must not decide whether to change DNS from the score alone. The JSON export separates facts observed in public DNS, interpretation limits, priorities, suggested fixes, supporting DNS records, and lookup errors.</p>
        <p data-doc-i18n-html="policy.p2">Before moving DMARC to <span class="mono mono-inline">p=quarantine</span> or <span class="mono mono-inline">p=reject</span>, a human should review the authorized sender inventory, real-message authentication results, RUA aggregate reports, current DNS values, and a rollback plan. Remediation is a review aid, not an instruction for automatic deployment.</p>
      </section>

      <section class="card p-16 mt-12">
        <h2 data-doc-i18n="cite.title">How to cite a diagnosis</h2>
        <p data-doc-i18n-html="cite.p1">For the product, cite: “DMARC4all, ToppyMicroServices, DMARC4all public-DNS email authentication diagnostic, <a href="https://dmarc4all.toppymicros.com/">https://dmarc4all.toppymicros.com/</a> (accessed YYYY-MM-DD).”</p>
        <p data-doc-i18n-html="cite.p2">For a specific result, retain <span class="mono mono-inline">generatedAt</span>, <span class="mono mono-inline">resolver</span>, <span class="mono mono-inline">schemaVersion</span>, and the relevant evidence. Do not describe the output as a certification or a receiver-side conformance result.</p>
      </section>

      <p class="mt-12"><a href="index.html" data-doc-i18n="links.back">Back to Quick Check</a> / <a href="standards_privacy.html" data-doc-i18n="links.standards">Standards & Privacy</a> / <a href="dns_provider_guides.html" data-doc-i18n="links.guides">DNS provider guides</a></p>
    </main>
  </div>
</body>
</html>