How to change the hostname / domain

To change the hostname/domain of SquaredUp DS 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 SquaredUp DS 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, SquaredUp DS 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 SquaredUp DS folder.
   Where to find the SquaredUp folder

   Name of the SquaredUp folder

   Location of the SquaredUp folder

   If you deployed SquaredUp DS via the Azure Marketplace:

   The default location for the SquaredUp folder is F:\SquaredUpv[Version Number].
   For v5 it is F:\SquaredUpv5 and for v4 F:\SquaredUpv4.

   If you installed SquaredUp DS using the installer:

   A custom location may have been chosen during the installation.

   The default location for the SquaredUp folder is C:\inetpub\wwwroot\SquaredUp

   For v5 it 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.