Bridge Microsoft AD

Informazioni su come risolvere i problemi comuni di Active Directory (AD).

Connessione client bridge Active Directory (AD) a un dominio errato

Quando viene rilevato che il client del bridge AD si connette a un dominio diverso.

Il dominio a cui è connesso il client del bridge AD viene determinato dal dominio dell'utente che ha eseguito l'accesso e che sta installando il client del bridge AD in Windows Server.

Controllare se l'utente è presente nel dominio corretto tramite l'utilità Utenti e computer di Active Directory.

Questo è ciò che viene visualizzato quando DummyUser è presente nel dominio adfs.fed.oracle.com.

Utente presente in ADFS

Impossibile connettersi ad Active Directory sulla porta SSL

Quando non è possibile connettersi ad Active Directory su una porta SSL.

Active Directory deve essere configurato per una connessione SSL. Provare a connettere ldp.exe con Active Directory su SSL. Per verificare la connessione SSL:

  1. Assicurarsi che gli strumenti di supporto Windows siano installati sul computer Active Directory.
    1. Selezionare Start, Tutti i programmi, Strumenti di supporto Windows, quindi Prompt dei comandi.
    2. Avviare lo strumento ldp digitando ldp al prompt dei comandi.
  2. Dalla finestra LDAP, selezionare Connessione | Connessione e fornire il nome host e il numero di porta (636). Selezionare inoltre la casella di controllo SSL.
    1. Se la connessione riesce, viene visualizzata una finestra in cui sono elencate le informazioni relative alla connessione SSL di Active Directory.
    2. Se la connessione non riesce, riavviare il sistema e ripetere questa procedura. Se Active Directory ancora non si connette, completare le istruzioni riportate di seguito per abilitare SSL Abilita LDAP su SSL con un'autorità di certificazione di terze parti.

Notifica di ripristino della connettività al bridge AD

Quando si riceve una notifica di posta elettronica relativa al ripristino della connettività al bridge AD

il server bridge AD potrebbe essere disconnesso a IAM a causa di problemi di connettività di rete. Una volta ripristinata la connettività, viene inviata una notifica di posta elettronica.

Nota

Eventuali problemi di connettività ritardano la sincronizzazione. Tutti i nuovi dati verranno sincronizzati dopo il ripristino della connettività.

Se non si desidera ricevere queste notifiche di posta elettronica, modificare le impostazioni delle notifiche dalla console di amministrazione IAM. Per accedere alle notifiche dell'amministratore, vedere Informazioni sulle notifiche e-mail. È possibile scegliere di attivare le seguenti notifiche di connettività del bridge AD amministratore:

  • Riepilogo del job di sincronizzazione
  • Notificare a un amministratore quando la connettività tra AD, ADbridge e il server del dominio di Identity viene interrotta.
  • Inviare una notifica a un amministratore quando la connettività tra AD, ADbridge, server del dominio di Identity viene ripristinata.
  • Aggiornamento bridge disponibile
  • Comunicare a un amministratore la sincronizzazione tra AD-ADbridge: server del dominio di Identity riuscita.
  • Inviare una notifica a un amministratore quando la sincronizzazione tra AD ADbridge e il server del dominio di Identity non è riuscita.

Il file di log mostra il server LDAP non disponibile

Quando viene visualizzato un errore "Server LDAP non disponibile" nel file di log, attenersi alla procedura riportata di seguito.

L'errore "Server LDAP non disponibile" si verifica quando il server su cui è installato il client bridge AD non è in grado di connettersi al controller del dominio Active Directory tramite LDAP. Verificare che i servizi Active Directory siano in esecuzione (nella lista Servizi Windows, controllare lo stato del servizio Controller dominio AD DS) e quindi provare a connettersi utilizzando l'utility client ldp.exe.

  1. Aprire una finestra di esecuzione da Start.
  2. Immettere ldp per aprire la utility client.
  3. Selezionare la connessione, quindi Nuova connessione. Completare i dettagli, quindi verificare se la connessione riesce.

    Connessione LDAP riuscita

ADBridge Errore non raggiungibile

Quando nell'interfaccia utente viene visualizzato il messaggio "ADBridge Non raggiungibile", utilizzare le informazioni riportate di seguito per determinare la causa.

