Microaplicaciones

Integrar Microsoft Outlook

Implemente la integración de Microsoft Outlook para programar y modificar eventos y horas de oficina, y para recibir una notificación una hora antes de la hora de inicio de un evento.

Nota:

¡Su opinión nos interesa! Proporcione comentarios sobre esta plantilla de integración a medida que la utiliza. Para cualquier problema, nuestro equipo también supervisará el foro dedicado a diario.

Para obtener información detallada sobre la microaplicación de uso inmediato para Microsoft Outlook, consulte Usar microaplicaciones de Microsoft Outlook.

Revisar requisitos previos

Tras configurar esta integración con Microsoft Outlook, necesitará estos artefactos para agregar la integración en las microaplicaciones de Citrix Workspace:

  • URL BASE: https://graph.microsoft.com/
  • URL DE AUTORIZACIÓN: https://login.microsoftonline.com/{tenantId}/oauth2/v2.0/authorize
  • URL DEL TOKEN: https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token
  • ID DE CLIENTE: El ID de cliente es la cadena que representa la información de registro del cliente exclusiva del servidor de autorización.
  • SECRETO: El secreto del cliente es la cadena única emitida al configurar la integración de la aplicación de destino.

Nota:

Se recomienda utilizar OAuth 2.0 como método de autenticación del servicio siempre que esté disponible. OAuth 2.0 garantiza que la integración es conforme a los requisitos de seguridad más estrictos con la microaplicación configurada.

Configure Citrix Gateway para que admita Single Sign-On para Microsoft Outlook, de modo que, una vez que los usuarios hayan iniciado sesión, no tengan que volver a introducir sus credenciales para registrarse. Para obtener más información acerca de la configuración de SSO, consulte Citrix Gateway Service https://docs.citrix.com/en-us/citrix-gateway-service/.

El número de solicitudes de API que se pueden realizar a recursos específicos es limitado, por lo que recomendamos lo siguiente:

Permisos

La integración requiere acceso periódico a su instancia de Microsoft Outlook, por lo que recomendamos crear una cuenta de usuario dedicada. Puede ver los permisos o privilegios en https://docs.microsoft.com/en-us/graph/permissions-reference.

Esta cuenta debe tener los siguientes permisos: Administrador global. El rol Administrador global concede consentimiento de administrador para los permisos a nivel de aplicación y las API de acceso en Microsoft Outlook.

Inicie sesión aquí: https://account.microsoft.com/.

Configurar el servidor de OAuth

Configure el servidor de OAuth para que lea los datos a través de la integración de Microsoft Outlook.

  1. Inicie sesión con su cuenta de servicio en: https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/RegisteredApps
  2. Seleccione New Register.
  3. En Supported account types, seleccione Accounts in any organizational directory (Any Azure AD directory - Multitenant).
  4. Rellene los campos necesarios e introduzca las siguientes URL de redirección autorizadas para esta integración en el campo Redirect URL: https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext
  5. Haga clic en Register.
  6. Copie y guarde los valores de Application (client) ID y Directory (tenant) ID que se muestran en pantalla. Utilice estos detalles para la autenticación de servicio mientras configura la integración.
  7. Haga clic en View Permissions en Call API y seleccione Add a permission y elija el icono de Microsoft Graph.
  8. Seleccione el icono Application permissions y agregue los ámbitos enumerados a continuación: **User.Read.All Calendars.Read**
  9. Seleccione Grant admin consent for Citrix Systems y seleccione Yes.
  10. Seleccione Certificates & secrets en el panel izquierdo y seleccione New client secret. Elija la validez de caducidad “nunca” y haga clic en Add.
  11. Copie y guarde el valor de los secretos del cliente.

Configurar cliente de OAuth

Configure el cliente OAuth para reescritura de datos a través de la integración de Microsoft Outlook.

  1. Inicie sesión con su cuenta de servicio en: https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/RegisteredApps
  2. Seleccione New Register.
  3. En Supported account types, seleccione Accounts in any organizational directory (Any Azure AD directory - Multitenant).
  4. Rellene los campos necesarios e introduzca las siguientes URL de redirección autorizadas para esta integración en el campo Redirect URL: https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback
  5. Haga clic en Register.
  6. Copie y guarde los valores de Application (client) ID y Directory (tenant) ID que se muestran en pantalla. Utilice estos detalles para la autenticación de servicio mientras configura la integración.
  7. Haga clic en View Permissions en Call API y seleccione Add a permission y elija el icono de Microsoft Graph.
  8. Seleccione el icono Delegated permissions y agregue estos ámbitos enumerados: **Calendars.ReadWrite**
  9. Seleccione Grant admin consent for Citrix Systems y seleccione Yes.
  10. Seleccione Certificates & secrets en el panel izquierdo y seleccione New client secret. Elija la validez de caducidad “nunca” y haga clic en Add.
  11. Copie y guarde el valor de los secretos del cliente.

