Come funziona la sincronizzazione
Microsoft Entra ID, in precedenza Azure Active Directory o Azure AD, sincronizza gli utenti con Sage Sales Management tramite il protocollo SCIM 2.0.
La sincronizzazione è unidirezionale: le modifiche vengono trasmesse da Microsoft Entra ID a Sage Sales Management. Questa connessione non modifica i dati della directory da Sage Sales Management.
In base alle azioni configurate, puoi sincronizzare:
Creazione: gli utenti inclusi nell’ambito della sincronizzazione vengono creati con autorizzazioni di base e il gruppo e l’ambiente predefiniti.
Aggiornamento: le modifiche agli attributi configurati, come nome, telefono, indirizzo o responsabile, vengono trasmesse a Sage Sales Management.
Disattivazione: quando un utente viene eliminato dalla directory o rimosso dalle assegnazioni dell’applicazione, perde l’accesso a Sage Sales Management.
La disattivazione conserva i dati dell’utente. Se torna attivo e rientra nell’ambito della sincronizzazione, può recuperare l’accesso e i propri dati.
Requisiti
Sono necessari:
Un account Microsoft Entra ID autorizzato a creare applicazioni aziendali, assegnare utenti e configurare il provisioning.
Un account aziendale esistente in Sage Sales Management.
Un utente Sage Sales Management autorizzato ad amministrare gli utenti di quell’account.
Consigliamo inoltre di configurare Microsoft Entra ID come fornitore di autenticazione per gestire i criteri delle password e di accesso tramite Microsoft.
La sincronizzazione degli utenti e l’autenticazione sono configurazioni distinte. Attivare una non configura automaticamente l’altra.
1. Verificare l’accesso e ottenere il token
Accedi con le credenziali di Sage Sales Management. Usa quelle Microsoft se Microsoft è configurato come fornitore di autenticazione.
Verifica di poter accedere alla schermata delle credenziali.
Copia il token mostrato in API Key. Ti servirà per configurare la connessione.
L’accesso al portale conferma l’accesso alle credenziali. Verificherai successivamente la connessione con Microsoft Entra ID.
2. Creare un’applicazione aziendale
Apri l’interfaccia di amministrazione di Microsoft Entra.
Accedi a Entra ID > Applicazioni aziendali.
Seleziona Nuova applicazione, quindi Crea la tua applicazione.
Inserisci un nome. Consigliamo «Sage Sales Management SCIM User sync».
Seleziona l’opzione per integrare un’applicazione non presente nella raccolta.
Crea l’applicazione.
3. Configurare la connessione
Apri la sezione Provisioning dell’applicazione.
Imposta la modalità di provisioning su Automatico.
Nelle credenziali di amministratore, inserisci:
URL tenant:
https://be-pro.forcemanager.net/scim/Token segreto: il token ottenuto dal portale di sincronizzazione.
Seleziona Test connessione.
Se il test riesce, salva le modifiche.
La modalità automatica permette di configurare il servizio. Verifica e attiva la sua esecuzione dopo aver controllato la sincronizzazione.
4. Definire le azioni e gli attributi
In Mapping, apri la configurazione del provisioning degli utenti.
Verifica le azioni disponibili: Crea, Aggiorna ed Elimina. Attiva quelle necessarie per la tua configurazione.
Per disattivare gli utenti conservando i loro dati, verifica gli aggiornamenti e il mapping dell’attributo active. Non selezionare solo Elimina presumendo che questa azione gestisca tutte le disattivazioni.
Mantieni i mapping standard, salvo quando devi adattare attributi specifici della directory.
L’indirizzo e-mail principale deve coincidere nei due sistemi per identificare correttamente lo stesso utente.
5. Selezionare gli utenti da sincronizzare
Definisci l’ambito del provisioning:
Solo gli utenti e i gruppi assegnati all’applicazione.
Tutti gli utenti inclusi nell’ambito definito in Microsoft Entra ID.
Se utilizzi le assegnazioni, configura gli utenti o i gruppi corrispondenti in Utenti e gruppi.
L’ambito del provisioning determina quali utenti vengono sincronizzati. L’accesso tramite autenticazione dipende dalle impostazioni di autenticazione e assegnazione dell’applicazione.
6. Verificare e attivare la sincronizzazione
Seleziona Provisioning su richiesta.
Cerca un utente di prova incluso nell’ambito.
Esegui il provisioning.
Controlla il risultato in Sage Sales Management e verifica i dati e le impostazioni dell’utente.
Verifica le azioni attivate.
Attiva il provisioning automatico.
Consulta i log di provisioning per individuare eventuali errori.