Integration mit DocuSign

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 6 Minuten Lesedauer

    • Durch die Integration Ihrer Anwendung Software Asset ManagementDocuSign in den Service [] 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 von DocuSign 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üssel aus.
      • 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üssel die Option APP UND INTEGRATIONSSCHLÜSSEL HINZUFÜGEN aus.
    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-callback hinzu.
    9. Wählen Sie erneut URI HINZUFÜGEN aus, und fügen Sie https://ServiceNow instance.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 (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.
      Client-Secret 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.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 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 (com.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-Integrationsprofil aus.
      Software-Asset-Arbeitsbereich
      1. Navigieren zu Lizenzvorgänge > Anwenderabonnements > Profile für direkte Integration.
      2. Wählen Sie Neu.
      3. Wählen Sie DocuSign in der Dropdown-Liste aus.
      4. Wählen Sie Fortsetzen aus.
    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-Abonnement festgelegt.
    3. Wählen Sie Absenden.
    4. 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.

    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.
    Hinweis:
    Software Asset Management ruft die Ereignisse 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 hergestellt wurde, erstellt Ihre Instanz ServiceNow automatisch Softwaremodelle, Reklamationsregeln und Benutzerabonnements, die täglich aktualisiert werden.

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