> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Docusign

> Conecta Docusign a Iru Compliance mediante OAuth JWT Grant con una clave de integración, un par de claves RSA y consentimiento para recopilar evidencia de sobres y de la cuenta.

### 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.

| Detalle | Valor |
| - | - |
| **Categoría** | Productividad |
| **Autenticación** | OAuth 2.0 JWT Grant |

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](https://developers.docusign.com/platform/auth/), [JWT Grant](https://developers.docusign.com/platform/auth/jwt/jwt-get-token/), [Crear una integración](https://developers.docusign.com/platform/build-integration/), [eSignature REST](https://developers.docusign.com/docs/esign-rest-api/).

### 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

<Tabs>
  <Tab title="Docusign">
    <Note>
      Completa esta pestaña antes de conectar la fuente en Compliance.
    </Note>

    <Steps>
      <Step title="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).
      </Step>

      <Step title="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.
      </Step>

      <Step title="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.
      </Step>

      <Step title="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.
      </Step>

      <Step title="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.
      </Step>
    </Steps>

    <Note>
      Continúa en la pestaña [**Iru Compliance**](#iru-compliance).
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Termina primero la pestaña [**Docusign**](#docusign).
    </Note>

    <Steps>
      <Step title="Abrir Sources">
        En Iru Compliance, en la barra de navegación izquierda, expande **Cumplimiento** y selecciona **Fuentes**.

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="Navegación izquierda: Compliance expandido, Sources seleccionado" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Activar Docusign">
        Busca **Docusign** (usa **Categoría** o **Buscar por nombre o descripción**). En esa tarjeta, activa el **interruptor**. Es posible que se abra una pestaña o ventana del navegador para el asistente del conector.
      </Step>

      <Step title="Introducir la Integration Key y el ID de usuario">
        En el asistente, pega la **Integration Key** (**ID de cliente**) y el **ID** (**GUID**) del usuario suplantado para la cuenta en cuyo nombre debe actuar Docusign.
      </Step>

      <Step title="Introducir la clave privada y el URI base de REST">
        Pega la **clave privada RSA** y el **URI base de REST** de tu cuenta (por ejemplo, `https://na4.docusign.net/restapi`). Si no estás seguro del URI base, descúbrelo mediante **`/oauth/userinfo`**, tal como documenta Docusign.
      </Step>

      <Step title="Finalizar la conexión">
        **Envía** la configuración (usa la etiqueta que aparezca en tu asistente; el flujo del proveedor lo denomina **Submit the configuration**). Cuando la conexión se realiza correctamente, el asistente muestra **Conexión configurada**.
      </Step>

      <Step title="Confirmar que la fuente está activa">
        Cierra la pestaña del navegador **Iru está solicitando acceso a servicios externos** y, a continuación, vuelve a **Cumplimiento** → **Fuentes** y confirma que la tarjeta de **Docusign** está **Activo**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Solución de problemas

<AccordionGroup>
  <Accordion title="No se abre nada al activar la fuente">
    Revisa la configuración del **bloqueador de ventanas emergentes** para el sitio de Iru e inténtalo de nuevo.
  </Accordion>

  <Accordion title="consent_required">
    Completa el consentimiento de suplantación en el navegador.
  </Accordion>

  <Accordion title="invalid_grant / errores de JWT">
    Comprueba que la clave privada coincide con la clave pública cargada y que el reloj del servidor es preciso.
  </Accordion>

  <Accordion title="URI base incorrecto">
    Obtén el host regional de **`restapi`** a partir de los metadatos de la cuenta de Docusign.
  </Accordion>

  <Accordion title="Sandbox o producción">
    Las claves y los hosts de OAuth deben coincidir con el entorno.
  </Accordion>
</AccordionGroup>

### Consideraciones

<CardGroup cols={2}>
  <Card title="Los tokens de acceso caducan aproximadamente cada hora: JWT Grant se vuelve a ejecutar…" icon="circle-info">
    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.
  </Card>
</CardGroup>

### Artículos relacionados

<CardGroup cols={2}>
  <Card title="Gestión de fuentes" icon="plug" href="/es/compliance/sources-management">
    Explora y gestiona todas las fuentes de Compliance.
  </Card>

  <Card title="Introducción a Compliance" icon="rocket" href="/es/compliance/getting-started-with-compliance">
    Marcos, acciones y **Artefactos**.
  </Card>

  <Card title="Descripción general de Iru" icon="layer-group" href="/es/iru/platform-overview/iru-overview">
    Cómo encajan Endpoint, Compliance e Identity.
  </Card>

  <Card title="Gestión de artefactos" icon="folder-open" href="/es/compliance/artifacts-management">
    Sube, revisa y organiza la evidencia de fuentes y acciones.
  </Card>
</CardGroup>