Single sign-on per siti Drupal
Questa pagina spiega come integrare un calendario SuperSaaS in un sito basato su Drupal in modo che gli utenti debbano effettuare il login una sola volta per accedere sia al tuo sito sia al calendario SuperSaaS incorporato. Per poterlo usare devi prima creare un account SuperSaaS gratuito.
- Usare il login Drupal per i calendari SuperSaaS
- Installare e configurare il modulo in Drupal
- Modificare le impostazioni di SuperSaaS
- Aggiungere il pulsante di prenotazione alle tue pagine
- Suggerimenti per la risoluzione dei problemi
Usare i nomi utente Drupal per il tuo calendario SuperSaaS
Il modulo SuperSaaS per Drupal mostra un pulsante “Prenota ora” che collega automaticamente l’utente a un calendario SuperSaaS usando il suo nome utente Drupal. Se non utilizzi il sistema di registrazione utenti di Drupal, dovresti invece seguire le istruzioni generali su come integrare un calendario nel tuo sito.
Il pulsante generato dal modulo invia a SuperSaaS le informazioni del database utenti di Drupal, creando l’utente nel database SuperSaaS oppure aggiornandone i dati quando necessario. In questo modo gli utenti non devono creare un accesso separato per il sistema di prenotazione ed evitano di effettuare il login due volte.
Installazione e configurazione del modulo in Drupal
Segui questi passaggi per configurare il modulo in Drupal:
-
Installa il modulo (Drupal 10.2 & 11).
Nella pagina del progetto Modulo Drupal SuperSaaS segui le istruzioni di installazione nella sezione “rilasci”.
Poi, nella pagina Estendi, seleziona la casella accanto al nome del modulo per abilitarlo e fai clic su .Ora vai in Gestisci>Configurazione e fai clic su Impostazioni SuperSaaS.
Compila o svuota i campi e seleziona o deseleziona “Abilita HTTPS” in base alle tue impostazioni.Nel menu di amministrazione di Drupal, fai clic su Gestisci>Struttura e poi su Layout blocchi. Dopo il blocco in cui vuoi inserire il modulo SuperSaaS, fai clic su Posiziona blocco. Individua il blocco “accesso SuperSaaS” e fai clic sul pulsante Posiziona blocco accanto ad esso. In “Configura blocco” puoi modificare il titolo, disattivare la visualizzazione del titolo e regolare varie impostazioni.
Per la compatibilità con versioni più vecchie di Drupal scarica una versione dalla pagina versioni GitHub. -
Configura il modulo. Apri la schermata Impostazioni SuperSaaS e compila i campi:
- Nome account SuperSaaS – È il nome del tuo account, non il tuo indirizzo email
- Chiave API SuperSaaS – Puoi trovare la chiave API del tuo account SuperSaaS in fondo alla pagina Info account.
- Nome del calendario – Puoi inserire il nome di un calendario oppure un URL completo se vuoi aggiungere parametri specifici per indirizzare l’utente a una vista particolare. Se utilizzi più di un calendario, vedi sotto.
- Etichetta pulsante – L’etichetta del pulsante. Il valore predefinito è “Prenota ora” o il suo equivalente nelle lingue supportate. Se il pulsante ha un’immagine di sfondo, questo valore verrà usato come testo alternativo.
- Immagine pulsante – L’URL dell’immagine di sfondo. Non ha un valore predefinito, quindi se non lo configuri il pulsante non avrà alcuna immagine di sfondo. Esempio:
- Nome dominio personalizzato – Se hai creato un dominio personalizzato che punta al tuo calendario, puoi inserirlo qui per indirizzare correttamente gli utenti
- Abilita HTTPS – Seleziona questa opzione se hai attivato “Cifra la connessione con SSL/TLS” per il/i tuo/i calendario/i SuperSaaS
(Vedi 
Modifica le impostazioni dell’account SuperSaaS per usarlo con Drupal
Il database utenti di Drupal è la fonte primaria, quindi qualsiasi modifica ai dati utente sul tuo sito Drupal verrà aggiornata in SuperSaaS, ma non viceversa. Per questo consigliamo di non permettere agli utenti di cambiare le proprie informazioni in SuperSaaS, perché ciò potrebbe confonderli facilmente. Ad esempio, se un utente potesse cambiare la propria password in SuperSaaS probabilmente non si accorgerebbe che la password di Drupal resta la stessa.
Applica le seguenti modifiche al tuo account SuperSaaS per evitare incoerenze:
- Nella pagina Controllo accessi, seleziona
- Nella pagina Controllo accessi, seleziona
- Nella pagina Impostazioni layout, compila il campo Il tuo URL con l’URL della pagina del tuo sito in cui gli utenti possono effettuare il login
Inoltre, devi assicurarti che i campi del database Drupal corrispondano a quelli del database utenti SuperSaaS. Apporta le seguenti modifiche nella pagina Controllo accessi:
- Deseleziona
- Imposta il pulsante di opzione Indirizzo email che appare su Facoltativo (o Obbligatorio)
- Imposta tutti gli altri campi su Non chiedere (puoi disattivare anche il campo Password se hai selezionato )
Ora puoi provare il pulsante sul tuo sito. Come amministratore dovrai comunque effettuare l’accesso tramite la pagina di login principale di SuperSaaS, quindi conviene fare la prova fingendosi un utente normale. Se vuoi definire dei superuser in SuperSaaS, assicurati che abbiano effettuato almeno una volta il login tramite il pulsante prima di cambiarne il ruolo nella pagina Gestione utente.
Configura SuperSaaS
Questa immagine mostra la pagina Controllo accessi del tuo account SuperSaaS dopo aver applicato le impostazioni descritte sopra.Aggiungi il pulsante alle tue pagine
Nel menu principale vai su Gestisci>Struttura (Drupal 10.2 o 11) e seleziona l’opzione Layout blocchi. Poi fai clic su Posiziona blocco nel punto della pagina in cui vuoi inserirlo. Puoi fare clic su configura per personalizzare ulteriormente il titolo e le pagine in cui il pulsante deve comparire.
Suggerimenti per la risoluzione dei problemi
- Ricorda che il pulsante appare solo agli utenti che hanno effettuato l’accesso al tuo sito Drupal
- Se vedi l’errore “L’indirizzo email non è un indirizzo email valido”, rileggi il paragrafo precedente per verificare di aver configurato correttamente il tuo account SuperSaaS
- Se il pulsante reindirizza l’utente ma non sembra effettivamente autenticarlo, e hai usato un URL nel campo Nome del calendario, assicurati che il dominio di quell’URL sia stato inserito nel campo Nome dominio personalizzato