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

> Verbinden Sie Docusign per OAuth JWT Grant mit einem Integration Key, einem RSA-Schlüsselpaar und einer Zustimmung mit Iru Compliance, um Nachweise zu Umschlägen und Konten zu erfassen.

### Über Docusign

Iru ruft die **eSignature REST API** über **OAuth 2.0 JWT Grant** auf: Sie registrieren einen **Integration Key** (**Client-ID**), laden einen **öffentlichen RSA-Schlüssel** hoch, erteilen die **Zustimmung zum Identitätswechsel** für einen Dienstbenutzer, und Iru tauscht ein **signiertes JWT** gegen **Zugriffstokens** ein. Dies eignet sich für **Server-zu-Server**-Automatisierung ohne stündliche interaktive Zustimmung.

### So funktioniert es

DocuSign unterstützt mehrere OAuth-2.0-Grant-Typen; für den **Server-zu-Server**-Connector von Iru ist **JWT Grant** das richtige Modell: Sie erstellen einen **Integration Key** (**Client-ID**), konfigurieren ein **RSA-Schlüsselpaar**, erteilen einmalig die **Zustimmung zum Identitätswechsel** für den Benutzer, in dessen Namen Iru handelt, und Iru tauscht ein **signiertes JWT** gegen **Zugriffstokens** für die eSignature REST API ein.

| Detail | Wert |
| - | - |
| **Kategorie** | Produktivität |
| **Authentifizierung** | OAuth 2.0 JWT Grant |

Schritte im Überblick: **Apps and Keys** → **Integration Key** erstellen → **JWT**-Authentifizierung → **RSA** generieren oder hochladen → **Integration Key**, **GUID** des vertretenen Benutzers, **Konto-Basis-URI** und **privaten Schlüssel** gemäß dem Iru-Assistenten erfassen.

