Risoluzione dei problemi relativi agli account duplicati in caso di modifica dell'email

Questa guida ti aiuta a risolvere i problemi relativi agli account utente duplicati creati da Looker quando l'indirizzo email principale di un utente esistente cambia nel tuo provider di identità (IdP), ad esempio Azure Active Directory (Azure AD).

Prima di iniziare la risoluzione dei problemi, devi determinare se la tua istanza è un'istanza di Looker (originale) (ospitata o self-hosted) o un'istanza di Looker (Google Cloud core), perché supportano opzioni di unione degli utenti diverse:

  • Looker (originale): supporta le credenziali di email e password locali. Questa opzione ti consente di unire gli utenti in base alla corrispondenza delle email quando gli identificatori IdP univoci cambiano.
  • Looker (Google Cloud core): non supporta l'accesso con email e password locali o credenziali email. Per questo motivo, non puoi unire gli utenti utilizzando l'opzione delle credenziali email e password in Looker (Google Cloud core).

Istanze di Looker (originale)

Utilizza la seguente struttura decisionale per risolvere i problemi relativi alle modifiche delle email nelle istanze di Looker (originale):

Le sezioni seguenti descrivono in modo più dettagliato gli scenari nella struttura.

Configurare le impostazioni del provider di identità

Per evitare account duplicati quando gli indirizzi email degli utenti cambiano, puoi configurare l'IdP in modo che affermi un identificatore univoco immutabile:

  1. Nell'IdP (ad esempio Azure AD), trova le impostazioni di mappatura dell'identificatore univoco (ad esempio, l'attributo Identificatore utente univoco (ID nome) per SAML o l'attestazione sub per OIDC).
  2. Configura questo attributo in modo che venga mappato a un attributo utente immutabile (ad esempio un ID dipendente o un UUID del database) anziché a un indirizzo email modificabile.
  3. Salva le configurazioni. Poiché l'identificatore univoco rimane costante quando l'indirizzo email cambia, Looker riconosce l'utente esistente e aggiorna automaticamente la sua email al successivo accesso senza creare un account duplicato.

Evitare i duplicati

Se utilizzi un indirizzo email modificabile come identificatore univoco in Looker (originale) e non puoi modificarlo in un attributo immutabile, devi seguire questi passaggi per configurare Looker in modo che unisca gli utenti in base alla corrispondenza delle email:

  1. Nel pannello Amministrazione di Looker, vai ad Amministrazione > SAML o Amministrazione > OpenID Connect.
  2. Vai all'opzione Unisci utenti utilizzando e seleziona la casella Email/password di Looker.
  3. Prima che l'utente acceda con il nuovo indirizzo email, devi creare una credenziale email di Looker nel suo account utente esistente che corrisponda al nuovo indirizzo email. Utilizza l'endpoint API Looker create_user_credentials_email: POST /api/4.0/users/<var>USER_ID</var>/credentials_email Specifica il nuovo indirizzo email nel corpo della richiesta.
  4. Chiedi all'utente di accedere. Looker farà corrispondere la nuova email dichiarata dall'IdP alla credenziale email precreata e unirà gli account.

Liberare spazio dai duplicati

Se l'indirizzo email è già stato modificato e sono presenti account utente duplicati, segui questi passaggi per pulire e unire gli account:

  1. Nel pannello Amministrazione di Looker, vai ad Amministrazione > Utenti e identifica l'account originale dell'utente e l'account duplicato.
  2. Determina se l'account duplicato contiene contenuti o pianificazioni generati dall'utente che devi conservare. In caso affermativo, segui i passaggi descritti nella sezione Eseguire la migrazione dei contenuti duplicati.
  3. Nelle impostazioni SAML o OIDC di Looker, verifica che l'opzione Unisci utenti utilizzando abbia Email/password di Looker attivata.
  4. Elimina l'account utente duplicato.
  5. Nell'API Looker, crea una credenziale email di Looker nell' account utente originale che utilizzi il nuovo indirizzo email: POST /api/4.0/users/<var>USER_ID</var>/credentials_email
  6. Chiedi all'utente di accedere utilizzando SAML o OIDC. Looker unirà le credenziali di accesso all'account utente originale.

Eseguire la migrazione dei contenuti duplicati

Se l'account duplicato contiene contenuti generati dall'utente, elementi della cartella personale, Look, dashboard o pianificazioni, puoi eseguirne la migrazione all'account originale prima di eliminare il duplicato:

  1. Utilizza l'API Looker per recuperare l'elenco dei contenuti e delle pianificazioni associati all'ID utente duplicato.
  2. Chiama gli endpoint di aggiornamento (ad esempio update_dashboard, update_look o update_schedule_plan) per modificare il proprietario di queste risorse con l'ID utente originale.
  3. In alternativa, puoi utilizzare strumenti come Looker open-source Admin Power Pack per eseguire migrazioni collettive del contenuto dell'utente.
  4. Una volta trasferiti i contenuti, procedi con l'eliminazione dell'account utente duplicato.

Istanze di Looker (Google Cloud core)

Looker (Google Cloud core) non supporta le credenziali email o l'unione di email e password. Utilizza la seguente struttura decisionale per gestire le modifiche delle email in Looker (Google Cloud core):

Le sezioni seguenti descrivono in modo più dettagliato gli scenari nella struttura.

Passaggi precedenti alla migrazione

Se ti stai preparando a eseguire la migrazione da un'istanza di Looker (originale) a Looker (Google Cloud core), devi seguire questi passaggi per convertire prima gli utenti in un metodo di autenticazione supportato da Core (ad esempio Google OAuth):

  1. Attiva Google OAuth nell'istanza di Looker (originale).
  2. Attiva l'opzione Unisci utenti utilizzando con Email/password di Looker attivata nelle impostazioni di Google OAuth.
  3. Chiedi a tutti gli utenti di accedere utilizzando Google OAuth nell'istanza di Looker (originale) per unire i propri account prima della migrazione.
  4. Esegui la migrazione a Looker (Google Cloud core).

Passaggi successivi alla migrazione

Se la migrazione a Looker (Google Cloud core) è stata completata e sono ancora presenti account duplicati, esegui una delle seguenti attività:

  • Se l'istanza di Looker (originale) è ancora accessibile: contatta Google Cloud l'assistenza per ripristinare l'istanza, esegui i passaggi di unione di Google OAuth nell'istanza originale e poi esegui di nuovo la migrazione a Looker (Google Cloud core).
  • Se l'istanza di Looker (originale) non è accessibile: devi eseguire manualmente la migrazione dei contenuti generati dall'utente utilizzando gli script dell'API Looker dai vecchi account degli utenti ai nuovi account, quindi eliminare i vecchi account o quelli duplicati.

Revisione finale e assistenza

Se non riesci ancora a risolvere il problema degli account duplicati, contatta l'assistenza.