Gruppe [ Adobe Sign mit ServiceNowsynchronisieren

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

    • Synchronisieren Sie ServiceNow mit der erforderlichen Gruppe in Adobe Sign, um über Adobe Sign-Spoke] auf die gruppenspezifischen Dokumente und Vereinbarungen zuzugreifen.

    Vorbereitungen

    • IntegrationHub-Abonnement anfordern
    • Adobe Sign-Spoke aktivieren
    • Erforderliche Rolle: admin

    Warum und wann dieser Vorgang ausgeführt wird

    Diese Schritte werden ausgeführt, um nur eine Adobe Sign Gruppe zu synchronisieren. Um eine weitere Adobe Sign Gruppe zu synchronisieren, wiederholen Sie diesen Vorgang.

    Erstellen Sie eine benutzerdefinierte OAuth-Anwendung im Konto Adobe Sign .

    Erstellen Sie eine benutzerdefinierte OAuth-Anwendung aus Ihrem Konto Adobe Sign, um die OAuth 2.0-Authentifizierung mit dem Adobe Sign-Spokezu aktivieren.

    Vorbereitungen

    • Adobe Sign Account
    • Erforderliche Rolle: Adobe Sign Administratoranmeldeinformationen

    Warum und wann dieser Vorgang ausgeführt wird

    Führen Sie diese Schritte von Ihrem Adobe Sign -Konto aus. Siehe Adobe Sign Entwicklung -Dokumentation finden Sie Anweisungen zum Erstellen und Konfigurieren benutzerdefinierter Anwendungen.

    Prozedur

    1. Erstellen Sie in Ihrem Konto Adobe Sign eine Anwendung.
    2. Kopieren Sie die Anwendungs-ID und das Anwendungsgeheimnis, und notieren Sie sie zur späteren Verwendung.
      Diese Details sind erforderlich, um die Anwendung als OAuth-Drittpartei in Ihrer ServiceNow -Instanz zu registrieren.

    Ergebnisse

    Die benutzerdefinierte OAuth-Anwendung aus Ihrem Konto Adobe Sign wird erstellt und kann in die Instanz ServiceNow integriert werden.

    Webhook konfigurieren

    Konfigurieren Sie den Webhook in Ihrer Anwendung Adobe Sign, damit Adobe Sign Daten an ServiceNow senden kann, wenn ein Teilnehmer eine Vereinbarung oder ein Dokument unterzeichnet.

    Vorbereitungen

    Erforderliche Rolle: admin

    Warum und wann dieser Vorgang ausgeführt wird

    Wenn der Bereich der Anwendung Adobe Sign Account ist, verwenden Sie denselben Webhook für alle im Account-Bereich definierten Gruppen. Wenn der Bereich der Anwendung Adobe Sign Gruppe ist, müssen Sie für jede Gruppe konfigurieren.

    Prozedur

    1. Erstellen Sie in Ihrem Konto Adobe Sign einen Webhook mit diesen Konfigurationen.
      1. Geben Sie die Ziel-URL in URL in diesem Format ein: https://<instance-name> .service-now.com/api/sn_adobesign_spoke/adobesign_webhook .
      2. Geben Sie Vereinbarung für alle Events ein und Mega Signieren für alle Events in Events.
      3. Wählen Sie alle erforderlichen Vereinbarungsereignisse unter Benachrichtigungsparameteraus.
        Siehe Adobe Sign Entwicklung -Dokumentation finden Sie weitere Informationen zum Erstellen von Webhooks in Ihrem Adobe Sign -Konto.
    2. Fügen Sie in Ihrer Instanz ServiceNow die Client-Details hinzu.
      1. Navigieren zu Adobe Sign-Spoke > Client-Details.
      2. Öffnen Sie den Datensatz Adobe Sign-Client-ID.
      3. Füllen Sie diese Werte im Formular aus.
        Feld Beschreibung
        Authentifizierungsschlüssel Schlüssel zur Authentifizierung. Geben Sie UB7E5BXCXY ein.
        Client-ID Während der Adobe Sign Kontokonfiguration erstellte Anwendungs-ID.
      4. Klicken Sie auf Aktualisieren.

    Ergebnisse

    Webhook wird in Ihrem Konto Adobe Sign erstellt, und Signaturereignisse in Adobe Sign werden in den Tabellen von Adobe Sign-Spoke] aktualisiert.

    Registrieren Sie Adobe Sign als OAuth-Provider

    Verwenden Sie die Informationen, die während der Kontokonfiguration von Adobe Sign generiert wurden, um Adobe Sign als OAuth-Provider zu registrieren und der Instanz ServiceNow zu erlauben, OAuth 2.0-Token anzufordern.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > System-OAuth > Applikationsregistrierung.
    2. Klicken Sie auf Neu.
      Die Meldung Welche Art von OAuth-Anwendung?wird angezeigt.
    3. Wählen Sie Verbindung zu einem fremden OAuth-Provider herstellen aus.
    4. Füllen Sie die Felder des Formulars aus.
      Feld Wert erforderlich
      Name Name zur eindeutigen Identifizierung des Datensatzes. Geben Sie beispielsweise Adobe Sign OAuth-Profilein.
      Client-ID Während der Adobe Sign Kontokonfiguration erstellte Anwendungs-ID.
      Geheimer Clientschlüssel Anwendungsgeheimnis, das während der Adobe Sign Kontokonfiguration erstellt wurde.
      OAuth-API-Skript Optionales Skript zum Anpassen der Anforderung und Antwort.
      Logo-URL URL, die ein Bild enthält, das als Anwendungslogo verwendet werden soll.
      Standardgewährungstyp Zum Erstellen des Tokens verwendeter Gewährungstyp. Wählen Sie Autorisierungscode aus.
      Lebensdauer von Aktualisierungstoken Zeit in Sekunden, die das Aktualisierungstoken gültig ist. Die Standardzeit beträgt 8.640.0000 Sekunden.
      PKCE erforderlich Option, damit öffentliche Clients PKCE für eine Autorisierung anfordern können.
      Hinweis:
      Sie können nur den Autorisierungscode als Standardgewährungstyp verwenden, wenn PKCE aktiviert ist.
      Anwendung Anwendungsbereich, der diesen Datensatz enthält. Wählen Sie Adobe Sign-Spoke aus.
      Hinweis:
      Sie müssen sicherstellen, dass der Anwendungsbereich Adobe Sign Spokeist.
      Zugänglich von Anwendungsbereich, von dem aus auf diese Registrierung zugegriffen werden kann.
      Aktiv Option zur aktiven Verwendung der Anwendungsregistrierung.
      Autorisierungs-URL OAuth-Autorisierungscode-Endpunkt. Beispiel: https://secure.<region> .echosign.com/public/oauth/v2 .
      Token-URL OAuth-Servertoken-Endpunkt. Beispiel: https://secure.<region> .echosign.com/oauth/v2/token .
      Token-Sperr-URL OAuth-Server-Token-Sperrendpunkt.
      Umleitungs-URL OAuth-Callback-Endpunkt. Das System generiert die URL beim Speichern der Anwendungsregistrierung.
      URL zur Token-Aktualisierung URL zum Aktualisieren eines Tokens. Beispiel: https://secure.<region> .echosign.com/oauth/v2/refresh .
      Hinweis:
      Dieses Feld ist im Formularlayout ausgeblendet. Konfigurieren Sie das Formularlayout so, dass dieses Feld angezeigt wird.
      Gegenseitige Authentifizierung aktivieren Option zur Verwendung der gegenseitigen Authentifizierung für die Anforderung und den Widerruf von Token. Für diese Option muss ein Profil für gegenseitige Authentifizierung angegeben werden.
    5. Fügen Sie Datensätze für Gruppenbereichs-Modifizierer in die zugehörige Liste „OAuth-Entitätsbereiche“ in folgendem Format ein:<scope> :<modifier> .
      Beispiel: Wenn der Anwendungsbereich user_read für den Gruppenmodifikator in der Anwendung Adobe Sign aktiviert ist, fügen Sie den folgenden Datensatz in die zugehörige Liste OAuth-Entitätsbereiche ein.
      Feld Wert
      user_read:group user_read:group
    6. Klicken Sie mit der rechten Maustaste auf den Formularheader und wählen Sie Speichern aus.
      Das System validiert die OAuth-Anmeldeinformationen und füllt die Umleitungs-URLaus.
    7. Kopieren Sie die Umleitungs-URL, und notieren Sie sie.
    8. Melden Sie sich bei Ihrem Konto Adobe Sign an, und bearbeiten Sie die Konfiguration Ihrer benutzerdefinierten Anwendung Adobe Sign.
      Siehe Adobe Sign Entwicklung -Dokumentation für -Anweisungen.
    9. Fügen Sie den Wert für Redirect URL (Umleitungs-URL) in den Umleitungs-URI für Ihre benutzerdefinierte Anwendung Adobe Sign ein.
      Fügen Sie beispielsweise https://adobesign1.service-now.com/oauth_redirect.doein.

    Ergebnisse

    Die Instanz kann OAuth 2.0-Token für die Spoke anfordern, und es wird ein Aktualisierungstoken erstellt, um Token erneut zu generieren.

    Erstellen Sie Anmeldeinformationsdatensätze für Adobe Sign-Spoke

    Autorisieren Sie die Aktionen Adobe Sign-Spoke, indem Sie Anmeldeinformationsdatensätze für die in Adobe Signregistrierte Anwendung erstellen. Der Alias für Verbindungen und Anmeldeinformationen Adobe Sign-Spoke verwendet diese Anmeldeinformationen zum Autorisieren von Aktionen.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Berechtigungen.
    2. Klicken Sie auf Neu.
      Das System zeigt die Meldung Welche Art von Anmeldeinformationen möchten Sie erstellen? an..
    3. Wählen Sie OAuth 2.0-Anmeldeinformationen aus.
    4. Füllen Sie die Felder des Formulars aus.
      Feld Wert erforderlich
      Name Name zur eindeutigen Identifizierung des Datensatzes. Beispiel: Adobe Sign-Anmeldeinformationen.
      Aktiv Option zur aktiven Verwendung des Anmeldeinformationsdatensatzes.
      OAuth-Einheitenprofil OAuth-Profil, das während der Registrierung von Adobe Sign-Spoke als OAuth-Provider erstellt wurde. Wählen Sie beispielsweise Adobe Sign OAuth-Profilaus.
      Betrifft MID Servers, die diese Anmeldeinformationen verwenden können. Wählen Sie beispielsweise Alle MID Server aus.
      Reihenfolge Reihenfolge, in der die Anmeldeinformationen verwendet wurden. Geben Sie z. B. 100ein.
    5. Klicken Sie mit der rechten Maustaste in den Header des Formulars und wählen Sie Speichern aus.
    6. Um das OAuth-Token zu generieren, klicken Sie auf den zugehörigen Link OAuth-Token abrufen.

    Ergebnisse

    Der Anmeldeinformationsdatensatz für Adobe Sign-Spoke wird erstellt.

    Erstellen Sie einen Alias für Verbindungen und Anmeldeinformationen für die Gruppe Adobe Sign .

    Verwalten Sie die Verbindungs- und Anmeldeinformationen einer Gruppe Adobe Sign, um die gruppenspezifischen Aktionen zu autorisieren, indem Sie einen Alias für Verbindungen und Anmeldeinformationen für die Gruppe Adobe Sign erstellen.

    Vorbereitungen

    Erforderliche Rolle: admin

    Warum und wann dieser Vorgang ausgeführt wird

    Zu Demonstrationszwecken wird ein Beispielalias für Verbindungen und Anmeldeinformationen bereitgestellt. Wenn Sie den Beispielalias verwenden, ist es nicht erforderlich, einen Alias für Verbindungen und Anmeldeinformationen zu erstellen. Der Administrator muss jedoch einen Alias für jede andere Gruppe von Adobe Sign erstellen, um diese Gruppe mit der Instanz von ServiceNow ] zu synchronisieren.

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Aliasse für Verbindungen und Anmeldeinformationen.
    2. Klicken Sie auf Neu.
    3. Füllen Sie die Felder im Formular aus.
      Tabelle : 1. Formular „Aliasse für Verbindungen und Anmeldeinformationen“
      Feld Beschreibung
      Name Name zur eindeutigen Identifizierung des Alias Beispiel: AdobeSign_Legal.
      ID Vom System generierte eindeutige ID.
      Anwendung Anwendungsbereich, der diesen Datensatz enthält. Wählen Sie Adobe Sign-Spoke aus.
      Typ Aliastyp. Wählen Sie Verbindung und Anmeldeinformationen aus.
      Verbindungstyp Verbindungstyp Wählen Sie HTTP aus.
      Unterstützt mehrere aktive Verbindungen Mit dieser Option können Sie festlegen, ob der Alias mehrere aktive Verbindungen unterstützt.
    4. Klicken Sie auf Speichern.

    Ergebnisse

    Der Alias für Verbindungen und Anmeldeinformationen wird für die Gruppe Adobe Sign erstellt, und die Gruppe kann mit der Instanz ServiceNow synchronisiert werden.

    Erstellen Sie einen Verbindungsdatensatz und Verbindungsattribute für den Adobe Sign-Spoke

    Führen Sie Aktionen in Adobe Sign aus, indem Sie Verbindungsdatensätze und Verbindungsattribute für Ihre Gruppe Adobe Sign ] erstellen. Der Alias für Verbindungen und Anmeldeinformationen Adobe Sign-Spoke verwendet diese Verbindungen, um Aktionen für Adobe Signauszuführen.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Aliasse für Verbindungen und Anmeldeinformationen.
    2. Öffnen Sie den Datensatz für Adobe Sign.
    3. Klicken Sie in der zugehörigen Liste „Verbindungen“ auf Neu.
    4. Füllen Sie die Felder des Formulars aus.
      Tabelle : 2. HTTP(s)-Verbindungsformular
      Feld Wert erforderlich
      Name Name zur eindeutigen Identifizierung des Datensatzes. Beispiel: Adobe Sign-Verbindung.
      Anmeldeinformation Anmeldeinformationsdatensatz für Adobe Sign-Spokeerstellt. Beispiel: Adobe Sign-Anmeldeinformationen.
      Verbindungsalias Alias-Datensatz, der dieser Verbindung zugeordnet ist.
      URL-Builder
      Hinweis:
      Aktivieren Sie das Kontrollkästchen nicht.
      Verbindungs-URL Verbindungs-URL. Beispiel: https://api.eu1.echosign.com/.
      MID-Server verwenden Option zur Verwendung eines MID-Servers. Wenn das Kontrollkästchen aktiviert ist, definieren Sie die Felder in der zugehörigen Liste „Erweiterte MID-ServerKonfiguration“.
      Aktiv Option zur aktiven Verwendung dieser Verbindung.
      Domäne Domäne, in der die Aktion oder Aktivität ausgeführt wird.
    5. Klicken Sie auf Absenden.
    6. Klicken Sie in der zugehörigen Liste „Verbindungsattribute“ auf Neu.
    7. Füllen Sie die Felder des Formulars aus.
      Tabelle : 3. Formular „Verbindungsattribute“
      Feld Wert erforderlich
      Typ Verbindungsattributtyp. Wählen Sie Zeichenfolge aus.
      Bezeichnung Name zur Identifizierung des Verbindungsattributs. Geben Sie Version ein.
      Spaltenname Vom System generierter Wert, der auf dem in Bezeichnung eingegebenenWert basiert.
      Anwendung Anwendungsbereich, der diesen Datensatz enthält.
      Hinweis:
      Stellen Sie sicher, dass der Anwendungsbereich Adobe Sign-Spokeist.
      Aktiv Option zur aktiven Verwendung des Verbindungsattributs.
      Schreibgeschützt Option zum Deaktivieren von Änderungen am Verbindungsattribut. Geben Sie falseein.
      Standardwert Standardwert des Verbindungsattributs. Geben Sie v6 ein.
    8. Klicken Sie auf Absenden.

    Ergebnisse

    Der Verbindungsdatensatz und das Verbindungsattribut werden für die Verbindung und den Anmeldeinformationsalias erstellt.

    Konfigurieren Sie den Anwendungszugriff auf die Tabellen ServiceNow .

    Ermöglichen Sie Adobe Sign-Spoke, die Gruppenadministrator-Benutzerrolle zu erstellen, wenn eine Gruppe ServiceNow mit Tabellen Adobe Sign synchronisiert wird, indem Sie den Anwendungszugriff der erforderlichen Tabellen ServiceNow ] konfigurieren.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > Systemdefinition > Tabellen.
    2. Stellen Sie für jede der folgenden Tabellen sicher, dass die Optionen Kann lesen,Kann erstellenund Kann aktualisieren in der zugehörigen Liste Anwendungszugriff ausgewählt sein.
      Bezeichnung Name
      Rolle sys_user_role
      Zugriffssteuerung sys_security_acl
      Zugriffsrollen sys_security_acl_role
      Anwendungsmenü sys_app_application
      Modul sys_app_module
    3. Klicken Sie auf Aktualisieren.

    Ergebnisse

    Der Anwendungszugriff auf die erforderlichen Tabellen ServiceNow ist konfiguriert.

    Gruppe [ Adobe Sign in ServiceNowerstellen

    Synchronisieren Sie ServiceNow mit der erforderlichen Gruppe in Adobe Sign, indem Sie in der Tabelle „AdobeSign-Gruppendetails“ [sn_adobesign_spoke_adobesign_group_details] einen Datensatz erstellen.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > Adobe Sign-Spoke > Gruppen.
    2. Klicken Sie auf Neu.
    3. Füllen Sie die Felder des Formulars aus.
      Tabelle : 4. Formular „AdobeSign-Gruppendetails“
      Gruppenname Name zur eindeutigen Identifizierung der Gruppe Adobe Sign. Beispiel: Rechtsabteilung.
      Gruppen-ID Eindeutige ID, die dem Datensatz zugeordnet ist.
      Verbindungsalias Verbindungsalias, der erstellt wurde, um die Gruppe [ Adobe Sign mit ServiceNowzu synchronisieren.

    Ergebnisse

    Die erforderliche Gruppe Adobe Sign wird in ServiceNow erstellt und kann über Adobe Sign-Spokeverwaltet werden.
    Die für die Gruppe spezifische Benutzerrolle wird in ServiceNowerstellt, wenn die Gruppe in der Instanz ServiceNow erstellt wird. Beispielsweise wird die HR-Gruppenbenutzerrolle sn_adobesign_spoke.HR erstellt, wenn die HR-Gruppe in ServiceNowerstellt wird. ServiceNow Administratoren können diese Gruppenbenutzerrollen Benutzern zuweisen und den Zugriff auf gruppenspezifische Informationen steuern, z. B.:
    • Dokumente und Vereinbarungen
    • Aliasse für Verbindungen und Anmeldeinformationen
    • Anmeldeinformationsdatensätze
    • Anwendungsregistrierungen
    • Daten in Tabellen der Adobe Sign-Spoke

    Nur ServiceNow -Administratoren haben Zugriff auf Informationen zu allen Adobe Sign -Gruppen, die mit der Instanz ServiceNow synchronisiert werden.

    Dokumente in Gruppe [ Adobe Sign mit ServiceNowsynchronisieren

    Synchronisieren Sie ServiceNow mit der erforderlichen Gruppe in Adobe Sign, um über Adobe Sign-Spoke] auf die für die Gruppe spezifischen Dokumente und Vereinbarungen zuzugreifen.

    Vorbereitungen

    Erforderliche Rolle: admin

    Warum und wann dieser Vorgang ausgeführt wird

    Stellen Sie sicher, dass die Gruppen mit ihren jeweiligen Aliassen für Verbindungen und Anmeldeinformationen eingerichtet und konfiguriert sind, bevor Sie die Gruppendokumente synchronisieren.

    Prozedur

    1. Navigieren zu Alle > Adobe Sign-Spoke > Dokumente.
      Die Tabelle „AdobeSign-Dokumente“ [sn_adobesign_spoke_adobe_sign_documents] wird geöffnet.
    2. Klicken Sie auf die zugehörige Liste Dokumente abrufen.
      Hinweis:
      • Wenn Sie sich als Administrator angemeldet haben, können Sie die Dokumente aller Adobe Sign -Gruppen synchronisieren.
      • Wenn Sie sich als Gruppenadministrator angemeldet haben, können Sie nur die Dokumente synchronisieren, die für Ihre Adobe Sign -Gruppen spezifisch sind.

    Ergebnisse

    Details aller Dokumente, die für die erforderlichen Adobe Sign Gruppen spezifisch sind, werden mit ServiceNowsynchronisiert.