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

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama IT Asset Management

ft:clusterId :

    - itam

bundleId :

    - itam

workflow :

    - Technology


---

# Integration mit DocuSign

# Integration mit DocuSign {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 Minuten Lesedauer

Integration von Software Asset ManagementAnwendung mit DocuSignMit dem Service können Sie Ihre Softwareabonnements nachverfolgen und nicht verwendete Lizenzen zurückfordern.

DocuSignKäufe über Händler spiegeln sich nicht innerhalb von wider DocuSignStandardabrechnungssystem. Daher werden über die APIs keine Werte für den Umschlagverbrauch zurückgegeben, der für verfügbar ist ServiceNow.  
Hinweis:  
DocuSignHat entfernt LastLogin Feld aus der Anwender-API. Daher werden die letzten Aktivitäten der Anwender im Rahmen dieser Integration nicht nachverfolgt.

Für weitere Informationen über DocuSignService, siehe [Die 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 DocuSignAnwendung | Authentifizierungsbereiche |
|-|-|-|
| Abonnements herunterladen | Administrator | Keine Umfänge |
| Abonnement zurückfordern | Administrator | Keine Umfänge |
[Tabelle : 1. Minimale Anwenderberechtigungen]

{#integrate-with-docusign__table_kcp_jts_nbc}

## Registrieren Sie ein DocuSignAnwendung {#ariaid-title2}

Registrieren Sie ein DocuSignAnwendung über DocuSignadministratorportal.

### Vorbereitungen

DocuSign Erforderliche Rolle: administrator

### Prozedur

1. Melden Sie sich bei an DocuSignDemo-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 für die Verwendung in der Produktion bereit ist, [Fahren Sie mit Schritt 33 fort](https://servicenow-prod.fluidtopics.net/ggxSaZia35N8g4uQpiJq2A#register-docusign-app__docusign-prod-login).
   * Wenn Ihr Client-Geheimnis nicht gespeichert ist, müssen Sie ein neues Geheimnis generieren.
   {#register-docusign-app__choices_zhf_2hm_m5b}
4. Wählen Sie im linken Bereich aus INTEGRATIONENApps 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 auswählen 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 <kbd class="ph userinput">https://oauth.pstmn.io/v1/browser-callback </kbd>.
9. Wählen Sie Aus FÜGEN SIE URI HINZU Erneut und hinzufügen <kbd class="ph userinput">https:// <var class="keyword varname">ServiceNow-Instanz </var>.service-now.com/oauth_redirect.do </kbd>.
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 ServiceNowInstanz. {#register-docusign-app__step9}
{#register-docusign-app__step9}
11. Wählen Sie Speichern.
12. Laden Sie die neueste Version von herunter [Postman-App](https://www.getpostman.com/)Und überspringen Sie die Anmeldung.
13. Auswählen Neue Sammlung Und geben Sie einen Namen für die Sammlung 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 auf aus Konfigurationsoptionen Registerkarte zum Erstellen eines Tokens:  
    {#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> |
    | Authentifizierungs-URL | <kbd class="ph userinput">https://account-d.docusign.com/oauth/auth</kbd> |
    | Zugriffstoken-URL | <kbd class="ph userinput">https://account-d.docusign.com/oauth/token</kbd> |
    | Client-ID | Der Integrationsschlüssel von Ihrem DocuSignDemo-Account in erstellt [Schritt 10](https://servicenow-prod.fluidtopics.net/ggxSaZia35N8g4uQpiJq2A#register-docusign-app__step9). |
    | Geheimer Clientschlüssel | Der geheime Schlüssel von Ihrem DocuSignDemo-Account [Schritt 10](https://servicenow-prod.fluidtopics.net/ggxSaZia35N8g4uQpiJq2A#register-docusign-app__step9). |
    [ ]

    {#register-docusign-app__table_h2h_zgf_dhb}
17. Wählen Sie Aus Neues Zugriffstoken Abrufen .  
    Sie werden zu weitergeleitet DocuSign.
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 Aus Neue Anforderung Dient zum Erstellen einer GET-Anforderung für Ihre Account-ID
21. Geben Sie die URL im Feld „ABRUFEN" als ein <kbd class="ph userinput">https://account-d.docusign.com/oauth/userinfo </kbd>.
22. Wählen Sie auf der Registerkarte Header die Option aus Autorisierung Unter SCHLÜSSEL Und Eingabetaste <kbd class="ph userinput">Bearer <var class="keyword varname">&lt;Zugriffstoken, das Sie während der Authentifizierung kopiert haben&gt; </var> </kbd>Unter Wert .
23. Wählen Sie Aus Senden Und stellen Sie sicher, dass Ihre Anforderung abgeschlossen ist.  
    Die Account-ID wird im Antworttext angezeigt.
24. GET-Anforderung duplizieren.  
    Kopieren Sie den Autorisierungsschlüssel und -Wert unter Header .
25. Aktualisieren Sie die URL im Feld „ABRUFEN" als <kbd class="ph userinput">https://demo.docusign.net/restapi/v2/accounts/&lt;account-id&gt;/Anwender </kbd>.  
    Hier, <var class="keyword varname">Account-ID </var>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 DocuSignadministratorportal.
27. Navigieren Sie zu Apps und Integrationsschlüssel Auf DocuSignadministratorportal.
28. Auswählen AktionenZeigen Sie das API-Dashboard an Neben Ihrer Anwendung.
29. Warten Sie einige Minuten auf DocuSignUm alle 20 API-Aufrufe zu registrieren.
30. Navigieren zu INTEGRATIONENApps 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. Auswählen AktionenStart-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 DocuSignProduktionsinhalts-Account. {#register-docusign-app__docusign-prod-login}
{#register-docusign-app__docusign-prod-login}
34. Wählen Sie Ihr Profilbild aus.
35. Wählen Sie Aus Wechseln Sie zum Administrator .
36. Wählen Sie im linken Bereich aus INTEGRATIONENApps und Schlüsselan.  
    Suchen Sie Ihre API-Account-ID, die für das Integrationsprofil in verwendet werden soll ServiceNowInstanz.
37. Wählen Sie neben Ihrer Anwendung die Option aus AktionenBearbeitenan.
38. Wählen Sie Aus FÜGEN SIE URI HINZU Und hinzufügen <kbd class="ph userinput">https:// <var class="keyword varname">ServiceNow-Instanz </var>.service-now.com/oauth_redirect.do </kbd>.
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 zu verwenden ServiceNowInstanz. {#register-docusign-app__step39}
{#register-docusign-app__step39}
40. Wählen Sie Speichern.
{#register-docusign-app__steps_tyr_3rg_ynb}

## Erstellen Sie ein DocuSignIntegrationsprofil {#ariaid-title3}

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

### Vorbereitungen

Zum Erstellen von DocuSignIntegrationsprofil, fordern Sie an Software Asset Management-- SaaS-LizenzmanagementPlugin (sn_sam_saas_int) von [ServiceNow-Speicher](https://store.servicenow.com/).

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 DocuSignIntegrationsprofil in Core-UIIst inaktiv.

### Prozedur

1. Navigieren Sie zum Integrationsprofil.

   | Schnittstelle | Aktion |
   | Core-UI | 1. Navigieren zu AlleSoftware AssetSaaS-LizenzProfile für direkte Integrationan. 2. Wählen Sie Neu. 3. Wählen Sie Aus DocuSign-Integrationsprofil . {#create-integration-profile-docusign__ol_ijd_bjk_qtb} |
   | Software-Asset-Arbeitsbereich | 1. Navigieren zu LizenzvorgängeAnwenderabonnementsDirekte Integrationsprofilean. 2. Wählen Sie Neu. 3. Wählen Sie Aus DocuSign Aus der Dropdown-Liste. 4. Wählen Sie Fortsetzen. {#create-integration-profile-docusign__ol_wjd_bjk_qtb} |
   |-|-|

   {#create-integration-profile-docusign__choicetable_o3p_z3k_qtb}
2. Füllen Sie im Formular die Felder 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 erstellte OAuth-Anwendung [Schritt 10](https://servicenow-prod.fluidtopics.net/ggxSaZia35N8g4uQpiJq2A#register-docusign-app__step9)In SaaSadministrator-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 DocuSignProduktionsaccount. |
   | Instanz-URL | URL der Anmeldeseite, die für den Zugriff auf verwendet wird DocuSignProduktionsaccount. Dieses Feld wird automatisch auf festgelegt https://account.docusign.com . |
   | Geheimer Clientschlüssel | Passwort, das der in erstellten Client-ID zugeordnet ist [Schritt 39](https://servicenow-prod.fluidtopics.net/ggxSaZia35N8g4uQpiJq2A#register-docusign-app__step39). |
   | Profiltyp | Typ des Integrationsprofils. Dieser Wert wird automatisch auf festgelegt DocuSign-Abonnement . |
   [Tabelle : 2. Integrationsprofilformular]

   {#create-integration-profile-docusign__integration-form-title}
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 SaaSLizenzen.  
   Hinweis:  
   Weitere Informationen zu den erforderlichen Rollen und Umfängen finden Sie unter [Minimale Anwenderberechtigungen](https://servicenow-prod.fluidtopics.net/ggxSaZia35N8g4uQpiJq2A#integrate-with-docusign "Integration von Software Asset ManagementAnwendung mit DocuSignMit dem Service können Sie Ihre Softwareabonnements nachverfolgen und nicht verwendete Lizenzen zurückfordern.")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.

   {#create-integration-profile-docusign__ul_nmd_wsd_xcc}
4. Wählen Sie Absenden.  
   Ihr ServiceNowInstanz erstellt einen Entwurf für ein Integrationsprofil.
5. Wählen Sie im Integrationsprofil aus OAuth-Token abrufen Und führen Sie die Schritte aus, um ein OAuth-Token abzurufen.  
   Hinweis:  
   Informationen zur Rolle, die zur Ausführung dieses Schritts erforderlich ist, finden Sie unter [Minimale Anwenderberechtigungen](https://servicenow-prod.fluidtopics.net/ggxSaZia35N8g4uQpiJq2A#integrate-with-docusign "Integration von Software Asset ManagementAnwendung mit DocuSignMit dem Service können Sie Ihre Softwareabonnements nachverfolgen und nicht verwendete Lizenzen zurückfordern.")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 das Validieren 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](https://servicenow-prod.fluidtopics.net/1nWMyGAS9USaPpcCFrBp8g "Verwenden Sie Reklamationsregeln, um Anwenderabonnements abzubrechen, die auf keine Aktivität beschränkt sind."). Software Asset ManagementRuft 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 ServiceNowDie Instanz erstellt 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](https://servicenow-prod.fluidtopics.net/Y0Uo7ezlcLuiHutjgYvLQQ "Erstellen Sie einen untergeordneten Alias, um mehrere Integrationsprofile mit eindeutigen Verbindungen einzurichten und verschiedene Konfigurationen für jedes Integrationsprofil zu verwalten.").

Überprüfen Sie alle automatisch generierten Reklamationsregeln, um Anwenderabonnements zurückzufordern. Weitere Informationen finden Sie unter [Überprüfen Sie eine Software-Reklamationsregel](https://servicenow-prod.fluidtopics.net/1nWMyGAS9USaPpcCFrBp8g "Verwenden Sie Reklamationsregeln, um Anwenderabonnements abzubrechen, die auf keine Aktivität beschränkt sind.").  
Erstellen Sie Softwareberechtigungen für die automatisch generierten Softwaremodelle, um verwendete Software mit eigener Software zu verfolgen.

* Weitere Informationen zum Erstellen von Softwareberechtigungen finden Sie in Software Asset ManagementCore-UI, siehe [Erstellen Sie Berechtigungen in Software Asset ManagementKlassisch](https://servicenow-prod.fluidtopics.net/opVnSXksHS_8wNM28tekAg "Erstellen Sie Berechtigungen in Software Asset ManagementAnwendung klassisch, um Ihre Lizenzdetails aufzuzeichnen und Anwendern oder Geräten erworbene Softwarerechte zuzuweisen.").
* Weitere Informationen zum Erstellen von Softwareberechtigungen im Software-Asset-Arbeitsbereich finden Sie unter [Erstellen Sie Berechtigungen im Arbeitsbereich](https://servicenow-prod.fluidtopics.net/7Y2gRBoTe~ED1KeWEBWfPQ "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 Software Asset ManagementPlaybook, siehe [Erstellen Sie Berechtigungen mithilfe der geführten Walk-Through](https://servicenow-prod.fluidtopics.net/Y2PngmmQR5tENlnARLs3nw "Verwenden Sie das geführte Walk-Through-Playbook für einen Schritt-für-Schritt-Prozess zum Erstellen von Berechtigungen.").
{#create-integration-profile-docusign__ul_cbz_vhr_sqb}  
Der Abgleich wird auch für Ihre Abonnements als geplante Aufgabe oder bei Bedarf ausgeführt. Sie können Ihre Abgleichsergebnisse in anzeigen [Lizenz-Workbench](https://servicenow-prod.fluidtopics.net/3~5s3QlcEcJwwH2A8ac6vQ "Überprüfen Sie die Abgleichsergebnisse in einer vereinfachten Workbench-Ansicht.")( Software Asset ManagementKlassische Anwendung) oder [Lizenznutzungsansicht](https://servicenow-prod.fluidtopics.net/Mr_Swf4Bk6D85OdjcdHdbQ "Verwenden Sie die Ansicht „Lizenznutzung“ als einzelne Ebene, um die Lizenzposition aller Softwareprodukte zu verstehen, Nichteinhaltung zu beheben, Abgleichsergebnisse anzuzeigen, Entfernungskandidaten anzuzeigen oder hinzuzufügen und anzuzeigen Software Asset ManagementZugehörige Berichte.")(Software-Asset-Arbeitsbereich). Verwenden Sie diese Ergebnisse, um Ihre Lizenz-Compliance-Position zu bestimmen und Nichteinhaltung zu beheben.

* Weitere Informationen zum Ausführen des Abgleichs finden Sie in Software Asset ManagementKlassische Anwendung, siehe [Führen Sie den Softwareabgleich in aus Software Asset ManagementKlassisch](https://servicenow-prod.fluidtopics.net/uC6DHgx7BlFvc0QrU7R_bw "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 den Softwareabgleich im Arbeitsbereich aus](https://servicenow-prod.fluidtopics.net/XsHatXBSe6M9BzuJltailA "Der Abgleich wird als geplante Aufgabe ausgeführt (Standard ist wöchentlich), Sie können den Abgleich jedoch auch manuell ausführen, um Softwareprodukte in der Umgebung des Software-Asset-Arbeitsbereichs bei Bedarf abzugleichen.").
{#create-integration-profile-docusign__ul_qgf_zhr_sqb}