Introduzione

Questo articolo illustra come integrare Docebo con il proprio account Google Apps, in modo che sia possibile importare gli utenti dal database Google Apps e permettere loro di accedere alla piattaforma con le credenziali di Google Apps.

Suggerimento: Se Google Apps e Slack lavorano sullo stesso utente o sugli stessi utenti, le due integrazioni non possono essere utilizzate contemporaneamente.

Configurare l'account di Google Apps

Accedere al proprio Account Google Work in qualità di Admin, quindi alla pagina Google Apps Admin e cliccare Admin Console. Si aprirà una nuova tab/pagina con l'elenco delle aree in cui è possibile operare. Cliccare l'icona Security.

Nella pagina Security, selezionare API Reference, e abilitare l'opzione Enable API Access. Aprire ora la pagina Google Cloud Services Manage Resources (si apre in una nuova tab)

https://console.cloud.google.com/cloud-resource-manager

Cliccare Create Project nella barra superiore della pagina. Definire il nome del progetto, selezionare l'organizzazione e la posizione e premere Create per avviare la procedura di creazione. L'ID del progetto è assegnato automaticamente da Google, ma è possibile modificarlo premendo Edit in fondo alla riga dell'ID progetto.

Una volta creato, il progetto sarà elencato nel menu a tendina Notifications. Cliccare sul link Select Project sotto il nome del progetto per accedere alla pagina principale dello stesso. Nella sezione APIs, cliccare Go to APIs Overview per accedere alla APIs & Services Dashboard. Spostarsi alla tab Library e cercare Admin SDK API dalla barra di ricerca. Selezionare Admin SDK API.

Premere Enable nell'intestazione della sezione per abilitare le chiamate API. Una volta attivate le API, è necessario creare le credenziali per poterle utilizzare. Spostarsi quindi alla tab Credentials e premere Create Credentials dalla barra superiore della pagina.

In questa pagina, eseguire la seguente configurazione: nel campo Which API are you using? selezionare Admin SDK e per What data will you be accessing? selezionare User data. Quindi selezionare Next. Nella schermata successiva inserire il nome dell'applicazione che richiede il consenso, scegliere l'indirizzo email di assistenza dal menu a tendina, eventualmente aggiungere un'immagine del logo dell'applicazione e inserire l'indirizzo email dello sviluppatore, quindi cliccare su Save and Continue.

Nella schermata successiva è possibile aggiungere ambiti all'applicazione, quindi cliccare su Save and Continue.

Nella sezione successiva scegliere Web Application dal menu a tendina Application Type:

A questo punto è possibile dare un nome all'applicazione web (facoltativo in quanto è già precompilato).

Cliccare sul pulsante Add URI in Authorized Javascript Origins e inserire l'URL della propria piattaforma. Se si sta utilizzando l'App Dominio Personalizzato, è necessario inserire l'URL del dominio personalizzato.

Cliccare quindi sul pulsante Add URI in Authorized Redirect URIs e inserire il seguente URL, sostituendo mylms.docebosaas.com con l'URL della propria piattaforma:

https://mylms.docebosaas.com/lms/index.php?r=GoogleappsApp/GoogleappsApp/googleappsRedirect

Cliccare su Create per andare al passaggio successivo.

Compariranno le proprie credenziali OAuth, che è possibile scaricare o copiare negli appunti.

Il processo di integrazione dal lato Google è completo. Il sistema permetterà di scaricare le proprie credenziali, ed è possibile farlo subito o in qualsiasi momento sia necessario, in futuro. Premere Done per concludere la procedura.

Attivare Google Apps in Docebo 

Attivare la app Google Apps come descritto nell'articolo della Knowledge Base dedicato alla gestione di applicazioni e funzionalità. La app si trova nella tab Single Sign On.

Dopo l’attivazione è possibile iniziare le configurazione. Fare riferimento alla sezione che segue per ulteriori informazioni.

Configurare Google Apps in Docebo

Consiglio d'utilizzo: Quando si configurano un'integrazione SSO e un dominio personalizzato definito nella Gestione domini per la stessa piattaforma, consigliamo di configurare prima il dominio personalizzato. Gli URL degli endpoint necessari all'integrazione SSO dipendono dell'URL della piattaforma.

Per configurare l'app, accedere al Menu Amministrazione dall'icona ingranaggio in alto a destra, e identificare la sezione Google Apps, quindi premere Gestione. Nella pagina di configurazione, completare i campi come segue:

Dominio Google Apps

Digitare il proprio dominio Google Apps. Omettere i prefissi https:// e www e non aggiungere slash. Ad esempio, per il dominio https://www.mydomainname.com/ inserire solo mydomainname.com

Consumer key

Il Client ID precedentemente generato nell'area di configurazione di Google

Consumer secret

Il campo Client Secret nell'area di configurazione di Google

L'URL di reindirizzamento sarà generato automaticamente in base al nome del dominio. Premere Salva Modifiche per completare la configurazione. 

Importare gli utenti di Google Apps in Docebo

Suggerimento: Gli unici campi che possono essere importati in Docebo durante il provisioning degli utenti sono nome ed email. Invece, campi aggiuntivi o attributi devono essere importati in modo diverso.

Per importare gli utenti di Google Apps nella piattaforma Docebo, accedere al Menu amministrazione dall'icona ingranaggio in alto a destra della homepage e selezionare Utenti dalla sezione E-Learning. Nella pagina di gestione degli utenti, cliccare Importa e gestisci in alto a destra e quindi Importa utenti da Google Apps fra le opzioni disponibili.

Procedere all'import abilitando l'accesso ai contatti Google. Il sistema mostra il numero di contatti che saranno importati. Selezionare Import users from Google Apps per completare il processo.

Attenzione! Durante l'import, gli utenti Google Apps con lo stesso username di utenti Docebo esistenti non saranno importati. Gli utenti importati da Google Apps potranno accedere alla piattaforma selezionando il pulsante Google Apps dalla pagina di login.