# Authorised Domains

## Authorised Domains Guide

In this article, we explain the process of adding **Authorised Domains** as an **admin** on the admin portal. This will allow you to issue training and phishing campaigns for your users, using email addresses that derive from such domains.

**Prerequisites:**

Before adding a domain, ensure that the requirements below are met:

* You own the domain.
* You can whitelist emails sent to the domain.
* You can add a TXT record for the authorised domain to the DNS server.

&#x20;

**1.** Click on the **drop-down** list to view more than 10 entries in a single page:

![](/files/sn0P4fx9vspq1ucBac6R)

**2.** Click on the following button to create a **new** authorised domain:

![](/files/7exMo4VpG9HzaPtuB5MM)

You should expect the following output:

<div align="left"><img src="/files/K6W0VbkvoSW1Xy7DPCrn" alt=""></div>

**3.** Fill the details required and select **Close** or **Save changes:**

<div align="left"><img src="/files/RVq1cEGA7tVNKPiA3dei" alt=""></div>

**4.** For this example, we will be using a domain called **example.com.**

<div align="left"><img src="/files/zOgzsJNbn50806lYQhj3" alt=""></div>

You should receive a similar prompt with a unique txt record for verification:

![](/files/GCTvJUdhSuGT8Q7DYBLr)

All the information is provided accordingly, but for security purposes, they are hidden in these images.

&#x20;

**5.** As mentioned in the image above, create a **txt record** for your corresponding domain in your **DNS provider.**

&#x20;

**6.** To do that, open a new window and access your **DNS.** From there, select the **Add Record** and set the **Record Type** to **TXT Record:**

![](/files/r8nxP8bMWNDR4DMb2Aoq)

**7.** Then, paste **your unique txt** record in the text box:

![](/files/sEcwuF6764PZhWDsHcDU)

**8.** Click **Add Record** to save it or **Cancel** to step back:

![](/files/ecFrNiq5aUNVVwq98LFo)

**9.** If you have added the record, return to your **Verify domain** prompt in the platform:

![](/files/yLA0lXUGqd92UPQ8quFa)

**10.** If you choose to **Close,** the process will finalise without verifying the domain and you will have to repeat the process of verification again:

![](/files/iHBXfbcAsyPetTPAp1ph)

**11.** From there, you can also edit the soon-to-be authorised domain by clicking on the **pencil** symbol:

![](/files/BzKHV02RdUn0I5TGmpxu)

<div align="left"><img src="/files/s4Sjy8i4iRkQVsDL9ZSM" alt=""></div>

**12.** Alternatively, if you select **Verify Domain,** a confirmation window will appear. Click **OK** to proceed.

![](/files/l3N5Rht6orbzg48H2V1l)

**13.** As we can see, the domain has been authorised as requested!

![](/files/uAkgRXztzZVg9v4k0fLp)

**14.** You can always delete a domain. To do so, click on the **trash can** button:

![](/files/Ht4f3KdpFem1knYwo1XM)

**15.** Select **Delete** to confirm your action or **Cancel** to maintain the domain.

![](/files/X3k5SB2OAwIRYJU3zsEw)

**16.** If you’ve chosen to delete the domain, a confirmation prompt should pop up. Select **OK** to finalise!

![](/files/fBx5Tvn1jvz9wHzMhmJU)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cyberawaresecurity.com/admin-portal/authorised-domains.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
