> For the complete documentation index, see [llms.txt](https://hub.equipme.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hub.equipme.io/pro/dokumentation/automation/connectors/microsoft-entra-id.md).

# Microsoft Entra ID

Microsoft Entra ID Connector für Provider: Benutzer, Gruppen, Lizenzen und Geräte in Kunden-Tenants aus Flows verwalten – mit Equipme Pro kombiniert.

**Pfad:** „Automation“ → „Workflows“ → Flow-Designer → Modul **„Microsoft Entra ID“**

Mit dem **Microsoft Entra ID Connector** verwaltest du als Provider die Microsoft-Verzeichnisse deiner Kunden aus [Workflows](https://hub.equipme.io/pro/dokumentation/automation/workflows.md) heraus. Kombiniert mit dem Modul [„Equipme Pro“](https://hub.equipme.io/pro/dokumentation/automation/connectors/equipme-pro.md) legst du Konten für neue Kundenmitarbeiter an, vergibst Lizenzen und Gruppen, sperrst Zugänge beim Offboarding und prüfst die Kunden-Tenants regelmäßig auf Auffälligkeiten – als wiederholbare Managed-Service-Leistung.

## Wofür?

* **Onboarding als Service:** Neuer Kundenmitarbeiter in Pro → Konto im Tenant des Kunden anlegen, Gruppen und Lizenzen zuweisen, Temporary Access Pass erzeugen.
* **Offboarding als Service:** Kundenmitarbeiter scheidet aus → Konto sperren, Sitzungen beenden, Lizenzen freigeben.
* **Lizenzmanagement für Kunden:** Freie und ungenutzte Lizenzen je Kunde prüfen und Nachbestellungen oder Kündigungen anstoßen – z. B. als Grundlage für Angebote und Abrechnung in Pro.
* **Sicherheits-Checks je Kunde:** ablaufende Client Secrets, Administratoren ohne MFA, Gruppen ohne Besitzer oder veraltete Geräte erkennen und als Ticket oder Bericht an den Kunden melden.
* **Geräte in Kunden-Tenants:** Veraltete Geräte erkennen und deaktivieren, bevor sie ausgetauscht werden.

## Voraussetzungen

* Das freigeschaltete [Automation-Modul](https://hub.equipme.io/pro/dokumentation/automation.md)
* Je Kunde ein **Microsoft-Konto im Tenant des Kunden** mit passenden Administratorrollen – je nach Aktion z. B. „Benutzeradministrator“, „Gruppenadministrator“, „Lizenzadministrator“, „Authentifizierungsadministrator“, „Anwendungsadministrator“ oder „Administrator für privilegierte Rollen“
* Die Zustimmung zu den angeforderten Berechtigungen im jeweiligen Kunden-Tenant (bei den meisten Berechtigungen ist eine **Administratorzustimmung** durch den Kunden nötig)
* Für Beispiele mit Kundendaten eine Verbindung des [equipme Connectors](https://hub.equipme.io/pro/dokumentation/automation/connectors/equipme-pro.md) mit dem Modul „Equipme Pro“

## Verbindung einrichten

1. Im Flow-Designer eine Komponente des Moduls „Microsoft Entra ID“ auf die Arbeitsfläche ziehen (z. B. *GetUser*).
2. **Connect account** klicken.
3. Im Anmeldefenster von Microsoft mit dem Konto **im Tenant des Kunden** anmelden und die angeforderten Berechtigungen bestätigen.
4. Die Verbindung erscheint mit dem Namen des Microsoft-Kontos unter **„Accounts“**. Gib ihr einen eindeutigen Namen mit dem Kundennamen.
5. Für jeden weiteren Kunden eine eigene Verbindung anlegen.

{% hint style="warning" %}
Eine Verbindung gilt immer für **genau einen Tenant** – den des angemeldeten Kontos. In jeder Komponente wählst du die Verbindung fest aus. Für mehrere Kunden legst du deshalb je Kunde einen eigenen Flow an (z. B. per „Clone“ aus einer Vorlage) und wählst darin die Verbindung des Kunden.
{% endhint %}

{% hint style="info" %}
Die Module „Microsoft Entra ID“, „Microsoft Intune“ und „Microsoft Dynamics 365 Business Central“ nutzen dieselbe Microsoft-Anmeldung. Alle Aktionen laufen mit den Rechten des angemeldeten Kontos. Verwende im Kunden-Tenant ein eigenes Dienstkonto für die Automation, damit Änderungen im Überwachungsprotokoll des Kunden klar zuzuordnen sind.
{% endhint %}

## Grundbegriffe

* **User ID / Group ID / Device ID / Application ID:** Die meisten Aktionen erwarten die Objekt-ID aus Entra ID. Bei Benutzern akzeptieren viele Aktionen auch den Benutzerprinzipalnamen (UPN, z. B. `max.muster@kunde.de`). IDs übergibst du aus vorherigen Schritten, etwa aus dem Ergebnis von *AddUser* oder *ListUsers*.
* **Listen-Aktionen und „Output Type“:** Alle *List…*-Aktionen lesen alle Einträge und bieten **Output Type** („All items at once“, „One item at a time“, „First item only“, „Store to CSV file“) – wie beim [equipme Connector](https://hub.equipme.io/pro/dokumentation/automation/connectors/equipme-pro.md#grundkonzepte).
* **OData Filter:** *ListUsers*, *ListGroups* und *ListDevices* lassen sich mit einem Filterausdruck eingrenzen, z. B. `accountEnabled eq false` oder `startswith(displayName,'Test')`.
* **Monitor-Komponenten:** Die *Monitor…*-Aktionen prüfen das Verzeichnis und haben zwei Ausgänge: **findings** (es gibt Treffer, mit Liste und lesbarer Zusammenfassung) und **ok** (alles in Ordnung). So brauchst du keinen zusätzlichen Filter im Flow.

## Trigger

| Komponente         | Löst aus, wenn …                                                                           | Einstellungen                                                                                                                                                                                                     |
| ------------------ | ------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| NewUser            | ein neuer Benutzer angelegt wird (regelmäßige Abfrage)                                     | After                                                                                                                                                                                                             |
| NewGroupMember     | ein Mitglied zu einer Gruppe hinzugefügt wird (Benachrichtigung durch Microsoft)           | Group                                                                                                                                                                                                             |
| RemovedGroupMember | ein Mitglied aus einer Gruppe entfernt wird (Benachrichtigung durch Microsoft)             | Group                                                                                                                                                                                                             |
| SecretExpiring     | ein Client Secret oder Zertifikat einer App-Registrierung bald abläuft oder abgelaufen ist | Check Interval („Every Minute“, „Hourly“, „Daily“, „Weekly“; Standard „Daily“), Warning Threshold (Days, Standard 60), Escalation Threshold (Days, Standard 30), Include Certificates, Include Service Principals |

*SecretExpiring* hat drei Ausgänge: **warning** (unter der Warnschwelle), **escalation** (unter der Eskalationsschwelle) und **overdue** (abgelaufen). Jedes Geheimnis wird pro Stufe nur einmal gemeldet.

## Aktionen

### Benutzer

| Komponente                      | Zweck                                                    | Wichtige Optionen                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ------------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| AddUser                         | Benutzer anlegen                                         | Pflicht: User principal name, Mail nickname, Display name, Force change password, Account enabled. Optional: Password (leer = zufälliges Passwort, Länge über „Password length“), Given name, Surname, Job title, Company name, Department, Employee ID, Employee type, Employee hire date, Employee leave date time, Office location, Adresse, Business phone, Mobile phone, Mail, Other mails, Usage Location (Ländercode, nötig für Lizenzen), Manager ID, Age group, User type („Member“, „Guest“) |
| UpdateUser                      | Benutzer ändern                                          | User ID; dieselben Felder wie *AddUser*; „Account enabled“ aus sperrt die Anmeldung                                                                                                                                                                                                                                                                                                                                                                                                                    |
| GetUser                         | Benutzer lesen                                           | User ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ListUsers                       | Benutzer auflisten                                       | OData Filter, After, Output Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| DeleteUser                      | Benutzer löschen (landet für 30 Tage im Papierkorb)      | User ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| GetUserManager / SetUserManager | Vorgesetzten lesen bzw. setzen                           | User ID, Manager ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ResetUserPassword               | Passwort zurücksetzen                                    | User ID, Password (leer = zufällig, Länge Standard 10), Force Change Password Next Sign In                                                                                                                                                                                                                                                                                                                                                                                                             |
| RevokeUserSessions              | Alle Anmeldesitzungen beenden – wichtig beim Offboarding | User ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| InviteGuest                     | Externe Person als Gast einladen                         | Email Address, Display Name, Redirect URL, Send Invitation Message, Message Body; liefert den Einlösungslink                                                                                                                                                                                                                                                                                                                                                                                           |
| ListUserDevices                 | Geräte eines Benutzers auflisten                         | User ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |

### Gruppen

| Komponente                                         | Zweck                                                                   | Wichtige Optionen                                                                                                                                                                                                                                    |
| -------------------------------------------------- | ----------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| AddGroup                                           | Gruppe anlegen                                                          | Pflicht: Display name, Mail enabled, Mail nickname, Security enabled. Optional: Description, Group types, Visibility („Private“, „Public“, „Hidden Membership“), Membership Rule (dynamische Gruppe, z. B. `user.department -eq "Sales"`), Owner IDs |
| UpdateGroup                                        | Gruppe ändern                                                           | Group ID, Display name, Description, Mail nickname, Unique name                                                                                                                                                                                      |
| GetGroup / ListGroups / DeleteGroup                | Gruppe lesen, auflisten, löschen                                        | Group ID; *ListGroups* mit OData Filter, After, Output Type                                                                                                                                                                                          |
| AddGroupMembers                                    | Mitglieder hinzufügen                                                   | Group ID, Users (kommagetrennte Liste von Benutzer-IDs)                                                                                                                                                                                              |
| RemoveGroupMember                                  | Mitglied entfernen                                                      | Group, Member (Auswahlliste oder ID)                                                                                                                                                                                                                 |
| ListGroupMembers                                   | Mitglieder auflisten                                                    | Group ID, Output Type                                                                                                                                                                                                                                |
| CheckGroupMembership                               | Prüfen, ob ein Benutzer Mitglied ist (auch über verschachtelte Gruppen) | User ID, Group IDs (bis zu 20)                                                                                                                                                                                                                       |
| ListGroupOwners / AddGroupOwner / RemoveGroupOwner | Besitzer verwalten                                                      | Group ID, User ID                                                                                                                                                                                                                                    |

### Lizenzen und Rollen

| Komponente                                | Zweck                                                             | Wichtige Optionen                |
| ----------------------------------------- | ----------------------------------------------------------------- | -------------------------------- |
| ListLicenses                              | Lizenzen (SKUs) des Tenants mit verbrauchten und freien Einheiten | Output Type                      |
| AssignLicense                             | Lizenzen zuweisen (der Benutzer braucht eine Usage Location)      | User ID, SKU IDs, Disabled Plans |
| RemoveLicense                             | Lizenzen entfernen                                                | User ID, SKU IDs                 |
| ListDirectoryRoles                        | Aktivierte Verzeichnisrollen auflisten                            | Output Type                      |
| AssignDirectoryRole / RemoveDirectoryRole | Verzeichnisrolle zuweisen bzw. entfernen                          | Role Template ID, User ID        |

### Authentifizierung

| Komponente                 | Zweck                                                    | Wichtige Optionen                                                      |
| -------------------------- | -------------------------------------------------------- | ---------------------------------------------------------------------- |
| CreateTemporaryAccessPass  | Temporary Access Pass für die passwortlose Erstanmeldung | User ID, Lifetime (Minutes, Standard 60), Usable Once, Start Date Time |
| ListAuthenticationMethods  | Registrierte MFA-Methoden eines Benutzers                | User ID, Output Type                                                   |
| DeleteAuthenticationMethod | MFA-Methode entfernen (z. B. bei verlorenem Smartphone)  | User ID, Method Type, Method ID                                        |

### Geräte

| Komponente              | Zweck                                                       | Wichtige Optionen                                                                                                  |
| ----------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| AddDevice               | Gerät anlegen                                               | Account enabled, Display name, Operating system, Operating system version, Profile type, Extension attributes 1–15 |
| UpdateDevice            | Gerät ändern                                                | Device ID sowie dieselben Felder wie *AddDevice*                                                                   |
| GetDevice / ListDevices | Gerät lesen bzw. auflisten                                  | *ListDevices* mit OData Filter, Stale For (Days), Output Type                                                      |
| DisableDevice           | Gerät deaktivieren, sodass es sich nicht mehr anmelden kann | Device ID                                                                                                          |
| DeleteDevice            | Gerät löschen                                               | Device ID                                                                                                          |

### App-Registrierungen

| Komponente                                                | Zweck                                                           | Wichtige Optionen                                                                                  |
| --------------------------------------------------------- | --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| ListApplications / GetApplication                         | App-Registrierungen auflisten bzw. lesen                        | Display Name Filter; Application ID oder App ID (Client ID)                                        |
| CreateApplication / UpdateApplication / DeleteApplication | App-Registrierung anlegen, ändern, löschen                      | Display Name, Sign In Audience, Notes, Tags, Identifier URIs, Redirect URIs                        |
| AddApplicationOwner                                       | Besitzer hinzufügen                                             | Application ID, User ID                                                                            |
| AddApplicationSecret                                      | Client Secret erzeugen (der Wert wird nur einmal zurückgegeben) | Application ID, Secret Name, Valid For (Months, Standard 24) oder End Date Time                    |
| RemoveApplicationSecret                                   | Client Secret entfernen                                         | Application ID, Key ID                                                                             |
| AddApplicationCertificate                                 | Öffentliches Zertifikat hochladen                               | Application ID, Certificate, Certificate Name                                                      |
| ListExpiringSecrets                                       | Secrets und Zertifikate mit Restlaufzeit auflisten              | Max Remaining Days, Include Certificates, Include Expired, Include Service Principals, Output Type |

### Papierkorb

| Komponente         | Zweck                                                                     | Wichtige Optionen                                          |
| ------------------ | ------------------------------------------------------------------------- | ---------------------------------------------------------- |
| ListDeletedItems   | Gelöschte Benutzer, Gruppen oder App-Registrierungen (30 Tage aufbewahrt) | Type („Users“, „Groups“, „App Registrations“), Output Type |
| RestoreDeletedItem | Gelöschtes Objekt wiederherstellen                                        | Object ID                                                  |

### Prüfungen (Monitor)

Alle Monitor-Aktionen haben die Ausgänge **findings** und **ok** und eignen sich für einen Zeitplan (Scheduler).

| Komponente                | Prüft …                                                                                      | Einstellungen (Standard)                                                                   |
| ------------------------- | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| MonitorInactiveUsers      | Konten ohne Anmeldung seit X Tagen oder ohne jede Anmeldung                                  | Inactive For (Days) (90), Include Guests, Include Never Signed In                          |
| MonitorStaleGuests        | Gäste mit nicht eingelöster Einladung oder lange inaktiv                                     | Pending Invitation For (Days) (30), Inactive For (Days) (90)                               |
| MonitorUnusedLicenses     | Gesperrte Konten, die noch Lizenzen haben                                                    | –                                                                                          |
| MonitorLicenseStock       | Lizenzen mit zu wenigen freien Einheiten                                                     | Minimum Available Units (5), SKU Filter                                                    |
| MonitorGroupsWithoutOwner | Gruppen ohne Besitzer                                                                        | Security Groups Only                                                                       |
| MonitorExpiringGroups     | Microsoft-365-Gruppen (auch Teams), die bald ablaufen                                        | Expires Within (Days) (30)                                                                 |
| MonitorDeletedItemsPurge  | Gelöschte Objekte kurz vor dem endgültigen Löschen                                           | Warn Before Purge (Days) (7)                                                               |
| MonitorAdminRoles         | Zu viele globale Administratoren, gesperrte Konten mit Rollen, Gäste mit Administratorrollen | Max Global Administrators (5)                                                              |
| MonitorMfaRegistration    | Benutzer ohne registrierte MFA-Methode                                                       | Admins Only                                                                                |
| MonitorSyncHealth         | Ob die Synchronisierung aus dem lokalen Verzeichnis (Entra Connect) noch läuft               | Max Sync Age (Hours) (2)                                                                   |
| MonitorStaleDevices       | Geräte ohne Anmeldung seit X Tagen                                                           | Stale For (Days) (90), Include Disabled                                                    |
| MonitorNewApplications    | Neu angelegte App-Registrierungen                                                            | Created Within (Days) (7)                                                                  |
| MonitorExpiringSecrets    | Bald ablaufende Secrets und Zertifikate                                                      | Max Remaining Days (30), Include Certificates, Include Service Principals, Include Expired |

## Beispiele

### Onboarding für Kundenmitarbeiter

1. **Scheduler** – stündlich (je Kunde ein Flow mit der Verbindung zu dessen Tenant).
2. **Equipme Pro › List Customer Employees** – Mitarbeiter des Kunden lesen und per **Filter** neue Mitarbeiter ohne gespeicherte Entra-ID-Kennung auswählen (*Get Customer Employee Metadata*).
3. **Microsoft Entra ID › AddUser** – UPN, Name, Abteilung, Position, Employee ID, Usage Location des Kunden.
4. **Microsoft Entra ID › AddGroupMembers** und **AssignLicense** – Standardgruppen und Lizenzen des Kunden.
5. **Microsoft Entra ID › CreateTemporaryAccessPass** – Pass für die erste Anmeldung.
6. **Equipme Pro › Update Customer Employee Metadata** – Entra-ID-Objekt-ID am Kundenmitarbeiter speichern.

### Lizenz-Check als Managed Service

1. **Scheduler** – monatlich, je Kunde.
2. **Microsoft Entra ID › MonitorLicenseStock** – Ausgang **findings**, wenn freie Lizenzen unter die Mindestmenge fallen.
3. **Microsoft Entra ID › MonitorUnusedLicenses** – gesperrte Konten mit Lizenzen.
4. **Email › Send Email** – Bericht an den Account Manager des Kunden (aus *Get Customer* in Equipme Pro) bzw. Ticket im eigenen PSA anlegen.
5. Optional: **Equipme Pro › Add Billing Item** – Prüfung als Leistung („Fee“) abrechnen.

### Ablaufende App-Geheimnisse beim Kunden

1. **Microsoft Entra ID › SecretExpiring** – Check Interval „Daily“, Warning Threshold 60, Escalation Threshold 30, Include Service Principals an.
2. Ausgang **warning** → **Email › Send Email** an den Kunden.
3. Ausgang **escalation** und **overdue** → Ticket im eigenen PSA oder Helpdesk mit hoher Priorität.

## Hinweise und Grenzen

* *NewUser* fragt Entra ID in regelmäßigen Abständen ab. Setze „After“ beim ersten Start, sonst meldet der erste Durchlauf auch bereits vorhandene Benutzer.
* *NewGroupMember* und *RemovedGroupMember* reagieren auf Benachrichtigungen von Microsoft und lösen in der Regel innerhalb weniger Sekunden aus.
* *AddUser* gibt das gesetzte bzw. erzeugte Passwort im Ergebnis zurück. Gib es nur über sichere Wege weiter; für die Erstanmeldung ist ein Temporary Access Pass meist die bessere Wahl.
* Lizenzen lassen sich nur zuweisen, wenn der Benutzer eine **Usage Location** hat.
* Die Monitor-Komponenten zu Anmeldungen und MFA (*MonitorInactiveUsers*, *MonitorStaleGuests*, *MonitorMfaRegistration*) benötigen Zugriff auf Anmeldeinformationen; dafür setzt Microsoft in der Regel eine Entra-ID-P1- oder -P2-Lizenz voraus.
* Beim Testen eines Flows schreiben die ändernden Aktionen nichts nach Entra ID, sondern liefern Beispieldaten.
* Gelöschte Objekte bleiben 30 Tage im Papierkorb und lassen sich in dieser Zeit mit *RestoreDeletedItem* wiederherstellen.

## Fehlersuche

| Problem                                                                                  | Ursache / Lösung                                                                                                    |
| ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| Anmeldung bei „Connect account“ schlägt fehl oder verlangt eine Administratorgenehmigung | Ein globaler Administrator des Kunden muss den angeforderten Berechtigungen im Kunden-Tenant zustimmen.             |
| Fehler „Insufficient privileges“ / „Forbidden“                                           | Dem angemeldeten Konto fehlt die nötige Entra-ID-Rolle für diese Aktion, oder die Berechtigung wurde nicht erteilt. |
| *AssignLicense* schlägt fehl                                                             | Der Benutzer hat keine Usage Location, oder es sind keine freien Lizenzen vorhanden (*ListLicenses* prüfen).        |
| *AddUser* meldet einen Konflikt                                                          | Der UPN oder Mail nickname ist bereits vergeben, auch im Papierkorb (*ListDeletedItems*).                           |
| *NewUser* löst nicht aus                                                                 | Flow gestartet? „After“ liegt in der Zukunft?                                                                       |
| Gruppen-Trigger lösen nicht aus                                                          | Die gewählte Gruppe prüfen; nach Änderungen am Konto den Flow neu starten.                                          |

Protokolle jeder Ausführung findest du unter **„Insights“**. Für Unterstützung wende dich an den [Support](https://hub.equipme.io/pro/dokumentation/help/support.md).

## Häufige Fragen

**Kann ein Flow mehrere Kunden-Tenants bedienen?**

Nein, jede Komponente nutzt eine fest gewählte Verbindung und damit genau einen Tenant. Lege je Kunde einen Flow an; mit „Clone“ kopierst du eine Vorlage schnell.

**Wie ordne ich Konten den Kundenmitarbeitern in Pro zu?**

Speichere die Entra-ID-Objekt-ID nach *AddUser* als Metadatum am Kundenmitarbeiter (*Update Customer Employee Metadata*). Spätere Flows finden das Konto damit eindeutig.

**Wie finde ich die SKU IDs für&#x20;*****AssignLicense*****?**

Mit *ListLicenses* im jeweiligen Kunden-Tenant. Das Ergebnis enthält zu jeder Lizenz die SKU-ID, die Bezeichnung und die freien Einheiten.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://hub.equipme.io/pro/dokumentation/automation/connectors/microsoft-entra-id.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
