Microaplicaciones

Integrar Webex

Implemente la integración de Webex para programar reuniones de Webex desde cualquier dispositivo o intranet. Los usuarios pueden alojar reuniones periódicas o puntuales, agregar invitados y coanfitriones, y seleccionar entre diferentes zonas horarias. Además, la microaplicación incluye correo electrónico de seguimiento para el anfitrión y los invitados con el objeto de la reunión correspondiente para facilitar la integración con el calendario.

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 una lista completa de las microaplicaciones de Webex de uso inmediato, consulte Usar las microaplicaciones de Webex.

Revisar requisitos previos

En estos requisitos previos, se entiende que el administrador forma parte de la estructura de integración de Webex de la organización. Esta cuenta de administrador de Webex debe tener privilegios de lectura sin restricciones de la información del usuario.

Tras configurar esta integración con Webex, necesitará estos artefactos para agregar la integración en las microaplicaciones de Citrix Workspace; en concreto, la siguiente lista de parámetros para configurar la integración de OAuth:

  • URL BASE: https://webexapis.com/v1/
  • URL DE AUTORIZACIÓN: https://webexapis.com/v1/authorize
  • URL DEL TOKEN: https://webexapis.com/v1/access_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 Webex, 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.

La integración requiere acceso periódico a su instancia de Webex, por lo que recomendamos crear una cuenta de usuario dedicada. Esta cuenta debe tener los siguientes permisos. Puede ver los permisos/privilegios a través de Webex Control Hub, en .

  • Permisos necesarios para la cuenta de servicio: Privilegios de administrador total

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

Habilitar API

Las API de Webex están habilitadas de forma predeterminada a través de servicios web para las cuentas de pago.

Crear una cuenta de servicio

Regístrese aquí: https://web.webex.com/. Consulte la siguiente URL para las nuevas cuentas de servicio: https://help.webex.com/en-us/nkhozs6/Get-Started-with-Cisco-Webex-Control-Hub.

Configurar el servidor de OAuth

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

  1. Inicie sesión con su cuenta de servicio en: https://developer.webex.com/docs/platform-introduction.
  2. Seleccione el nombre de usuario presente en la parte superior derecha.
  3. Seleccione My Webex Apps y Create a New App.
  4. Seleccione Create an Integration en el icono Integration.
  5. 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
  6. En la sección Scopes, seleccione las casillas de verificación spark:all y spark-admin:people_read.
  7. Después de completar todos los campos obligatorios, seleccione Add Integration.
  8. Copie y guarde el ID de cliente y el secreto que aparecen en la pantalla. Utilice estos detalles para la autenticación de servicio mientras configura la integración.

Configurar cliente de OAuth

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

  1. Inicie sesión con su cuenta de servicio, como antes: https://developer.webex.com/docs/platform-introduction.
  2. Seleccione el nombre de usuario presente en la parte superior derecha.
  3. Seleccione My Webex Apps y Create a New App.
  4. Seleccione Create an Integration en el icono Integration.
  5. 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
  6. En la sección Scopes, active la casilla de verificación meeting:schedules_write.
  7. Después de completar todos los campos obligatorios, seleccione Add Integration.
  8. Copie y guarde el ID de cliente y el secreto que aparecen en la pantalla. Utilice estos detalles para la autenticación de acciones de servicio mientras configura la integración.

Agregar la integración a las microaplicaciones de Citrix Workspace

Agregue la integración de Webex Meeting 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 Webex Meeting.
  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 de la instancia: https://webexapis.com/v1/.
    • Seleccione un icono para la integración en la Biblioteca de iconos, o deje el icono predeterminado.

    Nombre y URL base

  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. 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 muestra la URL de respuesta, que utiliza al registrar su aplicación
    2. Seleccione Cuerpo de la solicitud en el menú Autorización de token.
    3. La URL de autorización se rellena automáticamente: https://webexapis.com/v1/authorize
    4. La URL del token se rellena automáticamente: https://webexapis.com/v1/access_token
    5. Compruebe que el valor introducido para el ámbito es el siguiente: spark:all spark-admin:people_read
    6. 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.
    7. 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.

    Autenticación de servicio

  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 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.
    3. Seleccione Cuerpo de la solicitud en el menú Autorización de token.
    4. La URL de autorización se rellena automáticamente: https://webexapis.com/v1/authorize
    5. La URL del token se rellena automáticamente: https://webexapis.com/v1/access_token
    6. Compruebe que se ha introducido lo siguiente para el ámbito: meeting:schedules_write
    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.

    Autenticación de acciones de servicio

  7. Seleccione la opción Habilitar la limitación del índice de solicitudes. Introduzca 100 como Cantidad de solicitudes y 1 minuto como Intervalo de tiempo.
  8. (Optativo) Habilite la opción Registro para conservar un registro de 24 horas con fines de asistencia.

    Opciones para limitación de solicitudes y registro

  9. Seleccione Guardar para continuar.
  10. En Autorización de OAuth, seleccione Autorizar para iniciar sesión con su cuenta de servicio. Aparecerá una ventana emergente con una pantalla de inicio de sesión de Webex.
    1. Introduzca el nombre de usuario y la contraseña de su cuenta de servicio y seleccione Iniciar sesión.
    2. Seleccione Aceptar. Autenticación de servicio

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.

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

Usar las microaplicaciones de Webex Meetings

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

Crear una reunión: Permite programar y seleccionar la duración, las zonas horarias, los invitados y los coanfitriones.

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