Offizielle Referenzen: [Plattform-Authentifizierung](https://developers.docusign.com/platform/auth/), [JWT Grant](https://developers.docusign.com/platform/auth/jwt/jwt-get-token/), [Integration erstellen](https://developers.docusign.com/platform/build-integration/), [eSignature REST](https://developers.docusign.com/docs/esign-rest-api/).

### Voraussetzungen

* **Administrator**-Zugriff in Docusign.
* Zugriff auf **developers.docusign.com** zur Verwaltung von Integrationen.
* Eine klare Entscheidung zwischen **Demo**- und **Produktions**schlüsseln und OAuth-Hosts (`account-d.docusign.com` bzw. `account.docusign.com`).

### Docusign mit Iru verbinden

<Tabs>
  <Tab title="Docusign">
    <Note>
      Schließen Sie diese Registerkarte ab, bevor Sie die Quelle in Compliance verbinden.
    </Note>

    <Steps>
      <Step title="Apps and Keys öffnen">
        Melden Sie sich bei der richtigen Docusign-Umgebung an (**Demo** oder **Produktion**). Öffnen Sie **Einstellungen** → **Apps and Keys** (die Bezeichnung kann je nach Kontotyp leicht variieren).
      </Step>

      <Step title="App und Integration Key hinzufügen">
        Wählen Sie **Add App and Integration Key** (oder **Create app**). Benennen Sie die App so, dass Betreiber sie erkennen (zum Beispiel **Iru Compliance**). Kopieren Sie den **Integration Key**; dies ist Ihre OAuth-**Client-ID** für JWT.
      </Step>

      <Step title="JWT Grant aktivieren">
        Aktivieren Sie in den Authentifizierungseinstellungen der App **JWT Grant** für die Server-zu-Server-Nutzung. Speichern Sie die Änderungen, wenn Docusign Sie dazu auffordert.
      </Step>

      <Step title="RSA-Schlüssel generieren oder hochladen">
        Wählen Sie unter **Service Integration** die Option **Generate RSA** (oder laden Sie Ihren öffentlichen Schlüssel gemäß der Docusign-Dokumentation hoch). Laden Sie den **privaten Schlüssel** sofort herunter und bewahren Sie ihn in einem Tresor auf. Sie können den privaten Schlüssel später nicht erneut von Docusign abrufen.
      </Step>

      <Step title="Zustimmung zum Identitätswechsel erteilen">
        Öffnen Sie die **Zustimmungs-URL**, die Docusign für JWT bereitstellt (die Scopes umfassen in der Regel **`signature`** und **`impersonation`**). Melden Sie sich als der **zu vertretende Benutzer** an und wählen Sie **Zulassen** aus. Schließen Sie alle Weiterleitungen ab, die Ihre App-Registrierung erfordert.
      </Step>
    </Steps>

    <Note>
      Fahren Sie auf der Registerkarte [**Iru Compliance**](#iru-compliance) fort.
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Schließen Sie zuerst die Registerkarte [**Docusign**](#docusign) ab.
    </Note>

    <Steps>
      <Step title="Quellen öffnen">
        Erweitern Sie in Iru Compliance in der linken Navigationsleiste **Compliance** und wählen Sie **Quellen** aus.

        <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="Linke Navigation: Compliance erweitert, Sources ausgewählt" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Docusign aktivieren">
        Suchen Sie **Docusign** (verwenden Sie **Kategorie** oder **Nach Name oder Beschreibung suchen**). Aktivieren Sie auf dieser Karte den **Schalter**. Möglicherweise öffnet sich eine Browser-Registerkarte oder ein Fenster für den Connector-Assistenten.
      </Step>

      <Step title="Integration Key und Benutzer-ID eingeben">
        Fügen Sie im Assistenten den **Integration Key** (**Client-ID**) und die **ID** (**GUID**) des vertretenen Benutzers für das Konto ein, in dessen Namen Docusign handeln soll.
      </Step>

      <Step title="Privaten Schlüssel und REST-Basis-URI eingeben">
        Fügen Sie den **privaten RSA-Schlüssel** und die **REST-Basis-URI** für Ihr Konto ein (zum Beispiel `https://na4.docusign.net/restapi`). Wenn Sie sich bei der Basis-URI nicht sicher sind, ermitteln Sie sie über **`/oauth/userinfo`**, wie von Docusign dokumentiert.
      </Step>

      <Step title="Verbindung abschließen">
        Übermitteln Sie die Konfiguration mit **Senden** (verwenden Sie die Bezeichnung in Ihrem Assistenten; im Ablauf des Anbieters heißt dies **Submit the configuration**). Wenn die Verbindung erfolgreich ist, zeigt der Assistent **Verbindung konfiguriert** an.
      </Step>

      <Step title="Prüfen, ob die Quelle aktiv ist">
        Schließen Sie die Browser-Registerkarte **Iru fordert Zugriff auf externe Dienste an**, kehren Sie dann zu **Compliance** → **Quellen** zurück und vergewissern Sie sich, dass die Karte **Docusign** den Status **Aktiv** hat.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Fehlerbehebung

<AccordionGroup>
  <Accordion title="Beim Aktivieren der Quelle öffnet sich nichts">
    Überprüfen Sie die Einstellungen des **Pop-up-Blockers** für die Iru-Website und versuchen Sie es erneut.
  </Accordion>

  <Accordion title="consent_required">
    Schließen Sie die Zustimmung zum Identitätswechsel im Browser ab.
  </Accordion>

  <Accordion title="invalid_grant / JWT-Fehler">
    Stellen Sie sicher, dass der private Schlüssel zum hochgeladenen öffentlichen Schlüssel passt und die Serveruhr genau geht.
  </Accordion>

  <Accordion title="Falsche Basis-URI">
    Ermitteln Sie den regionalen **`restapi`**-Host aus den Kontometadaten von Docusign.
  </Accordion>

  <Accordion title="Sandbox oder Produktion">
    Schlüssel und OAuth-Hosts müssen zur Umgebung passen.
  </Accordion>
</AccordionGroup>

### Hinweise

<CardGroup cols={2}>
  <Card title="Zugriffstokens laufen etwa stündlich ab: JWT Grant wird erneut ausgeführt…" icon="circle-info">
    Zugriffstokens laufen etwa stündlich ab – **JWT Grant** wird automatisch erneut ausgeführt; schützen Sie den **privaten RSA-Schlüssel** wie ein Produktions-Secret.
  </Card>
</CardGroup>

### Verwandte Artikel

<CardGroup cols={2}>
  <Card title="Quellenverwaltung" icon="plug" href="/de/compliance/sources-management">
    Alle Compliance-Quellen durchsuchen und verwalten.
  </Card>

  <Card title="Erste Schritte mit Compliance" icon="rocket" href="/de/compliance/getting-started-with-compliance">
    Frameworks, Aktionen und **Artefakte**.
  </Card>

  <Card title="Iru-Übersicht" icon="layer-group" href="/de/iru/platform-overview/iru-overview">
    Wie Endpoint, Compliance und Identity zusammenwirken.
  </Card>

  <Card title="Artifacts-Verwaltung" icon="folder-open" href="/de/compliance/artifacts-management">
    Nachweise aus Quellen und Aktionen hochladen, prüfen und organisieren.
  </Card>
</CardGroup>