1. Introduzione

Il provisioning è il processo che consente di creare, aggiornare o sospendere automaticamente gli account utente in un'applicazione quando avvengono modifiche nella directory principale (in questo caso, Microsoft Entra). Configurando il provisioning, puoi assicurarti che gli account utente nelle tue applicazioni restino sempre aggiornati sulla piattaforma Cyber Guru senza dover intervenire manualmente.

Questa guida ti aiuta a configurare il provisioning per un'applicazione in Microsoft Entra.

2. Termini chiave

• Microsoft Entra: Il servizio di identità online di Microsoft che aiuta a gestire l’accesso e la sicurezza degli utenti.
• Provisioning: Creazione, aggiornamento o sospensione automatica degli account utente in un'applicazione collegata, in base alle informazioni presenti in Microsoft Entra.
• Applicazione: Qualsiasi servizio o strumento online utilizzato dalla tua organizzazione (ad esempio, un software HR o un servizio cloud).
• SCIM: Un protocollo utilizzato per semplificare il provisioning degli utenti (se la tua applicazione supporta SCIM).

3. Prima di iniziare

Assicurati di avere accesso come amministratore a Microsoft Entra. Se non ne sei sicuro, contatta il supporto IT.

Devi sapere chiaramente per quale applicazione vuoi effettuare il provisioning degli utenti. Nella maggior parte dei casi, dovrai creare una nuova applicazione.

Devi aver ricevuto la URL del tenant e il token da Cyber Guru.

Tutti gli attributi richiesti dalla piattaforma Cyber Guru devono essere presenti in Entra come valori degli attributi utente.

4. Configurazione passo-passo del provisioning

4.1. Passo 1: Accesso a Microsoft Entra

Apri il tuo browser internet e vai alla pagina di amministrazione di Microsoft Entra.

4.2. Passo 2: Vai all'applicazione

Dopo aver effettuato l’accesso, cerca il pannello di navigazione. Clicca su “Applicazioni aziendali” (o “App”).

Nell’elenco delle applicazioni, trova quella che vuoi configurare per il provisioning e cliccaci sopra.

Se l’applicazione non è già presente nell’elenco, potrebbe essere necessario aggiungerla come nuova applicazione.

Nella parte superiore della pagina “Applicazioni aziendali” di solito c’è un pulsante con scritto “Nuova applicazione” o “Aggiungi applicazione”.

Clicca su quel pulsante.

Clicca su “Crea la tua applicazione”.

4.3. Passo 3: Trova la sezione Provision

Nella pagina dell’applicazione selezionata, trova l’opzione “Provisioning” nel menu. Di solito è visibile insieme ad altre impostazioni come “Single Sign-On”.

Clicca su “Provisioning” per accedere alle impostazioni di configurazione oppure su “Inizia” nella scheda “3. Provision User Accounts”

Procedi quindi a collegare la tua applicazione

4.4. Passo 4: Configurazione della connessione

Ora dovrai inserire alcune informazioni specifiche per collegare Microsoft Entra a Cyberguru. Queste includono:   

• Tenant URL: L’indirizzo web fornito da Cyber Guru a cui vengono inviati i dati degli utenti.

• Secret Token o Chiave di autenticazione: Una chiave unica fornita da Cyber Guru che permette a Microsoft Entra di comunicare in modo sicuro con la piattaforma.

Clicca su “Test connessione”.

Se il test va a buon fine, vedrai un messaggio di conferma.

Se invece il test fallisce, controlla i dati inseriti e riprova.

Se il problema persiste, contatta il supporto IT o il fornitore dell'applicazione.

Clicca su “Crea”

4.5. Configurare la mappatura degli attributi

4.5.1. Disabilitare il provisioning dei gruppi

Per prima cosa, dobbiamo disabilitare il provisioning dei gruppi perché non è abilitato sulla piattaforma Cyber Guru.

Nel menu a sinistra, seleziona “Mappatura attributi”

Seleziona “Provision Microsoft Entra ID Groups” e imposta il pulsante “Abilita” su “No”

