Zum Hauptinhalt springen

E-Mail-Domains verifizieren

Die Verifizierung einer E-Mail-Domain weist nach, dass sie Ihrer Organisation gehört. Sie fügen einen DNS-TXT-Eintrag hinzu, den XFA abfragt. Eine verifizierte Domain zeigt unter Einstellungen → Domains einen grünen Status Verifiziert, und Sie können die Anmeldung und das Onboarding über den Identity Provider (IdP) auf verifizierte Domains beschränken.

Bevor Sie beginnen

  • Sie sind Administrator Ihrer Organisation in XFA.
  • Sie können die DNS-Einträge der Domain bearbeiten.
  • Die Domain gehört zu den E-Mail-Domains Ihrer Organisation, die unter Einstellungen → Domains aufgeführt sind. Klicken Sie auf Domain hinzufügen, um eine hinzuzufügen. Die IdP-Anleitungen akzeptieren diese neben den Erlaubten E-Mail-Domains jeder Verbindung. Öffentliche E-Mail-Anbieter wie gmail.com oder outlook.com können nicht hinzugefügt werden: XFA antwortet „Dies ist ein öffentlicher E-Mail-Anbieter. Fügen Sie die eigene Domain Ihrer Organisation hinzu.“

Der Eintrag

FeldWert
TypTXT
Host_xfa-<label> (der vollständige Name lautet _xfa-<label>.<domain>)
Wertxfa-domain-verification=<token>

Label und Token gelten nur für Ihre Organisation und die Domain, der Host ist also für jede Organisation und Domain anders, zum Beispiel _xfa-k7q2m4x9p3r5t6v8 für acme.com. Aus dem DNS lässt sich nicht ablesen, welche Domains XFA nutzen. Öffnen Sie Einstellungen → Domains, klicken Sie neben der Domain auf Verifizieren und kopieren Sie Host und Wert im Dialog mit Host kopieren und Wert kopieren genau so, wie sie angezeigt werden. Der Dialog zeigt den vollständigen Namen des Eintrags außerdem unter Host.

Geben Sie den Host relativ zu Ihrer DNS-Zone ein. Ist die E-Mail-Domain die Zone selbst, etwa acme.com in der Zone acme.com, ist das der kopierte Host. Ist die E-Mail-Domain eine Subdomain, die in einer übergeordneten Zone gehostet wird, ergänzen Sie die Subdomain im Host. Für staff.example.com in der Zone example.com lautet der Name _xfa-<label>.staff. Prüfen Sie, dass der vollständige Name, den Ihr DNS-Anbieter anzeigt, mit dem vollständigen Namen im Dialog übereinstimmt.

Unter demselben Namen können weitere TXT-Einträge liegen, etwa SPF oder andere Verifizierungseinträge. XFA sucht den Eintrag mit dem exakten Wert.

Den Eintrag hinzufügen

Wo Sie den Eintrag hinzufügen, hängt davon ab, wer Ihr DNS hostet. Liegen Domainname und DNS bei verschiedenen Unternehmen, nutzen Sie das Unternehmen, das das DNS hostet (die Nameserver).

Cloudflare

  1. Öffnen Sie die Domain im Cloudflare-Dashboard und gehen Sie zu DNS → Records.
  2. Klicken Sie auf Add record.
  3. Setzen Sie Type auf TXT, geben Sie den Host bei Name ein, wie unter Der Eintrag beschrieben, und fügen Sie den Wert bei Content ein.
  4. Klicken Sie auf Save.

Google Domains und Squarespace

Google Domains heißt jetzt Squarespace Domains.

  1. Öffnen Sie die Domain und gehen Sie zu DNS → DNS settings.
  2. Klicken Sie unter Custom records auf Add record.
  3. Setzen Sie Type auf TXT, geben Sie den Host bei Host ein, wie unter Der Eintrag beschrieben, und fügen Sie den Wert bei Data ein.
  4. Klicken Sie auf Save.

GoDaddy

  1. Öffnen Sie die Domain und gehen Sie zu DNS.
  2. Klicken Sie auf Add New Record.
  3. Setzen Sie Type auf TXT, geben Sie den Host bei Name ein, wie unter Der Eintrag beschrieben, und fügen Sie den Wert bei Value ein.
  4. Klicken Sie auf Save.

Amazon Route 53

  1. Öffnen Sie die Hosted Zone der Domain.
  2. Klicken Sie auf Create record.
  3. Geben Sie den Host bei Record name ein, wie unter Der Eintrag beschrieben, setzen Sie Record type auf TXT und fügen Sie den Wert bei Value ein. Lassen Sie den Wert in doppelten Anführungszeichen, wenn die Konsole sie verlangt.
  4. Klicken Sie auf Create records.

DNS-Änderungen können bis zu einer Stunde brauchen, bis sie XFA erreichen.

