Hi ,
Welcome to the Support Portal. How can we help?
Follow

Is it possible to create a custom URL for a Workspace 365 environment?

A custom URL for a Workspace environment is possible for both self-hosted and hosted partners. Self-hosted partners can configure this themselves. Partners hosted by us need to submit a Change Request (CR), as we will explain in this article.

Do note that we only direct the requested URL to a specific instance (and environment if requested). We do not manage the domain name and are not in control of any changes concerning the DNS.

We do request the certificate in your stead, but that's only possible due to the CNAME (which is explained later in this article). If the CNAME is removed, the custom URL might not work anymore.

 

Step 1. Request custom URL

If you want your environment to have a custom URL, you can request this via:
Submit a request – CR-03 - Custom URL

You will need to provide us with the following information:

  • New URL. Here you can define what the URL for your Instance/environment will be. Do note that the URL needs to be available for us to request it. Furthermore, your original Instance hostname will always work and this will be an 'extra' URL.
  • Redirect. For most URL's you'd want the URL to redirect to a specific customer. You can define where the URL will lead, for example "Portal.workspace365.net/examplecustomer". The URL the customer uses will be "Portal.workspace365.net/" (so one redirect per URL).


Step 2. Records

DNS record

For us to be able to configure the URL and request the certificate, there needs to be a CNAME within the DNS of the customer that directs to the Partner Record.

Usually the partner record is "Partnername".workspace365.net. If you are not fully sure what it should be, feel free to mention this when submitting the CR.


CAA records

If you have CAA records, make sure the record mentioned above ("Partnername".workspace365.net) is configured in your DNS. Click here for more information on the requirements when using CAA records.

We support the use of CAA records. If you have no CAA records, we can directly request the certificate when you fill in the CR-03 and have the DNS correctly configured.

 

Step 3. Redirect URL

Add the new URL to the Single Sign-On application in Azure AD:

    1. Go to portal.azure.com.
    2. Select the Workspace SSO application.
    3. Go to Authentication.
    4. Add the new Redirect URI, for example: 
      'https://customname.domainname.net/environmentname/OAuth2/HandleAuthorityResponse'

Back to top