WEM Community - Forum​

Forum home  > WEM Modeler-Tips and tricks  > How to link your own hostname/domain to your WEM-Portal

Post: How to link your own hostname/domain to your WEM-Portal​

Ralph

338 posts

 

2017-11-30 16:51 
last edited:  2020-06-05 17:18

Moderator

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:

  1. Create a CNAME record for this hostname in your domain's DNS management (or let your DNS management people do this for you).
  2. 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).
  3. 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   CNAME target
portal.yourdomain.ext   live.wem.io
testing.yourdomain.ext   staging.wem.io


 

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.

 

[EDIT]

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.

 

explain cname settings.png Explanatory picture of CNAME and WEM-settings

 

Ralph - WEM Xpert since 2011

"I speak to machines with the voice of humanity"
-- Marillion, Man of a thousand faces --

 

 

Comments​

Re:How to link your own hostname/domain to your WEM-Portal​

Christof

18 posts

 

2018-01-05 00:10 

0 0   

Thanks for this explanation. Does this also work in the same way for staging?

 

 

 

 

Re:How to link your own hostname/domain to your WEM-Portal​

Ralph

338 posts

 

2018-01-24 14:45 

0 0   

Moderator

This should not be applied to staging.

There should be no need for it in staging, as staging is not meant to be a production environment. Only for production portals you might want or need a hostname different from live.wem.io.

 

 

Ralph - WEM Xpert since 2011

"I speak to machines with the voice of humanity"
-- Marillion, Man of a thousand faces --

 

 

Re:How to link your own hostname/domain to your WEM-Portal​

Christof

18 posts

 

2018-01-24 15:34 

0 0   

Thank you for the response!

 

 

 

 

Re:How to link your own hostname/domain to your WEM-Portal​

Danny

8 posts

 

2019-04-09 12:29 

0 0   

Hello,

 

Is the SSL certifying automated or do we still need to create a ticket for that ?

 

Thanks.

 

 

 

 

Re:How to link your own hostname/domain to your WEM-Portal​

Ralph

338 posts

 

2019-04-09 14:30 

0 0   

Moderator

Ticket is still required, and I've seen that you've already done so and that the certificate is already in place.

 

 

Ralph - WEM Xpert since 2011

"I speak to machines with the voice of humanity"
-- Marillion, Man of a thousand faces --

 

 

Re:How to link your own hostname/domain to your WEM-Portal​

2019-08-28 16:06 
last edited:  2019-08-28 16:34

0 0   

Hi, do I understand it correct that SSL is not possible for staging environments and therefore it is best to not to create a custom hostname for staging if we want it to run under SSL?

 

 

 

 

 

Re:How to link your own hostname/domain to your WEM-Portal​

Ralph

338 posts

 

2019-08-28 16:12 

0 0   

Moderator

SSL is very well possible for staging environments.

For this you need to use the CNAME staging.wem.io for your own staging hostname in DNS, and create a ticket to ask for a LetsEncrypt SSL-certificate for that specific hostname.

But you do not need to, if you just use hostname {yourportal}.staging.wem.io (then you'll automatically join the wildcard domain and SSL settings).

 

The original post states this:

Your domain hostnames   CNAME target
portal.yourdomain.ext   live.wem.io
testing.yourdomain.ext   staging.wem.io

 

 

Ralph - WEM Xpert since 2011

"I speak to machines with the voice of humanity"
-- Marillion, Man of a thousand faces --

 

 

Re:How to link your own hostname/domain to your WEM-Portal​

2019-08-28 16:35 
last edited:  2019-08-28 16:36

0 0   

Thanks. Are there any costs associated to this Certificate. Looking at their site I only see a donate button, so I suppose this is part of the services WEM is providing. Am I correct?

 

 

 

 

Re:How to link your own hostname/domain to your WEM-Portal​

Ralph

338 posts

 

2019-09-13 18:32 

0 0   

Moderator

LetsEncrypt certificates are free.

WEM Platform/Infra management needs to make some config changes manually. This is currently free of charge, but that might be changed in near future.

 

 

Ralph - WEM Xpert since 2011

"I speak to machines with the voice of humanity"
-- Marillion, Man of a thousand faces --

 

 

Re:How to link your own hostname/domain to your WEM-Portal​

Bert

9 posts

 

2020-05-22 08:50 

0 0   

We would like to use a "catch all" url for our applications, so all our apps can be reached at *.app.domein.nl

 

for example:

application1.app.domein.nl

application2.app.domein.nl

application3.app.domein.nl

etc.

 

for this we can acquire an "catch all"  PKI certificate.

 

What should the DNS entry look like?

 

 

 

 

 

 

 

Re:How to link your own hostname/domain to your WEM-Portal​

Ralph

338 posts

 

2020-05-22 10:03 

0 0   

Moderator

Try a cname record with wildcard in its name.

*.app.domein.nl CNAME live.wem.io.

 

 

Ralph - WEM Xpert since 2011

"I speak to machines with the voice of humanity"
-- Marillion, Man of a thousand faces --

 

 

Back