Clicca su “Salva” e dovresti vedere ora:

4.5.2. Mappatura degli attributi

Nella schermata precedente, clicca ora su “Provision Microsoft Entra ID Users”. Verrà mostrato l’elenco completo degli attributi. Quelli evidenziati in rosso sono quelli effettivamente utilizzati dalla piattaforma Cyber Guru.

I prossimi passaggi saranno:

Rimuovere tutti gli attributi non necessari

• Aggiungere la mappatura “locale” per la lingua. Questa è la lingua dell’utente sulla piattaforma Awareness e (in caso di phishing) per il template email.

• Modificare la mappatura “country” per il paese dell’utente. Questo è il paese dell’utente sulla piattaforma Awareness e (in caso di phishing) per il template email.

• Aggiungere le mappature per le organizzazioni definite nell’azienda Cyber Guru

• Rivedere e ottimizzare le mappature

Rimuovi gli attributi utilizzando il pulsante “Elimina”:

• displayName

• title

• preferredLanguage

• name.formatted

• addresses[type eq "work"].formatted

• addresses[type eq "work"].streetAddress

• addresses[type eq "work"].locality

• addresses[type eq "work"].region

• addresses[type eq "work"].postalCode

• phoneNumbers[type eq "work"].value

• phoneNumbers[type eq "fax"].value

• urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber

• urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department

• urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager

Aggiungiamo l'attributo "locale":

Clicca su “Aggiungi nuova mappatura” e inserisci l’attributo di origine e quello di destinazione come mostrato qui sotto:

L’attributo locale deve essere composto da due lettere minuscole che indicano la lingua utilizzata sulla nostra piattaforma (secondo i codici lingua ISO 639). Questo significa che ci aspettiamo che l’attributo di origine contenga questo valore. Se così non fosse, usa un altro attributo oppure valuta di utilizzare un’espressione per ricavare il valore da altri attributi.

Per un esempio di espressione, consulta il documento “Hint&TipsSCIM”

Clicca su “OK”

Clicca su “Salva”

Vediamo ora la mappatura per l’attributo paese.

Assicurati che l’attributo "source" contenga il valore del paese come due lettere maiuscole. Se così non fosse, usa un altro attributo oppure valuta di utilizzare un’espressione per ricavare il valore da altri attributi.

Per un esempio di espressione, consulta il documento “Hint&TipsSCIM”

Clicca su “OK”

Clicca su “Salva”

Aggiungi gli attributi dell’organizzazione

Per aggiungere queste mappature, dobbiamo prima creare l’attributo. In questa guida, abbiamo preparato un’azienda su Cyber Guru con tre organizzazioni:

• Ufficio

• Titolo di lavoro

• Dipartimento

Questo è solo un esempio. Se hai altre organizzazioni, puoi aggiungerle seguendo la procedura qui sotto.

In fondo alla pagina, seleziona “Mostra opzioni avanzate”.

Seleziona “Modifica elenco attributi per customappsso”.

In fondo alla pagina vedrai un campo vuoto.

Compila il campo vuoto con il nome delle organizzazioni usando

urn:ietf:params:scim:schemas:extension:Tags:2.0:User:Department

Fai attenzione, l'ultima parte del nome deve corrispondere esattamente all'organizzazione (Dipartimento) creata in azienda (fa distinzione tra maiuscole e minuscole).

Fai clic su "Salva"

Ripeti i passaggi per le organizzazioni:

urn:ietf:params:scim:schemas:extension:Tags:2.0:User:Jobtitle
urn:ietf:params:scim:schemas:extension:Tags:2.0:User:Office

Vai alla schermata di mappatura degli attributi, che ora apparirà così:

Clicca su “Aggiungi nuova mappatura”

Inserisci i valori nei campi origine e destinazione per l'organizzazione Dipartimento:

