# 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 () öffnen Sie den Bereich *App registrations*. Anschliessend erstellen Sie eine neue App mit einem Klick auf *+ New registration*.

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//settings/msgraphconnect`

Name und Redirect URI der App Registraion

Erstellen Sie die App Registration mit einem Klick auf *Register*. Kopieren Sie auf der nachfolgenden Seite folgende Werte: * *Application (client) ID* * *Directory (tenant) ID*

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

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

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

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

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