> For the complete documentation index, see [llms.txt](https://docs.intranet.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.intranet.ai/acknowledgement/requirements.md).

# 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: 

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

In self-hosted mode: 

* 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. 

In SaaS mode: 

* 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.