Skip to main content

How to change the Azure Tenant

Documentation Team
  • Updated

How to change the Azure Tenant

To change the Azure Active Directory tenant that your instance of Dashboard Server is using, you will need to modify the tenant-id in the openid.json on the SquaredUp server and then recycle the Dashboard Server application pool.

You will need to connect to your SquaredUp server (How to connect to your SquaredUp server).

Changing the tenant ID

  1. On the SquaredUp server, run notepad as administrator (File, Run, type notepad, and then right-click and select Run as administrator). With notepad in administrator mode, open the following file in the Dashboard Server folder:

    ...\User\Configuration\openid.json

    Name of the Dashboard Server folder

    The name of the Dashboard Server folder is SquaredUpv followed by the product version number.

    Location of the Dashboard Server folder

    If you deployed Dashboard Server via the Azure Marketplace:

    The default location for the Dashboard Server folder is F:\SquaredUpv[Version Number].
    For example, for Dashboard Server Azure Edition v5 the default location is F:\SquaredUpv5 and for v4 F:\SquaredUpv4.

    If you installed Dashboard Server using the installer:

    The default location for the Dashboard Server folder is C:\inetpub\wwwroot\SquaredUpv[Version Number], but a custom location may have been chosen during the installation.
    For example, for Dashboard Server v5 the default folder location is C:\inetpub\wwwroot\SquaredUpv5 and for v4 C:\inetpub\wwwroot\SquaredUpv4

  2. The file will contain four properties:

    tenant-id

    client-id

    client-secret

    redirect-uri

  3. Replace the tenant-id property with the ID of the new tenant you wish to use.

    You can find the tenant ID that the Azure portal is using from the Azure portal Azure Active Directory > Tenant ID and clicking Copy to clipboard.

  4. Remove the values for the client-id and client-secret properties. Your file will look something like this:

    Copy
    {
      "tenant-id": "a3b25c6f-1fa0-4ec1-8cda-6240690e021e",
      "client-id": "",
      "client-secret": "",
      "redirect-uri": "https://squaredup.contoso.com"
    }
  5. Save the file.
  6. In IIS recycle the Dashboard Server application pool for the setting to take effect (How to check and modify the application pool identity).
  7. If you now browse to Dashboard Server, you will be prompted to re-complete the Azure AD Setup with your new tenant. You will need a global admin user to run the setup wizard.