# Microsoft 365 anbinden

> **Zielgruppe & Rolle**
>
> **Rolle**: IT-Administrator des Kunden (Anwendungsadministrator oder Globaler Administrator) | **Voraussetzung**: im
> Portal das Recht „Kommunikation verwalten“

# Microsoft 365 anbinden

Das Portal spricht Ihr Microsoft 365 über **eine** App-Registrierung in Microsoft Entra ID an. Dieselbe App dient

- den [Postfächern](/knowledge/docs/products/portal/system-config/microsoft-365-mail.md) (Versand, Belegeingang, Ticket- und Bewerbungspostfächer) und
- [Microsoft Teams](/knowledge/docs/products/portal/system-config/microsoft-teams.md) (Anrufe, Besprechungen, Transkripte, Kalender).

Beides ist optional: Ohne Microsoft 365 versendet das Portal E-Mails über die Plattform und empfängt sie über Ihre
Adressen auf der Subdomain Ihres Mandanten. Die App selbst braucht keine Berechtigungen – die vergeben erst die Skripte
für Mail und Teams.

## Einrichtung per PowerShell

Das Skript [Setup-MbcomCloudApp.ps1](/knowledge/docs/products/portal/system-config/Setup-MbcomCloudApp.ps1) legt die App „MBCOM Cloud“ an (oder verwendet eine
vorhandene gleichen Namens) und erstellt ein Client-Secret. Am Ende zeigt es Tenant-ID, Client-ID und Client-Secret.

Voraussetzung ist PowerShell 7 (Windows, macOS oder Linux; mit Nix ohne Installation: `nix shell nixpkgs#powershell`,
dann `pwsh`). Das Modul `Microsoft.Graph.Applications` installiert das Skript bei Bedarf für den aktuellen Benutzer.

```powershell
./Setup-MbcomCloudApp.ps1               # Anmeldung im Browser
./Setup-MbcomCloudApp.ps1 -DeviceCode   # Anmeldung mit Gerätecode, z. B. unter Linux oder per SSH
```

| Parameter | Bedeutung |
|---|---|
| `-DisplayName` | Name der App (Standard „MBCOM Cloud“) |
| `-NewSecret` | neues Client-Secret auch für eine vorhandene App (Laufzeit `-SecretMonths`, Standard 24) |
| `-DeviceCode` | Anmeldung mit Gerätecode (microsoft.com/devicelogin) statt Browserfenster |

> [!WARNING]
> Das Client-Secret wird nur dieses eine Mal angezeigt. Legen Sie es sofort in Ihrem Passwortmanager ab und tragen Sie
> vor Ablauf ein neues ein.

## Einrichtung von Hand

1. **Microsoft Entra Admin Center › App-Registrierungen › Neue Registrierung** (nur dieses Verzeichnis).
2. Unter **Zertifikate & Geheimnisse** ein Client-Secret anlegen.
3. Tenant-ID (Verzeichnis-ID) und Client-ID (Anwendungs-ID) auf der Übersichtsseite der App ablesen.

## Im Portal

**Einstellungen › Integrationen › Microsoft 365**: Tenant-ID, Client-ID und Client-Secret eintragen und **Testen** –
der Test prüft die Anmeldung der App. Optional geben Sie einen **Absender für Benachrichtigungen** an: Dann gehen
E-Mails des Portals (Benachrichtigungen, Aufgaben, Rechnungsversand) von dieser Adresse aus Ihrem Microsoft 365 statt
über die Plattform. Dafür braucht die App die Berechtigungen aus [Postfächer anbinden](/knowledge/docs/products/portal/system-config/microsoft-365-mail.md).

Weiter geht es mit den [Postfächern](/knowledge/docs/products/portal/system-config/microsoft-365-mail.md) und/oder [Microsoft Teams](/knowledge/docs/products/portal/system-config/microsoft-teams.md).
