Microaplicaciones

Integrar Adobe Sign

Implemente la integración de Adobe Sign para hacer digitales todos los acuerdos y aprobaciones de forma rápida y segura.

Con la integración de Adobe Sign de Citrix, los usuarios pueden realizar las siguientes acciones:

  • Enviar una plantilla y cargar acuerdos para su firma por los destinatarios.
  • Enumerar los acuerdos de Adobe Sign a la espera de firma. Los usuarios pueden firmar el acuerdo desde Citrix Workspace.
  • Enumerar los acuerdos de Adobe Sign enviados para firma. Los usuarios también pueden cancelar un acuerdo enviado.
  • Enumerar los acuerdos de Adobe Sign completados, con detalles. Los usuarios también pueden compartir los acuerdos recibidos.
  • Enumerar los acuerdos de Adobe Sign cancelados, con detalles.
  • Administrar y modificar acuerdos de plantilla.

¡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 las microaplicaciones, consulte Usar microaplicaciones de Adobe Sign.

Revisar requisitos previos

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

  • URL base: https://api.in1.adobesign.com/
  • ID de grupo de Adobe Sign: Este ID de grupo representa el identificador de grupo de usuarios para la cuenta de administrador.
  • Acuerdos por usuario: Representa el número de acuerdos que se deben almacenar por usuario en caché. El valor máximo es 100. Recomendamos de 15 a 30 acuerdos por usuario.
  • URL de autorización: https://{HostName}.com/public/oauth
  • URL del token: https://{HostName}.com/oauth/token
  • URL de token de actualización: https://{HostName}.com/oauth/refresh
  • Ámbito: user_read:self user_write:self user_login:self agreement_read:self agreement_write:self agreement_send:self application_write:self library_write:self
  • 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.
  • Estado de retransmisión: NINGUNO
  • Limitación del índice de solicitudes: 500 solicitudes por segundo
  • Tiempo de espera de solicitud: 120

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.

Crear cuenta de servicio

La integración requiere un acceso periódico a su instancia de Adobe Sign. Recomendamos crear una cuenta de usuario dedicada. Debe ser una cuenta de administrador de Adobe Sign con privilegios de administrador total.

Para configurar una nueva cuenta, consulte Crear una cuenta gratuita de Adobe Sign.

Habilitar API

No hay ninguna limitación de API mencionada en Adobe Sign. Los límites de transacciones de Adobe Sign se mencionan en el siguiente enlace: https://helpx.adobe.com/in/sign/using/transaction-limits.html. Puede elegir los planes que mejor se adapten a sus necesidades.

Configurar la aplicación cliente de OAuth

Configure el cliente de OAuth para reescritura de datos a través de la integración. Para obtener más información sobre cómo trabajar con Adobe Sign, consulte la Guía de introducción (Adobe Sign).

  1. Inicie sesión en la cuenta de administrador de Adobe Sign: https://secure.echosign.com/public/login
  2. Seleccione Cuenta y Aplicaciones de API en la sección API de Adobe Sign.
  3. Seleccione Crear y cree dos nuevas aplicaciones.
  4. Para la primera aplicación, pegue las URL de redirección en el campo URI de redirección .

    • https://{yourmicroappserverurl}.us.iws.cloud.com/app/api/auth/serviceAction/callback
    • https://{yourmicroappserverurl}.us.iws.cloud.com/admin/api/gwsc/auth/serverContext
  5. Seleccione la opción Configurar OAuth y habilite todos los ámbitos con modificador como Grupo.
  6. Repita el mismo proceso para la segunda aplicación OAuth.
  7. Recopile el ID de cliente y el secreto de cliente de ambas aplicaciones OAuth y guárdelos para uso en el futuro. Estos valores se utilizan en Autenticación de servicio y Autenticación de acciones de servicio mientras se configura la integración.

Configurar grupo y obtener el ID de grupo

