Integration mit DocuSign

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 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 .

    Wichtig:
    Minimieren Sie Sicherheitsrisiken, und schützen Sie Informationen, indem Sie nur den erforderlichen Anwender- oder API-Berechtigungen Zugriff gewähren.
    Tabelle : 1. Minimale Anwenderberechtigungen
    Prozess Erforderliche Anwenderrolle in DocuSignAnwendung Authentifizierungsbereiche
    Abonnements herunterladen Administrator Keine Umfänge
    Abonnement zurückfordern Administrator Keine Umfänge

    Registrieren Sie ein DocuSignAnwendung

    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 .
      • Wenn Ihr Client-Geheimnis nicht gespeichert ist, müssen Sie ein neues Geheimnis generieren.
    4. Wählen Sie im linken Bereich aus INTEGRATIONEN > Apps 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 https://oauth.pstmn.io/v1/browser-callback .
    9. Wählen Sie Aus FÜGEN SIE URI HINZU Erneut und hinzufügen https:// ServiceNow-Instanz .service-now.com/oauth_redirect.do .
    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.
    11. Wählen Sie Speichern.
    12. Laden Sie die neueste Version von herunter Postman-App 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:
      Feld Wert
      Callback URL https://oauth.pstmn.io/v1/browser-callback
      Authentifizierungs-URL https://account-d.docusign.com/oauth/auth
      Zugriffstoken-URL https://account-d.docusign.com/oauth/token
      Client-ID Der Integrationsschlüssel von Ihrem DocuSignDemo-Account in erstellt Schritt 10 .
      Geheimer Clientschlüssel Der geheime Schlüssel von Ihrem DocuSignDemo-Account Schritt 10 .
    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 https://account-d.docusign.com/oauth/userinfo .
    22. Wählen Sie auf der Registerkarte Header die Option aus Autorisierung Unter SCHLÜSSEL Und Eingabetaste Bearer <Zugriffstoken, das Sie während der Authentifizierung kopiert haben> 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 https://demo.docusign.net/restapi/v2/accounts/<account-id>/Anwender .
      Hier, Account-ID 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 Aktionen > Zeigen Sie das API-Dashboard an Neben Ihrer Anwendung.
    29. Warten Sie einige Minuten auf DocuSignUm alle 20 API-Aufrufe zu registrieren.
    30. Navigieren zu INTEGRATIONEN > Apps 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 Aktionen > Start-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.
    34. Wählen Sie Ihr Profilbild aus.
    35. Wählen Sie Aus Wechseln Sie zum Administrator .
    36. Wählen Sie im linken Bereich aus INTEGRATIONEN > Apps 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 Aktionen > Bearbeitenan.
    38. Wählen Sie Aus FÜGEN SIE URI HINZU Und hinzufügen https:// ServiceNow-Instanz .service-now.com/oauth_redirect.do .
    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.
    40. Wählen Sie Speichern.

    Erstellen Sie ein DocuSignIntegrationsprofil

    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 .

    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.
      SchnittstelleAktion
      Core-UI
      1. Navigieren zu Alle > Software Asset > SaaS-Lizenz > Profile für direkte Integrationan.
      2. Wählen Sie Neu.
      3. Wählen Sie Aus DocuSign-Integrationsprofil .
      Software-Asset-Arbeitsbereich
      1. Navigieren zu Lizenzvorgänge > Anwenderabonnements > Direkte Integrationsprofilean.
      2. Wählen Sie Neu.
      3. Wählen Sie Aus DocuSign Aus der Dropdown-Liste.
      4. Wählen Sie Fortsetzen.
    2. Füllen Sie im Formular die Felder aus.
      Tabelle : 2. Integrationsprofilformular
      Feld Wert
      Anzeigename Name des Integrationsprofils. Beispiel: DocuSign-Integration
      Client-ID Client-ID für die in erstellte OAuth-Anwendung Schritt 10 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 .
      Profiltyp Typ des Integrationsprofils. Dieser Wert wird automatisch auf festgelegt DocuSign-Abonnement .
    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 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.

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

    Überprüfen Sie alle automatisch generierten Reklamationsregeln, um Anwenderabonnements zurückzufordern. Weitere Informationen finden Sie unter Überprüfen Sie eine Software-Reklamationsregel.

    Erstellen Sie Softwareberechtigungen für die automatisch generierten Softwaremodelle, um verwendete Software mit eigener Software zu verfolgen.
    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 ( Software Asset ManagementKlassische Anwendung) oder Lizenznutzungsansicht (Software-Asset-Arbeitsbereich). Verwenden Sie diese Ergebnisse, um Ihre Lizenz-Compliance-Position zu bestimmen und Nichteinhaltung zu beheben.