PORTAL und PPS Knowledge Base

Domain & DNS-Einträge

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.)

  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:

(siehe )

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

Domain

Typ

Wert

Wann?

Domain

Typ

Wert

Wann?

domain.tld

A

tba

Release

www.domain.tld

A

tba

Release

media01.domain.tld

A

tba

sofort

media02.domain.tld

A

tba

sofort

media03.domain.tld

CNAME

tba

sofort

media04.domain.tld

CNAME

tba

sofort

mailjet._xxxxxx.domain.tld

TXT

tba

sofort

domain.tld (= SPF-Record)

TXT

tba

sofort

mailjet._domainkey.domain.tld

TXT

tba

sofort

 Verwandte Seiten