Aangepast domein
De aanmelding uitleveren vanaf uw eigen domein in plaats van de standaardhost van het platform.
Opmerking over het abonnement: Aangepaste domeinen zijn beschikbaar vanaf het Essential-abonnement. Zie Abonnementen & add-ons. Op lagere niveaus wordt de aanmelding uitgeleverd vanaf de standaardhost van het platform.
Opmerking: Een aangepast domein wordt niet in de Admin Console geconfigureerd. De inrichting verloopt in het afzonderlijke portaal waarmee uw instantie wordt beheerd. Deze pagina legt uit wat een aangepast domein verandert en wat u vóór de inrichting voorbereidt.
Standaard is uw tenant bereikbaar via een host die het platform beheert. Met een aangepast domein melden uw gebruikers zich aan op een hostnaam die u zelf bezit, bijvoorbeeld auth.yourcompany.com, zodat de aanmeldpagina's, de links in e-mails van het platform en de OIDC-eindpunten allemaal uw eigen domein gebruiken. Zo blijft de ervaring consistent met de rest van uw dienst.
Wat u voorbereidt
| Onderdeel | Details |
|---|---|
| Een specifieke hostnaam | Een subdomein dat uitsluitend voor de aanmelding wordt gebruikt, zoals auth.yourcompany.com. Gebruik niet de hostnaam van een bestaande website. |
| Toegang tot de DNS-zone | Voor de hostnaam worden twee records gepubliceerd: een CNAME die het verkeer naar het platform leidt, en een TXT-record dat aantoont dat het domein van u is. De exacte hostnamen en waarden worden tijdens de inrichting getoond. |
| Een TLS-certificaat (optioneel) | Alleen als u een eigen certificaat wilt gebruiken in plaats van een beheerd certificaat. Houd de volledige PEM-certificaatketen en de bijbehorende privésleutel gereed. Het certificaat moet de hostnaam dekken en mag niet verlopen zijn. |
Hoe de inrichting verloopt
De stappen verlopen in een vaste volgorde:
- Domein geregistreerd. De hostnaam wordt voor uw instantie vastgelegd.
- Eigendom geverifieerd. U publiceert het TXT- en het CNAME-record bij uw DNS-provider. De verificatie lukt zodra de records zijn gepropageerd, wat doorgaans enkele minuten duurt.
- Certificaat gekozen. Er wordt een beheerd certificaat uitgegeven en automatisch vernieuwd, of u levert uw eigen certificaat met privésleutel aan.
- Domein geactiveerd. Het domein wordt aan de edge ingericht en de aanmelding wordt erop overgezet. De activering duurt een moment en kan actieve sessies kort onderbreken.
Na de activering
- De aanmeldpagina's, de meervoudige-verificatievragen, het toestemmingsscherm en het eindgebruikersportaal worden vanaf uw domein uitgeleverd.
- De OIDC-issuer en alle eindpunten gebruiken de nieuwe hostnaam. Applicaties die het discovery-document uitlezen, nemen dat automatisch over; alles met hard gecodeerde eindpunt-URL's moet worden aangepast.
- Links in e-mails van het platform verwijzen naar de nieuwe hostnaam.
- Laat de DNS-records staan zolang het domein in gebruik is. Worden ze verwijderd, dan werkt de aanmelding niet meer.
Probleemoplossing
- De eigendomsverificatie wordt niet afgerond. DNS-wijzigingen hebben enkele minuten, soms langer, nodig om te propageren. Controleer of de host en de waarde van het record exact overeenkomen met wat de inrichting toont, zonder extra tekens.
- CNAME-conflict. Zorg dat er voor dezelfde hostnaam geen A- of AAAA-record bestaat.
- Certificaat geweigerd. In de modus eigen certificaat moet het certificaat een geldige PEM-keten zijn, bij de privésleutel passen, de hostnaam dekken (CN of SAN) en niet verlopen zijn.
- De aanmelding loopt nog via de oude host. De activering is de laatste stap en staat los van de verificatie. Controleer of het domein als actief wordt weergegeven voordat u uw gebruikers overzet.