Skip to main content

​
Acerca de Docusign

Iru llama a la eSignature REST API mediante OAuth 2.0 JWT Grant: registras una Integration Key (ID de cliente), cargas una clave pública RSA, concedes consentimiento de suplantación para un usuario de servicio, e Iru intercambia un JWT firmado por tokens de acceso. Esto es adecuado para la automatización de servidor a servidor sin consentimiento interactivo cada hora.

​
Cómo funciona

DocuSign admite varios tipos de concesión de OAuth 2.0; para el conector de servidor a servidor de Iru, JWT Grant es el modelo adecuado: creas una Integration Key (ID de cliente), configuras un par de claves RSA, concedes una vez el consentimiento de suplantación para el usuario en cuyo nombre actúa Iru, e Iru intercambia un JWT firmado por tokens de acceso para la eSignature REST API. Pasos generales: Apps and Keys → crear la Integration Key → autenticación JWT → generar o cargar la clave RSA → obtener la Integration Key, el GUID del usuario suplantado, el URI base de la cuenta y la clave privada según el asistente de Iru. Referencias oficiales: Autenticación de la plataforma, JWT Grant, Crear una integración, eSignature REST.

​
Requisitos previos

  • Acceso de administrador en Docusign.
  • Acceso a developers.docusign.com para gestionar las integraciones.
  • Una elección clara entre las claves y los hosts de OAuth de demo o de producción (account-d.docusign.com frente a account.docusign.com).

​
Conectar Docusign a Iru

Completa esta pestaña antes de conectar la fuente en Compliance.
1

Abrir Apps and Keys

Inicia sesión en el entorno de Docusign correcto (demo o producción). Abre Configuración → Apps and Keys (el texto puede variar ligeramente según el tipo de cuenta).
2

Añadir una aplicación y una clave de integración

Selecciona Add App and Integration Key (o Create app). Asigna a la aplicación un nombre que los operadores reconozcan (por ejemplo, Iru Compliance). Copia la Integration Key; es tu ID de cliente de OAuth para JWT.
3

Habilitar JWT Grant

En la configuración de autenticación de la aplicación, habilita JWT Grant para el uso de servidor a servidor. Guarda los cambios si Docusign te lo solicita.
4

Generar o cargar las claves RSA

En Service Integration, elige Generate RSA (o carga tu clave pública según la documentación de Docusign). Descarga la clave privada de inmediato y guárdala en un almacén seguro. No podrás recuperar la clave privada de Docusign más adelante.
5

Conceder el consentimiento de suplantación

Abre la URL de consentimiento que proporciona Docusign para JWT (los alcances suelen incluir signature e impersonation). Inicia sesión como el usuario que se va a suplantar y selecciona Permitir. Completa cualquier redirección que requiera el registro de tu aplicación.
Continúa en la pestaña Iru Compliance.

​
Solución de problemas

Revisa la configuración del bloqueador de ventanas emergentes para el sitio de Iru e inténtalo de nuevo.
Comprueba que la clave privada coincide con la clave pública cargada y que el reloj del servidor es preciso.
Obtén el host regional de restapi a partir de los metadatos de la cuenta de Docusign.
Las claves y los hosts de OAuth deben coincidir con el entorno.

​
Consideraciones

Los tokens de acceso caducan aproximadamente cada hora: JWT Grant se vuelve a ejecutar…

Los tokens de acceso caducan aproximadamente cada hora; JWT Grant se vuelve a ejecutar automáticamente. Protege la clave privada RSA como un secreto de producción.

​
Artículos relacionados

Gestión de fuentes

Explora y gestiona todas las fuentes de Compliance.

Introducción a Compliance

Marcos, acciones y Artefactos.

Descripción general de Iru

Cómo encajan Endpoint, Compliance e Identity.

Gestión de artefactos

Sube, revisa y organiza la evidencia de fuentes y acciones.