Integrazione Outlook¶
Un'integrazione Outlook può essere aggiunta alla vostra installazione di Drovio Server. Permette agli utenti di pianificare riunioni Drovio direttamente dal loro calendario Outlook: un pulsante Add a Drovio meeting inserisce nell'appuntamento il link per partecipare, e l'invio dell'appuntamento mantiene la riunione allineata con la sua data, i suoi partecipanti e la sua ricorrenza. Dovrete creare una registrazione di applicazione in Microsoft Entra ID.
Il componente aggiuntivo funziona in Outlook sul web, nel nuovo Outlook per Windows, in Outlook classico per Windows e in Outlook per Mac. Autentica i suoi utenti con il loro account Microsoft: 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.
Solo HTTPS
Outlook carica i componenti aggiuntivi soltanto in HTTPS. Il vostro Drovio Server deve essere raggiungibile in HTTPS dalle macchine su cui gira Outlook.
Dichiarare il componente aggiuntivo in Microsoft Entra ID¶
In quanto segue, <your server> indica il nome host contenuto nell'URL pubblico
del vostro Drovio Server, per esempio drovio.example.com.
Non dovete costruire a mano l'URI di reindirizzamento e l'Application ID URI: la pagina Outlook del pannello di amministrazione li mostra entrambi, pronti da copiare. Aprite Integrations, poi Configure sulla scheda Outlook.
Creare la registrazione di applicazione¶
Nel portale Azure, aprite Microsoft Entra ID, poi App registrations, e New registration.
| Campo | Valore |
|---|---|
| Name | Un nome a scelta, per esempio Drovio Outlook |
| Supported account types | Accounts in this organizational directory only (single tenant) |
| Redirect URI | Single-page application (SPA), poi brk-multihub://<your server> |
Nel riquadro Overview, rilevate:
| Valore in Entra ID | Usato come |
|---|---|
| Application (client) ID | client_id |
| Directory (tenant) ID | tenant_id |
Non serve alcun secret client: il componente aggiuntivo non si autentica mai come applicazione.
Esporre l'API¶
Sotto Expose an API, fate clic su Add accanto all'Application ID URI, e inserite l'URI che il pannello di amministrazione mostra una volta salvato l'Application ID:
api://<your server>/<client id>
Poi Add a scope:
| Campo | Valore |
|---|---|
| Scope name | access_as_user |
| Who can consent | Admins and users |
| Admin consent display name | Use Drovio as the user |
| Admin consent description | Lets Outlook sign the user in to Drovio. |
| State | Enabled |
Sempre sotto Expose an API, fate clic su Add a client application,
inserite ea5a67f6-b6f3-4338-b240-c655ddc3cc8e e spuntate l'ambito
access_as_user. Questo identificativo rappresenta l'insieme delle applicazioni
Office, che chiedono un token per conto del componente aggiuntivo quando Outlook
non dispone della nested app authentication.
Richiedere token in versione 2¶
Sotto Manifest, portate requestedAccessTokenVersion a 2, nella sezione
api, poi Save. Drovio Server verifica i token così come Entra ID li emette
in quella versione.
Concedere il consenso¶
Sotto API permissions, Add a permission, aprite APIs my organization
uses, trovate la registrazione di applicazione tramite il suo nome e aggiungete
la sua autorizzazione delegata access_as_user. Fate poi clic su Grant admin
consent for <your tenant>, il che risparmia a ogni utente la richiesta di
consenso.
Configurare l'integrazione¶
Nel pannello di amministrazione, aprite Integrations, poi Configure sulla scheda Outlook.
| Campo | Da dove viene |
|---|---|
| Status | Enabled o Disabled |
| Application ID | Il client_id rilevato in Entra ID |
| Tenant ID | Il tenant_id rilevato in Entra ID |
Il salvataggio ha effetto già dalla richiesta successiva, senza riavvio. Una volta salvato l'Application ID, la pagina mostra l'Application ID URI e l'URI di reindirizzamento che la registrazione di applicazione deve dichiarare.
Passare lo stato a Disabled rifiuta le richieste provenienti da Outlook, lasciando comunque accessibile la pagina per configurare l'integrazione.
Riferimento di configurazione¶
Ecco le chiavi dell'elemento outlook 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 |
client_id |
Application (client) ID della registrazione di applicazione | |
tenant_id |
Directory (tenant) ID della registrazione di applicazione, necessario per attivare l'integrazione | |
manifest_id |
Identifica il componente aggiuntivo in Microsoft 365. Impostato al primo salvataggio, da non modificare |
Distribuire il componente aggiuntivo¶
Il componente aggiuntivo è descritto da un manifest che punta al vostro server. Nella pagina Outlook del pannello di amministrazione, la sezione Manifest permette di scaricarlo, compilato con la configurazione salvata.
Nel Microsoft 365 admin center, andate in Settings, poi Integrated apps, e Upload custom apps. Scegliete Office Add-in, caricate il manifest, poi selezionate gli utenti o i gruppi a cui distribuirlo. La distribuzione impiega fino a 24 ore per raggiungere Outlook, a volte di più per Outlook classico per Windows.
Usare il componente aggiuntivo¶
In un appuntamento di cui l'utente è organizzatore, la barra multifunzione mostra un gruppo Drovio:
| Pulsante | Cosa fa |
|---|---|
| Add a Drovio meeting | Crea la riunione Drovio a partire dall'appuntamento, imposta il link per partecipare come luogo e lo aggiunge all'invito |
| Settings | Mostra l'account Drovio a cui è collegato il componente aggiuntivo e permette all'utente di disconnettersi |
All'invio dell'appuntamento, il componente aggiuntivo aggiorna la riunione Drovio con le modifiche apportate nel frattempo: oggetto, descrizione, date, partecipanti e ricorrenza. Drovio non invia alcun invito proprio: l'invito di Outlook è quello che ricevono i partecipanti.
Outlook sul web e il nuovo Outlook
In Outlook sul web e nel nuovo Outlook per Windows, il componente aggiuntivo viene eseguito all'invio soltanto quando l'appuntamento è aperto in una finestra propria, con Open in new window. Dal modulo che si apre all'interno della finestra principale, o quando l'appuntamento viene inoltrato, le modifiche apportate dopo l'aggiunta della riunione Drovio non le arrivano.