Damit das PEIQ PORTAL launchen kann und für die Öffentlichkeit erreichbar wird, müssen im Vorfeld DNS-Einträge vorgenommen werden. PEIQ kann keine DNS-Einträge für Kund:innen verwalten. Diese müssen von den Kund:innen selbst gemanagt werden.
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.
PEIQ verwaltet keine DNS-Einträge für Kund:innen. Diese müssen von den Kund:innen selbst gemanagt werden.
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:
Domain
Gewünschte Hauptdomain*
*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.)
domain.tld
www.domain.tld
- Subdomain
www.nicht für das PORTAL gültig (PORTAL kann also unterwww.domain.tldnicht 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).
Bei Launch wird die für das Set-up benötigte Sandbox-Domain umgehend deaktiviert, es findet keine Weiterleitung auf die neue Domain statt. Bei der Sandbox sollte deshalb darauf geachtet werden, dass bei eingerichteten Verlinkungen innerhalb des PORTALs nicht dauerhaft absolut (z.B. https://peiq-beta.peiq.dev/c-news) auf diese Domain verlinkt wird, da dies nach Launch nicht mehr funktioniert. Stattdessen sollten von Anfang an relative Verlinkungen (/c-news) gesetzt werden.
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 https://peiq.atlassian.net/wiki/spaces/PPSD/pages/304185395/SMTP-Zugang#Konfiguration%3A-Einbindung-eines-E-Mail-Dienstes-durch-PEIQ)und/oder ggf. Authentifizierungseinträge für AWS
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.
Wird die gewünschte Hauptdomain aktuell nicht verwendet, kann die Umstellung auch jederzeit vorab gemacht werden!
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.
Rückmeldung an PEIQ, sobald die DNS-Umstellung erfolgt ist.
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
Der Wert für den Domain-Key für mailjet._domainkey.domain.tld muss in einer Zeile stehen (k=rsa; p=XXXYYYZZZ...) und darf keine Umbrüche enthalten!
Der Wert für den SPF-Eintrag für domain.tld muss ggf. an die eigenen Gegebenheiten bzw. Infrastruktur angepasst werden!
Domain | Typ | Wert | Wann? |
|---|---|---|---|
|
| tba | Release |
|
| tba | Release |
|
| tba | sofort |
|
| tba | sofort |
|
| tba | sofort |
|
| tba | sofort |
|
| tba | sofort |
|
| tba | sofort |
|
| tba | sofort |
Verwandte Seiten
Disclaimer
Für die vorliegende Systemübersicht/Publikation behalten wir uns alle Rechte vor. Nachdruck, Vervielfältigung und Verbreitung (auch auszugsweise) ist nur mit schriftlicher Genehmigung der PEIQ Publishing GmbH & Co. KG erlaubt. Wir behalten uns vor, die Systemübersicht/Publikation jederzeit ohne vorherige Ankündigung zu ändern und/oder zu erweitern. Die vorliegenden Angaben dienen lediglich Informationszwecken. Die PEIQ Publishing GmbH & Co. KG übernimmt keinerlei Haftung und/oder Garantie für Fehler und/oder unvollständige Angaben in der Systemübersicht/Publikation, mit Ausnahme von vorsätzlich falschen oder arglistig verschwiegenen Angaben. Da unsere Software laufend weiter entwickelt wird, handelt es sich bei den vorliegenden nur um allgemeine Angaben. Es handelt sich weder um eine Zusicherung von Mindestvertragsinhalten, noch um Beschaffenheitsgarantien im Sinne des § 443 BGB.