Requisiti

Devi avere accesso SuperAdmin a Libraesva.
Accesso Global admin al tenant Microsoft 365
Devi avere un connettore Graph API creato in ESG. Per crearlo, segui la guida precedente Microsoft 365 APIs configuration.

Configurazione

Il processo di configurazione prevede alcuni passaggi: seguili nell'ordine in cui sono scritti. Libraesva ESG offre una facile integrazione per tutti gli utenti di Microsoft Outlook. Sono supportate sia la versione Windows che quella Mac. Sostanzialmente l'add-in consente di interagire con la quarantena e di segnalare un messaggio come dannoso; puoi tuttavia decidere di rimuovere alcune funzionalità durante la creazione del file manifest.xml.

[fruitful_alert type="alert-info"]NOTA: è necessario un certificato TLS valido sull'ESG affinché l'Outlook Add-in funzioni. Fai riferimento alla pagina dei Certificati del manuale.[/fruitful_alert]

Aggiungere l'API Permission per l'Outlook Add-In

Configurare i Redirect URI e il Front-Channel Logout URL

Cerca il portale App registrations come mostrato:

Cerca la tua App registration relativa a Libraesva ESG e aprila

[fruitful_alert type="alert-warning"]NOTA: questa "App Registration" È LA STESSA APP registration che hai già creato in precedenza. Se non l'hai creata, segui la guida Microsoft 365 APIs configuration.[/fruitful_alert]

Ora clicca su Authentication nel menu a sinistra:
- Clicca Add a platform
- Scegli l'opzione Single-page application (SPA)
- Inserisci il tuo https://<YOUR-ESG-HOSTNAME>/outlook-addin-assets/taskpane.html in Redirect URI

Clicca Settings
- Inserisci il tuo https://<YOUR-ESG-HOSTNAME>/outlook-addin-assets/taskpane.html in Front-Channel Logout URL

Configurare API Permission

Ora clicca su API permissions nel menu a sinistra:
- Clicca Add a permission
- Seleziona l'API Microsoft Graph
- Seleziona i seguenti permessi sotto Application permissions
  - Mail.Read
- Seleziona i seguenti permessi sotto Delegate permissions
  - offline_access
  - openid
  - profile
- Clicca Done

Clicca Grant admin consent e clicca Yes nella finestra di dialogo

Applicare l'admin app consent

Vai su: App registration > Overview > scorri in basso > clicca “Go to Enterprise applications”

Vai su: Security > Permissions > clicca “Grant admin consent for ….”

Accetta la richiesta di permesso

Creazione del file Manifest.xml

Recuperare il Directory (Tenant) ID

Cerca il portale App registrations come mostrato:

Cerca la tua App registration relativa a Libraesva ESG e aprila
Prendi nota del Directory (Tenant) ID mostrato nell'angolo in alto a destra

Inserire il Directory (Tenant) ID in Libraesva ESG

Vai in Admin Area > Integrations > Microsoft 365
Modifica il connettore

Inserisci il Directory (Tenant) ID nella configurazione del connettore

Ora puoi generare il file Manifest.xml cliccando sul pulsante per generarlo

Decidi quali impostazioni Includere o Rimuovere dalle capacità dell'add-in

- Barra laterale "Quarantine": permette all'utente di vedere i messaggi attualmente presenti nel proprio ambiente di quarantena

- Pulsante "Report as Bad": permette all'utente di segnalare un messaggio come dannoso direttamente dall'add-in senza bisogno di altre azioni (Documentazione: Come funziona il pulsante "Report as")

Abilitare le API in Libraesva ESG

Accedi al tuo ESG
Vai in Admin Area -> Authentication -> Web Portal -> API Service
Abilita l'API Service

[fruitful_alert type="alert-warning"]Mobile APP e Outlook Add-in richiedono l'accesso API abilitato. Se salti questo passaggio, la connessione non funzionerà![/fruitful_alert]

DISTRIBUZIONE MICROSOFT 365

Se devi distribuire l'Add-In automaticamente a molti utenti, puoi farlo centralmente collegandoti alla Exchange Management Console.

Accedi al tuo tenant Microsoft 365 tramite il portale online di Microsoft con un account admin
nell'admin center di Microsoft 365, scegli Settings > Integrated apps > Add-ins
Clicca su + Deploy Add-in

Clicca "+ Deploy Add-In"
Seleziona "Upload custom apps"
Seleziona "I have the manifest file (.xml) on this device"
Seleziona il file Manifest.xml creato in precedenza

Clicca su Upload

[fruitful_tabs type="default" width="100%" fit="false"] [fruitful_tab title="Entire Tenant Deployment"]

Seleziona "Everyone" per distribuire l'Add In all'intero tenant

[/fruitful_tab] [fruitful_tab title="Single Users Deployment"]

Seleziona uno o più utenti/gruppi a cui distribuire l'Add In

[/fruitful_tab] [/fruitful_tabs]

Clicca Deploy

[fruitful_alert type="alert-info"]NOTA: a causa dei tempi di propagazione di Microsoft, possono essere necessarie fino a 72 ore perché l'add-in venga distribuito a tutti gli utenti. Se ci sono problemi con la distribuzione, contatta il supporto Microsoft[/fruitful_alert]

Seleziona Next e poi Close

DISTRIBUZIONE EXCHANGE-ON-PREMISE