Gruppe [ Adobe Sign mit ServiceNowsynchronisieren

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

    • Synchronisieren Sie ServiceNow mit der erforderlichen Gruppe in Adobe Sign, um von Adobe Sign-Spoke] auf gruppenspezifische 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. Wiederholen Sie diesen Vorgang, um eine weitere Adobe Sign -Gruppe zu synchronisieren.

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

    Erstellen Sie eine anwenderdefinierte OAuth-Anwendung von Ihrem Konto Adobe Sign aus, um die OAuth 2.0-Authentifizierung mit dem Konto Adobe Sign-Spoke] zu aktivieren.

    Vorbereitungen

    • Adobe Sign Account
    • Erforderliche Rolle: Adobe Sign Administratoranmeldeinformationen

    Warum und wann dieser Vorgang ausgeführt wird

    Führen Sie diese Schritte in Ihrem Konto Adobe Sign aus. Siehe Adobe Sign Entwicklung In der Dokumentation zu finden Sie Anweisungen zum Erstellen und Konfigurieren benutzerdefinierter Anwendungen.

    Prozedur

    1. Erstellen Sie über Ihren Account 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 Instanz ServiceNow zu registrieren.

    Ergebnisse

    Die anwenderdefinierte OAuth-Anwendung von 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 signiert.

    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 Anwendungsbereich 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 Ereignisse “ und „Megasignatur für alle Ereignisse “ in Ereignisseein.
      3. Wählen Sie alle erforderlichen Vereinbarungsereignisse unter Benachrichtigungsparameteraus.
        Siehe Adobe Sign Entwicklung In der -Dokumentation finden Sie weitere Informationen zum Erstellen von Webhooks in Ihrem Adobe Sign -Account.
    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 für die Authentifizierung. Geben Sie UB7E5BXCXY ein.
        Client-ID Anwendungs-ID, die während der Konfiguration des Accounts Adobe Sign erstellt wurde.
      4. Klicken Sie auf Aktualisieren.

    Ergebnisse

    Der 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-Anbieter

    Verwenden Sie die Informationen, die während der Konfiguration des Accounts für [ Adobe Sign generiert wurden, um Adobe Sign als OAuth-Anbieter zu registrieren und der Instanz ServiceNow die Anforderung von OAuth 2.0-Token zu gestatten.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > System-OAuth > Applikationsregistrierung.
    2. Klicken Sie auf Neu.
      Das System zeigt die Meldung Welche Art von OAuth-Anwendung?
    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 das Adobe Sign-OAuth-Profilein.
      Client-ID Anwendungs-ID, die während der Konfiguration des Accounts Adobe Sign erstellt wurde.
      Geheimer Clientschlüssel Während der Konfiguration des Accounts Adobe Sign erstellter Anwendungsschlüssel.
      OAuth-API-Skript Optionales Skript zur Anpassung der Anforderung und der 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.
      Lebensdauer von Aktualisierungstoken Zeit in Sekunden, die das Aktualisierungstoken gültig ist. Die Standardzeit beträgt 8.640.000 Sekunden.
      PKCE erforderlich Option, damit öffentliche Clients für eine Autorisierung PKCE obligatorisch machen können.
      Hinweis:
      Sie können den Autorisierungscode nur dann 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-Servertoken-Rücknahme-Endpunkt.
      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 wird im Formularlayout ausgeblendet. Konfigurieren Sie das Formularlayout für die Anzeige dieses Felds.
      Gegenseitige Authentifizierung aktivieren Option zur Verwendung der gegenseitigen Authentifizierung für Tokenanforderung und -sperrung. Für diese Option muss ein Profil für gegenseitige Authentifizierung angegeben werden.
    5. Fügen Sie Datensätze für die Gruppenbereichsmodifikatoren in der zugehörigen Liste „OAuth-Entitätsumfänge“ in diesem Format ein.<scope> :<modifier> .
      Wenn beispielsweise der Bereich user_read für den Modifikator Gruppe 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 anwenderdefinierten Anwendung Adobe Sign.
      Siehe Adobe Sign Entwicklung Dokumentation für Anweisungen.
    9. Fügen Sie den Wert der Umleitungs-URL in den Umleitungs-URI für Ihre anwenderdefinierte 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 die Token neu 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 verwenden diese Anmeldeinformationen zum Autorisieren von Aktionen.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Akadem. Grade.
    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-Anbieter erstellt wurde. Wählen Sie beispielsweise das 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. 100 ein.
    5. Klicken Sie mit der rechten Maustaste in den Header Kopfzeile 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 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 Adobe Sign -Gruppe erstellen, um diese Gruppe mit der Instanz 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 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. Formular „HTTP(s)-Verbindung“
      Feld Wert erforderlich
      Name Name zur eindeutigen Identifizierung des Datensatzes. Beispiel: Adobe Sign-Verbindung.
      Anmeldeinformationen Für Adobe Sign-Spoke erstellter Anmeldeinformationsdatensatz. 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 die Version ein.
      Spaltenname Vom System generierter Wert, der auf dem in „ Bezeichnung“ eingegebenen Wert 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 den Alias für Verbindungen und Anmeldeinformationen erstellt.

    Konfigurieren Sie den Anwendungszugriff auf die Tabellen ServiceNow

    Ermöglichen Sie Adobe Sign-Spoke, die Anwenderrolle „Gruppenadministrator“ 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 werden.
      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 „Adobe Sign-Gruppendetails“.
      Gruppenname Name zur eindeutigen Identifizierung der Gruppe Adobe Sign. Beispiel: Rechtsabteilung.
      Gruppen-ID Eindeutige ID, die dem Datensatz zugeordnet ist.
      Verbindungsalias Verbindungsalias erstellt, 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 Anwenderrolle wird in ServiceNowerstellt, wenn die Gruppe in der Instanz ServiceNow erstellt wird. Beispiel: Die HR-Gruppenbenutzerrolle sn_adobesign_spoke.HR wird erstellt, wenn die HR-Gruppe in ServiceNowerstellt wird. Der Administrator ServiceNow kann diese Gruppenbenutzerrollen Benutzern zuweisen und den Zugriff auf gruppenspezifische Informationen steuern, z. B.:
    • Dokumente und Vereinbarungen
    • Aliasse für Verbindungen und Anmeldeinformationen
    • Datensätze für Anmeldeinformationen
    • Anwendungsregistrierungen
    • Daten in Tabellen der Adobe Sign-Spoke

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

    Dokumente in der Gruppe [ Adobe Sign mit ServiceNowsynchronisieren

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

    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 „Adobe Sign-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.