Il bridge AD dispone di una comunicazione unidirezionale con IAM. Ciò significa che IAM non può comunicare direttamente con il server su cui è installato il bridge AD. Al contrario, il bridge AD esegue frequentemente il polling di IAM per verificare se un'operazione (come la sincronizzazione) è in sospeso. Un messaggio "Bridge AD non raggiungibile" indica che il polling non viene eseguito. Di seguito sono riportati alcuni motivi per cui il ponte AD potrebbe essere irraggiungibile.

  • Il bridge AD non è installato.
  • Il bridge AD è installato ma non è in grado di raggiungere IAM tramite Internet.
    • Controllare le impostazioni di connessione/proxy.
    • Eseguire il test della connettività utilizzando l'interfaccia utente del bridge AD.
  • Il servizio in background è stato arrestato.
    • Avviare Microsoft Active Directory Bridge Service di Identity Cloud Service da Windows Services.
    • Verificare che il tipo di avvio sia automatico.

Dopo aver determinato la causa, riavviare il servizio bridge AD dall'interfaccia utente del bridge AD (pulsanti Arresta/Avvia) o dai servizi Windows.

Nota

Prima di riavviare il servizio bridge AD, eseguire un dump dei thread del processo IAM e condividerlo con il team del supporto Oracle. Vedere 30. Come eseguire il dump dei thread del servizio AD Bridge sul computer AD Bridge?

Affinché il bridge AD funzioni correttamente, è necessario risolvere questo problema. Se non si risolve questo problema, le funzionalità del bridge AD, incluse la sincronizzazione e l'autenticazione delegata, non funzioneranno correttamente.

Nessun messaggio di sincronizzazione attivo

Quando viene visualizzato il messaggio "Nessuna sincronizzazione attiva" nella console, è possibile ignorarlo in tutta sicurezza.

Questo messaggio non indica che si è verificato un problema. Ciò significa che attualmente non è in corso una sincronizzazione. La sincronizzazione successiva verrà eseguita in base all'intervallo impostato per il dominio tramite la pagina di configurazione. Oppure può essere attivato manualmente.

Poiché la sincronizzazione incrementale legge solo i dati modificati, una sincronizzazione può verificarsi molto rapidamente e potrebbe sembrare che il messaggio "Nessuna sincronizzazione attiva" non scompaia mai. È sempre possibile verificare lo stato dell'ultima sincronizzazione dalla pagina Importa per il dominio specifico.

Spostamento del controller di dominio in un altro computer

Quando si sposta il controller di dominio dal computer corrente a un altro computer, è possibile verificare che tutto funzioni correttamente.

Lo spostamento del controller di dominio non dovrebbe causare problemi. Verificare la connettività del controller del dominio utilizzando l'opzione Test della connettività nell'interfaccia utente del bridge AD. Se si verifica un problema nella comunicazione AD Bridge to Domain Controller (LDAP), selezionare Rileva controller dominio per rilevare ulteriormente se il controller dominio è accessibile.

Le schermate seguenti sono esempi di test di connessione riusciti.

Mostra un messaggio di test riuscito

Mostra un messaggio di test riuscito

Aggiornamento delle credenziali nel client bridge AD

Quando si dispone delle credenziali utente per la connessione ad Active Directory, viene descritto come modificare le credenziali nel client Active Directory Bridge.

Dopo AD Bridge versione 21.3.1, questa funzione è disponibile nell'interfaccia utente. Scaricare e installare la versione più recente di AD Bridge.

Nota

Non è necessario disinstallare i file binari correnti. L'installazione li aggiorna. Vedere "Aggiorna credenziali AD" nel seguente screenshot.

Credenziali utente

Gli utenti sincronizzati non possono accedere

Gli utenti sono sincronizzati, ma non sono in grado di eseguire l'accesso.

