Personen aus Microsoft Entra ID synchronisieren

Verbinden Sie Microsoft Entra ID als Personenquelle, und Polzy liest die Benutzer in Ihrem Verzeichnis über Microsoft Graph nach Zeitplan aus. Neue Benutzer werden Mitglieder dieses Workspace, mit Position, Abteilung, Standort und Führungskraft; Änderungen folgen bei der nächsten Synchronisierung; und Konten, die Sie deaktivieren oder löschen, erhalten keine Umfragen mehr.

Synchronisierung, SCIM oder Single Sign-on?

Polzy verbindet sich auf drei Arten mit Microsoft Entra ID, für drei verschiedene Aufgaben:

• Verzeichnissynchronisierung (dieser Artikel). Polzy liest Benutzer nach Zeitplan aus Entra ID in einen Workspace, mit den Attributen, nach denen Sie Ergebnisse gruppieren — Abteilung, Standort, Position, Führungskraft. Ab Team, eingerichtet von einem Admin des Workspace.
• SCIM-Provisioning. Entra ID überträgt Mitglieder in dem Moment an Ihre Organisation, in dem sie sich ändern, und ordnet sie über Gruppen Workspaces zu. Enterprise, eingerichtet vom Inhaber — siehe SCIM.
• Single Sign-on. Personen melden sich mit ihrem Microsoft-Konto statt mit einem Passwort bei Polzy an. Es bestimmt, wie man sich anmeldet, nicht, wer zu einem Workspace gehört. Enterprise, eingerichtet vom Inhaber — siehe Single Sign-on.

Single Sign-on funktioniert mit jeder der beiden anderen. Verzeichnissynchronisierung und SCIM können nicht in derselben Organisation laufen: Solange sie ein SCIM-Token hat, kann kein Workspace eine Personenquelle verbinden.

Bevor Sie beginnen

Sie brauchen:

• Admin-Rechte im Polzy-Workspace, auf Team oder höher, mit eingeschalteter Personensynchronisierung unter Einstellungen → Allgemein → Was dieser Arbeitsbereich leistet.
• In Microsoft Entra ID eine Rolle, die Anwendungen registrieren darf, und jemanden, der die Administratorzustimmung erteilen darf, etwa einen Cloud Application Administrator.
• Die Felder, nach denen Sie Ergebnisse gruppieren möchten, etwa Abteilung oder Standort, bereits in Polzy angelegt.

Ein Workspace synchronisiert jeweils aus genau einer Quelle. Ist schon eine andere Quelle verbunden, trennen Sie diese zuerst.

Eine App in Microsoft Entra ID registrieren

1. Gehen Sie im Microsoft Entra Admin Center zu Entra ID → App registrations und wählen Sie New registration.
2. Nennen Sie die App Polzy, wählen Sie unter Supported account types die Option Single tenant only und wählen Sie Register. Eine Umleitungsadresse ist nicht nötig.
3. Kopieren Sie auf der Overview der App die Application (client) ID und die Directory (tenant) ID.
4. Öffnen Sie API permissions, wählen Sie Add a permission → Microsoft Graph → Application permissions, markieren Sie User.Read.All und wählen Sie Add permissions.
5. Wählen Sie Grant admin consent for Ihre Organisation und bestätigen Sie. Der Status der Berechtigung wechselt auf erteilt.
6. Öffnen Sie Certificates & secrets → Client secrets → New client secret. Geben Sie eine Beschreibung und eine Ablaufzeit an und wählen Sie Add.
7. Kopieren Sie sofort den Value des Secrets — nicht die Secret ID. Microsoft zeigt ihn nie wieder an.

Secrets gelten höchstens zwei Jahre. Tragen Sie sich einige Wochen vor dem Ablauf eine Erinnerung ein: Läuft es ab, stoppt die Synchronisierung, bis Sie ein neues einfügen. Siehe Microsoft: Register an application, Microsoft: Add an application permission and grant admin consent und Microsoft: Add a client secret.

Entra ID in Polzy verbinden

1. Öffnen Sie Kontakte → Sync und Felder.
2. Suchen Sie Microsoft Entra ID unter Verfügbare Quellen und wählen Sie Verbinden. Ein Bereich mit drei Schritten öffnet sich: Verbindung, Sync-Einstellungen und Feldzuordnung.
3. Fügen Sie die Tenant ID (die Verzeichnis-ID), die Application (Client) ID und den Wert des Client Secret ein.
4. Wählen Sie Verbindung testen. Eine Meldung, die mit Successfully connected to Entra ID beginnt, bedeutet, dass Polzy Ihr Verzeichnis lesen konnte.
5. Wählen Sie Weiter, prüfen Sie die Sync-Einstellungen (siehe unten) und wählen Sie erneut Weiter.
6. Behalten Sie bei Feldzuordnung die Standardzuordnung bei oder schalten Sie Benutzerdefinierte Feldzuordnung ein (siehe unten), und wählen Sie dann Verbinden.

