Vai al contenuto
Bexxo Assistenza

Assistenza La piattaforma Importazione e SSO

Collegare Google Workspace

Per gli amministratori Aggiornato il 13 novembre 2026

Collegare Google Workspace per sincronizzare le persone e i gruppi dell’organizzazione e preparare l’accesso con l’account Google (SSO).
In questa pagina
  1. Panoramica
  2. Preparare l’accesso presso Google
  3. Compilare la sezione Connessione
  4. Che cosa viene importato
  5. Accesso SSO con Google
  6. Verificare e risolvere i problemi

Panoramica

Google Workspace viene letto in sola lettura: utenti, gruppi e membri. Questo articolo tratta la preparazione presso Google e le sezioni Connessione e Accesso SSO; le altre impostazioni sono comuni a tutte le importazioni.

Le impostazioni comuni a tutte le importazioniImportare le persone e configurare l’SSO

1Preparare l’accesso presso Google

La sincronizzazione utilizza un account di servizio Google che agisce a nome di un amministratore del vostro dominio. Vi occorre:

  1. un account di servizio in un progetto Google Cloud, con una chiave JSON (il file deve contenere client_email, private_key e token_uri);

  2. l’API Admin SDK attivata per questo progetto;

  3. nella console di amministrazione di Google Workspace, la delega a livello di dominio concessa all’ID client dell’account di servizio, con esattamente i tre ambiti in sola lettura qui sotto;

  4. l’indirizzo email di un amministratore del dominio che può leggere gli utenti e i gruppi: l’account di servizio agisce a suo nome.

Ambiti da delegare

I menu delle console Google cambiano spesso: cercate « Account di servizio » per la chiave e « Delega a livello di dominio » per gli ambiti.

2Compilare la sezione Connessione

CampoContenuto
Chiave JSON dell’account di servizioObbligatorio. Il contenuto completo del file JSON; è il segreto dell’importazione, da non trasmettere da nessun’altra parte.
Email dell’amministratore delegatoObbligatorio. L’amministratore a nome del quale l’account di servizio legge la directory.
ID cliente Google (customer ID)Facoltativo. Vuoto: my_customer, l’account dell’amministratore delegato.
DominioFacoltativo. Limita gli utenti letti a questo dominio, ad esempio exemple.ch. I gruppi vengono sempre letti per tutto l’account.

La chiave JSON contiene una chiave privata: incollatela solo in questo campo.

Che cosa viene importato

  • Un utente sospeso o archiviato in Google viene importato come inattivo.
  • Solo i membri diretti di tipo utente vengono associati a un gruppo: un gruppo annidato non viene espanso.
  • Proprietà utilizzabili nella corrispondenza dei campi e nei filtri, per una persona: primaryEmail, name.givenName, name.familyName, name.fullName, phones[0].value, organizations[0].title, orgUnitPath, languages[0].languageCode e gli altri campi di primo livello restituiti da Google, ad esempio suspended.
  • Per un gruppo: name, email, description.

Esempio di filtro per unità organizzativa: Proprietà orgUnitPath, Inizia con, /Siège.

Accesso SSO con Google

L’SSO utilizza un’applicazione OAuth di tipo « applicazione Web » creata in Google Cloud, distinta dall’account di servizio.

  1. Dichiarate tutti gli URL di reindirizzamento visualizzati in Accesso SSO (portale e Academy) come URI di reindirizzamento autorizzati dell’applicazione OAuth.

  2. Inserite l’emittente https://accounts.google.com, l’ID client e il segreto client dell’applicazione OAuth, salvate, poi verificate il rilevamento.

L’attivazione dell’SSO e gli effetti di un’interruzione sono descritti nell’articolo generale.

Verificare e risolvere i problemi

SituazioneDa verificare
Verifica della connessione non riuscitaLa chiave JSON è completa e aggiornata? La delega riguarda l’ID client di questo account di servizio, con i tre ambiti? L’email delegata è quella di un amministratore che può leggere utenti e gruppi?
La verifica riesce, ma mancano delle personeIl campo Dominio limita la lettura? Le persone mancanti sono membri diretti dei gruppi selezionati?
Organizzazione con crittografia attivaLa verifica e la sincronizzazione passano per l’agente Bexxo Protected: deve essere avviato e raggiungere gli indirizzi Google.
Organizzazione con crittografia attivaInstallare l’agente Bexxo Protected

Non avete trovato la risposta? Contattarci