Nachrichten im AutoDNS

Bei jedem Auftrag, der an AutoDNS gesendet wird,  regiert das System mit Rückmeldungen über den Verarbeitungsstatus des Auftrages im System (job) und den Status der Erledigung der spezifischen Auftrages (task).

Je nach Auftragstyp werden nur Systemantworten in Echtzeit zurückgegeben oder zusätzlich weitere  Systembenachrichtigungen. Für die Systembenachrichtigungen kann die Zustellungsart E-Mail, Push oder Polling gewählt werden.

Nachrichtenarten im AutoDNS

Systemantworten

• Echtzeit-Systemantworten: Diese Antworten werden direkt nach dem Absenden eines Auftrags zurückgegeben.

  • Success (S): Auftrag wurde erfolgreich akzeptiert.

  • Error (E): Fehler bei der Bearbeitung mit spezifischer Fehlermeldung (EF,  z. B. „EF0101“).

  • Notify (N): Auftrag wurde akzeptiert und wird weiterverarbeitet. Der Endstatus wird später über Benachrichtigungen übermittelt (Success/Error).

Benachrichtigungen

• Interne Benachrichtigungen durch Polling/Push/E-Mail: Resultieren aus Aufträgen mit „Notify“-Status. Diese Benachrichtigungen übermitteln den Endstatus (Success/Error) nach Abschluss der Verarbeitung.

• Externe Benachrichtigungen: Ereignisse von außen (z. B. durch eine Registry) lösen Nachrichten aus, die keinem internen Auftrag zugeordnet sind.

Benachrichtigungsarten

Interne Benachrichtigungen durch Polling/Push/E-Mail:

Diese Nachrichten sind direkt mit einem Auftrag im System verknüpft.

• Status-Typen:

  • Success (S): Auftrag wurde erfolgreich abgeschlossen.

  • Failed (F): Auftrag ist fehlgeschlagen.

  • Running: Nur bei spezifischen Prozessen (z. B. TransferIn), zeigt an, dass der Auftrag noch läuft.

Siehe: Ausführliche JSON- und XML Code-Beispiele für Domain-Aufträge, Kontakt-Aufträge, OwnerChange und TransferIn-Aufträge.

Extern ausgelöste Benachrichtigungen

Diese Nachrichten werden durch externe Ereignisse ohne Bezug zu einem internen Auftrag ausgelöst.

Liste externer Benachrichtigungen

TransferOut

• transfer_start - Start eines ausgehenden Domaintransfers.

• transfer_autoack - Automatische Bestätigung eines ausgehende Transfers einer Domain (AutoAck). Nur für gTLDs.

• transfer_autonack - Automatische Ablehnung eines ausgehende Transfers einer Domain (AutoNack).

• transfer_reminder - Erinnerung an einen laufenden Transfer.

• domain_away - Löschung einer Domain aus dem Bestand, z. B. bei Domain-Tansfers ohne Beteiligung des Registrars.

DomainAutoUpdate

• autoupdate_dns_success - Erfolgreiche Konnektivitätsprüfung.

• autoupdate_dns_error - Erfolgreiche Ausführung einer automatischen Aktualisierung. Nur bei .de-Domains. Eine automatische Aktualisierung wird nur durchgeführt, wenn die Konnektivitätsprüfung, die ein Teil des Registrierungsprozesses ist, fehlgeschlagen ist.

• autoupdate_deferred_success - Erfolgreiches nachgelagertes AutoUpdate.

• autoupdate_deferred_error - Fehlgeschlagenes nachgelagertes AutoUpdate.

OCVAL (OwnerC-Validierung)

• ocval_reminder - Erinnerung an die Abschaltung der Domain (5 Tage vorher).

• ocval_deactivation - Information über die Dekonnektierung der Nameserver und die Nicht-Erreichbarkeit der Domain.

• ocval_reactivation - Information über die Rekonnektierung der Nameserver und die Wieder-Erreichbarkeit der Domain.

Purge Notifications

• zone_deleted - Zone erfolgreich gelöscht

• contact_deleted - Kontakt erfolgreich gelöscht

Beispiele für Nachrichten

Systemantworten

        <status>
            <type>success</type>
            <code>S0301</code>
            <text>Der Domain-Kontakt wurde erfolgreich aktualisiert.</text>
        </status>

    "status": {
        "resultCode": "S0301",
        "text": "Der Domain-Kontakt wurde erfolgreich aktualisiert.",
        "type": "SUCCESS"

Externe Benachrichtigungen:

{
    "notification": {
        "type": "transfer_start",
        "domain": "example.com",
        "timestamp": "2024-12-30T12:00:00Z"
    }
}

  <notification>
    <type>zone_deleted</type>
    <zone>example.com</zone>
    <timestamp>2024-12-30T12:00:00Z</timestamp>
</notification>

Benachrichtigungsprozess

1. Auftrag starten:

   • Systemantwort mit „Success“, „Error“ oder „Notify“ wird zurückgegeben.

2. Notify-Prozess:

   • Bei „Notify“-Status wird der endgültige Status (Success/Error) über eine Benachrichtigung übermittelt.

3. Externe Ereignisse:

   • Direkte Benachrichtigung über Ereignisse außerhalb des Systems (z. B. TransferOut, ZonePurge).

Siehe: Schematische Darstellung der Auftragsverarbeitung für Domains und Domain-Kontakte, Zonen, Benutzer und Abfragen, TransferIn und OwnerChange

Struktur und Keywords von Benachrichtigungen (XML)