---
sourceDocument: Xanadu – IT Asset Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/it-asset-management

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu – IT Asset Management

ft:clusterId :

    - itam

bundleId :

    - itam

workflow :

    - Technology


---

# Integration mit DocuSign

# Integration mit DocuSign {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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](https://developers.docusign.com/ios_sdk/developer.html).  
Wichtig:  
Minimieren Sie Sicherheitsrisiken und schützen Sie Informationen, indem Sie nur den erforderlichen Anwender- oder API-Berechtigungen Zugriff gewähren.{#integrate-with-docusign__table_kcp_jts_nbc__entry__3}

| Prozess | Erforderliche Anwenderrolle in der Anwendung DocuSign | Authentifizierungsbereiche |
|-|-|-|
| Abonnements herunterladen | Administrator | Keine Bereiche |
| Abonnement zurückfordern | Administrator | Keine Bereiche |
[Tabelle : 1. Minimale Benutzerberechtigungen]

{#integrate-with-docusign__table_kcp_jts_nbc}

## Registrieren Sie eine DocuSign -Anwendung {#ariaid-title2}

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](https://servicenow-prod.fluidtopics.net/npFnUlesRlhklvb7OBPDEw#register-docusign-app__docusign-prod-login).
   * Wenn Ihr Clientgeheimnis nicht gespeichert ist, müssen Sie ein neues generieren.
   {#register-docusign-app__choices_zhf_2hm_m5b}
4. Wählen Sie im linken Bereich aus INTEGRATIONENApps 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 <kbd class="ph userinput">https://oauth.pstmn.io/v1/browser-callback hinzu</kbd>.
9. Wählen Sie erneut URI HINZUFÜGEN aus, und fügen Sie<kbd class="ph userinput"> https://<var class="keyword varname">ServiceNow instance</var>.service-now.com/oauth_redirect.do hinzu</kbd>.
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. {#register-docusign-app__step9}
{#register-docusign-app__step9}
11. Wählen Sie Speichern.
12. Laden Sie die aktuelle Version der [Postman-App](https://www.getpostman.com/) 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:  
    {#register-docusign-app__table_h2h_zgf_dhb__entry__2}

    | Feld | Wert |
    |-|-|
    | Callback URL | <kbd class="ph userinput">https://oauth.pstmn.io/v1/browser-callback</kbd> |
    | Auth-URL | <kbd class="ph userinput">https://account-d.docusign.com/oauth/auth</kbd> |
    | Zugriffs-Token-URL | <kbd class="ph userinput">https://account-d.docusign.com/oauth/token</kbd> |
    | Client-ID | Der Integrationsschlüssel aus Ihrem in [Schritt 10](https://servicenow-prod.fluidtopics.net/npFnUlesRlhklvb7OBPDEw#register-docusign-app__step9)erstellten Demo-Account DocuSign. |
    | Client-Secret | Der geheime Schlüssel aus Ihrem Demo-Account DocuSign[Schritt 10](https://servicenow-prod.fluidtopics.net/npFnUlesRlhklvb7OBPDEw#register-docusign-app__step9). |
    [ ]

    {#register-docusign-app__table_h2h_zgf_dhb}
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 <kbd class="ph userinput">https://account-d.docusign.com/oauth/userinfo</kbd>ein.
22. Wählen Sie auf der Registerkarte Header die Option Autorisierung unter SCHLÜSSEL aus, und geben Sie <kbd class="ph userinput">Bearer</kbd> ein\<Access Token that you copied during authentication\> unter Wert .<var class="keyword varname"></var>
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 <kbd class="ph userinput">https://demo.docusign.net/restapi/v2/accounts/ aktualisieren</kbd>\<account-id\> /users .  
    Hier ist „<var class="keyword varname"> account-id</var> " 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 AktionenAPI-Dashboard anzeigen neben Ihrer Anwendung.
29. Warten Sie einige Minuten, bis DocuSign alle 20 API-Aufrufe registriert hat.
30. Navigieren zu INTEGRATIONENApps 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 AktionenStart-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. {#register-docusign-app__docusign-prod-login}
{#register-docusign-app__docusign-prod-login}
34. Wählen Sie Ihr Profilbild aus.
35. Wählen Sie Zu Administrator wechseln.
36. Wählen Sie im linken Bereich aus INTEGRATIONENApps 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 AktionenBearbeiten.
38. Wählen Sie URI HINZUFÜGEN aus, und fügen Sie<kbd class="ph userinput"> https://<var class="keyword varname">ServiceNow-Instanz</var>.service-now.com/oauth_redirect.do hinzu</kbd>.
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. {#register-docusign-app__step39}
{#register-docusign-app__step39}
40. Wählen Sie Speichern.
{#register-docusign-app__steps_tyr_3rg_ynb}

## DocuSign-Integrationsprofile erstellen {#ariaid-title3}

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 Store](https://store.servicenow.com/)an.

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.

   | Schnittstelle | Aktion |
   | Core-UI | 1. Navigieren zu AlleSoftware AssetSaaS-LizenzProfile für direkte Integration. 2. Wählen Sie Neu. 3. Wählen Sie DocuSign-Integrationsprofil aus. {#create-integration-profile-docusign__ol_ijd_bjk_qtb} |
   | Software-Asset-Arbeitsbereich | 1. Navigieren zu LizenzvorgängeAnwenderabonnementsProfile 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. {#create-integration-profile-docusign__ol_wjd_bjk_qtb} |
   |-|-|

   {#create-integration-profile-docusign__choicetable_o3p_z3k_qtb}
2. Füllen Sie die Felder des Formulars aus.  
   {#create-integration-profile-docusign__table_gnm_whv_5fb__entry__2}{#create-integration-profile-docusign__display-name-def}{#create-integration-profile-docusign__client-id-def}{#create-integration-profile-docusign__redirect-url-def}{#create-integration-profile-docusign__activity-date}{#create-integration-profile-docusign__client-secret-def}{#create-integration-profile-docusign__profile-type-def}

   | Feld | Wert |
   |-|-|
   | Anzeigename | Name des Integrationsprofils. Beispiel: <kbd class="ph userinput">DocuSign-Integration</kbd> |
   | Client-ID | Client-ID für die in [Schritt 10](https://servicenow-prod.fluidtopics.net/npFnUlesRlhklvb7OBPDEw#register-docusign-app__step9) 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 39](https://servicenow-prod.fluidtopics.net/npFnUlesRlhklvb7OBPDEw#register-docusign-app__step39)erstellten Client-ID zugeordnet ist. |
   | Profiltyp | Integrationsprofiltyp. Dieser Wert wird automatisch auf DocuSign-Abonnement festgelegt. |
   [Tabelle : 2. Formular „Integrationsprofil".]

   {#create-integration-profile-docusign__integration-form-title}
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](https://servicenow-prod.fluidtopics.net/npFnUlesRlhklvb7OBPDEw#integrate-with-docusign "Durch die Integration Ihrer Anwendung Software Asset ManagementDocuSign in den Service [] können Sie Ihre Softwareabonnements nachverfolgen und nicht verwendete Lizenzen zurückfordern.").

### 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](https://servicenow-prod.fluidtopics.net/N~LqaOTb~b624x0iPfd7~g "Verwenden Sie Reklamationsregeln, um Benutzerabonnements zu stornieren, für die eine Beschränkung auf keine Aktivität festgelegt wurde.").  
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](https://servicenow-prod.fluidtopics.net/N~LqaOTb~b624x0iPfd7~g "Verwenden Sie Reklamationsregeln, um Benutzerabonnements zu stornieren, für die eine Beschränkung auf keine Aktivität festgelegt wurde.").  
Erstellen Sie Softwareberechtigungen für die automatisch generierten Softwaremodelle, um verwendete Software im Vergleich zu eigener Software nachzuverfolgen.

* Weitere Informationen zum Erstellen von Softwareberechtigungen in der klassischen Anwendung \[ Software Asset Management finden Sie unter [Erstellen Sie Berechtigungen in Software Asset Management Classic](https://servicenow-prod.fluidtopics.net/cXIPH2Gt1MySV1Nq1EFh_w "Erstellen Sie Berechtigungen in der klassischen Anwendung Software Asset Management, um Ihre -Lizenzdetails aufzuzeichnen und erworbene Softwarerechte Benutzern oder Geräten zuzuweisen.").
* Weitere Informationen zum Erstellen von Softwareberechtigungen im Software-Asset-Arbeitsbereich finden Sie unter [Erstellen Sie Berechtigungen im Arbeitsbereich](https://servicenow-prod.fluidtopics.net/IeYNOyHDtVZ1wYkgPqMj~w "Erstellen Sie im Software-Asset-Arbeitsbereich Berechtigungen, um Lizenzdetails einzugeben und erworbene Softwarerechte Benutzern oder Geräten zuzuweisen.").
* Weitere Informationen zum Erstellen von Softwareberechtigungen mit dem Playbook Software Asset Management finden Sie unter [Erstellen Sie Berechtigungen mithilfe der geführten Tour](https://servicenow-prod.fluidtopics.net/8bbgwiXjQy2FWTBmtCjVMQ "Verwenden Sie das Playbook mit geführten Anleitungen, um eine schrittweise Anleitung zum Erstellen von Berechtigungen zu erhalten.").
{#create-integration-profile-docusign__ul_cbz_vhr_sqb}  
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](https://servicenow-prod.fluidtopics.net/Ffzv17MfqitHYVJScRk2ng "Überprüfen Sie die Abgleichergebnisse in einer vereinfachten Workbench-Ansicht.") (Software Asset Management klassische Anwendung) oder in der [Ansicht](https://servicenow-prod.fluidtopics.net/2ZfLQdvo_8r0dxKfDLMJgQ "Verwenden Sie die Lizenznutzungsansicht als zentrale Anzeige, um die Lizenzposition aller Softwareprodukte zu verstehen, Nicht-Compliance zu beheben, Abgleichergebnisse anzuzeigen, Kandidaten für die Entfernung anzuzeigen oder hinzuzufügen und Software Asset Management -bezogene Berichte anzuzeigen.") Lizenznutzung (Software Asset Workspace) anzeigen. Verwenden Sie diese Ergebnisse, um Ihre Position bei der Lizenz-Compliance zu bestimmen und etwaige Nichteinhaltungen zu beheben.

* Weitere Informationen zum Ausführen des Abgleichs in der klassischen Anwendung \[ Software Asset Management finden Sie unter [Führen Sie einen Softwareabgleich aus](https://servicenow-prod.fluidtopics.net/wb0JsxI~BDh_r6xUtDh6_Q "Ein Abgleich wird als regelmäßige Aufgabe ausgeführt (Standard ist wöchentlich). Sie können den Abgleich jedoch auch manuell ausführen, um Softwareprodukte in Ihrer Umgebung bei Bedarf abzugleichen.").
* Weitere Informationen zum Ausführen des Abgleichs im Software-Asset-Arbeitsbereich finden Sie unter [Führen Sie im -Arbeitsbereich einen Softwareabgleich aus](https://servicenow-prod.fluidtopics.net/t9JtZWw66qlUhV5rh6o~Rg "Der Abgleich wird als regelmäßige Aufgabe ausgeführt (standardmäßig einmal pro Woche). Sie können den Abgleich jedoch auch manuell ausführen, um Softwareprodukte im Software-Asset-Arbeitsbereich nach Bedarf abzugleichen.").
{#create-integration-profile-docusign__ul_qgf_zhr_sqb}