Probleme mit doppelten Konten nach einer E‑Mail-Adressänderung beheben

In dieser Anleitung erfahren Sie, wie Sie Probleme mit doppelten Nutzerkonten beheben, die von Looker erstellt werden, wenn sich die primäre E‑Mail-Adresse eines vorhandenen Nutzers in Ihrem Identitätsanbieter (IdP) ändert, z. B. in Azure Active Directory (Azure AD).

Bevor Sie mit der Fehlerbehebung beginnen, müssen Sie feststellen, ob es sich bei Ihrer Instanz um eine Looker-Instanz (Original) (gehostet oder selbst gehostet) oder eine Looker-Instanz (Google Cloud Core) handelt, da sie unterschiedliche Optionen zum Zusammenführen von Nutzern unterstützen:

  • Looker (Original): Unterstützt lokale E‑Mail- und Passwort anmeldedaten. Mit dieser Option können Sie Nutzer per E‑Mail-Abgleich zusammenführen, wenn sich eindeutige IdP-Kennungen ändern.
  • Looker (Google Cloud Core): Unterstützt keine lokale Anmeldung per E‑Mail-Adresse und Passwort oder E‑Mail-Anmeldedaten. Daher können Sie Nutzer in Looker (Google Cloud Core) nicht mit der Option für E‑Mail- und Passwortanmeldedaten zusammenführen.

Looker-Instanzen (Original)

Verwenden Sie den folgenden Entscheidungsbaum, um Probleme mit E‑Mail-Änderungen in Looker-Instanzen (Original) zu beheben:

In den folgenden Abschnitten werden die Szenarien im Baum näher beschrieben.

Einstellungen des Identitätsanbieters konfigurieren

Um doppelte Konten zu vermeiden, wenn sich die E‑Mail-Adressen von Nutzern ändern, können Sie Ihren IdP so konfigurieren, dass er eine unveränderliche eindeutige Kennung bestätigt:

  1. Suchen Sie in Ihrem IdP (z. B. Azure AD) die Einstellungen für die Zuordnung eindeutiger Kennungen (z. B. das Attribut Unique User Identifier (Name ID) für SAML oder den Anspruch sub für OIDC).
  2. Konfigurieren Sie dieses Attribut so, dass es einem unveränderlichen Nutzerattribut (z. B. einer Mitarbeiternummer oder einer Datenbank-UUID) und nicht einer veränderlichen E‑Mail-Adresse zugeordnet wird.
  3. Speichern Sie die Konfigurationen. Da die eindeutige Kennung bei einer Änderung der E‑Mail-Adresse konstant bleibt, erkennt Looker den vorhandenen Nutzer und aktualisiert seine E‑Mail-Adresse bei der nächsten Anmeldung automatisch, ohne ein doppeltes Konto zu erstellen.

Doppelte Konten verhindern

Wenn Sie in Looker (Original) eine veränderliche E‑Mail-Adresse als eindeutige Kennung verwenden und diese nicht in ein unveränderliches Attribut ändern können, müssen Sie Looker so konfigurieren, dass Nutzer anhand des E‑Mail-Abgleichs zusammengeführt werden. Gehen Sie dazu so vor:

  1. Rufen Sie in der Looker-Admin-Konsole Admin > SAML oder Admin > OpenID Connect auf.
  2. Gehen Sie zur Option Merge Users Using (Nutzer zusammenführen mit) und wählen Sie das Kästchen für Looker Email/Password (Looker-E‑Mail-Adresse/Passwort) aus.
  3. Bevor sich der Nutzer mit seiner neuen E‑Mail-Adresse anmeldet, müssen Sie in seinem bestehenden Nutzerkonto Looker-E‑Mail-Anmeldedaten erstellen, die mit der neuen E‑Mail-Adresse übereinstimmen. Verwenden Sie den Looker API-Endpunkt create_user_credentials_email: POST /api/4.0/users/<var>USER_ID</var>/credentials_email Geben Sie die neue E‑Mail-Adresse im Anfragetext an.
  4. Lassen Sie den Nutzer sich anmelden. Looker gleicht die vom IdP deklarierte neue E‑Mail-Adresse mit den zuvor erstellten E‑Mail-Anmeldedaten ab und führt die Konten zusammen.

Doppelte Konten bereinigen

