At some point you will very likely want to use a hostname that is part of your own domain to be linked to your WEM-portal.
Something like https://portal.yourdomain.ext
That is surely possible:
- Create a CNAME record for this hostname in your domain's DNS management (or let your DNS management people do this for you).
- Point the CNAME to live.wem.io. (the last dot can be optional in some DNS editors... these will remove the last dot and that is OK).
- Add this hostname to your portal settings and publish.
You can also use the staging environment for a test-url.yourdomain.ext, by using staging.wem.io as targetvalue for the CNAME record.
ONLY use live.wem.io (for live/production) and staging.wem.io (for test/acceptance) as target values for your CNAME records!
These (live/staging .wem.io) are the domains by which the WEM Runtime Servers are known and reached on the internet; once the WEM Runtime Server is reached, the WEM Runtime will recognize your actual hostname and the corresponding portal will be loaded and presented to the user.
So, for CNAME records in your domain's DNS management, use:
|Your domain hostnames
Wait until the DNS-change is available through nameservers (can take up to 24 hours).
You can check this using Google's DIG: https://toolbox.googleapps.com/apps/dig/
This will be enough for portals without SSL (https).
To have SSL available as well, WEM uses Let's Encrypt certificates.
In the future, this will be automatically available from within the WEM Modeler, but for the time being, if you want to have SSL enabled on your portal on your own domain, you need to create a Ticket in your MyWEM, requesting a Let's Encrypt SSL Certificate for your specific portal, specifying the hostname for which the certificate should be made.
We can only create Let's Encrypt SSL certificates for a hostname if the CNAME is pointing to live.wem.io, we check this using Googles DIG online tool.
For portals running in the APAC zone (published to Asia Pacific), the following CNAME values should be used:
- live.wemapac.io - for production (staging is not available for custom domains in wemapac.io environment)
See image linked below for a hopefully helpful explanatory image of CNAME settings and WEM Portal Settings.