In questo esempio, stiamo associando l’attributo “department” del profilo utente Microsoft Entra. Se il valore che ti serve si trova in un altro attributo del profilo utente Microsoft Entra, selezionalo semplicemente dall’elenco degli attributi di origine.

Fai attenzione a questi attributi. Devono avere un valore in Microsoft Entra. Una volta attivato SCIM, non sarà più possibile aggiornare manualmente questi valori nella piattaforma Cyber Guru.

Clicca su “OK”

Clicca su “Salva”

Ripeti la procedura per le altre due organizzazioni, associando Office a physicalDeliveryOfficeName e Jobtitle a jobtitle

4.5.3. Configura gli altri mapping e verifica

L’elenco dei mapping degli attributi ora apparirà così:

Prestiamo attenzione a “userName” ed “externalId”

La nostra piattaforma si aspetta lo stesso valore in entrambi i campi. Questo valore non deve cambiare in futuro, quindi scegli con attenzione i valori di origine. Consigliamo vivamente di usare numeri di badge, codici identificativi, object ID di Active Directory, ecc.

Se l’applicazione ha la SSO configurata, è consigliabile usare l’“objectId” dell’utente Microsoft Entra per questi attributi. Supponiamo che sia così e modifichiamo il mapping dei due attributi come segue:

Clicca su “OK” e “Salva” su entrambi

Facciamo un ultimo controllo sugli attributi:

Ora siamo pronti per il test

Il test verrà eseguito su singoli utenti prima di attivare il provisioning automatico.

Scegli un utente e autorizzalo nell'applicazione Cyber Guru.

Accedi all'applicazione Cyber Guru, clicca su “Provisioning” nel menu a sinistra e poi su “Provision on demand”. Seleziona l’utente autorizzato come mostrato nell’esempio:

E clicca su “Provision”

Se il test va a buon fine, riceverai il seguente messaggio:

Controlla sulla piattaforma Cyber Guru che l’utente sia stato creato correttamente:

4.7 Scelta delle impostazioni di sincronizzazione degli utenti

Decidi quali utenti devono essere provisionati sull'applicazione. Potrebbero esserci opzioni per:   

• Sincronizza tutti gli utenti   

• Sincronizza solo gli utenti di gruppi specifici (ad esempio, “Dipendenti HR” o “Team Vendite”)

Scegli l’opzione che meglio si adatta alle esigenze della tua organizzazione.

4.8 Avvio del provisioning

• Controlla le informazioni inserite per assicurarti che sia tutto corretto.

• Vai sull’applicazione, seleziona “Panoramica” dal menu a sinistra e clicca sul pulsante “Avvia provisioning”.

Una volta avviato, Microsoft Entra inizierà a sincronizzare le informazioni degli utenti sulla piattaforma Cyber Guru in base alle regole impostate, con una frequenza di ogni 40 minuti.

5. Cosa aspettarsi

• I nuovi account utente verranno creati automaticamente.

• Le modifiche alle informazioni degli utenti (come il cambio di mansione) in Microsoft Entra saranno riportate nell’applicazione al successivo ciclo di sincronizzazione.

• Se un utente lascia l’organizzazione, il suo accesso verrà automaticamente sospeso sulla piattaforma Cyber Guru. Sospendiamo invece di eliminare perché, se il cliente desidera riattivare l’utente, è possibile farlo mantenendo tutti i dati dei corsi. Gli utenti possono essere eliminati definitivamente se il cliente ci invia una richiesta specifica.

6. Risoluzione dei problemi e supporto

• Controlla attentamente che l’URL dell’endpoint e il token segreto siano inseriti correttamente.

• Se il test di connessione fallisce, verifica i dettagli con il supporto IT o consulta la documentazione fornita dal fornitore della tua applicazione.

• Se noti problemi con la sincronizzazione degli utenti (ad esempio, utenti mancanti o informazioni non aggiornate), controlla le impostazioni di selezione di gruppi o utenti.

• Per ulteriore assistenza, usa l’opzione “Guida” in Microsoft Entra oppure contatta il team IT della tua organizzazione e il supporto Cyberguru.