La causa dipende da quale dei tre metodi di autenticazione (elencati di seguito) viene utilizzato per accedere agli utenti di Active Directory (AD). Questi metodi possono essere modificati utilizzando la pagina di configurazione del dominio. La funzionalità di accesso funziona in modo diverso in ogni caso.

  • Autenticazione locale (impostazione predefinita): dopo la sincronizzazione, gli utenti riceveranno una notifica di benvenuto per modificare la password del proprio account. Devono utilizzare il nome utente (da AD) e la password forniti impostati per accedere al proprio account.

    Azione da eseguire: controllare se l'utente è presente in IAM. La sincronizzazione utente potrebbe non essere riuscita a causa di dati non validi. Se l'utente esiste, provare a reimpostare la password da IAM.

  • Autenticazione delegata: con l'autenticazione locale, è possibile abilitare la delega da AD. Con l'autenticazione delegata, gli utenti non creeranno una password, ma utilizzeranno invece le password AD esistenti per collegarsi. IAM delega l'autenticazione utente AD AD tramite il bridge AD.

    Azione da eseguire: controllare se l'utente è presente in IAM. Inoltre, verificare se l'utente è attivo in AD e che la password non sia scaduta.

  • Autenticazione federata: questo metodo utilizza un servizio di terze parti come Microsoft AD FS per autenticare l'utente.

    Azione da eseguire: controllare la configurazione del servizio di terze parti.

Utilizzare i seguenti screenshot come guida.

Sincronizzato dall'utente Sincronizzato dall'utente

Impossibile abilitare Federation

Quando non è possibile abilitare la federazione, verificare se l'autenticazione delegata è abilitata. Se l'autenticazione delegata è abilitata, l'autenticazione federata non può essere abilitata. Per abilitarlo, effettuare le operazioni riportate di seguito.

  1. Disattiva autenticazione delegata. Fare riferimento alla sezione Disattivazione dell'autenticazione delegata.
  2. In In Integrazioni directory, attivare Autenticazione federata.
  3. Eseguire una migrazione completa.

Impossibile abilitare l'autenticazione delegata

Quando non è possibile abilitare l'autenticazione delegata, effettuare le operazioni riportate di seguito.

  1. Nella pagina Integrazioni directory, assicurarsi di aver scelto Abilita autenticazione locale.
  2. Se è abilitata l'autenticazione federata, disattivarla.
  3. Passare quindi alle impostazioni di autenticazione delegata e attivarla per il dominio desiderato.

Modificare il nome utente in un indirizzo e-mail

Quando si desidera modificare il nome utente di accesso in un indirizzo e-mail, utilizzare il seguente passo:

Mappare l'attributo mail di Active Directory (AD) a User Name nel mapping in entrata IAM come mostrato nello screenshot riportato di seguito.

Modifica mapping attributi

Nota

È possibile configurare sAMAccountName o mail con User Name, ma non entrambi contemporaneamente. Se gli utenti sono già sincronizzati, è necessario attivare un'importazione completa dopo aver modificato questo mapping di attributi. Un'importazione completa sincronizzerà di nuovo tutti gli utenti e questa volta memorizzerà mail da AD a User Name in IAM.

Gli utenti non si sincronizzano in IAM durante il job di sincronizzazione pianificato

Il bridge AD è configurato per sincronizzare gli utenti in IAM. A volte alcuni utenti non si sincronizzano in IAM durante il job di sincronizzazione pianificato, ma verranno sincronizzati se si esegue l'importazione completa.

Il bridge AD registra gli aggiornamenti in Active Directory utilizzando i token di sincronizzazione e un numero di sequenza di aggiornamento (USN). Il valore USN più alto precedente viene memorizzato e ogni volta che viene eseguita una sincronizzazione incrementale. IAM legge i dati dall'USN memorizzato all'USN più recente.

A volte, a causa di fattori come una modifica del controller di dominio, i numeri USN vengono danneggiati (se un nuovo DC ha un grande valore USN rispetto al DC precedente) causando la non sincronizzazione degli utenti. Una sincronizzazione completa non utilizza i token, motivo per cui gli utenti vengono visualizzati in una sincronizzazione completa.

Eseguire l'upgrade al bridge AD più recente per risolvere il problema.

Possibilità di sincronizzazione client bridge AD con Azure AD

Azure AD non è supportato tramite il bridge AD. Il bridge AD funziona solo con le directory attive in locale.

Azure AD è supportato tramite l'integrazione di Microsoft Azure e tramite il connettore Azure AD.

Modifica del mapping attributi