Personen-Sync

Microsoft Entra ID verbinden

Schlüssel werden verschlüsselt und nur in Ihrem Auftrag verwendet.

3 von 3 erforderlich

VerbindungSync-EinstellungenFeldzuordnung

Tenant IDErforderlich

Application (Client) IDErforderlich

Client SecretErforderlich

Im Ruhezustand verschlüsseltAbbrechenVerbindung testenWeiter

Das Secret wird verschlüsselt gespeichert und nur verwendet, um Ihr Verzeichnis zu lesen. Polzy prüft es erneut, wenn Sie Verbinden wählen: Lehnt Microsoft es ab, wird nichts gespeichert.

Sync-Einstellungen

Ein Filter, den Sie selbst schreiben, ersetzt den, der Gäste weglässt. Um Gäste weiter auszuschließen, ergänzen Sie ihn selbst: userType eq 'Member' and department eq 'Sales'. Polzy sendet den Filter unverändert, verwenden Sie also die einfachen Filter, die Microsoft Graph bei Benutzern ohne erweiterte Abfragen akzeptiert, etwa eq, in und startswith. Siehe Microsoft: Use the $filter query parameter.

Die Felder zuordnen

Die Standardzuordnung füllt:

Melden sich Ihre Leute mit einem Namen an, der nicht ihre E-Mail-Adresse ist, schalten Sie Benutzerdefinierte Feldzuordnung ein und ordnen E-Mail stattdessen mail zu. Jede Zeile hat auch einen Wert bei Wenn leer, verwende, der eingetragen wird, wenn Entra ID für diese Person nichts liefert — ein Wert, den es sendet, wird nie überschrieben. Polzy liest von jedem Benutzer diese Attribute: userPrincipalName, mail, givenName, surname, displayName, jobTitle, department, officeLocation, mobilePhone, employeeId, accountEnabled und die Führungskraft.

Personen-Sync

Microsoft Entra ID verbinden

Schlüssel werden verschlüsselt und nur in Ihrem Auftrag verwendet.

VerbindungSync-EinstellungenFeldzuordnung

Benutzerdefinierte Feldzuordnung

Benutzerdefinierte Zuordnung aktiv Wählen Sie aus, welches Feld aus Ihrem HR-System jedes Teilnehmerfeld befüllt.

Kernfelder

TeilnehmerfeldAus der QuelleWenn leer, verwende

E-MailErforderlich

Beispiel: anouk@acme.com, rahul@acme.com

VornameErforderlich

Beispiel: Anouk, Rahul

NachnameErforderlich

Beispiel: Jansen, Mehta

Workspace-Felder

TeilnehmerfeldAus der QuelleWenn leer, verwende

Abteilung

Beispiel: Vertrieb, Betrieb

Im Ruhezustand verschlüsseltZurückVerbinden

Gut zu wissen:

• Nur Felder Ihres Workspace werden gefüllt. Abteilung oder Standort werden nur gespeichert, wenn Ihr Workspace ein Feld mit diesem Namen hat. Legen Sie es mit Feld hinzufügen auf Sync und Felder an und ordnen Sie es dann zu.
• Gruppen. Um Ergebnisse nach einem Feld zu vergleichen, machen Sie es zu einem Liste-Feld und schalten daneben Gruppen ein, in der Tabelle Feldzuordnung. Werte aus Entra ID werden den Optionen des Felds zugeordnet.
• Echte Beispiele. Wählen Sie nach dem Verbinden Einstellungen auf Sync und Felder und öffnen Sie Feldzuordnung erneut: Die Liste stammt dann aus fünf echten Benutzern, jeweils mit einem Beispiel.
• Führungskräfte. Die Führungskraft wird verknüpft, wenn sie ebenfalls in Polzy ist. Ist sie noch nicht da, wird die Verknüpfung bei einer späteren Synchronisierung hergestellt. Dafür muss Berichtslinien im Workspace eingeschaltet sein.

Vorschau und erste Synchronisierung

