MyQ X Server
10.3 10.2 8.2 EoL Print Server Central Server English French German Italian Portuguese Spanish
10.3 10.2 8.2 EoL Print Server Central Server English French German Italian Portuguese Spanish

Sincronizzazione degli utenti da Google Workspace

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.

  1. Accedere alla Console di amministrazione di Google con un account di superamministratore.

  2. Accedere a App > LDAP e fare clic su Aggiungi client.

  3. Inserire un nome per il client (obbligatorio) e una descrizione facoltativa. Fare clic su Continua.

  4. 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.

  5. 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.

  6. Scaricare il pacchetto di certificati generato. Il file ZIP contiene:

    • Il certificato client (.crt o .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.

  7. Fare clic su Continua ai dettagli del client.

  8. 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.

  9. 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

ldap.google.com

Utente

Il nome utente generato in Google Admin (Fase 1)

Password

La password generata in Google Admin (Fase 1)

Certificato client

Caricare il file .crt o .pem scaricato da Google Admin

Chiave privata

Caricare il file .key scaricato da Google Admin


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

uid

Nome completo

cn

E-mail

mail

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.