L'importazione degli utenti da Microsoft Entra ID si basa su un processo di identificazione progressiva che utilizza il Object ID, l'email e il nome utente per determinare se un utente deve essere creato o aggiornato sulla piattaforma.
Identificazione degli utenti
Microsoft Entra ID assegna a ogni utente un identificatore unico chiamato Object ID.
Questo identificatore permette di:
- Identificare in modo univoco ogni utente
- Mantenere la coerenza tra Microsoft Entra ID e SMARTFENSE
Processo di importazione
Durante ogni sincronizzazione, la piattaforma segue il seguente flusso per ogni utente ricevuto da Microsoft Entra ID:
- Si consulta il Object ID dell'utente
- Si verifica se esiste un utente in SMARTFENSE con quell'Object ID
- Se esiste → si aggiorna quell'utente
- Se non esiste, si consulta l'email
- Se esiste → si aggiorna quell'utente
- Se non esiste, si determina il nome utente secondo la configurazione di importazione di
utenti per verificare come si desidera impostare il nome utente dell'utente.- Mail Nickname
- Prima parte dell'UPN (User Principal Name) fino al simbolo chiocciola
- UPN (User Principal Name) completo
- Si verifica se esiste già un utente con quel nome utente
- Se esiste → si aggiorna quell'utente
- Se non si trova corrispondenza → si crea un nuovo utente
Modifica degli utenti
Object ID
Quando un utente viene identificato tramite email o nome utente:
- Gli viene assegnato il suo Object ID in SMARTFENSE
- Alle sincronizzazioni future sarà identificato tramite questo valore
Questo garantisce una corrispondenza univoca con Microsoft Entra ID.
Pulire l'Object ID dall'istanza
Un amministratore può ripristinare manualmente l'Object ID assegnato a un utente da Utenti e gruppi > Utenti > Modifica Utente, tramite il pulsante Pulisci posizionato accanto al campo Object ID di Microsoft Entra ID.
Passaggi:
- Accedere a Utenti e gruppi > Utenti.
- Cercare e selezionare l'utente.
- Nella schermata Modifica Utente, individuare il campo Object ID di Microsoft Entra ID.
- Fare clic su Pulisci.
- Salvare le modifiche.
Il pulsante Pulisci elimina solo il valore memorizzato in SMARTFENSE. Non modifica né elimina l'Object ID dell'utente in Microsoft Entra ID.
Dopo aver pulito questo valore, la sincronizzazione successiva non troverà l'utente tramite l'Object ID e ripeterà il processo di importazione descritto sopra: prima tramite email, poi tramite nome utente. Una volta identificato tramite uno di questi due criteri, gli verrà assegnato automaticamente un nuovo Object ID.
Utilizzare questa opzione quando l'utente deve essere nuovamente identificato tramite email o nome utente, ad esempio se è stato ricreato in Microsoft Entra ID con un Object ID diverso da quello registrato in SMARTFENSE.
Gli utenti sincronizzati da Google Workspace dispongono di un campo equivalente, ID Google, con il proprio pulsante Pulisci nella stessa schermata Modifica Utente.
Nome utente
Il nome utente viene definito secondo la configurazione selezionata:
- Mail Nickname
- Prima parte dell'UPN (User Principal Name) fino al simbolo @
- UPN completo
Ad ogni sincronizzazione:
- Si verifica se il nome utente corrisponde alla configurazione attuale
- Se non corrisponde, si tenta di aggiornare
Conflitti di nome utente
Alcune configurazioni possono generare nomi duplicati, specialmente:
- Mail Nickname
- Prima parte dell'UPN
Questo può causare che:
- Il nuovo nome utente sia già in uso da un altro utente
- In tal caso:
- I dati dell'utente vengono aggiornati
- Ma il nome utente non viene modificato
Nome e cognome
I dati del nome vengono ottenuti da Microsoft Entra ID:
- Nome: givenName
- Cognome: surname
Se questi campi sono vuoti:
- Si utilizza il campo display_name per completare l'informazione
Considerazioni
- Il Object ID è l'identificatore principale nelle sincronizzazioni successive
- L'email e il nome utente sono utilizzati come meccanismi di riserva
- La configurazione del nome utente influisce sulla coerenza dei dati
- Alcuni attributi in Microsoft Entra ID potrebbero non essere unici
💡 Migliori pratiche
- Utilizzare configurazioni di nome utente che garantiscano unicità (es. UPN completo)
- Verificare che i campi givenName e surname siano correttamente compilati
- Evitare configurazioni che possano generare duplicati
- Validare la struttura prima di effettuare sincronizzazioni massive
- Prima di pulire l'Object ID di un utente, verificare che la sua email e il suo nome utente corrispondano esattamente a quelli della directory, per evitare la creazione di un utente duplicato.