1. Wählen Sie auf Sync und Felder unter Sync-Verlauf die Option Sync-Vorschau. Polzy ermittelt, was eine Synchronisierung hinzufügen, aktualisieren und deaktivieren würde, ohne etwas zu ändern, und öffnet das Protokoll, in dem das Ergebnis als Vorschau erscheint.
2. Prüfen Sie die Vorschau. Kämen die falschen Personen an, passen Sie die Filterabfrage unter Einstellungen an und sehen Sie sich die Vorschau erneut an.
3. Wählen Sie Jetzt synchronisieren. Das Ergebnis erscheint im Sync-Verlauf.

Sync und Felder

Microsoft Entra IDVerbundenLetzter Sync vor 5 Minuten · läuft stündlich · 431 Personen · 16 GruppenEinstellungenJetzt synchronisieren

Sync-VerlaufSync-Vorschau

Heute, 09:12Erfolgreich2 hinzugefügt · 5 aktualisiert

Heute, 08:10Teilweise1 aktualisiert · 3 übersprungen

Gestern, 16:40Vorschau431 hinzugefügt

Personen werden an ihrer Objekt-ID in Entra ID erkannt und danach an ihrer E-Mail-Adresse. Wen Sie schon von Hand eingeladen hatten, wird also aktualisiert statt doppelt angelegt.

Zeitplan und Sync-Verlauf

Nach der ersten Synchronisierung läuft Polzy von selbst, in der gewählten Häufigkeit, plus oder minus ein paar Minuten. Bittet Microsoft Polzy, langsamer zu werden, wartet es wie verlangt und macht dann weiter. Sync-Verlauf listet die letzten fünf Läufe — Erfolgreich, Teilweise (manche Personen wurden übersprungen oder sind fehlgeschlagen), Fehlgeschlagen oder Vorschau — und Vollständiges Protokoll öffnet jeden Lauf mit jeder Änderung, die er vorgenommen hat.

Schlägt eine Synchronisierung fehl, versucht Polzy es später erneut und wartet jedes Mal länger. Nach drei Fehlschlägen in Folge, oder sofort, wenn Microsoft die Zugangsdaten ablehnt — ein abgelaufenes Secret oder eine zurückgezogene Zustimmung —, zeigt die Quelle Erfordert Aufmerksamkeit, und die Admins werden benachrichtigt. Jetzt synchronisieren funktioniert wieder, sobald die Quelle verbunden ist: Fügen Sie unter Einstellungen ein neues Secret ein und speichern Sie.

Wenn jemand ausscheidet

• Konto deaktiviert. Ein Benutzer, dessen Konto in Entra ID deaktiviert ist, wird bei der nächsten Synchronisierung deaktiviert. Deaktivierte Personen erhalten keine Umfragen und belegen keinen Platz; ihre bisherigen Antworten bleiben erhalten.
• Gelöscht oder außerhalb des Filters. Mit eingeschaltetem Entfernte Benutzer deaktivieren wird auch deaktiviert, wer in dem, was Polzy liest, nicht mehr vorkommt — gelöscht oder nicht mehr passend zu Ihrem Filter.
• In Polzy gesperrt. Wen ein Admin in Polzy gesperrt hat, bleibt gesperrt, was auch immer Entra ID sagt.

Eine Synchronisierung löscht niemanden.

Fehlerbehebung

Gut zu wissen

• Mitglieder, keine Kontakte. Alle aus Entra ID sind Mitglieder: Sie können sich anmelden und belegen jeweils einen Platz. Eine Synchronisierung, die Ihre Plätze überschreiten würde, übernimmt, wer hineinpasst, hält dort an und informiert die Admins — siehe Nutzung und Limits.
• Keine sofortigen Updates. Änderungen kommen bei der nächsten geplanten Synchronisierung an oder wenn Sie Jetzt synchronisieren wählen. Für Änderungen im Moment, in dem sie geschehen, nutzen Sie SCIM.
• Trennen oder entfernen. Unter Einstellungen beendet Trennen die Synchronisierung und behält Einstellungen und Verlauf, sodass Sie später wieder verbinden können; Entfernen löscht die Verbindung. In beiden Fällen bleiben die bereits synchronisierten Personen in Polzy und werden nicht mehr aktualisiert.
• Hilfe nötig? Der Link Polzy fragen im Verbindungsbereich erklärt, wo Sie jeden Wert im Microsoft Entra Admin Center finden.

Nützliche Links

• Microsoft: Register an application — die App-Registrierung und wo ihre IDs stehen.
• Microsoft: Add an application permission and grant admin consent — User.Read.All und die Schaltfläche für die Zustimmung.
• Microsoft: Add a client secret — das Secret erstellen und seinen Wert kopieren.
• Microsoft: Find your tenant ID — falls Sie die Tenant-ID noch einmal brauchen.
• Microsoft: Use the $filter query parameter — eine Filterabfrage schreiben.