I mapping degli attributi possono essere modificati in qualsiasi momento. Assicurarsi di eseguire una sincronizzazione completa dopo aver salvato la nuova configurazione. I dati utente verranno aggiornati dalla sincronizzazione completa. Se non si esegue una sincronizzazione completa, i dati utente esistenti rimangono gli stessi e i nuovi utenti avranno dati aggiornati.

Nota

Si consiglia di non modificare frequentemente il mapping degli attributi.

La sincronizzazione non viene completata

Quando si nota che la sincronizzazione non è stata completata per giorni, interromperla attenendosi alla procedura riportata di seguito.

  1. Utilizzare l'opzione Interrompi nella pagina Importa per uscire dal job che non risponde. Questa operazione contrassegna la sincronizzazione bloccata precedente come non riuscita.
  2. Sottomettere una nuova sincronizzazione, quindi controllare la connettività da Windows Server (in cui è installato il bridge AD) a IAM.
    Se il problema persiste, contattare il Supporto Oracle.

Elimina notifiche

È possibile eliminare alcune e-mail e notifiche generate automaticamente.

IAM fornisce il controllo completo sulle notifiche. Andare a Impostazioni, quindi a Notifiche. Qui è possibile visualizzare tre schede:

  • Configura: selezionare le notifiche da inviare.
  • Destinatari: per limitare gli utenti a cui inviare le notifiche. Non apportare modifiche qui a meno che non si è sicuri.
  • Modelli e-mail: modificare la struttura o il contenuto dell'e-mail inviata ai clienti.

Trova errori di sincronizzazione

È possibile eseguire il trace degli errori tramite i log del bridge AD. È possibile trovare i file di log dall'interfaccia utente del client del bridge AD. Cercare il nome utente o il nome del gruppo per visualizzare eventuali errori che si sono verificati durante la sincronizzazione.

L'esempio seguente mostra un utente sincronizzato correttamente e un altro in cui la sincronizzazione non è riuscita.

Stato della sincronizzazione

Utenti scollegati

