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


---

# 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://help.aiaibot.com/robot/microsoft-azure-app-registration.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.