How to change the hostname / domain

To change the hostname/domain of Dashboard Server you will need to:

• Add appropriate DNS records for the new hostname.
• Re-configure IIS to listen on the new hostname with an appropriate SSL/HTTPS certificate.
• Re-configure the SquaredUp Enterprise Application in Azure Active Directory (AAD).

Add appropriate DNS records for the new hostname

If you deployed Dashboard Server from the Azure Marketplace, the virtual machine (VM) will have been configured with a public IP address. This IP address can be used as part of your DNS record, e.g. an A record pointing to that IP.

To configure a new hostname, create an appropriate DNS record following the instructions from your domain or DNS provider.

Re-configure IIS to listen on the new hostname with an appropriate SSL/HTTPS certificate

To ensure IIS can handle requests for the new hostname, it must be bound to the hostname and an appropriate SSL certificate configured.

• If you are using your own SSL certificate, follow the instructions here: How to configure TLS/SSL (HTTPS)
• If you wish to use a self-signed certificate, Dashboard Server can generate this for you. Follow the instructions here: How to generate a self-signed certificate

Re-configure the SquaredUp Enterprise Application

When the SquaredUp Enterprise Application is first created in Azure Active Directory (AAD), a specific reply/redirect URL is configured which matches the virtual machine's hostname, e.g. squaredup.uksouth.cloudapp.com. If you wish to use a new hostname this must be reconfigured.

1. Browse to portal.azure.com and login.
2. Select Azure Active Directory from the left-hand services menu.
3. Select App registrations.

4. Select your application from the list, it will be named similarly to SquaredUpAzure-XXXXXX. You may need to select the All applications tab to view the full list.

   You can ensure it's the correct application by verifying the Application (Client) ID of the application matches the client-id configured in User\Configuration\openid.json in the Dashboard Server folder.

   Where to find the Dashboard Server folder

   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

5. Select Authentication from the left-hand menu.
6. Under Redirect URIs add your new domain with https://, leaving the Type as Web, e.g. https://server.domain.com/
7. Select Save
8. Browse to the new hostname/domain you have configured. If everything is working as expected, you should be prompted to login.

If you see a Microsoft error indicating the reply URL is not valid after browsing to your new hostname, try again in a few minutes. It can take time for this setting to fully update.