Microaplicaciones

Integrar Autocertificación de la Covid-19

Implemente la integración de Autocertificación de la COVID-19 para enviar su estado de autocertificación de COVID-19 mediante la respuesta de autocertificación desde Citrix Workspace.

¡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 esta microaplicación, consulte Usar microaplicaciones de Autocertificación de la COVID.

Revisar requisitos previos

Para esta integración, se requiere el paquete de aplicaciones Podio para Autocertificación de la COVID. Para obtener más información, consulte Obtener y configurar la aplicación Autocertificación de la COVID en Citrix Podio.

Tras configurar esta integración con Autocertificación de la COVID-19, necesitará estos artefactos para agregar la integración en las microaplicaciones de Citrix Workspace:

  • URL base: https://api.podio.com
  • ID de la aplicación Autocertificación de la COVID: Introduzca su ID de aplicación en el espacio de trabajo de Podio. Consulte Recopilar ID de aplicación y token de aplicación.
  • ID de vista de Autocertificación de la COVID: Introduzca su ID de vista para la aplicación en el espacio de trabajo de Podio. Consulte Recopilar ID de vista.
  • ID de aplicación de los datos de país: Introduzca su ID de aplicación de los datos de país, disponible en la autocertificación de COVID-19. Consulte Recopilar ID de aplicación de los datos de país.
  • Método de autenticación: OAuth 2.0

    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.

  • Flujo de tipo de concesión: Código de autorización
  • Valor de tipo de concesión: authorization_code
  • URL de respuesta: https://{yourmicroappserverurl}.us.iws.cloud.com/admin/api/gwsc/auth/serverContext
  • Autorización de token: Cuerpo de la solicitud
  • Tipo de contenido del token: URL codificada del formulario
  • URL de autorización: https://podio.com/oauth/authorize
  • URL del token: https://podio.com/oauth/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 del cliente: El secreto del cliente es la cadena única emitida al configurar la integración de la aplicación de destino.
  • URL de token de actualización: NA
  • Ámbito: NA
  • Estado de retransmisión: NINGUNO
  • Parámetros del token de acceso: Introduzca los parámetros de nombre y valor de acuerdo con las instrucciones que se indican a continuación:
    1. app_id: Introduzca su ID de aplicación en el espacio de trabajo de Podio. Consulte Recopilar ID de aplicación y token de aplicación.
    2. app_token: Introduzca el token de aplicación en el espacio de trabajo de Podio. Consulte Recopilar ID de aplicación y token de aplicación.
    3. grant_type: aplicación
  • Limitación del índice de solicitudes:15 solicitudes por minuto
  • Tiempo de espera de solicitud: 120

Crear cuenta de servicio

La integración requiere acceso periódico a su instancia de Autocertificación de la COVID, por lo que recomendamos crear una cuenta de usuario dedicada. Esta cuenta debe ser un administrador o miembro de la aplicación Autocertificación de la COVID en el espacio de trabajo de Podio.

Para agregar varios administradores o miembros a la aplicación Autocertificación de la COVID en el espacio de trabajo de Podio, consulte Inviting and adding members to a Podio workspace.

Obtenga y configure la aplicación Autocertificación de la COVID en Citrix Podio

Para esta integración se requiere el paquete de aplicaciones Podio para autocertificación de la COVID. El paquete de aplicaciones incluye la aplicación Autocertificación de la COVID y la aplicación Datos de país. Instale este paquete de aplicaciones desde Podio App Market: pack de aplicaciones Autocertificación de la COVID.

