Integrazione Google Calendar¶
Un'integrazione Google Calendar può essere aggiunta alla vostra installazione di Drovio Server. Permette agli utenti di pianificare riunioni Drovio direttamente da Google Calendar: Drovio meeting tra le opzioni di videoconferenza di un evento crea la riunione, con le date dell'evento, e vi inserisce il link per partecipare. Il salvataggio delle modifiche all'evento mantiene la riunione allineata con le sue date, il suo oggetto, la sua descrizione, i suoi partecipanti e la sua ricorrenza; annullare l'evento, o scegliere un'altra opzione di videoconferenza, elimina la riunione. Drovio non invia alcun invito proprio: l'invito di Google Calendar è quello che ricevono i partecipanti.
Il componente aggiuntivo autentica i suoi utenti con il loro account Google: la prima volta, si autenticano anche una volta sulla vostra istanza di Drovio Server, per collegare i due account. Il loro account Drovio deve già esistere.
L'integrazione permette anche agli utenti dell'applicazione Drovio di pianificare una riunione con Google Calendar dal suo pulsante calendario, con o senza il componente aggiuntivo: consultate Pianificare dall'applicazione Drovio.
Solo HTTPS
Google chiama il componente aggiuntivo sul vostro server soltanto in HTTPS. Il vostro Drovio Server deve essere raggiungibile in HTTPS da Internet.
Distribuire il componente aggiuntivo nel vostro Google Workspace¶
La scheda pubblica di Drovio nel Google Workspace Marketplace serve soltanto il cloud Drovio. Il vostro server riceve un componente aggiuntivo proprio, che il vostro Google Workspace pubblica in modo privato e che il suo amministratore installa per tutti: gli utenti devono poi soltanto connetterlo. La pagina Google Calendar del pannello di amministrazione vi guida passo per passo: aprite Integrations, poi Configure sulla scheda Google Calendar.
Avrete bisogno di un account amministratore di Google Workspace, della Google Cloud CLI e di un progetto Google Cloud per il componente aggiuntivo.
Creare il progetto Google Cloud¶
Il progetto può essere creato dalla console Google Cloud, dalla Google Cloud CLI o da Terraform. I tre metodi portano allo stesso risultato: un progetto con attivate le tre API di cui ha bisogno il componente aggiuntivo.
| API | Servizio | A cosa serve |
|---|---|---|
| Google Workspace add-ons API | gsuiteaddons.googleapis.com |
Distribuisce il componente aggiuntivo |
| Google Calendar API | calendar-json.googleapis.com |
Permette al vostro server di leggere gli eventi che il componente aggiuntivo segue |
| Google Workspace Marketplace SDK | appsmarket-component.googleapis.com |
Pubblica la scheda da cui gli utenti installano il componente aggiuntivo |
Nella console Google Cloud, create un progetto nell'organizzazione del vostro Google Workspace. Poi, sotto APIs & Services e Library, cercate e attivate le tre API qui sopra.
Scegliete l'ID del progetto, che deve essere libero su tutto Google Cloud, poi trovate l'ID dell'organizzazione del vostro Google Workspace:
Create il progetto, attivatene le API, e rendetelo il progetto corrente della Google Cloud CLI, su cui lavorano i comandi dei passaggi successivi:
Lo stesso progetto, per un'infrastruttura già descritta sotto forma di codice,
con il provider google. I file qui sotto formano un unico modulo radice.
# The listing of the add-on is bound to the number of this project
resource "google_project" "calendar" {
name = "Drovio Calendar"
project_id = var.project_id
org_id = var.org_id
lifecycle {
prevent_destroy = true
}
}
resource "google_project_service" "calendar" {
project = google_project.calendar.project_id
for_each = toset([
"appsmarket-component.googleapis.com",
"calendar-json.googleapis.com",
"gsuiteaddons.googleapis.com",
])
service = each.key
disable_dependent_services = true
}
Rendetelo poi il progetto corrente della Google Cloud CLI, su cui lavorano i comandi dei passaggi successivi:
Terraform si ferma al progetto: Google non offre alcuna risorsa per la schermata di consenso OAuth, per la distribuzione del componente aggiuntivo o per la sua scheda, che vengono creati nei passaggi successivi.
La protezione prevent_destroy conserva il progetto: la scheda è legata al
suo numero, e un progetto eliminato e poi ricreato con lo stesso ID ne riceve
un altro, il che significa pubblicare una nuova scheda.
Configurare la schermata di consenso OAuth¶
Google non offre alcun comando per farlo: nella console Google Cloud, sotto APIs & Services e OAuth consent screen, configuratela con il pubblico Internal, che riserva il componente aggiuntivo agli utenti del vostro Google Workspace.
Creare la distribuzione¶
Nella sezione Private deployment del pannello di amministrazione, scaricate la distribuzione: descrive il componente aggiuntivo e punta al vostro server. Poi eseguite, con il progetto qui sopra come progetto corrente della Google Cloud CLI:
gcloud workspace-add-ons get-authorization
gcloud workspace-add-ons deployments create drovio --deployment-file=drovio-google-calendar-deployment.json
gcloud workspace-add-ons deployments install drovio
Il primo comando mostra il service account con cui Google chiama il componente aggiuntivo. Incollatelo in Service account, poi salvate.
La Google Cloud CLI è l'unico modo per creare la distribuzione: la console Google Cloud non ha alcuna pagina per farlo, e Terraform alcuna risorsa.
Pubblicare la scheda privata¶
Nel progetto Google Cloud, configurate il Google Workspace Marketplace SDK, attivato con il progetto qui sopra:
| Impostazione | Valore |
|---|---|
| App visibility | Private |
| Installation settings | Admin Only Install |
| App integration | Google Workspace add-on, HTTP or other deployments, poi selezionate la distribuzione drovio |
| Store listing | Compilatela: nome, descrizioni, loghi, link |
Pubblicate la scheda, poi installate l'applicazione per il vostro dominio dalla Google Admin console. Incollate l'URL della scheda in Marketplace listing, poi salvate.
Configurare l'integrazione¶
Nel pannello di amministrazione, aprite Integrations, poi Configure sulla scheda Google Calendar.
| Campo | Da dove viene |
|---|---|
| Status | Enabled o Disabled |
| Marketplace listing | L'URL della scheda privata pubblicata dal vostro Google Workspace |
| Service account | L'email mostrata da gcloud workspace-add-ons get-authorization |
La pagina mostra anche quanti utenti si sono connessi. Il salvataggio ha effetto già dalla richiesta successiva, senza riavvio. Passare lo stato a Disabled rifiuta le richieste provenienti da Google, lasciando comunque accessibile la pagina per configurare l'integrazione.
Riferimento di configurazione¶
Ecco le chiavi dell'elemento google_calendar di settings.conf, se preferite
modificarlo direttamente. In un cluster, il pannello di amministrazione non può
salvarle: ogni server legge il proprio file di configurazione, che va modificato
su ciascuno di essi.
| Chiave | Predefinito | Significato |
|---|---|---|
enabled |
false |
Attiva l'integrazione |
listing_url |
URL della scheda da cui gli utenti installano il componente aggiuntivo | |
service_account_email |
Service account della distribuzione, con cui Google chiama il componente aggiuntivo | |
meeting_scheduling |
true |
Propone Google Calendar nel pulsante calendario dell'applicazione Drovio, finché l'integrazione è attiva |
Usare il componente aggiuntivo¶
Una volta installato il componente aggiuntivo per il dominio, Google Calendar mostra Drovio nel pannello laterale e tra le opzioni di videoconferenza degli eventi:
| Dove | Cosa fa |
|---|---|
| Drovio meeting, tra le opzioni di videoconferenza di un evento | Crea la riunione Drovio dell'evento e inserisce nell'evento il suo link per partecipare |
| La scheda Drovio, nel pannello laterale | Collega l'account Google dell'utente al suo account Drovio, mostra l'account Drovio a cui è collegato il componente aggiuntivo e permette all'utente di scollegarlo |
Le modifiche a un evento raggiungono la sua riunione Drovio una volta salvato l'evento.
Collegare l'account Drovio¶
La prima volta, il componente aggiuntivo apre una finestra sulla vostra istanza di Drovio Server per collegare l'account Google dell'utente al suo account Drovio:
- a un utente già connesso a Drovio nel proprio browser viene chiesto di confermare l'account da collegare, con Connect;
- qualsiasi altro utente si autentica prima, poi conferma. La pagina di accesso è quella del vostro server, oppure un modulo dell'integrazione quando il vostro server non ne ha.
Il collegamento resta valido finché l'utente non lo scollega, dalla scheda Drovio del pannello laterale. Deve essere completato entro un quarto d'ora dall'apertura della finestra.
Eventi mai salvati¶
Il componente aggiuntivo crea la riunione Drovio non appena viene scelto Drovio meeting, mentre Google non dice nulla di un evento chiuso senza essere salvato. Un giorno dopo, la volta successiva in cui l'utente apre la scheda Drovio o modifica il proprio calendario, il componente aggiuntivo verifica l'evento presso Google ed elimina la riunione di un evento che non è mai stato salvato, o che è stato salvato senza di essa.
Pianificare dall'applicazione Drovio¶
Finché l'integrazione è attiva e meeting_scheduling è attivato, il pulsante
calendario dell'applicazione Drovio propone Google Calendar. Ciò che si apre
scegliendolo dipende dall'utente:
- un utente che ha collegato il componente aggiuntivo ottiene un nuovo evento di Google Calendar, in cui sceglie Drovio meeting tra le opzioni di videoconferenza: il componente aggiuntivo crea la riunione e la mantiene allineata con l'evento;
- qualsiasi altro utente ottiene una riunione Drovio creata per lui, poi un nuovo evento compilato con il suo link per partecipare, come luogo e nella descrizione. L'oggetto e la descrizione sono scritti nella lingua dell'account Drovio dell'utente. La riunione inizia nel momento in cui l'utente sceglie Google Calendar e dura un'ora, poiché nulla dice al vostro server quando si svolge l'evento; il suo link permette di raggiungerla in qualsiasi momento.
L'applicazione mostra il pulsante calendario dalla versione 3.7.1 dell'applicazione Drovio, con i mezzi di pianificazione offerti dalle integrazioni del vostro server: nessuno lo nasconde, uno lo apre direttamente, più di uno aprono un menu. Consultate Applicazione Drovio.