Agregar la integración a las microaplicaciones de Citrix Workspace

Agregue la integración de Microsoft Outlook a las microaplicaciones de Citrix Workspace para conectarse a su aplicación. Las opciones de autenticación están preseleccionadas. Compruebe que estas opciones estén seleccionadas a medida que complete el proceso. Esto proporciona microaplicaciones de uso inmediato con notificaciones y acciones preconfiguradas que se pueden usar desde ya en su espacio de trabajo.

Siga estos pasos:

  1. En la página Integraciones de microaplicaciones, seleccione Agregar nueva integración y Agregar una nueva integración a partir de plantillas proporcionadas por Citrix.
  2. Elija el icono de Microsoft Outlook.
  3. En el campo Nombre de la integración, introduzca un nombre para la misma.
  4. Introduzca los parámetros del conector.

    • Introduzca la URL base https://graph.microsoft.com/ de la instancia:
    • Seleccione un icono para la integración en la Biblioteca de iconos, o deje el icono predeterminado.
  5. En Autenticación de servicio, seleccione OAuth 2.0 en el menú Método de autenticación y complete los detalles correspondientes. Las opciones de autenticación están preseleccionadas. Compruebe que estas opciones estén seleccionadas a medida que complete el proceso. Utilice el protocolo de seguridad de OAuth 2.0 para generar tokens de solicitud/autorización para el acceso delegado. Se recomienda utilizar OAuth 2.0 como método de autenticación del servicio siempre que esté disponible. OAuth 2.0 garantiza que la integración es conforme a los requisitos de seguridad más estrictos con la microaplicación configurada.

    1. En el menú Tipo de concesión, seleccione Credenciales del cliente.
    2. Seleccione Cuerpo de la solicitud en el menú Autorización de token.
    3. La URL del token se rellena automáticamente: https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token
    4. Compruebe que se ha introducido lo siguiente para el ámbito: .default offline_access
    5. Introduzca su ID de cliente. El ID de cliente es la cadena que representa la información de registro del cliente exclusiva del servidor de autorización. Obtendrá este y el secreto al configurar el servidor de OAuth. Deberá agregar la URL de respuesta que aparece en la página de configuración de la integración.
    6. Introduzca su Secreto del cliente. El secreto del cliente es la cadena única emitida al configurar la integración de la aplicación de destino.
  6. En Autenticación de acciones de servicio, habilite la opción Usar autenticación de usuario independiente en Acciones. La autenticación de acciones de servicio autentica en el nivel de acción de servicio. Las opciones de autenticación están preseleccionadas. Compruebe que estas opciones estén seleccionadas a medida que complete el proceso.

    1. En el menú Método de autenticación, seleccione OAuth 2.0 y complete los detalles de autenticación.
    2. Seleccione Cuerpo de la solicitud en el menú Autorización de token.
    3. Seleccione Código de autorización en el menú Tipo de concesión. De esta manera, se concede un código temporal que el cliente intercambia por un token de acceso. El código se obtiene del servidor de autorización, donde se puede ver la información que solicita el cliente. Solo este tipo de concesión permite la suplantación segura de usuarios. Se mostrará la URL de respuesta, que utiliza al registrar su aplicación.
    4. La URL de autorización se rellena automáticamente: https://login.microsoftonline.com/{tenantId}/oauth2/v2.0/authorize
    5. La URL del token se rellena automáticamente: https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token
    6. Compruebe que se ha introducido lo siguiente para el ámbito: .default offline_access
    7. Introduzca su ID de cliente. El ID de cliente es la cadena que representa la información de registro del cliente exclusiva del servidor de autorización. Obtendrá este y el secreto al configurar el cliente de OAuth. Deberá agregar la URL de respuesta que aparece en la página de configuración de la integración.
    8. Introduzca su Secreto del cliente. El secreto del cliente es la cadena única emitida al configurar la integración de la aplicación de destino.
  7. Seleccione la opción Habilitar la limitación del índice de solicitudes. Introduzca 60 como Cantidad de solicitudes y 1 segundo como Intervalo de tiempo.
  8. (Optativo) Habilite la opción Registro para conservar un registro de 24 horas con fines de asistencia.
  9. Seleccione Guardar para continuar.

Se abrirá la página Integraciones de microaplicaciones con la integración agregada y sus microaplicaciones. Desde aquí, puede agregar otra integración, seguir configurando sus microaplicaciones de uso inmediato o crear una nueva microaplicación para esta integración.