Para configurar la aplicación, siga estos pasos:

  1. Inicie sesión en su cuenta de Citrix Podio: https://podio.com/.
  2. Cree un espacio de trabajo con un nombre adecuado.
  3. Agregue la aplicación Datos de país a su espacio de trabajo e inserte los cuatro campos siguientes en dicha aplicación:
    1. Región: Agregue un componente de Texto llamado Region que almacene el nombre de la región.
    2. Países: Agregue un componente de Texto llamado Countries que almacene los países o las ciudades que quiere mostrar a los usuarios finales, relativo a la región.
    3. Directrices: Agregue un componente de Texto llamado Guidelines que almacene las directrices o las condiciones que los usuarios finales deben seguir.
    4. Imagen: Agregue un componente de Enlace llamado Image que almacene cualquier imagen adecuada para la región.
  4. Agregue la aplicación Autocertificación de la COVID al espacio de trabajo e inserte los siguientes seis campos en dicha aplicación:
    1. Nombre: Agregue un componente de Texto llamado Name que almacene el nombre del empleado/usuario.
    2. Correo electrónico: Agregue un componente de Correo electrónico llamado Email que almacene el correo electrónico del empleado/usuario.
    3. Condición Agregue un componente de Categoría llamado Condition e inserte dos opciones de categoría: Agree y Disagree.
    4. Fecha de creación: Agregue un componente de Fecha llamado CreatedOn que almacene el valor de fecha y hora aceptado o mejorado.
    5. Región: Agregue un componente de Texto llamado Region que almacene el valor de región seleccionado por el usuario/empleado.
    6. País: Agregue un componente de Texto llamado Country que almacene el valor de país seleccionado por el usuario/empleado.

Configurar la aplicación cliente de OAuth

  1. Inicie sesión en el sitio para desarrolladores de Podio como administrador de aplicaciones del espacio de trabajo de Podio: https://developers.podio.com.
  2. Seleccione Generar la clave de API.
  3. Seleccione Obtener una clave de API ahora y rellene los campos Nombre de aplicación y Dominio siguiendo las instrucciones que se indican a continuación.
    1. Nombre de aplicación: Introduzca el nombre de la aplicación.
    2. Dominio: Para el dominio completo (sin protocolo) de la URL de respuesta, introduzca su URL de instancia de microaplicaciones. Esta sección de la URL {yourmicroappserverurl} se compone de una parte de arrendatario, una parte de región y una parte de entorno: https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com.
  4. Seleccione Generar clave de API.
  5. En Sus claves de API, copie y guarde los valores de ID de cliente y Secreto del cliente para referencia posterior.

Para obtener más información, consulte https://docs.citrix.com/en-us/citrix-microapps/set-up-template-integrations/integrate-podio.html#collect-client-id-and-client-secret.

Recopilar ID de aplicación y token de aplicación

Obtenga el ID de aplicación y el token de aplicación de Podio para autenticación como aplicación, en lugar de como usuario. Con el acceso con ID de aplicación, los usuarios solo pueden acceder a los datos de las aplicaciones que se encuentran en el espacio de trabajo de Podio relacionado. Obtendrá este ID de aplicación Podio para el espacio de trabajo de Podio. Si tiene varias aplicaciones en un espacio de trabajo, puede usar cualquiera de los ID de aplicación afiliados al espacio de trabajo.

Siga estos pasos:

  1. Inicie sesión en Podio y vaya a su aplicación Podio.
  2. Seleccione el icono Herramientas situado junto al nombre de la aplicación.
  3. En Aplicación, seleccione Desarrollador.
  4. Copie y guarde los campos ID de aplicación y Token. Introducirá estos valores como parámetros de token de acceso al configurar la integración.

Para obtener más información, consulte https://docs.citrix.com/en-us/citrix-microapps/set-up-template-integrations/integrate-podio.html#collect-app-id-and-app-token.

Recopilar ID de vista

  1. Inicie sesión en Podio y vaya a su aplicación Podio.
  2. Pase el ratón sobre el campo especificado para ver el ID de vista en la sección inferior izquierda del explorador. Para Autocertificación de la COVID-19, coloque el cursor sobre Aceptada/No aceptada y busque su ID de vista en el enlace URL.

Para obtener más información, consulte https://docs.citrix.com/en-us/citrix-microapps/set-up-template-integrations/integrate-podio.html#collect-view-id.

Recopilar ID de aplicación de Datos de país

  1. Inicie sesión en Podio y vaya a su aplicación Podio.
  2. Seleccione el icono Herramientas situado junto al nombre de la aplicación.
  3. En Aplicación Datos de país, seleccione Desarrollador.
  4. Copie y guarde los campos ID de aplicación y Token. Introducirá estos valores como parámetros de token de acceso al configurar la integración.

Agregar la integración a las microaplicaciones de Citrix Workspace

