Разобрать SPF-запись домена
Проверяет SPF, считает DNS-lookups, показывает механизмы и качество финального all.
Что делает скрипт
Скрипт находит SPF-запись, разбирает механизмы и рекурсивно учитывает include и redirect. Отдельно проверяется число DNS-lookups и квалификатор all. Результат помогает найти слишком сложные и потенциально неработающие политики.
Быстрый старт
python spf_check.py example.com
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python spf_check.py example.compython spf_check.py example.com --verbose
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
py -m pip install dnspython
python3 -m pip install dnspython
python3 -m pip install dnspython
spf_check.py
#!/usr/bin/env python3
"""Разбор и проверка SPF-записи домена."""
from __future__ import annotations
import argparse
import sys
try:
import dns.exception
import dns.resolver
except ImportError:
print("Нужен dnspython: python -m pip install dnspython", file=sys.stderr)
sys.exit(2)
LOOKUP_MECHANISMS = {"a", "mx", "ptr", "exists"}
RESOLVER = dns.resolver.Resolver(configure=True)
RESOLVER.timeout = 4.0
RESOLVER.lifetime = 4.0
def get_txt(name: str) -> list[str]:
try:
answer = RESOLVER.resolve(name, "TXT", raise_on_no_answer=False)
except dns.resolver.NXDOMAIN:
return []
except dns.resolver.NoNameservers:
return []
except dns.exception.Timeout:
return []
except dns.exception.DNSException:
return []
if answer.rrset is None:
return []
records = []
for item in answer:
records.append(b"".join(item.strings).decode("utf-8", "replace"))
return records
def find_spf(domain: str) -> list[str]:
return [record for record in get_txt(domain) if record.lower().startswith("v=spf1")]
def analyze(record: str, domain: str, depth: int = 0, seen: set[str] | None = None) -> tuple[int, list[str], str | None]:
if seen is None:
seen = {domain}
if depth > 5:
return 0, ["слишком глубокая цепочка include"], None
tokens = record.split()
if not tokens or tokens[0].lower() != "v=spf1":
return 0, ["запись не начинается с v=spf1"], None
lookups = 0
notes: list[str] = []
all_qualifier: str | None = None
for token in tokens[1:]:
low = token.lower()
if low.startswith("include:"):
target = token.split(":", 1)[1].rstrip(".")
lookups += 1
if not target:
notes.append("пустой include")
continue
if target in seen:
notes.append(f"цикл include на {target}")
continue
seen.add(target)
nested = find_spf(target)
if len(nested) == 0:
notes.append(f"include без SPF: {target}")
elif len(nested) > 1:
notes.append(f"несколько SPF в include: {target}")
else:
sub_lookups, sub_notes, _ = analyze(nested[0], target, depth + 1, seen)
lookups += sub_lookups
notes.extend(sub_notes)
continue
if low.startswith("redirect="):
target = token.split("=", 1)[1].rstrip(".")
lookups += 1
if not target:
notes.append("пустой redirect")
continue
if target in seen:
notes.append(f"цикл redirect на {target}")
continue
seen.add(target)
nested = find_spf(target)
if len(nested) == 1:
sub_lookups, sub_notes, _ = analyze(nested[0], target, depth + 1, seen)
lookups += sub_lookups
notes.extend(sub_notes)
else:
notes.append(f"redirect без одной SPF: {target}")
continue
mechanism = low.split(":", 1)[0].split("/", 1)[0]
if mechanism in LOOKUP_MECHANISMS:
lookups += 1
stripped = low.lstrip("+-~?")
if stripped == "all":
all_qualifier = low[0] if low[0] in "+-~?" else "+"
return lookups, notes, all_qualifier
def main() -> int:
parser = argparse.ArgumentParser(description="Проверить SPF-запись домена")
parser.add_argument("domain", help="Домен для проверки")
parser.add_argument("--verbose", action="store_true", help="Показать все TXT-записи")
args = parser.parse_args()
domain = args.domain.rstrip(".")
if not domain or " " in domain:
parser.error("Укажите домен без пробелов")
records = find_spf(domain)
if args.verbose:
print("TXT-записи:")
for record in get_txt(domain):
print(f" {record}")
if not records:
print("SPF не найден", file=sys.stderr)
return 1
if len(records) > 1:
print(f"Найдено несколько SPF-записей: {len(records)}", file=sys.stderr)
for record in records:
print(f" {record}", file=sys.stderr)
return 1
record = records[0]
lookups, notes, qualifier = analyze(record, domain)
print(f"Домен: {domain}")
print(f"SPF: {record}")
print(f"Механизмы: {' '.join(record.split()[1:])}")
print(f"DNS-lookups: {lookups} из 10")
print(f"Финальный all: {qualifier + 'all' if qualifier else 'не указан'}")
failed = False
if qualifier is None:
print("Нет механизма all: политика может быть непредсказуемой", file=sys.stderr)
elif qualifier == "+":
print("Опасный +all: разрешает отправку с любых серверов", file=sys.stderr)
failed = True
elif qualifier == "?":
print("Нейтральный ?all не даёт защиты от подделки", file=sys.stderr)
if lookups > 10:
print("Превышен лимит DNS-lookups, получатели могут отклонить письма", file=sys.stderr)
failed = True
elif lookups > 8:
print("SPF близок к лимиту в 10 DNS-lookups", file=sys.stderr)
for note in notes:
print(f"Замечание: {note}", file=sys.stderr)
return 1 if failed else 0
if __name__ == "__main__":
raise SystemExit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.