Ya tiene todo listo para configurar y llevar a cabo su primera sincronización de datos. Como se puede extraer una gran cantidad de datos de la aplicación integrada y transferirla a la plataforma de microaplicaciones, le recomendamos utilizar la página Tabla para filtrar entidades relacionadas con la primera sincronización de datos y, así, acelerar la sincronización. Para obtener más información, consulte Verificar las entidades necesarias. Para obtener información completa acerca de las reglas de sincronización, la sincronización que no cumple con sus reglas de programación y las reglas de veto, consulte Sincronizar datos.

Nota:

La integración de Microsoft Outlook de Citrix utiliza Actualización de datos después de la acción para extraer los datos más recientes del usuario que ha iniciado sesión con el botón Actualizar tabla de la acción de servicio Mi calendario. Recomendamos utilizar este enfoque tal cual. Utilice la sincronización completa predeterminada una vez por semana para conservar una cantidad óptima de datos del usuario. Además, la integración no admite la sincronización incremental y se basa únicamente en la actualización de datos después de la acción para extraer los datos más recientes. Se recomienda establecer el intervalo “Sincronización completa” en semanal para quitar los eventos cancelados o eliminados de la plataforma de microaplicaciones y posteriormente del calendario del usuario.

El botón Actualizar sirve para sincronizar la memoria caché con los datos más recientes, en lugar de sincronización completa o incremental. Dado que esta integración no se basa en la sincronización completa/incremental para la última extracción de datos, la paginación no es necesaria ni se implementa. Esto también ayuda a limitar las llamadas de API.

Para obtener más información sobre los dispositivos de punto final de las API y las entidades de tabla, consulte Especificaciones del conector de MS Outlook.

Nota:

El dispositivo de punto final de datos de vista de Calendario está codificado con start_date_time and end_date_time pasados, ya que son obligatorios. Sin embargo, el usuario verá los datos más recientes en sus microaplicaciones con el método del botón Actualizar.

Usar microaplicaciones de Microsoft Outlook

Las integraciones de las aplicaciones existentes vienen con microaplicaciones de uso inmediato. Comience con estas microaplicaciones y personalícelas conforme a sus exigencias.

Nota:

Dado que las 40 zonas horarias disponibles actualmente están codificadas en las microaplicaciones Crear evento, Mis horas de oficina y Mi calendario, la incorporación de cualquier otra zona horaria requeriría que el administrador la agregase manualmente.

Crear evento: Esta microaplicación sirve para programar un evento o reunión conforme a las preferencias del usuario.

Notificación o página Flujos de trabajo por caso de uso
Página Crear evento Proporciona un formulario para programar un evento con los siguientes detalles según las preferencias del usuario: Título del evento, fecha y hora de inicio, fecha y hora de finalización, zona horaria, periodicidad (una vez, diaria, semanal, mensual), lugar, descripción y asistentes o invitados.

Mi Calendario: Esta microaplicación sirve para ver y modificar próximos eventos o reuniones.

Nota:

Las notificaciones de recordatorio de evento se activan solo para el organizador de este una hora antes de que comience (valor start_date_time). Esta notificación solo se activa para los eventos que se encuentran en la memoria caché del servidor de microaplicaciones en un momento dado. Para garantizar el envío de notificaciones oportunas, recomendamos usar el botón Actualizar tabla con frecuencia, así como ejecutar la sincronización completa semanal estándar, a fin de evitar la eliminación de notificaciones o el envío de notificaciones incorrectas.

Notificación o página Flujos de trabajo por caso de uso
Notificación Recordatorio del evento El propietario del evento recibe una notificación una hora antes de que comience.
Página Detalles del próximo evento Proporciona una vista de solo lectura de un evento con detalles, un botón para unirse a la reunión y un botón de modificación solo para el propietario del evento.
Página Próximos eventos Permite a los usuarios buscar eventos.
Página Detalles del evento Proporciona una vista de solo lectura de un evento con detalles. La opción Modificar está disponible para el propietario del evento.
Página Modificar evento Proporciona un formulario para modificar un evento.

Mis horas de oficina: Esta microaplicación sirve para crear, ver y modificar horas de oficina virtuales.

Notificación o página Flujos de trabajo por caso de uso
Página Horas de oficina virtual Permite a los usuarios ver las horas de oficina.
Página Crear horas de oficina Proporciona un formulario para programar horas de oficina virtual con los siguientes detalles conforme a las preferencias del usuario: Fecha/hora de inicio, fecha/hora de finalización, zona horaria, periodicidad (diaria, semanal, mensual), descripción de las horas de oficina.
Página Modificar horas de oficina Proporciona un formulario para modificar las horas de oficina.
Integrar Microsoft Outlook