Wenn sich die E‑Mail-Adresse bereits geändert hat und doppelte Nutzerkonten vorhanden sind, gehen Sie so vor, um die Konten zu bereinigen und zusammenzuführen:

  1. Rufen Sie in der Looker-Admin-Konsole Admin > Users (Nutzer) auf und suchen Sie das ursprüngliche Konto und das doppelte Konto des Nutzers.
  2. Prüfen Sie, ob das doppelte Konto von Nutzern erstellte Inhalte oder Zeitpläne enthält, die Sie behalten müssen. Wenn ja, folgen Sie der Anleitung im Abschnitt Doppelte Inhalte migrieren.
  3. Prüfen Sie in den Looker-SAML- oder OIDC-Einstellungen, ob für Merge Users Using (Nutzer zusammenführen mit) die Option Looker Email/Password (Looker-E‑Mail-Adresse/Passwort) aktiviert ist.
  4. Löschen Sie das doppelte Nutzerkonto.
  5. Erstellen Sie in der Looker API im ursprünglichen Nutzerkonto Looker-E‑Mail-Anmeldedaten mit der neuen E‑Mail-Adresse: POST /api/4.0/users/<var>USER_ID</var>/credentials_email
  6. Weisen Sie den Nutzer an, sich über SAML oder OIDC anzumelden. Looker führt die Anmeldedaten mit dem ursprünglichen Nutzerkonto zusammen.

Duplicate Content migrieren

Wenn das doppelte Konto von Nutzern erstellte Inhalte, Elemente im persönlichen Ordner, Looks, Dashboards oder Zeitpläne enthält, können Sie diese in das ursprüngliche Konto migrieren, bevor Sie das doppelte Konto löschen:

  1. Rufen Sie mit der Looker API die Liste der Inhalte und Zeitpläne ab, die mit der doppelten Nutzer-ID verknüpft sind.
  2. Rufen Sie die Endpunkte für die Aktualisierung auf (z. B. update_dashboard, update_look oder update_schedule_plan), um den Inhaber dieser Ressourcen in die ursprüngliche Nutzer-ID zu ändern.
  3. Alternativ können Sie Tools wie das Looker Admin Power Pack (Open Source) verwenden, um Nutzerinhalte in großen Mengen zu migrieren.
  4. Nachdem Sie die Inhalte übertragen haben, löschen Sie das doppelte Nutzerkonto.

Looker-Instanzen (Google Cloud Core)

Looker (Google Cloud Core) unterstützt keine E‑Mail-Anmeldedaten oder das Zusammenführen von E‑Mail-Adressen und Passwörtern. Verwenden Sie den folgenden Entscheidungsbaum, um E‑Mail-Änderungen in Looker (Google Cloud Core) zu verarbeiten:

In den folgenden Abschnitten werden die Szenarien im Baum näher beschrieben.

Schritte vor der Migration

Wenn Sie eine Migration von einer Looker-Instanz (Original) zu Looker (Google Cloud Core) vorbereiten, müssen Sie zuerst die Nutzer in eine von Core unterstützte Authentifizierungsmethode (z. B. Google OAuth) umwandeln. Gehen Sie dazu so vor:

  1. Aktivieren Sie Google OAuth in Ihrer Looker-Instanz (Original).
  2. Aktivieren Sie unter den Google OAuth-Einstellungen die Option Merge Users Using (Nutzer zusammenführen mit) und aktivieren Sie Looker Email/Password (Looker-E‑Mail-Adresse/Passwort).
  3. Weisen Sie alle Nutzer an, sich in der Looker-Instanz (Original) mit Google OAuth anzumelden, um ihre Konten vor der Migration zusammenzuführen.
  4. Führen Sie die Migration zu Looker (Google Cloud Core) durch.

Schritte nach der Migration

Wenn die Migration zu Looker (Google Cloud Core) abgeschlossen ist und weiterhin doppelte Konten vorhanden sind, führen Sie eine der folgenden Aufgaben aus:

  • Wenn die Looker-Instanz (Original) noch zugänglich ist: Wenden Sie sich an den Support, um die Instanz wiederherzustellen, führen Sie die Schritte zum Zusammenführen von Google OAuth in der ursprünglichen Instanz aus und führen Sie die Migration zu Looker (Google Cloud Core) noch einmal durch. Google Cloud
  • Wenn die Looker-Instanz (Original) nicht zugänglich ist: Sie müssen von Nutzern erstellte Inhalte manuell mit Looker API-Skripts aus den alten Konten der Nutzer in ihre neuen Konten migrieren und dann die alten oder doppelten Konten löschen.

Letzte Überprüfung und Support

Wenn Sie das Problem mit doppelten Konten weiterhin nicht beheben können, wenden Sie sich an den Support.