> For the complete documentation index, see [llms.txt](https://help.aiaibot.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aiaibot.com/robot/microsoft-azure-app-registration.md).

# Microsoft Azure App Registration

Eine Microsoft Azure App Registration ist nötig, wenn Sie E-Mails aus einem Exchange Online-Postfach abrufen oder versenden möchten. Dafür wird ein Microsoft Graph API Connector benötigt. Bevor Sie diesen Connector im Robot erstellen können, muss die App Registration eingerichtet werden.

## 1. Neue App registrieren

Im Azure Portal (<https://portal.azure.com>) öffnen Sie den Bereich *App registrations*. Anschliessend erstellen Sie eine neue App mit einem Klick auf *+ New registration*.

<figure><img src="/files/VDoxdzIjAeYWU4cuSqG8" alt="" width="242"><figcaption><p>Neue App Registration</p></figcaption></figure>

Geben Sie einen Namen ein und wählen Sie *Single Tenant* unter *Supported account types* aus.

Unter *Redirect URI (optional)* wählen Sie *Web* aus und geben Ihre Redirect URI ein. Die Redirect URI enthält die aiaibot Projekt ID und hat folgendes Format: `https://app.aiaibot.com/robot/<aiaibot-project-id>/settings/msgraphconnect`

<figure><img src="/files/K25NWlbCIALzhgBpQvam" alt="" width="563"><figcaption><p>Name und Redirect URI der App Registraion</p></figcaption></figure>

Erstellen Sie die App Registration mit einem Klick auf *Register*.

Kopieren Sie auf der nachfolgenden Seite folgende Werte:

* *Application (client) ID*
* *Directory (tenant) ID*

<figure><img src="/files/kaPkKBJ8YXyufCRfqyEh" alt="" width="328"><figcaption><p>Client und Tenant ID</p></figcaption></figure>

## 2. Client Secret erstellen

Klicken Sie auf *Clients & secrets* und anschliessend auf *+ New client secret* um ein neues Secret für die App zu erstellen.

<figure><img src="/files/KGWnachOsZaQIZZKOMe1" alt="" width="563"><figcaption><p>Certificates &#x26; secrets</p></figcaption></figure>

Vergeben Sie eine Beschreibung und wählen Sie aus, wie lange das Secret gültig sein soll.

{% hint style="warning" %}
Um sicherzustellen, dass das Abrufen oder Versenden von E-Mails ohne Unterbrechung funktioniert, muss ein neues Secret **rechtzeitig vor Ablauf** bei aiaibot hinterlegt werden.
{% endhint %}

Kopieren Sie das Secret in der Spalte *Value*.

<figure><img src="/files/7gMXiidpONhJUc0y3MUh" alt="" width="375"><figcaption><p>Kopieren des Secrets</p></figcaption></figure>

## 3. API Permissions vergeben

Klicken Sie auf *API permissions* um die gewünschten Berechtigungen zu vergeben.

<figure><img src="/files/YSXIfCRM9Ix0xd6tpG1A" alt="" width="375"><figcaption><p>API permission</p></figcaption></figure>

Anschliessend klicken Sie auf *+ Add a permission* und wählen dann *Microsoft Graph* aus.

<figure><img src="/files/voMAn1kXORJGdQymaPv0" alt="" width="375"><figcaption><p>Permissions für Microsoft Graph</p></figcaption></figure>

### Benötigte Permissions

Je nachdem, wofür Sie die App in aiaibot nutzen möchten, müssen unterschiedliche Permissions festgelegt werden. Diese müssen immer als **Delegated Permissions** vergeben werden. Wenn Sie die App sowohl zum Abrufen als auch zum Versenden von E-Mails verwenden möchten, vergeben Sie alle dafür benötigten Berechtigungen. Es ist nicht erforderlich, dafür separate Apps zu registrieren.

#### Abrufen einer Mailbox

* `offline_access`
* `User.Read`
* `Mail.ReadWrite`

#### Abrufen einer Shared-Mailbox

* `offline_access`
* `User.Read`
* `Mail.ReadWrite.Shared`

#### Versenden von E-Mails

* `offline_access`
* `User.Read`
* `Mail.Send`

#### Versenden vonE-Mails über eine Shared-Mailbox

* `offline_access`
* `User.Read`
* `Mail.Send.Shared`

Klicken Sie auf *Add permissions* um die ausgewählten Permissions zu übernehmen.

<figure><img src="/files/iqCaDqXyjN1fml8NsnTn" alt="" width="375"><figcaption><p>Mail.Send und Mail.Send.Shared Permission</p></figcaption></figure>