Agregue la integración de Autocertificación de la COVID a las microaplicaciones de Citrix Workspace para conectarse a su aplicación. 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 mosaico Autocertificación de la COVID.
  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://api.podio.com
    • Introduzca su ID de aplicación de Podio.
    • Introduzca el ID de vista de la aplicación en el espacio de trabajo de Podio.

    Configuración de Autocertificación de la COVID

  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ú Flujo de tipo de concesión, seleccione Código de autorización.
    2. En el campo Valor de tipo de concesión, introduzca authorization_code.
    3. En el campo URL de respuesta, introduzca https://{yourmicroappserverurl}.us.iws.cloud.com/admin/api/gwsc/auth/serverContext.
    4. Seleccione Cuerpo de la solicitud en el menú Autorización de token.
    5. En el menú Tipo de contenido de token, seleccione URL codificada del formulario.
    6. En el campo URL de autorización, introduzca https://podio.com/oauth/authorize.
    7. Confirme el campo URL del token. Este valor viene prerrellenado: https://podio.com/oauth/token.
    8. Introduzca el 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 del cliente al generar una clave de API. Consulte Configurar la aplicación cliente de OAuth.
    9. Introduzca el Secreto del cliente: El secreto del cliente es la cadena única emitida al configurar la integración de la aplicación de destino. Obtendrá este y el ID de cliente al generar una clave de API. Consulte Configurar la aplicación cliente de OAuth.
  6. URL de token de actualización: NA
  7. Ámbito: NA
  8. Estado de retransmisión: NINGUNO

    Configuración de la autenticación de COVID

  9. Agregue los siguientes Parámetros del token de acceso. Para obtener más información, consulte Recopilar ID de aplicación y token de aplicación.
    1. app_id: Introduzca el ID de aplicación en el espacio de trabajo de Podio
    2. app_token: Introduzca el token de aplicación en el espacio de trabajo de Podio
    3. grant_type: aplicación

Configuración del token de COVID

  1. 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 Google.
    1. Introduzca el Nombre de usuario de la cuenta de servicio y la Contraseña de la cuenta de servicio y seleccione Iniciar sesión.
    2. Seleccione Aceptar.
  2. En el campo Limitación del índice de solicitudes, introduzca 15 solicitudes por minuto.
  3. En el campo Tiempo de espera de solicitud, introduzca 120.
  4. Seleccione Guardar para continuar.

Ya tiene todo listo para configurar y llevar a cabo su primera sincronización de datos. 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:

Se recomienda desencadenar una sincronización incremental una vez cada hora y una sincronización completa dos o tres veces al día.

Para obtener información detallada sobre los dispositivos de punto final de las API y las entidades de tabla, consulte Especificaciones del conector de Autocertificación de la COVID-19.

Usar microaplicaciones de Autocertificación de la COVID

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

Autocertificarse: Envíe su respuesta diaria de estado de autocertificación de la COVID-19 desde Citrix Workspace.

Notificación o página Flujos de trabajo por caso de uso
Autocertificación de la COVID: Aceptada: Notificación de cambio de elemento Reciba notificaciones sobre todos los envíos de respuestas de Autocertificación de la COVID-19 aceptadas.
Autocertificación de la COVID: No aceptada: Notificación de cambio de elemento Reciba notificaciones sobre todos los envíos de respuestas de Autocertificación de la COVID-19 no aceptadas.
Nueva autocertificación: Aceptada: Notificación de nuevo elemento Reciba notificaciones sobre todos los envíos de respuestas de Autocertificación de la COVID-19 aceptadas (Nuevo usuario).
Nueva autocertificación: No aceptada: Notificación de nuevo elemento Reciba notificaciones sobre todos los envíos de respuestas de Autocertificación de la COVID-19 no aceptadas (Nuevo usuario).
Seleccionar región: Página de elemento Elija la ubicación de trabajo.
Página Directrices de autocertificación Envíe la respuesta para la autocertificación diaria.
Autocertificación aceptada: Página de elemento Vea los detalles de la respuesta aceptada para la autocertificación diaria.
Página Autocertificación confirmada Vea los detalles de la respuesta aceptada para la autocertificación diaria desde su feed de notificaciones.
Página Autocertificación denegada Vea los detalles de la respuesta no aceptada para la autocertificación diaria.
Página Autocertificación no aceptada Vea los detalles de la respuesta no aceptada para la autocertificación diaria desde su feed de notificaciones.