# Requirements

To set up the Acknowledgement system, **the following resources are needed**:

1. [An Azure Subscription to host the SQL database;](#id-1.-azure-subscription)
2. [A dedicated Resource Group;](#id-2.-resource-group)
3. [Registration of the Microsoft.Sql provider in the relevant subscription;](#id-3.-azure-provider)
4. [The Microsoft Graph Mail.Send permission for email notifications;](#id-4.-permission-to-send-email-notifications)
5. [A mail-enabled service account;](#id-5.-mail-enabled-service-account)
6. [A security group to manage access to the Power BI report](#id-6.-security-group-for-power-bi-report-data-access).

Further details are provided in the sections below.

### 1. Azure Subscription

An Azure subscription is required to host the **SQL database** for the tool.

In SaaS mode:&#x20;

* The Customer can use an existing Azure subscription.
* Alternatively, a resold Azure subscription can be provided by intranet.ai.

In self-hosted mode:&#x20;

* The installation is performed on an Azure subscription already in use for the other intranet.ai resources.

Please refer to the [Hosting options](https://docs.intranet.ai/acknowledgement/hosting-options) section for further details.

### 2. Resource Group

A dedicated Resource Group is required.&#x20;

In SaaS mode:&#x20;

* The Resource Group is usually created by the Customer within the dedicated Azure subscription. The **Contributor** role needs to be assigned to the intranet.ai service account on the Resource Group.

In self-hosted mode:

* The Resource Group already exists.

Please refer to the [Hosting options](https://docs.intranet.ai/acknowledgement/hosting-options) section for further details.

### 3. Azure Provider

The **Microsoft.Sql** provider must be registered in the subscription associated with the Resource Group.

### 4. Permission to Send Email Notifications

The **Mail.Send** application permission for **Graph** is required.

In SaaS mode:

* The permission should be configured on the **intranet.ai** app registration.

In self-hosted mode:

* The permission should be configured on the **intranet.ai-managed** app registration.

### 5. Mail-Enabled Service Account

A mail-enabled service account is needed to send **acknowledgment request emails**. This user will appear as the **sender** of such emails. It can be an existing account, or an account created specifically for this purpose.

### 6. Security Group for Power BI Report Data Access

Access to the **Power BI report** is managed through a security group.

The group can be **created by intranet.ai**. In this case:

* **Permission to create security groups** is required.
* The **list of users** to be included should be provided to intranet.ai.

The group is usually named Acknowledgement Report Readers.

Alternatively, the group can be **created by the Customer**, who will then **share the group name** with intranet.ai.

In both cases, **the customer can independently manage the group at any time**, adding or removing members as needed.


---

# 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.intranet.ai/acknowledgement/requirements.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.
