Integration mit DocuSign

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 5 Minuten Lesedauer

    • Sie können Ihre ServiceNow -Instanz mit dem DocuSign -Service integrieren, um Ihre Softwareabonnements nachzuverfolgen und nicht verwendete Lizenzen zurückzufordern.

    DocuSign Käufe, die über Reseller getätigt werden, werden nicht im standardmäßigen Abrechnungssystem von DocuSign berücksichtigt. Daher werden keine Werte über die APIs für den Verbrauchsumschlag zurückgegeben, der für ServiceNowverfügbar ist.

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

    Weitere Informationen zum Service DocuSign finden Sie auf der DocuSign-Entwicklerwebsite.

    Registrieren Sie eine Anwendung DocuSign .

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

    Vorbereitungen

    DocuSign Erforderliche Rolle: admin

    Prozedur

    1. Melden Sie sich bei Ihrem DocuSign -Demokonto (nicht in der Produktion) an.
    2. Wählen Sie Ihr Profilbild aus.
    3. Wählen Sie Meine Apps und Schlüssel aus.
      • Wenn Sie bereits einen API-Integrationsschlüssel aus einer früheren Integration haben, der in der Produktion verwendet werden kann, fahren Sie mit Schritt 33 fort.
      • Wenn Sie Ihren geheimen Clientschlüssel nicht gespeichert haben, müssen Sie einen neuen generieren.
    4. Wählen Sie im linken Bereich aus INTEGRATIONEN > Apps und Schlüssel.
    5. Wählen Sie im Abschnitt Apps and Integration Keys (Apps und Integrationsschlüssel) die Option ADD APP AND INTEGRATION KEY(App und Integrationsschlüssel hinzufügen) aus.
    6. Geben Sie im Formular „Integrationsschlüssel hinzufügen“ im Feld App-Name einen Namen ein, und wählen SieAPP ERSTELLENaus.
    7. Wählen Sie URI HINZUFÜGEN unter dem Feld Umleitungs-URIs im Abschnitt „ Zusätzliche Einstellungen “ aus.
    8. Fügen Sie https://oauth.pstmn.io/v1/browser-callback hinzu.
    9. Wählen Sie erneut URI HINZUFÜGEN aus, und fügen Sie https://ServiceNow-Instanz.service-now.com/oauth_redirect.do hinzu.
    10. Wählen Sie GEHEIM SCHLÜSSEL HINZUFÜGEN aus.
      Speichern Sie den Integrationsschlüssel (Client-ID) und den geheimen Schlüssel (Client-Secret) an einem sicheren Ort, um sie später in der Postman-App und den Integrationsschlüssel (Client-ID) in der Instanz ServiceNow zu verwenden.
    11. Wählen Sie Speichern.
    12. Laden Sie die neueste 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 aus.
    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
      Zugriffstoken-URL https://account-d.docusign.com/oauth/token
      Client-ID Der Integrationsschlüssel aus Ihrem DocuSign -Demokonto, das in Schritt 10erstellt wurde.
      Client-Secret Geheimer Schlüssel aus Ihrem DocuSign -Demokonto, Schritt 10.
    17. Wählen Sie Neues Zugriffstoken abrufen aus.
      Sie werden zu DocuSignweitergeleitet.
    18. Wählen Sie Akzeptieren aus.
    19. Nachdem das Zugriffstoken erfasst und die Authentifizierung abgeschlossen ist, 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 die URL im Feld GET als https://account-d.docusign.com/oauth/userinfoein.
    22. Wählen Sie auf der Registerkarte Header 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 ü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 GET-Feld als https://demo.docusign.net/restapi/v2/accounts/.<account-id> /users .
      Hier ist Account-ID die ID, die Sie in der vorherigen Anforderung gespeichert haben.
    26. Wählen Sie 20 Mal senden aus, um 20 API-Aufrufe durchzuführen.
      Sie müssen mindestens 20 API-Aufrufe aufrufen, um Ihre Anwendung über das DocuSign -Administratorportal zu registrieren.
    27. Navigieren Sie im Administratorportal DocuSign zu Apps and Integration Keys (Apps und Integrationsschlüssel).
    28. Auswahlvorgang Aktionen > Zeigen Sie das API-Dashboard an 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 aus.
      Nach 5 bis 20 Minuten ist die Überprüfung Ihrer Anwendung abgeschlossen. Sie können die Anwendung auf Ihr Produktionskonto heraufstufen.
    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 DocuSign Produktionsinhaltskonto an.
    34. Wählen Sie Ihr Profilbild aus.
    35. Wählen Sie Zu Administrator wechseln aus.
    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 ServiceNow -Instanz 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.do hinzu.
    39. Wählen Sie GEHEIM SCHLÜSSEL HINZUFÜGEN aus.
      Speichern Sie den geheimen Schlüssel (geheimer Clientschlüssel) für Ihr Produktionskonto an einem sicheren Ort, um ihn in Ihrer ServiceNow -Instanz 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

    Um ein DocuSign -Integrationsprofil zu erstellen, fordern Sie das Plugin Software Asset Management - SaaS-Lizenzmanagement (com.sn_sam_saas_int) aus dem ServiceNow Storean.

    ServiceNow Erforderliche Rolle: sam_integrator oder admin

    Warum und wann dieser Vorgang ausgeführt wird

    Wenn Sie Software Asset Workspace verwenden, ist die Option zum Erstellen des Integrationsprofils DocuSign in der 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-Integrationsprofil aus.
      Software-Asset-Arbeitsbereich
      1. Navigieren zu Lizenzvorgänge > Benutzerabonnements > Profile für direkte Integration.
      2. Wählen Sie Neu.
      3. Wählen Sie DocuSign aus der Dropdown-Liste aus.
      4. Wählen Sie Fortsetzen aus.
    2. Füllen Sie die Felder des Formulars aus.
      Tabelle : 1. Formular „Integrationsprofil“
      Feld Wert
      Anzeigename Name des Integrationsprofils. Beispiel: DocuSign-Integration
      Client-ID Client-ID für die in Schritt 10 erstellte OAuth-Anwendung im Administratorkonto SaaS.
      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-Konto-ID aus Ihrem DocuSign -Produktionskonto.
      Instanz-URL URL der Anmeldeseite, die für den Zugriff auf Ihr DocuSign -Produktionskonto 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-Abonnement festgelegt.
    3. Klicken Sie auf Absenden.
    4. Wählen Sie im Integrationsprofil OAuth -Token abrufen aus, und führen Sie die Schritte aus, um ein OAuth-Token zu erhalten.

    Ergebnisse

    Sie können Events anzeigen, die von einzelnen Benutzern bis zu einem Jahr vor dem aktuellen Datum durchgeführt wurden. Weitere Informationen finden Sie unter Überprüfen Sie eine Software-Rückforderungsregel.
    Hinweis:
    Software Asset Management ruft die Events ab dem Zeitpunkt ab, zu dem Sie mit dem Herunterladen von Benutzerabonnements beginnen, unabhängig vom Datum der Profilerstellung.

    Nächste Maßnahme

    Nachdem die Integration eine Verbindung hergestellt hat, erstellt Ihre ServiceNow -Instanz automatisch Softwaremodelle, Rückforderungsregeln und Benutzerabonnements, die täglich aktualisiert werden.

    Überprüfen Sie alle automatisch generierten Rückforderungsregeln, um Benutzerabonnements zurückzufordern. Weitere Informationen finden Sie unter Überprüfen Sie eine Software-Rückforderungsregel.

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