Skip to main content

​
Ü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. 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, JWT Grant, Integration erstellen, eSignature REST.

​
Voraussetzungen

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

​
Docusign mit Iru verbinden

Schließen Sie diese Registerkarte ab, bevor Sie die Quelle in Compliance verbinden.
1

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).
2

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

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

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

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.
Fahren Sie auf der Registerkarte Iru Compliance fort.

​
Fehlerbehebung

Überprüfen Sie die Einstellungen des Pop-up-Blockers für die Iru-Website und versuchen Sie es erneut.
Stellen Sie sicher, dass der private Schlüssel zum hochgeladenen öffentlichen Schlüssel passt und die Serveruhr genau geht.
Ermitteln Sie den regionalen restapi-Host aus den Kontometadaten von Docusign.
Schlüssel und OAuth-Hosts müssen zur Umgebung passen.

​
Hinweise

Zugriffstokens laufen etwa stündlich ab: JWT Grant wird erneut ausgeführt…

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.

​
Verwandte Artikel

Quellenverwaltung

Alle Compliance-Quellen durchsuchen und verwalten.

Erste Schritte mit Compliance

Frameworks, Aktionen und Artefakte.

Iru-Übersicht

Wie Endpoint, Compliance und Identity zusammenwirken.

Artifacts-Verwaltung

Nachweise aus Quellen und Aktionen hochladen, prüfen und organisieren.