IAM mantiene un mapping di tutti gli utenti AD (identificativo IAM mappato all'identificativo AD). Quando l'utente viene rimosso dalla sincronizzazione attiva a causa, ad esempio, di una nuova condizione di filtro, il record in IAM viene conservato e solo il mapping viene rimosso. La rimozione del mapping si chiama delinking.

Questo caso è diverso dall'eliminazione poiché l'utente non viene eliminato da AD. Se i filtri vengono reimpostati, l'utente verrà di nuovo collegato.

Installazione di più bridge AD

Per conoscere il numero di bridge AD che è possibile installare per il tipo di dominio di Identity in uso, vedere Limiti degli oggetti del dominio di Identity IAM.

È possibile installare un solo bridge sullo stesso computer Windows Server. Per utilizzare High Availability (HA), sono necessari più computer connessi allo stesso dominio AD.

Aggiornamento del client bridge AD

Quando è disponibile una nuova versione del client del bridge AD:

  • Si dovrebbe sempre aggiornare.
  • Assicurarsi di non utilizzare di nuovo la versione corrente. La reinstallazione della versione corrente rimuove il bridge esistente e potrebbe causare errori di autenticazione e sincronizzazione.

Non è necessario disinstallare il bridge AD esistente per eseguire l'upgrade a una versione più recente.

È possibile verificare il numero di versione dall'interfaccia utente del bridge AD.

Versione AD

I dati esistenti non vengono interessati a causa di un upgrade ed è possibile eseguire una sincronizzazione incrementale. Inoltre, la pianificazione della sincronizzazione non verrà interessata e la sincronizzazione successiva verrà eseguita come configurata.

Downgrade del client bridge AD

Si sconsiglia di eseguire il downgrade del client del bridge AD.

Se si decide di eseguire il downgrade del client, è necessario disinstallare il client bridge AD corrente che può comportare un tempo di inattività dei servizi (sincronizzazione, autenticazione delegata e così via).

È quindi possibile installare la versione desiderata.

Utenti/gruppi non sincronizzati

Quando si nota che alcuni utenti o gruppi non vengono sincronizzati, utilizzare queste informazioni per risolverli.

  • Controllare la configurazione OU nella pagina Integrazioni directory. È necessario selezionare le unità organizzative per gruppi e utenti separatamente. Anche se si dispone della stessa unità operativa per gruppi e utenti, selezionarli separatamente. Assicurarsi di salvare la pagina di configurazione dopo aver apportato le modifiche.
  • Confermare il filtro utilizzato in utenti/gruppi nella pagina di configurazione. Utilizzare PowerShell per eseguire il filtro e verificare se gli utenti sono visibili lì.
  • Controllare la connettività di rete dal client del bridge AD a IAM. (Solo se alcuni record non riescono).
  • Controllare il file di log IDBridge ("Visualizza log" dall'interfaccia utente del bridge AD). Cercare un errore nel modo seguente:

    Gruppi non sincronizzati

Abilita log modalità di trace bridge AD

Per abilitare il log della modalità traccia del bridge AD, attenersi alla procedura riportata di seguito.

Nota

La modifica del livello di log NON richiede il riavvio del client del bridge AD.
  1. Andare alla cartella di installazione del bridge AD. La posizione predefinita è: C:\Program Files\Oracle\IDBridge.
  2. Aprire il file log4net.config.
  3. Modificare questa riga <level value="info" /> in <level value="trace" />.
  4. Se si verifica un errore di autorizzazioni, aprire l'editor con privilegi di amministratore. Se si utilizza Blocco note, cercare Blocco note nel menu Start, selezionare a destra e scegliere "Esegui come amministratore", quindi aprire il file di log per apportare modifiche.

Esecuzione dei dump dei thread del servizio bridge AD

Come si esegue un dump di thread del servizio AD Bridge su un computer AD Bridge?

Quando è necessario eseguire un dump dei thread del servizio AD Bridge su un computer AD Bridge, attenersi alla procedura riportata di seguito.

  1. Aprire Task Manager in un computer in cui è installato il file binario del client AD Bridge.
  2. Andare alla scheda Processi.
  3. Cercare il processo denominato "Bridge Microsoft Active Directory di Identity Cloud Service" nella lista dei processi.
  4. Selezionare il processo con il pulsante destro del mouse e selezionare l'opzione Crea file di dump.

    Esempio di dump dei thread 1

  5. Dopo alcuni secondi vengono visualizzate la posizione del dump visualizzato e il nome del file di dump.

    Esempio di dump dei thread 2

Modifica del filtro

Quando si modifica il filtro, utilizzare le informazioni riportate di seguito per assicurarsi che i nuovi utenti e gruppi vengano sincronizzati.

I filtri possono impedire la sincronizzazione di nuovi utenti e gruppi in IAM.

Prima di aggiungere o modificare i filtri, completare i task riportati di seguito.

  • Verificare i filtri eseguendoli con i comandi PowerShell. Assicurarsi che tutti i dati siano inclusi.
  • Eseguire sempre la sincronizzazione completa dopo aver modificato i filtri. In questo modo, tutte le voci ignorate in precedenza verranno sincronizzate. Verrà inoltre eseguito il cleanup dei mapping ridondanti esistenti.
  • Gli utenti/gruppi esistenti non verranno eliminati. Anche se sono fuori filtro, verranno scollegati, ma conservati in IAM.

Richieste di autenticazione delegate non riuscite

Le richieste di autenticazione delegata non riescono quando una di queste è vera:

  • Il client del bridge AD è inattivo
  • Il client del bridge AD NON è in grado di connettersi a IAM
  • Active Directory è inattivo
  • Il client bridge AD è occupato nell'elaborazione di altre richieste di autenticazione delegata

In tutti questi casi, la richiesta di autenticazione non riesce a meno che l'inserimento della password nella cache non sia abilitato e la password sia disponibile nella cache.

Per i primi tre scenari, il servizio verrà recuperato quando il problema di sistema/connettività a valle viene risolto.

Per l'ultimo scenario, il servizio verrà recuperato dopo la riduzione del caricamento della richiesta concorrente.

La password utilizzata per l'autenticazione delegata

Se ho abilitato l'inserimento delle password nella cache, quale password verrà utilizzata per l'autenticazione delegata:

  • La password inserita nella cache
  • La password memorizzata in Active Directory

In primo luogo, la password memorizzata in Active Directory viene utilizzata per autenticare gli utenti. La richiesta passa a Active Directory tramite il bridge AD e la password memorizzata IAM non viene utilizzata.

Tuttavia, se la richiesta non riesce a causa di uno dei motivi indicati in Richieste di autenticazione delegate non riuscite, verrà eseguito un tentativo di autenticazione utilizzando la password memorizzata nella cache.

È possibile abilitare o disabilitare il fallback alla password inserita nella cache IAM dalle impostazioni di autenticazione delegata.

Password memorizzate nella cache in IAM

Funzionamento dell'inserimento delle password nella cache in IAM.

Se l'inserimento della password nella cache è abilitato e non è presente una password memorizzata nella cache o se la password della cache è scaduta, la volta successiva in cui l'utente esegue correttamente il login al sistema la password viene memorizzata.

La scadenza predefinita per una password è di cinque giorni, ma è possibile modificarla nelle impostazioni di autenticazione delegata.

Installazione del bridge AD non riuscita

Quando l'installazione del bridge AD non riesce, ciò è dovuto a:

  • Superamento del numero di domini di Identity per il tipo di dominio di Identity.
  • È stato superato il numero di client del bridge AD per il tipo di dominio di Identity.

Per conoscere il numero di domini di Identity o bridge AD che è possibile installare per il tipo di dominio di Identity in uso, vedere Limiti degli oggetti del dominio di Identity IAM.

File di log dell'installazione

Quando hai avuto problemi con l'installazione, usa i file di log per identificare cosa è andato storto.

Installer registra dalla cartella %TEMP% del computer Windows in cui è stata tentata l'installazione. Dal menu Start di Windows, aprire il prompt di esecuzione e immettere %TEMP%.

Verranno visualizzati tre file per installazione:

  • Identity_Cloud_Service_Microsoft_Active_Directory_Bridge_<timestamp>.log
  • Identity_Cloud_Service_Microsoft_Active_Directory_Bridge_<timestamp>_Internal.log
  • Identity_Cloud_Service_Microsoft_Active_Directory_Bridge_<timestamp>_ad_id_bridge.msi.log

Quando si invia una richiesta di servizio, fornire le versioni più recenti di questi file al supporto Oracle.

Impossibile visualizzare gli attributi AD

Quando non è possibile visualizzare gli attributi AD nella sezione Configura mapping attributi, utilizzare le informazioni riportate di seguito per risolvere la situazione.

Si noti che l'input Attributo utente directory non è una selezione a discesa, ma una casella di testo suggestiva. È possibile scrivere qualsiasi cosa nella casella di testo, anche se tale attributo non è presente nel proprio AD.

Assicurarsi di digitare esattamente l'attributo corretto (compresi i caratteri maiuscoli e minuscoli) nella modalità di visualizzazione del nome dell'attributo in Active Directory.

Se non si esegue questa operazione, non verrà visualizzato un errore durante il salvataggio del mapping, ma la sincronizzazione AD verrà interessata e non sarà in grado di estrarre questo attributo da Active Directory.

Il suggerimento si basa solo sugli attributi AD utilizzati più di frequente. Gli attributi IAM sono una selezione a discesa e verranno visualizzati tutti gli attributi.

Fare riferimento ai seguenti screenshot:

  1. Scrivere il nome dell'attributo, ad esempio someAdAttribute.

    Configurare l'esempio di mapping di attributi 1

  2. Salvare la riga.

    Configurare l'esempio di mapping di attributi 2

Dominio configurato parzialmente

Quando viene visualizzato che il dominio è parzialmente configurato e l'opzione di importazione è disabilitata, attenersi alla procedura riportata di seguito.

Un dominio parzialmente configurato indica che non è stata selezionata alcuna unità operativa nella pagina di configurazione. Qualsiasi selezione OU per utenti, gruppi o entrambi è necessaria per la configurazione del dominio per la sincronizzazione. Fino ad allora non c'è nulla da importare e l'importazione rimarrà disabilitata.

  1. Selezionare il dominio per aprirlo.
  2. Selezionare un'unità organizzativa da cui recuperare utenti e gruppi.
    Nota

    La selezione dell'unità organizzativa di utenti e gruppi deve essere effettuata separatamente.
  3. È possibile scegliere un set diverso di unità organizzative per utenti e gruppi.
  4. Qualsiasi selezione di unità organizzative per un utente o un gruppo abilita l'opzione di importazione.

    Opzione Importa disabilitata