Los grupos permiten tener subconjuntos de usuarios separados que tienen acceso a distintos documentos de la biblioteca y diferentes configuraciones. Para obtener más información, consulte Crear y administrar grupos (Adobe Sign.

  1. Inicie sesión en la cuenta de administrador de Adobe Sign: https://secure.echosign.com/public/login
  2. Seleccione Account y, a continuación, la sección Groups.
  3. Seleccione Create New Group para agregar un nuevo grupo.
  4. Introduzca un nombre apropiado para el grupo.
  5. Seleccione y elija la opción Group Setting para encontrar el ID de grupo en la página de configuración.
  6. Agregue o importe usuarios a los grupos.

Agregar la integración a las microaplicaciones de Citrix Workspace

Agregue la integración de Adobe Sign 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. Seleccione el mosaico de Adobe Sign.
  3. Introduzca un nombre para la integración.
  4. Introduzca los parámetros del conector:

    • Introduzca la URL base de la instancia: https://api.in1.adobesign.com/
    • Seleccione un icono para la integración en la Biblioteca de iconos, o deje el icono predeterminado.
    • Introduzca el ID de grupo de Adobe Sign. Para obtener más información, consulte Configurar grupo y obtener el ID de grupo.
    • Introduzca los Acuerdos por usuario. Es el número de acuerdos que se deben almacenar por usuario en la caché. El valor máximo es 100. Recomendamos de 15 a 30 acuerdos por usuario.
  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 y Tipo de contenido de token como URL codificada del formulario.
    3. Introduzca la URL del token de actualización: https://{HostName}/oauth/refresh.
    4. Introduzca lo siguiente para el Ámbito: user_read:self user_write:self user_login:self agreement_read:self agreement_write:self agreement_send:self application_write:self library_write:self
    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. Agregue 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 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
    3. Seleccione Cuerpo de la solicitud en el menú Autorización de token.
    4. La URL de autorización se rellena automáticamente.
    5. La URL del token se rellena automáticamente.
    6. Asegúrese de que se ha introducido lo siguiente para el Ámbito: user_read:self user_write:self user_login:self agreement_read:self agreement_write:self agreement_send:self application_write:self library_write:self library_read:self
    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. Agregue 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 Guardar para continuar.
  8. 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 y la contraseña de su cuenta de servicio y seleccione Iniciar sesión.
    2. Seleccione Aceptar.

Agregar acción de redirección a los botones de Abrir acuerdo

Configure esta acción Ir a URL con su nombre de host para los siguientes botones a fin de habilitar la funcionalidad de botón Abrir acuerdo para estas microaplicaciones. Esta configuración de Ir a URL redirige a los usuarios a la página de detalles del sobre específica en DocuSign. Desplácese hasta cada botón que se indica a continuación para realizar esta acción:

Microaplicación Página Botón
Acuerdos en curso Detalles de los acuerdos en curso Abrir acuerdo
Acuerdos cancelados Detalles de los acuerdos cancelados Abrir acuerdo
Acuerdos cancelados Acuerdo cancelado Abrir acuerdo
Acuerdos completados Detalles del acuerdo completado Abrir acuerdo
Acuerdos completados Acuerdo completado Abrir acuerdo

Siga estos pasos:

  1. Vaya al primer botón que aparece arriba, selecciónelo y seleccione la ficha Acciones situada a la derecha.
  2. En el campo Agregar acción, seleccione Ir a la URL.
  3. En el campo Plantilla de URL, sustituya la sección {Your Adobe Sign Host} de la URL por su nombre de host. Busque su nombre de host de Adobe Sign en la URL de la instancia de Adobe Sign siguiendo este modelo: https://{hostname}.in1.adobesign.com/public/login. Por ejemplo, https://citrixwsi.in1.adobesign.com/public/login.
  4. Ahora repita este procedimiento con los demás botones, reemplazando la sección {Your Abobe Sign Host} de la URL por su nombre de host.

    Acción Ir a la URL

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.

Para obtener información detallada sobre los dispositivos de punto final de las API y las entidades de tabla, consulte Especificaciones del conector de Adobe Sign.

Utilizar microaplicaciones de Adobe Sign

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

Enviar acuerdos: Envíe la plantilla y cargue un acuerdo para firma por los destinatarios.

Notificación o página Flujos de trabajo por caso de uso
Página Mi plantilla Proporciona una lista de acuerdos plantilla disponibles para el usuario, con opciones para Crear y enviar a los usuarios para su acuerdo mediante la opción de carga.
Página Enviar acuerdo Permite al usuario enviar un acuerdo a los destinatarios mediante la opción de carga.
Página Enviar plantilla Permite al usuario enviar acuerdos plantilla a los destinatarios.

Mis acuerdos recibidos: Proporciona una lista de acuerdos de Adobe Sign en espera de firma por un usuario. Un usuario puede firmar el formulario del acuerdo

Notificación o página Flujos de trabajo por caso de uso
Notificación Nuevo acuerdo recibido Se notifica a los destinatarios de todos los nuevos acuerdos creados.
Notificación Nuevo acuerdo cambiado Se notifica a los destinatarios de todos los acuerdos nuevos creados con una opción Ordenar por.
Notificación Recordatorios de acuerdo Se notifica a los destinatarios de los acuerdos sin firmar que están pendientes durante una semana.
Página Mi acuerdo recibido Proporciona una lista personalizada de todos los acuerdos recibidos.
Página Detalles de mi acuerdo recibido Se muestran los detalles de un acuerdo recibido, con opciones para Firmar acuerdo y Enviar a otro destinatario.
Página Acuerdo recibido Se muestran los detalles de un acuerdo recibido, con opciones para Firmar acuerdo y Enviar a otro destinatario.
Página Compartir acuerdo Permite a los destinatarios compartir los acuerdos recibidos con otros usuarios.
Página Firmar acuerdo Permite a los destinatarios firmar y completar acuerdos.

Acuerdos en curso: Lista de acuerdos en curso de Adobe Sign para firmar. El usuario también puede cancelar el Acuerdo enviado.

Notificación o página Flujos de trabajo por caso de uso
Página Mi acuerdo enviado Proporciona una lista personalizada de los acuerdos enviados.
Página Detalles del acuerdo en curso Permite a los usuarios ver información detallada del acuerdo enviado seleccionado, con opciones para Cancelar acuerdo y Abrir acuerdo.

Acuerdos completados: Lista de acuerdos completados de Adobe Sign y detalles. El usuario también puede compartir los acuerdos recibidos.

Notificación o página Flujos de trabajo por caso de uso
Notificación Acuerdo firmado Se notifica al remitente del acuerdo acerca de los acuerdos firmados.
Página Acuerdos completados Proporciona una lista personalizada de los acuerdos completados.
Página Detalles del acuerdo completado Permite a los usuarios ver información detallada de un acuerdo completado seleccionado, con opciones para Enviar a otro destinatario y Abrir acuerdo desde la página de acciones.
Página Acuerdo completado Permite a los usuarios ver información detallada de un acuerdo completado seleccionado, con opciones para Enviar a otro destinatario y Abrir acuerdo desde el feed de notificación.
Página Compartir acuerdo Permite a los destinatarios compartir los acuerdos recibidos con otros usuarios.

Acuerdos cancelados: Lista de acuerdos cancelados de Adobe Sign y detalles.

Notificación o página Flujos de trabajo por caso de uso
Notificación Acuerdo cancelado A los destinatarios del acuerdo se les notifican los acuerdos cancelados.
Página Acuerdo cancelado Proporciona una lista personalizada de acuerdos cancelados.
Página Detalles del acuerdo cancelado Permite a los usuarios ver información detallada de un acuerdo cancelado seleccionado con la opción para Abrir acuerdo.
Página Acuerdo cancelado Permite a los usuarios ver información detallada de un acuerdo cancelado seleccionado con la opción para Abrir acuerdo.

Gestionar acuerdos: Permite administrar y modificar acuerdos plantilla.

Notificación o página Flujos de trabajo por caso de uso
Página Mis plantillas Proporciona una lista personalizada de plantillas.
Página Administrar plantilla Permite a los usuarios modificar las plantillas seleccionadas en Citrix Workspace.