Direkt zum Hauptinhalt

Eine eigene Domain verwenden

Ziel​

Ihr Portal unter einer Adresse bereitstellen, die Ihrer Organisation gehört – portal.acme.com –, anstelle der Adresse, die Ihre Parsware-Installation ihm gegeben hat, oder zusätzlich dazu.

Bevor Sie beginnen​

Sie brauchen zwei Dinge, und keines davon liegt in Parsware:

  1. Eine Domain, die Sie kontrollieren, und jemanden, der Einträge zu ihrem DNS hinzufügen kann. In vielen Organisationen ist das nicht die Person, die das Portal baut, daher lohnt es sich, früh zu fragen: Die Zeit zwischen der Anfrage nach einem DNS-Eintrag und seiner Einrichtung misst man meist in Tagen.
  2. Einen CNAME-Eintrag, der den gewählten Namen auf Ihre Parsware-Installation verweist. Fragen Sie denjenigen, der Ihre Installation betreibt, wie das Ziel lauten soll – es ist dieselbe Adresse, unter der Ihr Portal bereits antwortet, die im Feld Webadresse angezeigte.

Schritte​

  1. Öffnen Sie Ihre Lösung, wählen Sie Portale aus und öffnen Sie das Portal.

  2. Drücken Sie unter Eigene Domains auf Domain hinzufügen und geben Sie den vollständigen Namen ein, den ein Besucher eintippen würde – portal.acme.com, nicht acme.com und nicht https://portal.acme.com.

  3. Drücken Sie Speichern. Auf diesen Schritt kommt es an: Der Eintrag, den Sie veröffentlichen müssen, existiert erst, wenn die Domain gespeichert ist, denn er enthält einen Code, der für dieses Portal und diese Domain erzeugt wird.

  4. Öffnen Sie das Portal erneut. Unter der Domain sehen Sie jetzt einen TXT-Eintrag – einen Namen und einen Wert.

  5. Bitten Sie Ihren DNS-Administrator, genau diesen Eintrag zu veröffentlichen. Er sieht so aus:

    TypTXT
    Name_parsware-verification.portal.acme.com
    Wertparsware-domain-verification= gefolgt von Ihrem Code

  6. Drücken Sie Jetzt prüfen. Ist der Eintrag angekommen, wechselt die Domain auf Bestätigt, und die Adresse beginnt zu antworten. Ist er es nicht, sagt der Bildschirm das und merkt sich, dass wir nachgesehen haben – das ist kein Fehler, sondern die Antwort, und in den ersten Minuten die übliche. Drücken Sie später erneut; eine DNS-Änderung kann eine Weile brauchen, bis sie uns erreicht, und so oft zu prüfen, wie Sie möchten, kostet nichts.

Warum Sie es nachweisen müssen​

Jeder, der ein Portal bearbeiten darf, kann jede beliebige Domain in dieses Feld eintippen. Genügte das Eintippen, könnte eine Person das Portal eines Kollegen – oder eines ganz anderen Kunden – auf einen Namen verweisen, auf den sie kein Recht hat, und die Plattform würde ein Zertifikat dafür beziehen und anfangen, ihn zu bedienen.

Eine Domain ist daher ein Anspruch, bis sie nachgewiesen ist, und ein Anspruch bewirkt gar nichts:

  • Sie antwortet nicht. Wer sie aufruft, erreicht nichts, was auch immer Ihr DNS sagt.
  • Für sie wird kein Zertifikat bezogen, sodass ein Browser, der dorthin geschickt wird, eine Sicherheitswarnung zeigt statt Ihres Portals.
  • Sie erscheint nirgends als Adresse, und ein Portal ohne andere Adresse kann nicht Veröffentlicht werden.

Nur wer einen Eintrag innerhalb einer Domain veröffentlichen kann, kann nachweisen, dass er sie kontrolliert – und genau diese Frage muss beantwortet werden.

Zwei können dieselbe Domain beanspruchen. Nur einer kann sie nachweisen.

Anders als beim Feld Webadresse – wo ein Name vergeben ist, sobald jemand ihn speichert, weil die Installation diese Namen besitzt – entscheidet bei einer Domain, die Ihnen gehört, das DNS. Zwei Portale können beide portal.acme.com aufführen, und dasjenige, dessen Code tatsächlich veröffentlicht ist, bekommt sie. Das ist Absicht: Den zweiten Anspruch abzulehnen würde es demjenigen, der einen Namen zuerst eingetippt hat, erlauben, den tatsächlichen Eigentümer aus seiner eigenen Domain auszusperren.

Sobald eine Domain für ein Portal bestätigt ist, kann kein anderes Portal sie bestätigen. Um eine Domain umzuziehen, entfernen Sie sie aus dem Portal, das sie hält, speichern Sie und bestätigen Sie sie dann beim anderen.

Was schiefgehen kann​

„Es wurde kein Nachweis gefunden.“ Der Eintrag ist noch nicht da, oder er stimmt nicht überein. Prüfen Sie drei Dinge, in dieser Reihenfolge: dass der Name mit _parsware-verification. beginnt (der Unterstrich ist wichtig – ein einfacher TXT-Eintrag auf portal.acme.com kann neben dem CNAME nicht existieren), dass der Wert die gesamte Zeichenkette einschließlich des Teils parsware-domain-verification= ist und dass genug Zeit vergangen ist.

„Wir konnten … nicht nachschlagen“ Dieser Fehler liegt bei uns, nicht bei Ihnen. Ihr DNS ist in Ordnung; unsere Abfrage hat keine Antwort bekommen. Versuchen Sie es in einigen Minuten erneut.

Die Domain ist bestätigt, aber die Seite lädt nicht. Die Bestätigung weist nach, dass der Name Ihnen gehört; sie verweist ihn nicht auf uns. Prüfen Sie den CNAME.

Es funktionierte nicht mehr, nachdem jemand das Portal bearbeitet hat. Wird eine Domain aus der Liste entfernt, wird ihr Nachweis mit entfernt. Sie wieder hinzuzufügen ist ein neuer Anspruch mit einem neuen Code, sodass der alte TXT-Eintrag nicht mehr übereinstimmt – veröffentlichen Sie den neuen.

Wo die Plattform selbst einen Link erzeugen muss – eine Bestätigungs-E-Mail nach der Registrierung, eine Einladung –, verwendet sie vorrangig die Webadresse, die Ihre Installation vergeben hat, und nicht eine eigene Domain. Diese Adresse funktioniert immer. Ihre eigene Domain wird für solche Links nur verwendet, wenn das Portal überhaupt keine Plattformadresse hat, und dann erst, wenn sie bestätigt ist.

Verwandte Seiten​