# Postfächer aus Microsoft 365 anbinden

> **Zielgruppe & Rolle**
>
> **Rolle**: IT-Administrator des Kunden (Globaler Administrator, oder Administrator für privilegierte Rollen und
> Exchange-Administrator) | **Voraussetzung**: [Microsoft 365 angebunden](/knowledge/docs/products/portal/system-config/microsoft-365.md)

# Postfächer aus Microsoft 365 anbinden

Mit Postfächern aus Microsoft 365 kann das Portal

- Benachrichtigungen von Ihrer eigenen Adresse senden (Absender in **Integrationen › Microsoft 365**),
- Rechnungen aus einem Ordner einlesen (Belegeingang),
- Tickets und Bewerbungen aus einem Ordner empfangen und von dieser Adresse beantworten.

Eine App bedient beliebig viele Postfächer. Ohne Postfach aus Microsoft 365 nutzt das Portal die Plattform und Ihre
Adressen auf der Subdomain Ihres Mandanten.

| Berechtigung (Anwendung, mit Administratorzustimmung) | Wofür |
|---|---|
| `Mail.Send` | Senden (Benachrichtigungen, Antworten auf Tickets und Bewerbungen) |
| `Mail.ReadWrite` | Ordner lesen und E-Mails nach der Verarbeitung verschieben |

Beide Berechtigungen gelten zunächst für **alle** Postfächer Ihrer Organisation. Wir empfehlen, die App per
**Application Access Policy** auf die Postfächer zu beschränken, die das Portal nutzt.

## Einrichtung per PowerShell

Das Skript [Setup-MbcomCloudMail.ps1](/knowledge/docs/products/portal/system-config/Setup-MbcomCloudMail.ps1) vergibt die Berechtigungen samt Zustimmung und – mit
`-Mailboxes` – legt die ausgeblendete E-Mail-aktivierte Sicherheitsgruppe „MBCOM Cloud Postfaecher“ an, nimmt die
Postfächer auf und beschränkt die App auf diese Gruppe. Wiederholen Sie es, um weitere Postfächer hinzuzufügen.

```powershell
./Setup-MbcomCloudMail.ps1 -AppId <Client-ID> -Mailboxes service@firma.de,rechnungen@firma.de
./Setup-MbcomCloudMail.ps1 -AppId <Client-ID> -Mailboxes noreply@firma.de -SendOnly   # nur senden
```

| Parameter | Bedeutung |
|---|---|
| `-AppId` | Client-ID der App; ohne sie sucht das Skript die App „MBCOM Cloud“ |
| `-Mailboxes` | Postfächer, die das Portal nutzen darf (ohne: keine Beschränkung, mit Warnung) |
| `-SendOnly` | nur `Mail.Send`, kein Lesen von Ordnern |
| `-DeviceCode` | Anmeldung mit Gerätecode statt Browserfenster |

Zusätzlich zu `Microsoft.Graph.Applications` braucht es das Modul `ExchangeOnlineManagement`; beide installiert das
Skript bei Bedarf.

> [!NOTE]
> Berechtigungen und Policy können bis zu einer Stunde brauchen, bis sie greifen. Bis dahin meldet die Prüfung eines
> Postfachs „Access is denied“.

## Einrichtung von Hand

1. **App-Registrierung › API-Berechtigungen › Microsoft Graph › Anwendungsberechtigungen**: `Mail.Send` und
   `Mail.ReadWrite` hinzufügen, dann **Administratorzustimmung erteilen**.
2. In der Exchange-Online-PowerShell (`Connect-ExchangeOnline`):

   ```powershell
   $grp = New-DistributionGroup -Name "MBCOM Cloud Postfaecher" -Alias mbcom-cloud-mailboxes -Type Security
   Add-DistributionGroupMember -Identity $grp.Identity -Member service@firma.de
   New-ApplicationAccessPolicy -AppId <Client-ID> -PolicyScopeGroupId $grp.PrimarySmtpAddress -AccessRight RestrictAccess
   Test-ApplicationAccessPolicy -Identity service@firma.de -AppId <Client-ID>   # erwartet: Granted
   ```

## Im Portal

**Einstellungen › Integrationen › Mail**: je Postfach Adresse, Verwendung (Belegeingang, Tickets oder Bewerbungen) und
Ordner eintragen und **Prüfen**. Dieselbe Adresse kann mehrfach vorkommen, wenn verschiedene Ordner verschiedenen Zwecken
dienen.
