Integration mit DocuSign

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 6 Minuten Lesedauer

    • Durch die Integration Ihrer Anwendung Software Asset Management in den Service DocuSign können Sie Ihre Softwareabonnements nachverfolgen und nicht verwendete Lizenzen zurückfordern.

    DocuSign -Käufe, die über Vertriebspartner getätigt wurden, werden nicht im Standardabrechnungssystem DocuSign von berücksichtigt. Daher werden über die APIs für den Umschlagverbrauch, die für ServiceNowverfügbar sind, keine Werte zurückgegeben.

    Hinweis:
    DocuSign hat das Feld „lastLogin“ aus der Anwender-API entfernt. Daher werden die letzten Aktivitäten der Anwender nicht als Teil dieser Integration nachverfolgt.

    Weitere Informationen zum Service DocuSign finden Sie auf der 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 Benutzerberechtigungen
    Prozess Erforderliche Anwenderrolle in der Anwendung DocuSign Authentifizierungsbereiche
    Abonnements herunterladen Administrator Keine Bereiche
    Abonnement zurückfordern Administrator Keine Bereiche

    Registrieren Sie eine DocuSign -Anwendung

    Registrieren Sie eine DocuSign -Anwendung über das Administratorportal DocuSign.

    Vorbereitungen

    DocuSign Erforderliche Rolle: admin

    Prozedur

    1. Melden Sie sich bei Ihrem DocuSign -Demo-Account (Nicht-Produktion) an.
    2. Wählen Sie Ihr Profilbild aus.
    3. Wählen Sie Meine Apps und Schlüsselaus.
      • Wenn Sie bereits einen API-Integrationsschlüssel aus einer früheren Integration haben, der zur Verwendung in der Produktion bereit ist, fahren Sie mit Schritt 33 fort.
      • Wenn Ihr Clientgeheimnis nicht gespeichert ist, müssen Sie ein neues generieren.
    4. Wählen Sie im linken Bereich aus INTEGRATIONEN > Apps und Schlüssel.
    5. Wählen Sie im Abschnitt Apps und Integrationsschlüsseldie Option APP UND INTEGRATIONSSCHLÜSSEL HINZUFÜGENaus.
    6. Geben Sie im Formular „Add Integration Key“ im Feld App-Name einen Namen ein, und wählen SieCREATE APPaus.
    7. Wählen Sie URI HINZUFÜGEN im Feld Umleitungs-URIs im Abschnitt Zusätzliche Einstellungen aus.
    8. Fügen Sie https://oauth.pstmn.io/v1/browser-callbackhinzu.
    9. Wählen Sie erneut URI HINZUFÜGEN aus, und fügen Sie https://ServiceNow instance.service-now.com/oauth_redirect.dohinzu.
    10. Wählen Sie GEHEIM SCHLÜSSEL HINZUFÜGENaus.
      Speichern Sie den Integrationsschlüssel (Client-ID) und den geheimen Schlüssel (geheimer Clientschlüssel) an einem sicheren Ort, um sie später in der Postman-App und dem Integrationsschlüssel (Client-ID) in der Instanz ServiceNow zu verwenden.
    11. Wählen Sie Speichern.
    12. Laden Sie die aktuelle Version der Postman-App herunter, und überspringen Sie die Anmeldung.
    13. Auswahlvorgang Neue Sammlung und geben Sie der Sammlung einen Namen.
    14. Wählen Sie die Registerkarte Autorisierung.
    15. Wählen Sie im Listenmenü „Typ“ die Option OAuth 2.0aus.
    16. Geben Sie einen Namen ein, und füllen Sie die Felder auf der Registerkarte Konfigurationsoptionen aus, um ein Token zu erstellen:
      Feld Wert
      Callback URL https://oauth.pstmn.io/v1/browser-callback
      Auth-URL https://account-d.docusign.com/oauth/auth
      Zugriffs-Token-URL https://account-d.docusign.com/oauth/token
      Client-ID Der Integrationsschlüssel aus Ihrem in Schritt 10erstellten Demo-Account DocuSign.
      Geheimer Clientschlüssel Der geheime Schlüssel aus Ihrem Demo-Account DocuSignSchritt 10.
    17. Wählen Sie Neuen Zugriffstoken abrufen aus.
      Sie werden zu DocuSignweitergeleitet.
    18. Wählen Sie Akzeptieren aus.
    19. Nachdem das Zugriffstoken gesammelt und die Authentifizierung abgeschlossen wurde, kopieren Sie das Zugriffstoken, um es später zu verwenden.
    20. Wählen Sie Neue Anforderung aus, um eine GET-Anforderung für Ihre Account-ID zu erstellen.
    21. Geben Sie im Feld GET die URL https://account-d.docusign.com/oauth/userinfoein.
    22. Wählen Sie auf der Registerkarte Header die Option Autorisierung unter SCHLÜSSEL aus, und geben Sie Bearer ein<Access Token that you copied during authentication> unter Wert .
    23. Wählen Sie Senden aus, und vergewissern Sie sich, dass Ihre Anforderung vollständig ist.
      Die Account-ID wird im Antworttext angezeigt.
    24. Duplizieren Sie die GET-Anforderung.
      Kopieren Sie den Autorisierungsschlüssel und den Wert unter Header.
    25. URL im Feld „GET“ als https://demo.docusign.net/restapi/v2/accounts/aktualisieren<account-id> /users .
      Hier ist „account-id“ die ID, die Sie bei der vorherigen Anforderung gespeichert haben.
    26. Wählen Sie „20 Mal senden“, um 20 API-Aufrufe durchzuführen.
      Sie müssen mindestens 20 API-Aufrufe aufrufen, um Ihre Anwendung über das -Administratorportal DocuSign zu registrieren.
    27. Navigieren Sie im -Administratorportal DocuSign zu Apps und Integrationsschlüssel.
    28. Auswahlvorgang Aktionen > API-Dashboard anzeigen neben Ihrer Anwendung.
    29. Warten Sie einige Minuten, bis DocuSign alle 20 API-Aufrufe registriert hat.
    30. Navigieren zu INTEGRATIONEN > Apps und Schlüssel und wählen Sie Zur Überprüfung senden.
      Nach 5 bis 20 Minuten ist Ihre Bewerbungsprüfung abgeschlossen. Sie können die Anwendung auf Ihren Produktionsaccount hochstufen.
    31. Auswahlvorgang Aktionen > Start-Go-Live-Überprüfung um die Anwendung auf das Produktionskonto hochzustufen.
    32. Wählen Sie ein berechtigtes Produktionskonto aus, um den Integrationsschlüssel zu verwalten.
    33. Melden Sie sich bei Ihrem Produktionsinhaltskonto DocuSign an.
    34. Wählen Sie Ihr Profilbild aus.
    35. Wählen Sie Zu Administrator wechseln.
    36. Wählen Sie im linken Bereich aus INTEGRATIONEN > Apps und Schlüssel.
      Suchen Sie Ihre API-Konto-ID, die für das Integrationsprofil in Ihrer Instanz ServiceNow verwendet werden soll.
    37. Wählen Sie neben Ihrer Anwendung aus Aktionen > Bearbeiten.
    38. Wählen Sie URI HINZUFÜGEN aus, und fügen Sie https://ServiceNow-Instanz.service-now.com/oauth_redirect.dohinzu.
    39. Wählen Sie GEHEIM SCHLÜSSEL HINZUFÜGENaus.
      Speichern Sie den geheimen Schlüssel (geheimer Clientschlüssel) für Ihr Produktionskonto an einem sicheren Ort, um ihn in Ihrer Instanz ServiceNow zu verwenden.
    40. Wählen Sie Speichern.

    DocuSign-Integrationsprofile erstellen

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

    Vorbereitungen

    Zum Erstellen eines DocuSign -Integrationsprofils fordern Sie das Plugin Software Asset Management - SaaS-Lizenzmanagement (sn_sam_saas_int) im ServiceNow Storean.

    ServiceNow Erforderliche Rolle: sam_integrator oder admin

    Warum und wann dieser Vorgang ausgeführt wird

    Wenn Sie Software-Asset-Arbeitsbereichverwenden, ist die Option zum Erstellen des Integrationsprofils DocuSign in Core-UI inaktiv.

    Prozedur

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

      • Das Kontrollkästchen Abonnements herunterladen ist standardmäßig aktiviert und kann nicht deaktiviert werden.

      • Das Kontrollkästchen Abonnements zurückfordern ist standardmäßig aktiviert. Wenn Sie Abonnements nicht zurückfordern möchten, können Sie dieses Kontrollkästchen deaktivieren. Wenn Sie diese Option löschen, werden die Entfernungskandidaten erstellt, aber der Subflow zum Zurückfordern des Abonnements wird nicht ausgelöst oder der Reklamationsprozess nicht initiiert.

    4. Wählen Sie Absenden.
      Ihre Instanz ServiceNow erstellt einen Integrationsprofilentwurf.
    5. Wählen Sie im Integrationsprofil OAuth-Token abrufen aus, und befolgen Sie die Schritte zum Abrufen eines OAuth-Tokens.
      Hinweis:
      Informationen zur Rolle, die zum Ausführen dieses Schritts erforderlich ist, finden Sie in der Tabelle der minimalen Anwenderberechtigungen.
    6. Wählen Sie im Formular „Integrationsprofil“ Verbindung validieren aus, um die Verbindungs- und Anmeldeinformationsdetails dieser Integration zu überprüfen.

      Durch das Validieren der Verbindung werden die Download Subscriptions APIs, aber nicht die Reclaim Subscriptions APIs überprüft.

    Ergebnisse

    Sie können Ereignisse anzeigen, die von einzelnen Anwendern bis zu einem Jahr vor dem aktuellen Datum durchgeführt wurden. Weitere Informationen finden Sie unter Überprüfen Sie eine Softwarereklamationsregel. Software Asset Management ruft die Ereignisse ab dem Zeitpunkt ab, zu dem Sie mit dem Herunterladen von Anwenderabonnements beginnen, unabhängig vom Datum der Profilerstellung.

    Nächste Maßnahme

    Nachdem die Integration hergestellt wurde, erstellt Ihre Instanz ServiceNow automatisch Softwaremodelle, Reklamationsregeln und Softwareabonnements, die täglich aktualisiert werden.

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

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