---
title: "Benutzer auch an der E-Mail-Adresse erkennen"
description: "Damit Benutzer nach einer Änderung des User Principal Name in Microsoft Entra ID, etwa nach einer Namensänderung oder einem Domainwechsel, weiter mit Bpanda abgeglichen werden: die E-Mail-Adresse im Provisioning als zweites Abgleichsmerkmal (Matching precedence) einrichten."
search:
  tags:
    - "entraid"
    - "provisioning"
    - "upn"
    - "domain"
---

Microsoft Entra ID erkennt einen Benutzer in Bpanda an seinem Benutzernamen, dem **User Principal Name** aus Deinem Tenant. Diesen Benutzernamen kann Bpanda nachträglich nicht ändern. Ändert sich der User Principal Name, findet Entra ID den Benutzer beim nächsten vollständigen Abgleich nicht mehr. Mit der E-Mail-Adresse als zweitem Abgleichsmerkmal findet es ihn trotzdem.

## Wann Du das brauchst [#when-you-need-this]

Die Einstellung brauchst Du, wenn sich in Deinem Tenant der User Principal Name von Benutzern ändern kann, zum Beispiel:

- Ein Benutzer bekommt nach einer Heirat einen neuen Nachnamen, und mit ihm ändern sich User Principal Name und E-Mail-Adresse.
- Dein Unternehmen wechselt seine Domain, und damit ändern sich User Principal Name und E-Mail-Adresse aller Benutzer.

Die neue E-Mail-Adresse übernimmt Bpanda im laufenden Betrieb, den neuen User Principal Name nicht. Beim nächsten vollständigen Abgleich sucht Entra ID den Benutzer unter dem neuen User Principal Name, findet ihn nicht und versucht, ihn neu anzulegen. Das scheitert, weil seine E-Mail-Adresse in Bpanda schon vergeben ist, und der Benutzer wird nicht mehr abgeglichen. Mit der E-Mail-Adresse als zweitem Abgleichsmerkmal sucht Entra ID dort weiter und findet den bestehenden Benutzer.

> **Wichtig:** Jede E-Mail-Adresse muss in Deinem Tenant eindeutig sein.

## Voraussetzungen [#prerequisites]

Du darfst in Entra ID das Provisioning der Bpanda Enterprise App bearbeiten, als **Global Administrator** oder **Application Administrator**.

## So gehst Du vor [#how-to-proceed]

1. Öffne in Entra ID Deine **Bpanda Enterprise App** und wechsle unter **Manage** auf **Provisioning** (deutsch: **Bereitstellung**).
2. Klicke auf **Edit provisioning** (**Bereitstellung bearbeiten**).
3. Klappe **Mappings** auf und öffne **Provision Microsoft Entra ID Users**.
4. Klicke in der Tabelle der Attribute in der Zeile `emails[type eq "work"].value` (Entra-Attribut `mail`) auf **Edit**.
5. Ändere im Dialog **Edit Attribute** diese beiden Werte und bestätige mit **Ok**:

   | Feld | Wert |
   | --- | --- |
   | Match objects using this attribute | `Yes` |
   | Matching precedence | `2` |

6. Klicke auf **Save**. Die Rückfrage meldet, dass daraufhin alle zugewiesenen Benutzer und Gruppen neu synchronisiert werden. Bestätige mit **Yes**.

In der Spalte **Matching precedence** steht danach bei `userName` eine 1 und bei `emails[type eq "work"].value` eine 2.

> **Wichtig:** Mit dem Speichern beginnt ein vollständiger Abgleich, nicht der übliche Zyklus. Je nach Größe Deines Verzeichnisses dauert er entsprechend lange.

Mehr zu Abgleichsmerkmalen beschreibt Microsoft in [Anpassen von Attributzuordnungen](https://learn.microsoft.com/de-de/entra/identity/app-provisioning/customize-application-attributes). Wenn Du Unterstützung brauchst, melde Dich bei uns.

Siehe auch: [Microsoft Entra ID einrichten](/technical-documentation/microsoft-entra-id), [Benutzerabgleich mit Entra ID prüfen](/technical-documentation/microsoft-entra-id/check-entra-id-synchronization)