DNS del correo

El asistente de correo calcula los registros que necesita una zona para los proveedores de buzón y de envío elegidos (un único SPF, MX, DKIM, DMARC) y comprueba lo que muestra el DNS público. Estas rutas no aplican nada; un plan se aplica con Lote de registros.

#Listar proveedores de correo

GET /v1/orgs/{org}/zones/{zone}/email/providers

Lista las plantillas de proveedores del asistente de correo, de buzón (mailbox, p. ej. Google Workspace, Microsoft 365, Zoho Mail, Proton Mail, Fastmail), de envío (sending, p. ej. Amazon SES, Resend, Mailgun, SendGrid, Brevo) y other, con los parámetros que pide cada una (con los valores por defecto ya calculados para la zona).

Rol necesario: readonly o superior.

#Parámetros

#Respuesta

• 200: Devuelve items, un array de EmailProvider.

#Errores

#Ejemplo

curl "https://dash.openwaf.dev/v1/orgs/$OPENWAF_ORG/zones/6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d/email/providers" \
  -H "Authorization: Bearer $OPENWAF_TOKEN"

import { OpenWAF } from "./openwaf";

const owf = new OpenWAF({ baseUrl: "https://dash.openwaf.dev" }); // token de OPENWAF_TOKEN
const result = await owf.listEmailProviders({
  zone: "6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d"
});

from openwaf import OpenWAF

owf = OpenWAF(base_url="https://dash.openwaf.dev")  # token de OPENWAF_TOKEN
result = owf.list_email_providers(zone="6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d")

{
  "items": [
    {
      "id": "example",
      "name": "example.com",
      "kind": "mailbox",
      "docs": "example",
      "spf": [
        "example"
      ],
      "params": [
        {}
      ]
    }
  ]
}

#Planificar los registros de correo

POST /v1/orgs/{org}/zones/{zone}/email/plan

Calcula los registros de correo que necesita la zona para los proveedores elegidos, comparados con sus registros actuales (el DNS público en una zona externa): un único SPF que une los mecanismos de los proveedores con los existentes (conservando el ~all/-all que hubiera), los MX del proveedor de buzón, las claves DKIM pegadas por el usuario (validadas), los registros de verificación, los subdominios de envío y DMARC (p=none por defecto). También cuenta las búsquedas DNS del SPF resultante (más de 10 es un error).

No aplica nada. Los problemas van en issues (los errores dejan batch nulo). batch se envía tal cual a Lote de registros, primero con dry_run=1. En zonas externas applicable es falso y las acciones son manual.

Rol necesario: readonly o superior.

#Parámetros

#Cuerpo de la petición

Tipo de contenido application/json. Esquema: EmailPlanInput.

#Respuesta

• 200: Devuelve EmailPlan.

#Errores

#Ejemplo

curl -X POST "https://dash.openwaf.dev/v1/orgs/$OPENWAF_ORG/zones/6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d/email/plan" \
  -H "Authorization: Bearer $OPENWAF_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
    "providers": [
      {
        "id": "google"
      }
    ],
    "dmarc": {
      "policy": "none"
    }
  }'

import { OpenWAF } from "./openwaf";

const owf = new OpenWAF({ baseUrl: "https://dash.openwaf.dev" }); // token de OPENWAF_TOKEN
const result = await owf.planEmailRecords({
  zone: "6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d",
  body: {
    providers: [
      {
        id: "google"
      }
    ],
    dmarc: {
      policy: "none"
    }
  }
});

from openwaf import OpenWAF

owf = OpenWAF(base_url="https://dash.openwaf.dev")  # token de OPENWAF_TOKEN
result = owf.plan_email_records(
    zone="6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d",
    body={
        "providers": [
            {
                "id": "google"
            }
        ],
        "dmarc": {
            "policy": "none"
        }
    },
)

{
  "zone": "example.com",
  "dns_mode": "delegated",
  "applicable": false,
  "records": [
    {
      "type": "A",
      "name": "example.com",
      "fqdn": "example",
      "content": "203.0.113.10",
      "priority": 0,
      "purpose": "mx",
      "provider": "example",
      "action": "block",
      "record_id": "aa747ff3-b956-4f78-aa3e-6502aeccf60a",
      "current": "example"
    }
  ],
  "delete": [
    {
      "record_id": "aa747ff3-b956-4f78-aa3e-6502aeccf60a",
      "type": "A",
      "name": "example.com",
      "content": "203.0.113.10",
      "priority": 0,
      "reason": "Point www at the new origin"
    }
  ],
  "batch": {},
  "issues": [
    {
      "severity": "error",
      "code": "example",
      "field": "example",
      "message": "",
      "params": {
        "key": "example"
      }
    }
  ],
  "spf": {
    "value": "4f1c2e9a7b3d",
    "lookups": 0,
    "error": ""
  },
  "dmarc": "example"
}

#Comprobar los registros de correo

GET /v1/orgs/{org}/zones/{zone}/email/check

Comprueba en resolvedores públicos los registros de correo de la zona, MX presentes y coherentes, un único SPF y sus búsquedas DNS (como mucho 10 con los include y redirect anidados), claves DKIM, DMARC, nombres de correo con proxy, conflictos CNAME y, en zonas delegadas, si el mundo ve los registros de la zona. Cada comprobación es ok, warn, fail o info con un code estable y sus params. El resultado se guarda 60 segundos.

Rol necesario: readonly o superior. refresh=true exige tech.

#Parámetros

#Respuesta

• 200: Devuelve EmailReport.

#Errores

#Ejemplo

curl "https://dash.openwaf.dev/v1/orgs/$OPENWAF_ORG/zones/6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d/email/check" \
  -H "Authorization: Bearer $OPENWAF_TOKEN"

import { OpenWAF } from "./openwaf";

const owf = new OpenWAF({ baseUrl: "https://dash.openwaf.dev" }); // token de OPENWAF_TOKEN
const result = await owf.checkEmail({
  zone: "6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d"
});

from openwaf import OpenWAF

owf = OpenWAF(base_url="https://dash.openwaf.dev")  # token de OPENWAF_TOKEN
result = owf.check_email(zone="6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d")

{
  "zone": "example.com",
  "dns_mode": "delegated",
  "checked_at": "2026-10-27T09:30:00Z",
  "summary": {
    "status": "ok",
    "ok": 0,
    "warn": 0,
    "fail": 0,
    "info": 0
  },
  "providers": [
    "example"
  ],
  "checks": [
    {
      "id": "mx",
      "status": "ok",
      "code": "example",
      "subject": "example",
      "message": "",
      "params": {
        "key": "example"
      }
    }
  ],
  "public": {
    "mx": [
      "example"
    ],
    "spf": [
      "example"
    ],
    "dmarc": [
      "example"
    ],
    "dkim": [
      {
        "selector": "google",
        "name": "example.com",
        "value": "4f1c2e9a7b3d",
        "cname": "example"
      }
    ]
  },
  "spf": {
    "lookups": 0,
    "void_lookups": 0,
    "truncated": false,
    "all": "example",
    "tree": [
      {}
    ],
    "problems": []
  }
}