Domain & DNS-Einträge

Funktionalitäten der Domain & DNS-Einträge

• Umwandlung des Domainnamens in die entsprechende IP-Adresse

• Wechsel von der PEIQ-Testumgebung auf die eigene Domain

• Voraussetzung für das Go-live eines PORTALS

Inhaltsverzeichnis

Allgemeine Beschreibung

Eine Domain ist eine in Wörtern bzw. in Buchstaben und Zahlen ausgedrückte Internetadresse, z. B. peiq.de. Sie lässt sich leichter merken als eine IP-Adresse.

DNS steht für Domain Name System. Das DNS funktioniert ähnlich wie ein Telefonbuch: Es wandelt die Domain in die zugehörige IP-Adresse um und führt den oder die Benutzer:in zum richtigen Server. Wie ein Telefonbuch benötigt das System auch Einträge. Diese werden bei den PEIQ PORTALen kundenseitig verwaltet.

Anleitung zum Set-up

Damit das PORTAL live geschaltet werden kann, muss kundenseitig eine DNS-Umstellung vorgenommen werden. Dazu erhalten Kund:innen von PEIQ eine Tabelle mit den benötigten DNS-Einträgen. Prinzipiell ist Folgendes zu beachten:

Vor dem Set-up

Vor dem Set-up muss zunächst festgelegt werden, wie die Hauptdomain lauten soll. Dazu braucht PEIQ folgende Informationen:

*Die Domain wird in der Regel mit und ohne der Subdomain www. hinterlegt. Die Hauptdomain gibt an, ob das PORTAL zukünftig primär mit www. (z.B. www.peiq.de) oder ohne Subdomain www. (z.B. peiq.de) erreicht werden soll. Sofern die Subdomain www. für das PORTAL nicht gültig sein soll, ist dies explizit anzugeben.

Damit ergeben sich für die Hauptdomain folgende Optionen:
(.tld bedeutet “Top Level Domain” und ist hier Platzhalter für .de, .com, .info etc.)

1. domain.tld

1. www.domain.tld

1. Subdomain www. nicht für das PORTAL gültig (PORTAL kann also unter www.domain.tld nicht erreicht werden).

Während des Set-ups

Sandbox: Domain läuft über PEIQ

Im Rahmen des Set-Ups wird von PEIQ eine Testumgebung mit dem späteren Live-PORTAL gestellt: die Sandbox. Die Sandbox ist zu diesem Zeitpunkt unter einer speziellen Domain von PEIQ erreichbar (z.B. peiq-beta.peiq.dev).

DNS-Einträge vornehmen

Für die Einrichtung der Sandbox benötigt PEIQ bereits einige DNS-Einträge. Während des Set-ups erhalten Sie von uns ein Memo mit allen relevanten DNS-Informationen für Ihr persönliches PORTAL. Eine beispielhafte Tabelle sehen Sie unten. Die DNS-Einträge sollten sehr zeitnah vorgenommen werden.

In der Regel müssen Sie DNS-Einträge für folgende Use-Cases vornehmen:

• Media-Domains (u.a. für die Bildauslieferung):
  Diverse A- und CNAME-Einträge nach Vorgabe durch PEIQ.

• ggf. PPS-Domain (sofern Sie ein PRINT PPS beauftragt haben):
  A-Record auf die entsprechende PEIQ-IP-Adresse. 

• ggf. Authentifizierungseinträge für Mailjet
  (siehe SMTP-Zugang | Konfiguration: Einbindung eines E Mail Dienstes durch PEIQ)

• und/oder ggf. Authentifizierungseinträge für AWS

(siehe TLS Zertifikate | Zertifikatsmanagement durch PEIQ)

Die Rückmeldung an PEIQ sollte unmittelbar nach der DNS-Umstellung erfolgen.

Eine Woche vor Launch

Eine Woche vor Umstellung sollte die DNS TTL (time to live) auf einen geringen Wert zwischen 5 und 15 Minuten herunter gestellt werden. DNS-Einträge werden üblicherweise gecached. Mit der TTL wird gesteuert, wie lange die Einträge im Cache gültig sind. Ist der Wert sehr hoch - eine TTL von einem Tag ist nicht unüblich - kann es sonst entsprechend lange dauern, bis bei allen Clients die neuen DNS-Einträge verfügbar sind. Wird diese Einstellung versäumt, lässt sich diese im Nachhinein nicht mehr andern.

Zum Launch-Termin

Zum Launch-Termin müssen dann folgende DNS-Einträge vorgenommen werden:

• Hauptdomain: A-Record auf die entsprechende PEIQ-IP-Adresse.

• ggf. PPS-Domain: A-Record auf die entsprechende PEIQ-IP-Adresse.  

Nach Launch

Bei Bedarf kann die TTL im Nachgang wieder erhöht werden. Das ist nur nötig, wenn es sich um einen langsamen Nameserver handelt. Die TTL sollte nicht größer als einen halben Tag sein. Empfehlung ist zwischen 0,5 und 6 Stunden.

Beispiel: Tabelle für kundenspezifische DNS-Einträge

 Verwandte Seiten

^{Nur für PEIQ-Mitarbeiter:innen}
https://peiq.atlassian.net/wiki/x/BACoMg