Abilitare l'autenticazione con Microsoft

Uno dei modi per permettere agli utenti di accedere in piattaforma è con Microsoft OAuth. Con questa modalità, gli utenti potranno accedere alla piattaforma con le proprie credenziali Microsoft (Office 365 / Azure AD).

Abilitare la piattaforma all'autenticazione con Microsoft è semplice, ma richiede alcuni passaggi di configurazione sul portale Azure.

Creazione credenziali su Microsoft Azure

Per prima cosa occorre creare una "Registrazione app" su Microsoft Azure. Se non hai accesso al portale Azure, rivolgiti al tuo team IT.

Dopo aver effettuato l'accesso al Portale di Azure, segui questi passaggi:

1. Registra una nuova applicazione

1. Cerca e seleziona il servizio Microsoft Entra ID (precedentemente Azure Active Directory).
2. Nel menu a sinistra, clicca su Registrazioni app (App registrations).
3. Clicca su + Nuova registrazione in alto.
4. Inserisci il Nome della piattaforma (es. Skillsincloud).
5. Sotto "Tipi di account supportati", seleziona: Account in qualsiasi directory organizzativa (qualsiasi directory di Microsoft Entra ID - Multi-tenant).
6. Sotto "URI di reindirizzamento", seleziona Web dal menu a tendina.

7. Inserisci l'URL di callback. L'indirizzo sarà l'URL della tua piattaforma seguito da: /users/auth/microsoft_graph/callback

   Esempio: https://lms.skillsincloud.com/users/auth/microsoft_graph/callback

Clicca su Registra per completare la creazione.

2. Copia gli ID Applicazione e Tenant

Una volta creata l'app, verrai reindirizzato alla pagina di panoramica (Overview). Qui troverai i codici identificativi necessari.

Copia e conserva i seguenti valori:

• ID applicazione (client): Questo sarà il tuo "Client ID".
• ID directory (tenant): Questo sarà il tuo "Tenant ID".

3. Crea il segreto (Client Secret)

1. Nel menu a sinistra dell'applicazione, clicca su Certificati e segreti.
2. Clicca su + Nuovo segreto client.
3. Aggiungi una descrizione (es. "Skillsincloud Auth") e scegli una scadenza (consigliato: 24 mesi).
4. Clicca su Aggiungi.
5. IMPORTANTE: Copia immediatamente il Valore del segreto (colonna "Valore", non "ID segreto"). Una volta ricaricata la pagina, questo codice verrà oscurato e non sarà più recuperabile.

Inserimento delle credenziali su Skillsincloud

Una volta completati i passaggi precedenti, occorre inserire le credenziali in piattaforma.

1. Dal menu a sinistra, vai su Personalizza -> Login / Registrazione.
2. Vai alla sezione Autenticazione con Microsoft.
3. Seleziona la checkbox "Abilita l'autenticazione con Microsoft".
4. Inserisci i dati recuperati da Azure:
   • Microsoft Client ID: Incolla l'ID applicazione (client) copiato al passaggio 2.
   • Microsoft Client Secret: Incolla il Valore del segreto copiato al passaggio 3.
   • Microsoft Tenant ID: Incolla l'ID directory (tenant) copiato al passaggio 2.

Una volta salvate le impostazioni, gli utenti potranno accedere cliccando sul pulsante "Accedi con Microsoft" nella pagina di login.