---
title: "Registering a Domain and Return URLs"
slug: "registering-a-domain"
updated: 2025-08-27T09:02:10Z
published: 2025-08-27T09:02:10Z
canonical: "docs.avontus.com/registering-a-domain"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.avontus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Registering a Domain and Return URLs

On the Global Options, you can add a Domain Name so that any username with an email address on this domain can log in via Microsoft Entra ID/Azure Active Directory (AAD).

You can create an Entra ID login on the Microsoft Azure Website. More information can be found here: [Azure Active Directory](https://docs.avontus.com/docs/deploying-quantify-to-azure).

To Register a Domain Name:

1. Select **Tools**
2. Select **Global Options**

![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image(59).png)
3. In the **General** tab, select the green + icon

![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image(60).png)

This will display the **Domain App Registration** dialog

![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image(61).png)

1. Provide the details of the Domain Name. These can be found when you created an Entra ID login on the Azure portal.
2. Click **Verify Login** Note: Click OK to save the domain without verifying the login.

![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image(80).png)
3. Pick an Account from those available

![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image(76).png)
4. Enter the Password, and click **Sign in.**

![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image(63).png)
5. Provide the Enter code sent to your authenticator app.

![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image(78).png)

Your login will be verified.

![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image(81).png)

You can find your domain in the **Global Options**.

![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image(88).png)

You would then have to create or edit a user with their email address on that domain added as their username.

![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image(84).png)

## Return URLs

Active Directory logins utilise OAuth which requires an HTTP listener to be present at the client side in order for the server to communicate with it. For security reasons, the specific listener URLs must be present in the list of registered redirect URIs in the Azure Portal.

1. Edit the App Registration you wish to configure
2. Click Authentication.
3. Add the 5 Urls below. The desktop app just requires [http://localhost](http://localhost/), but Quantify Web requires four URLs, for the different component parts of Quantify Web including the request portal. Add these as listed, replacing [yourserver.com/quantify](http://yourserver.com/quantify) with your specific web URL.

> [!NOTE]
> **Note - the ?returnUrl= part of the path needs to match the subdirectory of your server too. So if your Quantify Web server is hosted at** [**https://yourserver.com/quantify**](https://yourserver.com/quantify)**, ?returnUrl=/quantify is valid. However if you hosted Quantify web under** [**https://yourserver.com**](https://yourserver.com/)**, ?returnUrl=/ would be valid.**

![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image-S1F4OHDP.png)