Requisitos
- Necesita tener acceso SuperAdmin a Libraesva.
- Acceso de administrador global del tenant de Microsoft 365
- Necesita un conector Graph API creado en ESG. Para crearlo, siga la guía anterior Configuración de las API de Microsoft 365.
Configuración
El proceso de configuración tiene varios pasos, siga el orden en que están escritos. Libraesva ESG ofrece una integración sencilla para todos los usuarios de Microsoft Outlook. Se admiten tanto la versión de Windows como la de Mac. Básicamente, el add-in permite interactuar con su quarantine y reportar como malo un mensaje; sin embargo, puede decidir eliminar algunas funcionalidades durante la creación del archivo manifest.xml.[fruitful_alert type="alert-info"]NOTA: necesita un certificado TLS válido en el ESG para que el Outlook Add-in funcione. Consulte la página de Certificados del manual.[/fruitful_alert]
Añadir permiso de API para el Outlook Add-In
Configurar Redirect URIs y Front-Channel Logout URL
- Busque el portal App registrations como se muestra:
- Busque su App registration sobre Libraesva ESG y ábrala
- Ahora haga clic en Authentication en el menú izquierdo:
- Haga clic en Add a platform
- Elija la opción Single-page application (SPA)
- Introduzca https://<SU-NOMBRE-DE-HOST-ESG>/outlook-addin-assets/taskpane.html en Redirect URI
- Haga clic en Settings
- Introduzca https://<SU-NOMBRE-DE-HOST-ESG>/outlook-addin-assets/taskpane.html en Front-Channel Logout URL
Configurar API Permission
- Ahora haga clic en API permissions en el menú izquierdo:
- Haga clic en Add a permission
- Seleccione la API Microsoft Graph
- Seleccione los siguientes permisos en Application permissions
- Mail.Read
- Seleccione los siguientes permisos en Delegate permissions
- offline_access
- openid
- profile
- Haga clic en Done
- Haga clic en Grant admin consent y haga clic en Yes en el cuadro de diálogo
Aplicar el consentimiento del administrador de la app
- Vaya a: App registration > Overview > desplácese hacia abajo > haga clic en “Go to Enterprise applications”
- Vaya a: Security > Permissions > haga clic en “Grant admin consent for ….”
- Acepte la solicitud de permiso
Creación del archivo Manifest.xml
Obtener el Directory (Tenant) ID
- Busque el portal App registrations como se muestra:
- Busque su App registration sobre Libraesva ESG y ábrala
- Tome nota del Directory (Tenant) ID que se muestra en la esquina superior derecha
Introducir el Directory (Tenant) ID en Libraesva ESG
- Vaya a Admin Area > Integrations > Microsoft 365
- Edite el conector
- Introduzca el Directory (Tenant) ID en la configuración del conector
- Ahora puede generar el archivo Manifest.xml haciendo clic en el botón para generarlo
- Decida qué configuraciones incluir o eliminar de las capacidades del add-in
-
- Barra lateral "Quarantine": Permite al usuario ver los mensajes almacenados actualmente en su entorno de quarantine
-
- Botón "Report as Bad": Permite al usuario reportar como malo un mensaje directamente desde el add-in sin necesidad de ninguna otra acción (Documentación: Cómo funciona el botón "Report as")
Habilitar las API en Libraesva ESG
- Inicie sesión en su ESG
- Vaya a Admin Area -> Authentication -> Web Portal -> API Service
- Habilite el API Service
IMPLEMENTACIÓN EN MICROSOFT 365
Si necesita implementar el Add-In automáticamente a muchos usuarios, puede gestionarlo de forma centralizada conectándose a Exchange Management Console.- Inicie sesión en su tenant de Microsoft 365 a través del Portal en línea de Microsoft con una cuenta de administrador
- en el centro de administración de Microsoft 365, elija Settings > Integrated apps > Add-ins
- Haga clic en + Deploy Add-in
- Haga clic en "+ Deploy Add-In"
- Seleccione "Upload custom apps"
- Seleccione "I have the manifest file (.xml) on this device"
- Seleccione el archivo Manifest.xml creado anteriormente
- Haga clic en Upload
- Seleccione "Everyone" para implementar el Add In en todo el tenant
- Seleccione uno o más usuarios/grupos para implementar el Add In
- Haga clic en Deploy
[fruitful_alert type="alert-info"]NOTA: puede tardar hasta 72 horas en implementarse el add-in para todos los usuarios debido a los tiempos de propagación de Microsoft. Si hay problemas con la implementación, contacte con el soporte de Microsoft[/fruitful_alert]
- Seleccione Next y luego Close
IMPLEMENTACIÓN EN EXCHANGE ON-PREMISE
Si necesita implementar el Add-In automáticamente a muchos usuarios, puede gestionarlo de forma centralizada conectándose a Exchange Management Console.- Inicie sesión en su Microsoft Exchange ECP con una cuenta de administrador.
- navegue hasta Organization y luego add-ins
- Haga clic en + (nuevo) – Add from URL
- Introduzca la siguiente URL: <su-nombre-de-host>/outlook-addin/manifest.xml
- Haga clic en Install
- Edite Libraesva ESG Outlook-Add-In y habilítelo
- Haga clic en Save
[fruitful_alert type="alert-info"]NOTA: si recibe el error: “The app couldn’t be downloaded” abra el enlace XML con un navegador en su PC y guárdelo como archivo. Luego, al añadir el Add-In, seleccione Add from a file en lugar de Add from URL como se describe anteriormente.[/fruitful_alert]