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
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
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:
-
- Go to portal.azure.com.
- Select the Workspace SSO application.
- Go to Authentication.
- Add the new Redirect URI, for example:
'https://customname.domainname.net/environmentname/OAuth2/HandleAuthorityResponse'