# Erste Einrichtung (Microsoft Entra)

# Erste Einrichtung (Microsoft Entra)

Sie erhalten von Ihrem ScanDock-Ansprechpartner einen **Start-Link**. Er führt Schritt für Schritt durch die Anbindung an Ihr Microsoft Entra ID (früher Azure AD). Sie benötigen die Rolle **Anwendungsadministrator** oder **Globaler Administrator**.

![Einrichtungsassistent nach Öffnen des Start-Links](https://wiki.skit.center/uploads/images/gallery/2026-10/3516G0iWCsXCLKlB-14-einrichtung.png)
*Einrichtungsassistent nach Öffnen des Start-Links*

## Ablauf
1. **App registrieren:** In [entra.microsoft.com](https://entra.microsoft.com) → *Identität → Anwendungen → App-Registrierungen → Neue Registrierung*. Name z. B. „ScanDock“, *Nur Konten in diesem Organisationsverzeichnis*, Umleitungs-URI (Plattform *Web*) so, wie sie im Assistenten angezeigt wird.
2. **Werte notieren:** *Anwendungs-ID (Client)* und *Verzeichnis-ID (Mandant)* von der Übersichtsseite der App.
3. **Geheimen Clientschlüssel erstellen:** *Zertifikate & Geheimnisse → Neuer geheimer Clientschlüssel*. Den **Wert** (nicht die Geheimnis-ID) kopieren und das **Ablaufdatum** notieren.
4. **Berechtigung prüfen:** *API-Berechtigungen*: *Microsoft Graph → User.Read* (delegiert) ist bei neuen Apps bereits vorhanden. Empfohlen: **Administratorzustimmung erteilen**.
5. **Werte im Assistenten eintragen** und speichern. ScanDock prüft die Angaben sofort bei Microsoft.
6. **Mit Microsoft anmelden.** Klappt die Anmeldung, ist die Einrichtung abgeschlossen und der Start-Link ungültig.

![Entra: Übersichtsseite der App mit Anwendungs-ID und Verzeichnis-ID](https://wiki.skit.center/uploads/images/gallery/2026-10/xtvudocnKGy8KD1m-ms2-red.png)
*Entra: Übersichtsseite der App mit Anwendungs-ID und Verzeichnis-ID*


![Entra: API-Berechtigungen mit „Administratorzustimmung erteilen“](https://wiki.skit.center/uploads/images/gallery/2026-10/zjhcs0iUEvdZUkiq-ms3-red.png)
*Entra: API-Berechtigungen mit „Administratorzustimmung erteilen“*

## Optional: Vorschläge aus dem Verzeichnis
Damit ScanDock beim Freigeben von Geräten Personen und Gruppen aus Ihrem Verzeichnis vorschlägt: *API-Berechtigungen → Berechtigung hinzufügen → Microsoft Graph → **Anwendungsberechtigungen***: `User.Read.All` und `Group.ReadBasic.All`, danach **Administratorzustimmung erteilen**. Ohne diese Berechtigungen geben Sie Anmeldenamen bzw. Gruppen-IDs von Hand ein.

## Nach der Einrichtung
Zunächst haben **alle** angemeldeten Benutzer Admin-Rechte. Legen Sie deshalb gleich eine Admin-Gruppe fest (siehe *Einstellungen*). Den Start-Link verloren oder abgelaufen? Ihr ScanDock-Ansprechpartner stellt einen neuen aus.