Je eigen domein gebruiken
Doel
Serveer je portal op een adres dat van je organisatie is — portal.acme.com — in plaats van, of naast,
het adres dat je Parsware-installatie hem heeft gegeven.
Voordat je begint
Je hebt twee dingen nodig, en geen van beide zit in Parsware:
- Een domein dat je beheert, en iemand die records aan de DNS ervan kan toevoegen. In veel organisaties is dat niet degene die de portal bouwt, dus het loont om dit vroeg te vragen: de tijd tussen een DNS-record aanvragen en er een krijgen, wordt meestal in dagen gemeten.
- Een
CNAME-record dat de gekozen naam naar je Parsware-installatie laat wijzen. Vraag aan degene die je installatie beheert wat het doel moet zijn — het is hetzelfde adres waarop je portal nu al antwoordt, het adres in het vak Webadres.
Stappen
-
Open je oplossing, kies Portals en open de portal.
-
Druk onder Je eigen domeinen op Een domein toevoegen en typ de volledige naam die een bezoeker zou typen —
portal.acme.com, nietacme.comen niethttps://portal.acme.com. -
Druk op Opslaan. Dit is de stap die ertoe doet: het record dat je moet publiceren, bestaat pas als het domein is opgeslagen, omdat het een code bevat die voor deze portal en dit domein is aangemaakt.
-
Open de portal opnieuw. Onder het domein zie je nu een TXT-record — een naam en een waarde.
-
Vraag je DNS-beheerder precies dat record te publiceren. Het ziet er zo uit:
Type TXTNaam _parsware-verification.portal.acme.comWaarde parsware-domain-verification=gevolgd door je code -
Druk op Nu controleren. Is het record doorgekomen, dan springt het domein op Geverifieerd en begint het adres te antwoorden. Is dat niet zo, dan zegt het scherm dat en onthoudt het dat we hebben gekeken — dit is geen fout, het is het antwoord, en in de eerste minuten het gebruikelijke. Druk later nog eens; een DNS-wijziging kan even duren voordat die ons bereikt, en zo vaak controleren als je wilt kost niets.
Waarom je het moet bewijzen
Iedereen die een portal mag bewerken, kan elk domein in dat vak typen. Als typen genoeg was, zou één persoon de portal van een collega — of die van een heel andere klant — naar een naam kunnen laten wijzen waar hij geen recht op had, en het platform zou er een certificaat voor aanvragen en gaan serveren.
Een domein is daarom een claim totdat het is bewezen, en een claim doet helemaal niets:
- Het antwoordt niet. Wie ernaartoe gaat, bereikt niets, wat je DNS ook zegt.
- Er wordt geen certificaat voor aangevraagd, dus een browser die ernaartoe wordt gestuurd, toont een beveiligingswaarschuwing in plaats van je portal.
- Het verschijnt nergens als adres, en een portal zonder ander adres kan niet worden Gepubliceerd.
Alleen iemand die een record binnen een domein kan publiceren, kan bewijzen dat hij het beheert, en dat is precies de vraag die beantwoord moet worden.
Anders dan bij het vak Webadres — waar een naam bezet is zodra iemand hem opslaat, omdat de
installatie die namen bezit — wordt over een domein dat jij bezit beslist door DNS. Twee portals
kunnen allebei portal.acme.com noemen, en de portal waarvan de code daadwerkelijk is gepubliceerd,
krijgt het. Dat is bewust: de tweede claim weigeren zou degene die een naam het eerst typte in staat
stellen de echte eigenaar buiten zijn eigen domein te sluiten.
Is een domein voor één portal geverifieerd, dan kan geen andere portal het verifiëren. Om een domein te verplaatsen, verwijder je het van de portal die het heeft, sla je op en verifieer je het daarna op de andere.
Wat er mis kan gaan
"Er is geen bewijs gevonden." Het record staat er nog niet, of het komt niet overeen. Controleer
drie dingen, in deze volgorde: dat de naam begint met _parsware-verification. (het liggende streepje
doet ertoe — een gewoon TXT-record op portal.acme.com kan niet naast de CNAME bestaan), dat de
waarde de hele tekenreeks is inclusief het deel parsware-domain-verification=, en dat er genoeg tijd
is verstreken.
"We konden … niet opzoeken" Die is van ons, niet van jou. Je DNS is in orde; onze opzoekactie kreeg geen antwoord. Probeer het over een paar minuten opnieuw.
Het domein is geverifieerd, maar de pagina laadt niet. Verificatie bewijst dat de naam van jou is;
ze laat hem niet naar ons wijzen. Controleer de CNAME.
Het werkte niet meer nadat iemand de portal had bewerkt. Een domein uit de lijst verwijderen, verwijdert ook het bewijs ervan. Het opnieuw toevoegen is een nieuwe claim met een nieuwe code, dus het oude TXT-record komt niet meer overeen — publiceer het nieuwe.
Welk adres gebruiken links?
Waar het platform zelf een link moet maken — een bevestigingsmail na registratie, een uitnodiging — gebruikt het het Webadres dat je installatie heeft uitgegeven, in plaats van een eigen domein. Dat adres werkt altijd. Je eigen domein wordt alleen voor die links gebruikt als de portal helemaal geen platformadres heeft, en dan pas nadat het is geverifieerd.