Integration mit DocuSign

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 7 Minuten Lesedauer

    • Integration von Software Asset Management Anwendung mit DocuSign Mit dem Service können Sie Ihre Softwareabonnements nachverfolgen und nicht verwendete Lizenzen zurückfordern.

    DocuSignÜber Händler getätigte Käufe spiegeln sich nicht innerhalb von wider DocuSign Standardabrechnungssystem. Daher werden über die APIs keine Werte für den Umschlagverbrauch zurückgegeben, der für verfügbar ist ServiceNow.

    Wichtig:
    DocuSign Hat entfernt LastLogin Feld aus der Anwender-API, damit die letzten Aktivitäten des Anwenders im Rahmen dieser Integration nicht mehr nachverfolgt werden. Die Software Asset Management Die Anwendung erstellt jetzt Reklamationskandidaten basierend auf dem Zuweisungsdatum des Abonnements.

    Weitere Informationen zu finden DocuSign Service, siehe Die DocuSign-Entwicklerwebsite .

    Wichtig:
    Minimieren Sie Sicherheitsrisiken, und schützen Sie Informationen, indem Sie nur den erforderlichen Anwender- oder API-Berechtigungen Zugriff gewähren.
    Tabelle : 1. Minimale Anwenderberechtigungen
    Prozess Erforderliche Anwenderrolle in DocuSign Anwendung Authentifizierungsbereiche
    Abonnements herunterladen Administrator Keine Umfänge
    Abonnement zurückfordern Administrator Keine Umfänge

    Registrieren Sie einen DocuSign Anwendung

    Registrieren Sie einen DocuSign Anwendung über DocuSign administratorportal.

    Vorbereitungen

    DocuSign Erforderliche Rolle: administrator

    Prozedur

    1. Melden Sie sich bei an DocuSign Demo-Account (nicht-Produktion).
    2. Wählen Sie Ihr Profilbild aus.
    3. Wählen Sie Aus Meine Apps und Schlüssel .
      • Wenn Sie bereits einen API-Integrationsschlüssel aus einer vorherigen Integration haben, der in der Produktion verwendet werden kann, Fahren Sie mit Schritt 33 fort .
      • Wenn Ihr Client-Geheimnis nicht gespeichert ist, müssen Sie einen neuen generieren.
    4. Wählen Sie im linken Bereich aus INTEGRATIONEN > Apps und Schlüsselan.
    5. In Apps und Integrationsschlüssel Abschnitt auswählen FÜGEN SIE APP UND INTEGRATIONSSCHLÜSSEL HINZU .
    6. Geben Sie im Formular „Integrationsschlüssel hinzufügen“ einen Namen in ein App-Name Feld und wählen Sie aus ERSTELLEN SIE EINE APP .
    7. Wählen Sie Aus FÜGEN SIE URI HINZU Unter Umleitungs-URIs Feld in Zusätzliche Einstellungen Abschnitt.
    8. Hinzufügen https://oauth.pstmn.io/v1/browser-callback .
    9. Wählen Sie Aus FÜGEN SIE URI HINZU Erneut und hinzufügen https:// ServiceNow-Instanz .service-now.com/oauth_redirect.do .
    10. Wählen Sie Aus FÜGEN SIE EINEN GEHEIMEN SCHLÜSSEL HINZU .
      Speichern Sie den Integrationsschlüssel (Client-ID) und den geheimen Schlüssel (Client-Geheimnis) an einem sicheren Ort, um sie später in der Postman-App und den Integrationsschlüssel (Client-ID) in zu verwenden ServiceNow Instanz.
    11. Wählen Sie Speichern.
    12. Laden Sie die neueste Version von herunter Postman-App Und überspringen Sie die Anmeldung.
    13. Auswahlvorgang Neue Sammlung Und geben Sie der Sammlung einen Namen an.
    14. Wählen Sie aus Autorisierung Registerkarte.
    15. Wählen Sie im Listenmenü Typ die Option aus OAuth 2,0 .
    16. Geben Sie einen Namen an, und füllen Sie die Felder im aus Konfigurationsoptionen Registerkarte zum Erstellen eines Tokens:
      Feld Wert
      Callback URL https://oauth.pstmn.io/v1/browser-callback
      Authentifizierungs-URL https://account-d.docusign.com/oauth/auth
      Zugriffstoken-URL https://account-d.docusign.com/oauth/token
      Client-ID Der Integrationsschlüssel von Ihrem DocuSign Demo-Account in erstellt Schritt 10 .
      Geheimer Clientschlüssel Der geheime Schlüssel von Ihrem DocuSign Demo-Account Schritt 10 .
    17. Wählen Sie Aus Neues Zugriffstoken Abrufen .
      Sie werden zu weitergeleitet DocuSign.
    18. Wählen Sie Akzeptieren aus.
    19. Nachdem das Zugriffstoken erfasst wurde und die Authentifizierung abgeschlossen ist, kopieren Sie das Zugriffstoken, um es später zu verwenden.
    20. Wählen Sie Aus Neue Anforderung So erstellen Sie eine GET-Anforderung für Ihre Account-ID
    21. Geben Sie die URL im Feld GET als ein https://account-d.docusign.com/oauth/userinfo .
    22. Wählen Sie auf der Registerkarte Header die Option aus Autorisierung Unter SCHLÜSSEL Und geben Sie ein Bearer <Zugriffstoken, das Sie während der Authentifizierung kopiert haben> Unter Wert .
    23. Wählen Sie Aus Senden Und überprüfen Sie, ob Ihre Anforderung abgeschlossen ist.
      Die Account-ID wird im Antworttext angezeigt.
    24. Duplizieren Sie die GET-Anforderung.
      Kopieren Sie den Autorisierungsschlüssel und -Wert unter Header .
    25. Aktualisieren Sie die URL im Feld GET als https://demo.docusign.net/restapi/v2/accounts/<account-id>/Anwender .
      Hier, Account-ID Ist die ID, die Sie aus der vorherigen Anforderung gespeichert haben.
    26. Wählen Sie Aus Senden 20 Mal für 20 API-Aufrufe.
      Sie müssen mindestens 20 API-Aufrufe aufrufen, um Ihre Anwendung über zu registrieren DocuSign administratorportal.
    27. Navigieren Sie zu Apps und Integrationsschlüssel Auf der DocuSign administratorportal.
    28. Auswahlvorgang Aktionen > Zeigen Sie das API-Dashboard an Neben Ihrer Anwendung.
    29. Warten Sie einige Minuten auf DocuSign Um alle 20 API-Aufrufe zu registrieren.
    30. Navigieren zu INTEGRATIONEN > Apps und Schlüssel Und wählen Sie aus Zur Überprüfung senden .
      Nach 5-20 Minuten ist die Überprüfung Ihrer Anwendung abgeschlossen. Sie können die Anwendung auf Ihren Produktionsaccount heraufstufen.
    31. Auswahlvorgang Aktionen > Start-Go: Live-Überprüfung Zum Heraufstufen der Anwendung zum Produktionsaccount.
    32. Wählen Sie einen berechtigten Produktionsaccount aus, um den Integrationsschlüssel zu verwalten.
    33. Melden Sie sich bei an DocuSign Produktionsinhalts-Account.
    34. Wählen Sie Ihr Profilbild aus.
    35. Wählen Sie Aus Wechseln Sie zu Administrator .
    36. Wählen Sie im linken Bereich aus INTEGRATIONEN > Apps und Schlüsselan.
      Suchen Sie Ihre API-Account-ID, die für das Integrationsprofil in verwendet werden soll ServiceNow Instanz.
    37. Wählen Sie neben Ihrer Anwendung die Option aus Aktionen > Bearbeitenan.
    38. Wählen Sie Aus FÜGEN SIE URI HINZU Und hinzufügen https:// ServiceNow-Instanz .service-now.com/oauth_redirect.do .
    39. Wählen Sie Aus FÜGEN SIE EINEN GEHEIMEN SCHLÜSSEL HINZU .
      Speichern Sie den geheimen Schlüssel (geheimer Clientschlüssel) für Ihren Produktionsaccount an einem sicheren Ort, um ihn in Ihrem zu verwenden ServiceNow Instanz.
    40. Wählen Sie Speichern.

    DocuSign-Integrationsprofile erstellen

    Erstellen Sie ein Integrationsprofil, um Softwareabonnements nachzuverfolgen und die Lizenzierung für zu optimieren DocuSign Service.

    Vorbereitungen

    Zum Erstellen von DocuSign Integrationsprofil, fordern Sie an Software Asset Management– SaaS-Lizenzmanagement Plugin (sn_sam_saas_int) aus dem ServiceNow Store .

    ServiceNow Erforderliche Rolle: sam_Integrator oder admin

    Warum und wann dieser Vorgang ausgeführt wird

    Wenn Sie verwenden Software-Asset-Arbeitsbereich, Die Option zum Erstellen von DocuSign Integrationsprofil in Core-UI Ist inaktiv.

    Prozedur

    1. Navigieren Sie zum Integrationsprofil.
      SchnittstelleAktion
      Core-UI
      1. Navigieren zu Alle > Software Asset > SaaS-Lizenz > Profile für direkte Integrationan.
      2. Wählen Sie Neu.
      3. Wählen Sie Aus DocuSign-Integrationsprofil .
      Software-Asset-Arbeitsbereich
      1. Navigieren zu Lizenzvorgänge > Anwenderabonnements > Direkte Integrationsprofilean.
      2. Wählen Sie Neu.
      3. Wählen Sie Aus DocuSign Aus der Dropdown-Liste.
      4. Wählen Sie Fortsetzen.
    2. Füllen Sie im Formular die Felder aus.
      Tabelle : 2. Formular „Integrationsprofil“
      Feld Wert
      Anzeigename Name des Integrationsprofils. Beispiel: DocuSign-Integration
      Client-ID Client-ID für die in erstellte OAuth-Anwendung Schritt 10 In SaaS administrator-Account.
      Umleitungs-URL URL des OAuth-Providers, zu dem Sie nach der Authentifizierung weitergeleitet werden. Dieser Wert wird automatisch ausgefüllt.
      ID des technischen Accounts API-Account-ID von Ihrem DocuSign Produktionsaccount.
      Instanz-URL URL der Anmeldeseite, die für den Zugriff auf verwendet wird DocuSign Produktionsaccount. Dieses Feld wird automatisch auf festgelegt https://account.docusign.com .
      Geheimer Clientschlüssel Passwort, das der in erstellten Client-ID zugeordnet ist Schritt 39 .
      Profiltyp Integrationsprofiltyp. Dieser Wert wird automatisch auf festgelegt DocuSign-Abonnement .
    3. Überprüfen Sie die erforderlichen Anwenderrollen oder API-Berechtigungen, die in angegeben sind Lieferantenkonfiguration Feld für jeden Prozess, um Sicherheitsrisiken zu minimieren und zu optimieren SaaS Lizenzen.
      Hinweis:
      Weitere Informationen zu den erforderlichen Rollen und Umfängen finden Sie unter Minimale Anwenderberechtigungen Tabelle.

      • Die Abonnements herunterladen Das Kontrollkästchen ist standardmäßig aktiviert, und Sie können es nicht deaktivieren.

      • Die Abonnements zurückfordern Das Kontrollkästchen ist standardmäßig aktiviert. Wenn Sie keine Abonnements zurückfordern möchten, können Sie dieses Kontrollkästchen deaktivieren. Wenn Sie dies löschen, werden die Entfernungskandidaten erstellt, der Subflow „Abonnement zurückfordern“ wird jedoch nicht ausgelöst, oder der Reklamationsprozess wird nicht initiiert.

    4. Wählen Sie Absenden.
      Ihr ServiceNow Instanz erstellt einen Entwurf für ein Integrationsprofil.
    5. Wählen Sie im Integrationsprofil die Option aus OAuth-Token abrufen Und führen Sie die Schritte aus, um ein OAuth-Token abzurufen.
      Hinweis:
      Informationen zur Rolle, die für diesen Schritt erforderlich ist, finden Sie unter Minimale Anwenderberechtigungen Tabelle.
    6. Wählen Sie im Formular „Integrationsprofil“ die Option aus Validieren Sie Die Verbindung Dient zum Überprüfen der Verbindungs- und Anmeldeinformationsdetails dieser Integration.

      Durch die Validierung der Verbindung werden die APIs „Abonnements herunterladen“, aber nicht die APIs „Abonnements zurückfordern“ überprüft.

    Ergebnisse

    Sie können Ereignisse anzeigen, die von einzelnen Anwendern bis zu einem Jahr vor dem aktuellen Datum ausgeführt wurden. Weitere Informationen finden Sie unter Überprüfen Sie eine Software-Reklamationsregel. Software Asset Management Ruft die Ereignisse ab dem Zeitpunkt ab, zu dem Sie mit dem Herunterladen von Anwenderabonnements beginnen, unabhängig vom Erstellungsdatum des Profils.

    Nächste Maßnahme

    Nachdem die Integration eine Verbindung hergestellt hat, ist Ihr ServiceNow Die Instanz erstellt automatisch Softwaremodelle, Reklamationsregeln und Softwareabonnements, die täglich aktualisiert werden.

    Zeigen Sie nach dem Erstellen eines Integrationsprofils Informationen zum Profil in an Software-Asset-Arbeitsbereich Indem Sie zu navigieren Lizenzvorgänge > Anwenderabonnement > Direkte Integrationsprofilean. Sie können ein Integrationsprofil auswählen, um die folgenden zugehörigen Listen anzuzeigen. Wenn nicht alle der folgenden zugehörigen Listen für ein Integrationsprofil in der Standardansicht sichtbar sind, können Sie die anwenderdefinierte Integrationsansicht auf der Registerkarte Details auswählen:
    • Softwaremodelle
    • Nicht erkannte Abonnementbezeichner
    • Geplante Aufgaben
    • Ergebnisse der geplanten Aufgabe
    • Software-Abonnements
    • Ausschlussregel für Abonnementbezeichner
    • Ausschlussregel für Abonnementanwender

    Nach dem Erstellen eines Integrationsprofils können Sie Abonnementausschlussregeln definieren, um bestimmte Abonnements von den Berechnungen der Lizenzkosten zu befreien. Weitere Informationen finden Sie unter Abonnementausschlüsse für SaaS Und SSO-Anwendungen.

    Wenn Sie mehrere Integrationsprofile mit eindeutigen Verbindungen einrichten möchten, erstellen Sie untergeordnete Aliasse, um verschiedene Konfigurationen und Einstellungen für jedes Integrationsprofil zu verwalten. Weitere Informationen finden Sie unter Erstellen Sie einen untergeordneten Alias, um mehrere Integrationsprofile einzurichten.

    Überprüfen Sie alle automatisch generierten Reklamationsregeln, um Anwenderabonnements zurückzufordern. Weitere Informationen finden Sie unter Überprüfen Sie eine Software-Reklamationsregel.

    Erstellen Sie Softwareberechtigungen für die automatisch generierten Softwaremodelle, um verwendete Software im Vergleich zu eigener Software nachzuverfolgen.
    Der Abgleich wird auch für Ihre Abonnements als geplante Aufgabe oder bei Bedarf ausgeführt. Sie können Ihre Abgleichergebnisse in anzeigen Lizenz-Workbench ( Software Asset Management Klassische Anwendung) oder Lizenznutzungsansicht (Software-Asset-Arbeitsbereich). Verwenden Sie diese Ergebnisse, um Ihre Lizenz-Compliance-Position zu bestimmen und Verstöße zu beheben.