Integración con Outlook¶
Puede añadir una integración con Outlook a su instalación de Drovio Server. Permite a los usuarios programar reuniones de Drovio directamente desde su calendario de Outlook: un botón Add a Drovio meeting coloca el enlace para unirse en la cita, y el envío de la cita mantiene la reunión al día con su fecha, sus asistentes y su periodicidad. Necesitará un registro de aplicación en Microsoft Entra ID.
El complemento funciona en Outlook en la web, el nuevo Outlook para Windows, Outlook clásico para Windows y Outlook para Mac. Conecta a sus usuarios con su cuenta de Microsoft: la primera vez, se conectan además una sola vez a su instancia de Drovio Server, para vincular ambas cuentas. Su cuenta de Drovio debe existir previamente.
Solo HTTPS
Outlook solo carga los complementos por HTTPS. Su Drovio Server debe ser accesible por HTTPS desde los equipos en los que se ejecuta Outlook.
Registrar el complemento en Microsoft Entra ID¶
En lo que sigue, <your server> designa el nombre de host de la URL pública de su
Drovio Server, por ejemplo drovio.example.com.
No tiene que construir a mano el URI de redirección ni el Application ID URI: la página Outlook del panel de administración muestra ambos, listos para copiar. Abra Integrations y luego Configure en la tarjeta Outlook.
Crear el registro de aplicación¶
En el portal de Azure, abra Microsoft Entra ID, luego App registrations, y New registration.
| Campo | Valor |
|---|---|
| Name | El nombre que prefiera, por ejemplo Drovio Outlook |
| Supported account types | Accounts in this organizational directory only (un solo tenant) |
| Redirect URI | Single-page application (SPA), y luego brk-multihub://<your server> |
En el panel Overview, anote:
| Valor en Entra ID | Se usa como |
|---|---|
| Application (client) ID | client_id |
| Directory (tenant) ID | tenant_id |
No hace falta ningún secreto de cliente: el complemento nunca se autentica como la aplicación.
Exponer la API¶
En Expose an API, haga clic en Add junto al Application ID URI, e introduzca el URI que muestra el panel de administración una vez guardado el Application ID:
api://<your server>/<client id>
Luego Add a scope:
| Campo | Valor |
|---|---|
| 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 |
Todavía en Expose an API, haga clic en Add a client application,
introduzca ea5a67f6-b6f3-4338-b240-c655ddc3cc8e y marque el ámbito
access_as_user. Este identificador representa al conjunto de las aplicaciones
de Office, que piden un token en nombre del complemento cuando Outlook no dispone
de la autenticación de aplicaciones anidadas (nested app authentication).
Pedir tokens de la versión 2¶
En Manifest, ponga requestedAccessTokenVersion en 2, en la sección api,
y luego Save. Drovio Server comprueba los tokens tal como Entra ID los emite
en esa versión.
Conceder el consentimiento¶
En API permissions, Add a permission, abra APIs my organization
uses, busque el registro de aplicación por su nombre y añada su permiso
delegado access_as_user. Haga clic después en Grant admin consent for
<your tenant>, lo que ahorra a cada usuario la solicitud de
consentimiento.
Configurar la integración¶
En el panel de administración, abra Integrations y luego Configure en la tarjeta Outlook.
| Campo | De dónde viene |
|---|---|
| Status | Enabled o Disabled |
| Application ID | El client_id anotado en Entra ID |
| Tenant ID | El tenant_id anotado en Entra ID |
El guardado surte efecto desde la petición siguiente, sin reinicio. Una vez guardado el Application ID, la página muestra el Application ID URI y el URI de redirección que el registro de aplicación debe declarar.
Pasar el estado a Disabled rechaza las peticiones que vienen de Outlook, dejando la página accesible para configurar la integración.
Referencia de configuración¶
Estas son las claves del elemento outlook de settings.conf, si prefiere
editarlo directamente. En un clúster, el panel de administración no puede
guardarlas: cada servidor lee su propio fichero de configuración, que hay que
editar en cada uno de ellos.
| Clave | Por defecto | Significado |
|---|---|---|
enabled |
false |
Activa la integración |
client_id |
Application (client) ID del registro de aplicación | |
tenant_id |
Directory (tenant) ID del registro de aplicación, necesario para activar la integración | |
manifest_id |
Identifica el complemento en Microsoft 365. Se fija en el primer guardado, no lo modifique |
Desplegar el complemento¶
El complemento se describe mediante un manifest que apunta a su servidor. En la página Outlook del panel de administración, la sección Manifest permite descargarlo, rellenado con la configuración guardada.
En el centro de administración de Microsoft 365, vaya a Settings, luego Integrated apps, y Upload custom apps. Elija Office Add-in, cargue el manifest y seleccione después los usuarios o los grupos a los que desplegarlo. El despliegue tarda hasta 24 horas en llegar a Outlook, a veces más en Outlook clásico para Windows.
Usar el complemento¶
En una cita que organiza el usuario, la cinta muestra un grupo Drovio:
| Botón | Lo que hace |
|---|---|
| Add a Drovio meeting | Crea la reunión de Drovio a partir de la cita, pone el enlace para unirse como ubicación y lo añade a la invitación |
| Settings | Muestra la cuenta de Drovio con la que está conectado el complemento, y permite desconectarse |
Cuando se envía la cita, el complemento actualiza la reunión de Drovio con los cambios realizados desde entonces: asunto, descripción, fechas, asistentes y periodicidad. Drovio no envía ninguna invitación propia: la invitación de Outlook es la que reciben los asistentes.
Outlook en la web y el nuevo Outlook
En Outlook en la web y el nuevo Outlook para Windows, el complemento solo se ejecuta al enviar cuando la cita está abierta en una ventana propia, con Open in new window. Desde el formulario que se abre dentro de la ventana principal, o cuando la cita se reenvía, los cambios realizados después de añadir la reunión de Drovio no llegan a ella.