Den Eintrag prüfen

  1. Gehen Sie zu Einstellungen → Domains.
  2. Klicken Sie neben der Domain auf Verifizieren.
  3. Klicken Sie auf Jetzt prüfen.

Wird der Eintrag gefunden, bestätigt der Dialog Domain verifiziert und die Domain zeigt Verifiziert. Andernfalls nennt der Dialog den Grund:

MeldungBedeutung
Noch kein TXT-Eintrag unter _xfa-k7q2m4x9p3r5t6v8.acme.com gefundenXFA hat unter dem im Dialog angezeigten Namen keinen Eintrag gefunden. Prüfen Sie den Host und warten Sie, bis das DNS nachgezogen hat.
Der Eintrag wurde gefunden, aber sein Wert stimmt nicht übereinEs gibt einen Eintrag, aber mit einem anderen Wert, oft ein Token aus einem früheren Versuch. Kopieren Sie den Wert erneut aus dem Dialog.
Die Abfrage ist fehlgeschlagen, versuchen Sie es gleich noch einmalDie DNS-Abfrage wurde nicht abgeschlossen. Klicken Sie gleich noch einmal auf Jetzt prüfen.

Die Spalte Status unter Einstellungen → Domains zeigt unter einer nicht verifizierten Domain den Grund der letzten Prüfung: Kein TXT-Eintrag gefunden, Eintragswert stimmt nicht überein oder DNS-Abfrage fehlgeschlagen. Zuletzt geprüft zeigt, wann.

Nur verifizierte Domains können sich anmelden

Der Schalter Nur verifizierte Domains können sich anmelden unter Einstellungen → Domains erscheint, sobald mindestens eine Domain verifiziert ist. Bei Organisationen, die schon vor der Domain-Verifizierung bestanden, ist er aus, bei neuen Organisationen standardmäßig an. Ist er an, können sich Personen nur mit einer E-Mail-Adresse bei einer verifizierten Domain über Ihre Identity Provider anmelden oder onboarden. Der Schalter speichert, sobald Sie ihn ändern. Bevor er sich einschaltet, fragt XFA Personen bei nicht verifizierten Domains aussperren? und nennt Ihnen, wie viele bereitgestellte Benutzer bei nicht verifizierten Domains sich nicht mehr anmelden können, bis diese Domains verifiziert sind. Klicken Sie zur Bestätigung auf Einschalten.

Der Schalter beschränkt die E-Mail-Domains der Organisation. Eine Domain, die unter Erlaubte E-Mail-Domains einer Verbindung steht, bleibt für diese Verbindung erlaubt, ob verifiziert oder nicht. Entfernen Sie nach der Verifizierung der Domains Ihrer Organisation die Einträge, die sie wiederholen, aus den Verbindungen, damit die Verifizierung entscheidet.

Bei ausgeschaltetem Schalter ist die Verifizierung rein informativ: Nicht verifizierte Domains funktionieren weiter.

Wöchentliche Neuprüfung

XFA prüft den Eintrag jeder verifizierten Domain einmal pro Woche. Lassen Sie den Eintrag bestehen.

  1. Nach drei fehlgeschlagenen Prüfungen in Folge bleibt die Domain verifiziert und alle Administratoren erhalten eine Warn-E-Mail.
  2. Nach der vierten zeigt die Domain Verifizierung verloren und alle Administratoren erhalten eine zweite E-Mail, die den wiederherzustellenden Eintrag nennt. Ist Nur verifizierte Domains können sich anmelden an, stoppt die Anmeldung über die Domain, es sei denn, eine Verbindung führt die Domain noch unter ihren Erlaubten E-Mail-Domains. Ist er aus, ändert sich sonst nichts.

Um die Domain zurückzuerhalten, stellen Sie den Eintrag wieder her und klicken Sie dann auf Verifizieren und Jetzt prüfen.

Mehrere Organisationen auf einer Domain

Mehrere Organisationen können dieselbe Domain verifizieren. Wenn Sie mehrere XFA-Organisationen betreiben, zum Beispiel eine pro Tochtergesellschaft, fügen Sie die Domain in jeder davon hinzu und verifizieren Sie sie. Jede erhält ihren eigenen Eintrag, und die Einträge bestehen nebeneinander in der Zone.

Hinweise und Fehlerbehebung

  • Host und Token gehören zu einer Organisation und einer Domain. Kopieren Sie sie erneut aus dem Dialog, wenn Sie unsicher sind, welcher Eintrag Ihrer ist.
  • Manche DNS-Panels hängen die Domain selbst an den Host an. Findet Jetzt prüfen nichts, prüfen Sie, dass der Eintrag nicht unter _xfa-k7q2m4x9p3r5t6v8.acme.com.acme.com liegt.
  • Der Wert muss exakt übereinstimmen, ohne zusätzliche Leerzeichen oder Anführungszeichen darin.