MyQ X sincronizza gli utenti da Google Workspace utilizzando il servizio Secure LDAP di Google, che fornisce accesso in sola lettura alla directory di Google tramite LDAPS. La sincronizzazione importa gli account utente e le appartenenze ai gruppi e mappa gli attributi della directory alle proprietà utente di MyQ.
Prerequisiti
-
Privilegi di Super Amministratore in Google Workspace.
-
Un abbonamento a Google Workspace che supporti il servizio Secure LDAP.
-
Il server MyQ deve essere in grado di stabilire connessioni LDAPS in uscita (TCP 636) verso Google.
-
È necessario sapere a quali utenti o gruppi MyQ deve essere consentito l’accesso.
Considerazioni chiave
Ogni istanza del server MyQ richiede un proprio certificato client LDAP. Google emette un certificato univoco per ogni client LDAP. Se si gestiscono più server MyQ – ad esempio, un server centrale e server del sito – ciascuno deve disporre di un proprio client registrato in Google Admin con il proprio certificato e le proprie credenziali.
I certificati scadono e devono essere rinnovati. I certificati client LDAP di Google Workspace hanno una data di scadenza. Si raccomanda di pianificare il rinnovo dei certificati nel proprio calendario operativo. Quando un certificato scade, la sincronizzazione non andrà a buon fine finché non verrà generato un nuovo certificato e caricato su MyQ.
Le modifiche alle autorizzazioni di accesso possono richiedere fino a 24 ore per diventare effettive. Quando si modificano le autorizzazioni di accesso dei client LDAP nella Console di amministrazione di Google, le modifiche non sono immediate. Tenere conto di questo ritardo durante la configurazione iniziale e i test: se la sincronizzazione non restituisce i risultati previsti poco dopo una modifica delle autorizzazioni, attendere e riprovare prima di procedere con ulteriori operazioni di risoluzione dei problemi.
Il certificato client deve essere in formato PEM. MyQ richiede che il certificato client sia in formato PEM (codificato in Base64, con intestazioni BEGIN CERTIFICATE). Se il certificato scaricato da Google Admin è in formato binario DER, convertirlo prima di caricarlo su MyQ, ad esempio utilizzando OpenSSL: openssl x509 -inform der -in certificate.der -out certificate.pem
Non proteggere la chiave privata con una password. MyQ non è in grado di utilizzare una chiave privata protetta da password. Quando si generano le credenziali in Google Admin, lasciare la chiave privata non protetta.
Configurare il client LDAP in Google Admin
Questa operazione viene eseguita interamente nella Console di amministrazione di Google. Consente di generare il certificato client, la chiave privata e le credenziali LDAP necessarie a MyQ per la connessione.
-
Accedere alla Console di amministrazione di Google con un account di superamministratore.
-
Accedere a App > LDAP e fare clic su Aggiungi client.
-
Inserire un nome per il client (obbligatorio) e una descrizione facoltativa. Fare clic su Continua.
-
Nella pagina del client LDAP, fare clic su Autorizzazioni di accesso e configurare quanto segue:
Verifica delle credenziali utente: abilita l’autenticazione utente tramite MyQ. Impostare su Tutti gli utenti o su unità organizzative specificate.
Lettura delle informazioni utente: consente a MyQ di leggere gli attributi degli utenti. Impostare su tutti gli utenti o su unità organizzative specificate, quindi abilitare l’accesso a:
-
Attributi di sistema
-
Attributi personalizzati pubblici
-
Attributi personalizzati privati
Lettura delle informazioni sui gruppi – consente a MyQ di leggere l’appartenenza ai gruppi della directory. Impostare su On.
-
-
Fare clic su Aggiungi client LDAP e attendere il completamento della configurazione del client e la generazione del certificato. L’operazione potrebbe richiedere alcuni minuti.
-
Scaricare il pacchetto di certificati generato. Il file ZIP contiene:
-
Il certificato client (
.crto.pem) -
La chiave privata (
.key)
Conservare questi file in un luogo sicuro. Se il certificato è in formato DER, convertirlo in formato PEM prima di procedere.
-
-
Fare clic su Continua ai dettagli del client.
-
Fare clic su Credenziali di accesso, quindi su Genera nuove credenziali. Il nome utente e la password generati vengono visualizzati una sola volta: conservarli in un luogo sicuro prima di uscire da questa schermata.
-
Tornare alla pagina dei dettagli del client LDAP e impostare Stato del servizio su ON per tutti. Fare clic su Salva.
Google Workspace è ora configurato con MyQ come client LDAP.
Configurare il server di autenticazione in MyQ
Accedere a MyQ > Impostazioni > Server di autenticazione e aggiungere un nuovo server LDAP per Google Workspace.
|
Impostazione |
Valore |
|---|---|
|
Sicurezza |
SSL |
|
Porta |
636 |
|
Server |
|
|
Utente |
Il nome utente generato in Google Admin (Fase 1) |
|
Password |
La password generata in Google Admin (Fase 1) |
|
Certificato client |
Caricare il file |
|
Chiave privata |
Caricare il file |
Configurare l’origine di sincronizzazione
Accedere a MyQ > Impostazioni > Sincronizzazione utente, fare clic su +Aggiungi e selezionare Aggiungi origine LDAP.
Quanto segue riguarda specificatamente Google Workspace.
DN di base
Il DN di base per Google Workspace utilizza i componenti del dominio del proprio dominio Google Workspace. Ad esempio, per il dominio example.com:
dc=example,dc=com
Mappatura predefinita degli attributi
Google Workspace espone uno schema LDAP standard. Le mappature riportate di seguito sono tipiche della maggior parte delle directory di Google Workspace; tuttavia, si raccomanda di verificare i nomi degli attributi confrontandoli con la propria directory effettiva utilizzando il browser LDAP nella scheda Generale.
|
Proprietà MyQ |
Attributo tipico di Google Workspace |
|---|---|
|
Nome utente |
|
|
Nome completo |
|
|
|
|
|
Alias |
(nessuno – configurare esplicitamente se necessario) |
|
Numero personale |
(nessuno – configurare esplicitamente se necessario) |
Eseguire e pianificare la sincronizzazione
Per eseguire immediatamente la sincronizzazione, accedere a MyQ > Impostazioni > Sincronizzazione utente, selezionare l’origine e fare clic su Sincronizza ora. Se configurata correttamente, gli utenti e i gruppi sincronizzati appariranno in MyQ > Utenti.
Per eseguire la sincronizzazione automaticamente secondo una pianificazione, accedere a MyQ > Impostazioni > Funzione Programmazione e configurare l’attività di sincronizzazione utente.
Considerazioni sulla sicurezza
LDAPS è obbligatorio
Il servizio Secure LDAP di Google funziona esclusivamente tramite LDAPS: il protocollo LDAP standard non è supportato. Assicurarsi che il server MyQ possa raggiungere ldap.google.com sulla porta TCP 636 e che nessuna regola del firewall blocchi le connessioni in uscita su tale porta.
Proteggere i certificati client e le credenziali
Il certificato client, la chiave privata e le credenziali generate consentono l’accesso in lettura alla directory Google. Conservare tali elementi in modo sicuro e limitare l’accesso al server MyQ e ai suoi amministratori. Sostituire le credenziali qualora venissero compromesse.
Applicare il principio del privilegio minimo tramite le autorizzazioni di accesso
In Google Admin, limitare le autorizzazioni di accesso del client LDAP alle sole unità organizzative che MyQ deve leggere. Concedere l’accesso a tutti gli utenti quando la sincronizzazione copre solo un sottoinsieme dell’organizzazione costituisce un’esposizione non necessaria.