Follow

Changes to the domain(s) of Azure AD and/or Workspace 365

 

Overview

There are different kind of scenarios where you need to switch/migrate to a new Azure AD tenant and/or update the domain for the Azure AD tenant. But you can also update domain/url on the workspace side. We describe here into detail what needs to be updated and in which scenarios.

We assume the usage of the following information;

Azure AD tenant Domain UPN Workspace 365 url

w365support.com

a.carter@w365support.com

https://portal.workspace.url/w365support

Back to top

 

Changes on the Azure AD domain(s) 

Change Azure AD tenant with the same domain

If you want to migrate/change the exact same domain and users with UPN (e.g. a.carter@w365support.com) to a new Azure AD tenant, there are a few things to consider/update on the Workspace 365 side. 

  Old New

Azure AD tenant

w365support.onmicrosoft.com

newtenant.onmicrosoft.com

Azure AD domain

w365support.com

w365support.com

UPN

a.carter@w365support.com

a.carter@w365support.com

Workspace 365 url

https://portal.workspace.url/w365support

https://portal.workspace.url/w365support

Steps to take

  1. Make sure you have set up the new Azure AD with all the users present with the same domain and email address (UPN).
  2. Make sure the primary admin* has a mailbox.
  3. RequestEmergencyAdminAccess with the primary admin* in the Workspace.
  4. Follow the email flow and configure Single Sign-On.
  5. After you have setup Single Sign-On remove/cleanup the old Azure AD tenant.

*primary admin is the admin with which the workspace is created/registered.

Back to top

 

Change Azure AD tenant with different domain

If you want to migrate/change a different domain and users with UPN (carter@w365support.com) to a new Azure AD tenant (a.carter@newdomain.com), there are a few things to consider/update on the Workspace 365 side. 

  Old New

Azure AD tenant

w365support.onmicrosoft.com

newtenant.onmicrosoft.com

Azure AD domain

w365support.com

newdomain.com

UPN

a.carter@w365support.com

a.carter@newdomain.com

Workspace 365 url

https://portal.workspace.url/w365support

https://portal.workspace.url/w365support

Steps to take

  1. Make sure you have set up the new Azure AD with all the users present with the new domain and email address (UPN).
  2. UPN of the users needs to be updated in the database. Make sure you have the old domain (e.g. w365support.com), new domain (e.g. newdomain.com) and tenant url (e.g. portal.workspace365.net/w365support) ready.
    1. If you are a Self-hosted partner you could update this yourself or contact us
    2. If you are a Hosted partner please contact us
  3. Make sure the primary admin* has a mailbox.
  4. RequestEmergencyAdminAccess with the primary admin* in the Workspace.
  5. Follow the email flow and configure Single Sign-On.
  6. After you have setup Single Sign-On remove/cleanup the old Azure AD tenant.

*primary admin is the admin with which the workspace is created/registered.

Back to top

 

Same Azure AD tenant with different domain

It is also possible to have your own URL for customers/environments.
Check this article for more information about this.

  Old New

Azure AD tenant

w365support.onmicrosoft.com

w365support.onmicrosoft.com

Azure AD domain

w365support.com

newdomain.com

UPN

a.carter@w365support.com

a.carter@newdomain.com

Workspace 365 url

https://portal.workspace.url/w365support

https://portal.workspace.url/w365support

Steps to take

It is also possible to redirect the new URL directly to the customer environment.

Back to top

 

Changes on the Workspace 365 domains/url

Rename environment url

  Old New

Azure AD tenant

w365support.onmicrosoft.com

w365support.onmicrosoft.com

Azure AD domain

w365support.com

w365support.com

UPN

a.carter@w365support.com

a.carter@w365support.com

Workspace 365 url

https://portal.workspace.url/w365support

https://portal.workspace.url/newtenanturl

Steps to take

  • Log in to portal.azure.com
  • Go to active directory
  • Go to App registrations -> click all applications
  • Select the Workspace 365 SSO app
  • Go to authentication
  • Copy the current redirect URI
  • Paste it and replace the environment name part.

Back to top

 

Rename or adding extra url's to the workspace instance 

  Old New

Azure AD tenant

w365support.onmicrosoft.com

w365support.onmicrosoft.com

Azure AD domain

w365support.com

w365support.com

UPN

a.carter@w365support.com

a.carter@w365support.com

Workspace 365 url

https://portal.workspace.url/w365support

https://new.workspaceinstance.url/w365support

Steps to take

Raise a Renew or update certificate ticket and make sure all the information is added.

Also follow the next step for make sure the SSO app is configured right,

  • Log in to portal.azure.com
  • Go to active directory
  • Go to App registrations -> click all applications
  • Select the Workspace 365 SSO app
  • Go to authentication
  • Copy the current redirect URI
  • Paste it and replace the environment name part.

Back to top