DokumentationAEM as a Cloud ServiceBenutzerhandbuch

Verbinden von AEM Forms as a Cloud Service mit Adobe Acrobat Sign integrate-adobe-sign-with-aem-forms

Last update: Thu Nov 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Fortgeschrittener
  • Admin
  • Benutzende
Version
Artikel-Link
AEM 6.5
Hier klicken
AEM as a Cloud Service
Dieser Artikel

Adobe Acrobat Sign ermöglicht E-Signatur-Workflows für adaptive Formulare und AEM-Workflows. E-Signaturen verbessern die Workflows bei der Verarbeitung von Dokumenten in den Bereichen Recht, Vertrieb, Gehaltsabrechnung, Personalverwaltung u. v. a…

In einem typischen Szenario mit Adobe Acrobat Sign und adaptiven Formularen füllt der Benutzer ein adaptives Formular aus, um eine Dienstleistung zu beantragen. Dies könnte beispielsweise ein Antrag für eine Kreditkarte oder ein Formular für Dienstleistungen für Bürger sein. Wenn ein Benutzer das Antragsformular ausfüllt und signiert, wird dieses zur Bearbeitung an den Dienstleister gesendet. Der Dienstleister prüft den Antrag und markiert ihn mit Adobe Acrobat Sign als genehmigt. AEM Forms unterstützt sowohl Adobe Acrobat Sign als auch Adobe Acrobat Sign Solutions für Behörden. Je nach Ihrer Lizenz und Ihren Anforderungen können Sie AEM Forms mit einer der folgenden Lösungen integrieren oder verbinden:

Verbinden von AEM Forms mit Adobe Acrobat Sign adobe-sign

Um AEM Forms mit Adobe Acrobat Sign zu verbinden, richten Sie die im Abschnitt „Voraussetzungen“ aufgelistete Software und Konten ein und konfigurieren Sie den Adobe Sign Cloud Service in Ihren Authoring- und Publishing-Instanzen von Forms as a Cloud Service:

Voraussetzungen für das Verbinden von AEM Forms mit Adobe Acrobat Sign prerequisites-for-adobe-sign

Um Adobe Acrobat Sign mit AEM Forms zu integrieren, benötigen Sie das folgende Setup:

  1. Ein gültiges Adobe Acrobat Sign-Entwicklerkonto.
  2. Eine Adobe Acrobat Sign API-Anwendung.
  3. Anmeldeinformationen (Client-ID und Client Secret) der Adobe Acrobat Sign-API-Anwendung.
  4. (Nur für Authentifizierung mit amtlichem Lichtbildausweis) Aktivieren Sie die Authentifizierungsmethode für die Authentifizierung mit amtlichem Lichtbildausweis.

Verbinden von Authoring- und Publishing-Instanzen von AEM Forms mit Adobe Acrobat Sign configure-adobe-sign-with-aem-forms

Wenn alle Voraussetzungen erfüllt sind, führen Sie die folgenden Schritte aus, um Adobe Acrobat Sign in der Autoreninstanz mit AEM Forms zu konfigurieren.

  1. Navigieren Sie auf der AEM Forms-Autoreninstanz zu Tools hammer  > Allgemein > Konfigurations-Browser.

  2. Wählen Sie auf der Seite Konfigurations-Browser die Option Erstellen aus.

  3. Legen Sie im Dialogfeld Konfiguration erstellen einen Titel für die Konfiguration fest und aktivieren Sie Cloud-Konfigurationen. Wählen Sie dann die Option Erstellen aus. Es wird ein Konfigurations-Container für Cloud Services erstellt. Stellen Sie sicher, dass der Ordnername keine Leerzeichen enthält.

  4. Gehen Sie zu Werkzeuge Hammer > Cloud Services > Adobe Acrobat Sign und öffnen Sie den Konfigurations-Container, den Sie im vorherigen Schritt erstellt haben.

    note note
    NOTE
    Wenn Sie ein adaptives Formular erstellen, geben Sie den Namen des Containers im Feld Konfigurations-Container an.

  5. Wählen Sie auf der Konfigurationsseite Erstellen, um die Adobe Acrobat Sign-Konfiguration in AEM Forms zu erstellen.

  6. Geben Sie auf der Registerkarte Allgemein auf der Seite Erstellen der Konfiguration für Adobe Acrobat Sign einen Namen für die Konfiguration an und wählen Sie Weiter. Sie können optional einen Titel angeben und durchsuchen, um eine Miniaturansicht für die Konfiguration auszuwählen.

  7. Jetzt haben Sie die Option Lösung auswählen und können Adobe Acrobat Sign auswählen.

    Adobe Acrobat Sign Solutions-Konfiguration

  8. Kopieren Sie die im aktuellen Browser-Fenster vorhandene URL in einen Text-Editor und entfernen Sie den Teil /ui#/aem aus der URL. Die geänderte URL wird benötigt, um in einem späteren Schritt die Adobe Acrobat Sign-Anwendung mit AEM Forms zu konfigurieren. Wählen Sie Weiter aus.

  9. Führen Sie auf der Registerkarte Einstellungen folgende Schritte aus:

    • Das Feld  OAuth-URL  enthält die Standard-URL, die das Adobe Sign-Datenbank-Shard enthält. Das Format der URL ist:

      https://<shard>/public/oauth/v2

      Zum Beispiel:
      https://secure.na1.echosign.com/public/oauth/v2

    • Das Feld  Zugriffs-Token-URL enthält die Standard-URL, die das Adobe Sign-Datenbank-Shard enthält. Das Format der URL ist:

      https://<shard>/oauth/v2/token

      Zum Beispiel:
      https://api.na1.echosign.com/oauth/v2/token

    Hierbei gilt:

    na1 bezieht sich auf die Standarddatenbank-Shard. Sie können den Wert für die Datenbank-Shard ändern. Stellen Sie sicher, dass die ​ Adobe Acrobat Sign-Cloud-Konfigurationen auf die korrekte Shard verweisen.

    note note
    NOTE
    • Lassen Sie die Seite Erstellen einer Konfiguration für Adobe Acrobat Sign geöffnet. Schließen Sie sie nicht. Nachdem Sie die OAuth-Einstellungen für die Anwendung Adobe Acrobat Sign wie in den nächsten Schritten beschrieben konfiguriert haben, können Sie die Client-ID und den geheimen Client-Schlüssel abrufen.
    • Navigieren Sie nach der Anmeldung bei Ihrem Adobe Sign-Konto zu  Acrobat Sign-API >API-Informationen  > Dokumentation zu REST-API-Methoden  > OAuth-Zugriffs-Token, um auf Informationen im Zusammenhang mit der Adobe Sign OAuth-URL und der Zugriffs-Token-URL zuzugreifen.

  10. Konfigurieren Sie OAuth-Einstellungen für das Adobe Acrobat Sign-Programm:

    1. Öffnen Sie ein Browser-Fenster und melden Sie sich beim Adobe Acrobat Sign-Entwicklerkonto an.

    2. Wählen Sie die für AEM Forms konfigurierte Anwendung aus und wählen Sie OAuth für Anwendung konfigurieren.

    3. Fügen Sie im Feld Umleitungs-URL die im vorherigen Schritt (Schritt 8) kopierte URL ein und klicken Sie dann auf Speichern.

    4. Aktivieren Sie den folgenden Umfang für die Anwendung Adobe Acrobat Sign und klicken Sie auf Speichern.

    • aggrement_read
    • aggrement_write
    • aggrement_send
    • widget_read
    • widget_write
    • workflow_read
    note note
    NOTE
    Sie können den Scopes-Modifikator direkt von self in account ändern, wie in Schritt 12 AEM Benutzeroberfläche angegeben.

    Schritt-für-Schritt-Anleitungen zum Konfigurieren der OAuth-Einstellungen für ein Adobe Acrobat Sign-Programm und zum Abrufen der Schlüssel finden Sie in der Entwicklerdokumentation unter Konfigurieren von OAuth-Einstellungen für die Anwendung.

    OAuth Config

  11. Gehen Sie zurück zur Seite Erstellen einer Konfiguration für Adobe Acrobat Sign. Geben Sie auf der Registerkarte Einstellungen die [Client-ID (auch als Anwendungs-ID bezeichnet) und das Client-Geheimnis] an. Verwenden Sie die Client-ID und das Client-Geheimnis der Adobe Acrobat Sign-Anwendung, die Sie im vorherigen Schritt erstellt haben.

  12. Im Abschnitt Autorisierungsbereich können Sie die Bereiche entweder in "Konto"oder "selbst"ändern, indem Sie den Bereichen nach Bedarf das Präfix "selbst"oder "Konto"hinzufügen.
    Autorisierungsbereich

  13. Wählen Sie die Option Adobe Acrobat Sign für Anhänge aktivieren, um Dateien, die an einem adaptiven Formular angehängt sind, an ein entsprechendes Adobe Acrobat Sign-Dokument anzuhängen, das zum Signieren versandt wird.

  14. Wählen Sie Verbindung zu Adobe Acrobat Sign herstellen. Wenn Sie zur Eingabe der Anmeldedaten aufgefordert werden, geben Sie Benutzername und Passwort des Kontos an, das Sie bei der Erstellung der Adobe Acrobat Sign-Anwendung verwendet haben. Wenn Sie aufgefordert werden, den Zugriff für your developer account zu bestätigen, klicken Sie auf Zugriff erlauben. Wenn die Anmeldeinformationen korrekt sind und Sie AEM Forms erlauben, auf Ihr Adobe Acrobat Sign-Entwicklerkonto zuzugreifen, wird eine Erfolgsmeldung wie folgende angezeigt.

    Cloud-Konfiguration für Adobe Acrobat Sign erfolgreich

  15. Wählen Sie Erstellen, um die Adobe Acrobat Sign-Konfiguration zu erstellen.

  16. Wählen Sie die Konfiguration aus und klicken Sie auf Veröffentlichen, wählen Sie die Konfiguration aus und klicken Sie auf Veröffentlichen. Dadurch wird die Konfiguration in die entsprechende Umgebung im Veröffentlichungsmodus repliziert.

  17. Wiederholen Sie alle oben genannten Schritte für Ihre Entwicklungs-, Staging- und Produktionsinstanzen (je nachdem, welche noch übrig sind), um die Konfiguration von Adobe Acrobat Sign mit AEM Forms für Ihre Umgebung abzuschließen.

Jetzt können Sie Adobe Acrobat Sign-Felder zu einem adaptiven Formular hinzufügen. Stellen Sie sicher, dass Sie den für den Cloud Service verwendeten Konfigurations-Container zu allen adaptiven Formularen hinzufügen, die für Adobe Acrobat Sign aktiviert sind. Sie können einen Konfigurations-Container in den Eigenschaften eines adaptiven Formulars angeben.

NOTE
Um die Adobe Sign-Sandbox zu konfigurieren, können Sie die gleichen Konfigurationsschritte wie unter Adobe Sign beschrieben durchführen.

Fehlerbehebung resolve-config-error

Wenn Sie Adobe Acrobat Sign mit AEM Forms verbinden, könnten Sie einen Fehler Unable to authorize access because the client configuration is invalid: invalid_request finden, wie in der Abbildung unten dargestellt. Sie können dieses Problem lösen, indem Sie die nachstehenden Schritte befolgen:

Konfigurationsfehler

  1. Kopieren Sie die im aktuellen Browser-Fenster vorhandene URL in einen Texteditor und entfernen Sie den Teil /ui#/aem aus der URL.
  2. Öffnen Sie ein Browser-Fenster und melden Sie sich beim Adobe Acrobat Sign-Entwicklerkonto an.
  3. Wählen Sie die für AEM Forms konfigurierte Anwendung aus und wählen Sie OAuth für Anwendung konfigurieren.
  4. Fügen Sie im Feld Umleitungs-URL die im vorherigen Schritt kopierte URL ein und klicken Sie dann auf Speichern.

Verbinden von AEM Forms mit Adobe Acrobat Sign Solutions für Behörden adobe-acrobat-sign-for-government

Das Verbinden von AEM Forms mit Adobe Acrobat Sign Solutions für Behörden ist ein mehrstufiger Prozess. Er umfasst:

  • Erstellen einer Umleitungs-URL für Ihre AEM-Instanzen
  • Weitergeben der Umleitungs-URL und des Umfangs an das Team von Adobe Sign Solutions für Behörden
  • Erhalten von Anmeldedaten vom Adobe Sign-Team
  • Verwenden der erhaltenen Anmeldeinformationen, um AEM Forms mit Adobe Acrobat Sign Solutions für Behörden zu verbinden

Adobe Sign-Workflow für Behörden

AEM Forms as a Cloud Service bietet Entwicklungs-, Staging- und Produktionsumgebungen. Sie können damit beginnen, Ihre Entwicklungsumgebung mit Adobe Acrobat Sign Solutions für Behörden zu verbinden, und die Staging- und Produktionsumgebungen später verbinden.

Bevor Sie beginnen prerequisites-for-adobe-sign-for-acrobat-sign-for-government

Bevor Sie damit beginnen, AEM Forms mit Adobe Acrobat Sign zu verbinden, stellen Sie sicher, dass Ihr Adobe Acrobat Sign Solutions für Behörden-Konto bereitgestellt wurde.

Verbinden von AEM Forms as a Cloud Service mit Adobe Acrobat Sign Solutions für Behörden connect-adobe-acrobat-sign-for-government

Erstellen einer Umleitungs-URL für Ihre AEM-Instanz

  1. Gehen Sie in der Authoring-Instanz von Forms as a Cloud Service zu Werkzeuge Hammer > Allgemein > Konfigurations-Browser.
  2. Wählen Sie auf der Seite Konfigurations-Browser die Option Erstellen.
  3. Legen Sie im Dialogfeld Konfiguration erstellen einen Titel für die Konfiguration fest und aktivieren Sie Cloud-Konfigurationen. Wählen Sie anschließend Erstellen. Es wird ein Konfigurations-Container für Cloud Services erstellt. Stellen Sie sicher, dass der Ordnername keine Leerzeichen enthält.
  4. Navigieren Sie zu Tools Hammer > Cloud-Services > Adobe Acrobat Sign und wählen Sie den Konfigurations-Container aus, den Sie im vorherigen Schritt erstellt haben. Wenn Sie ein adaptives Formular erstellen, geben Sie den Namen des Containers im Feld Konfigurations-Container an.
  5. Wählen Sie auf der Konfigurationsseite die Option Erstellen, um die Adobe Acrobat Sign-Konfiguration in AEM Forms zu erstellen.
  6. Kopieren Sie die URL Ihres aktuellen Browser-Fensters in einen Texteditor und entfernen Sie /ui#/aem aus der URL. Diese URL wird als re-direct URL bezeichnet.
    Im nächsten Abschnitt geben Sie die re-direct URL und die Scopes an das Adobe Sign-Team weiter und fordern Anmeldeinformationen (Client-ID und Client-Geheimnis) an.

Weitergeben der Umleitungs-URL und der Bereiche an das Adobe Sign-Team und Empfangen von Anmeldeinformationen

Das Team von Adobe Acrobat Sign für Behörden benötigt die re-direct URL und die bestimmten Bereiche, die für Ihre Adobe Acrobat Sign-Anwendung aktiviert werden sollen (siehe unten), um Anmeldeinformationen (Client-ID und Client-Geheimnis) zu generieren, mit denen Sie AEM Forms mit Adobe Acrobat Sign Solutions für Behörden verbinden können.

Geben Sie die scopes (unten aufgelistet) und die re-direct URL, die Sie im letzten Schritt des vorherigen Abschnitts erstellt und notiert haben, an die Kontaktperson für Adobe Acrobat Sign for Government Solutions (Mitglied des Adobe Professional Services-Teams) weiter.

Bereiche

  • aggrement_read
  • aggrement_write
  • aggrement_send
  • widget_read
  • widget_write
  • workflow_read
  • offline_access

Die Kontaktperson generiert Anmeldeinformationen und teilt Ihnen diese mit. Im nächsten Abschnitt verwenden Sie die Anmeldeinformationen (Client-ID und Client-Geheimnis), um AEM Forms mit Adobe Acrobat Sign Solutions für Behörden zu verbinden.

Verwenden Sie die erhaltenen Anmeldeinformationen, um AEM Forms mit Adobe Acrobat Sign Solutions für Behörden zu verbinden.

  1. Öffnen Sie die re-direct URL in Ihrem Browser. Sie haben die re-direct URL im letzten Schritt des Abschnitts Erstellen einer Umleitungs-URL in Ihrer AEM-Instanz erstellt und notiert.

  2. Geben Sie auf der Registerkarte Allgemein der Seite Erstellen einer Adobe Sign-Konfiguration einen Namen für die Konfiguration an und wählen Sie Weiter aus. Sie können optional einen Titel angeben und eine Miniaturansicht für die Konfiguration suchen. Klicken Sie auf Weiter.

  3. Wählen Sie auf der Registerkarte Einstellungen der Seite Adobe Sign-Konfiguration erstellen für Lösung auswählen die Option Adobe Acrobat Sign Solutions for Government aus.

    Adobe Acrobat Sign Solutions für Behörden

  4. Geben Sie im Feld E-Mail die E-Mail-Adresse an, die mit Ihrem Konto von Adobe Acrobat Sign Solutions für Behörden verknüpft ist.

  5. Führen Sie auf der Registerkarte Einstellungen folgende Schritte aus:

    • Das Feld  OAuth-URL  enthält die Standard-URL, die das Adobe Sign-Datenbank-Shard enthält. Das Format der URL ist:

      https://<shard>/api/gateway/adobesignauthservice/api/v1/authorize

      Zum Beispiel:
      https://secure.na1.adobesign.us/api/gateway/adobesignauthservice/api/v1/authorize

    • Das Feld  Zugriffs-Token-URL enthält die Standard-URL, die das Adobe Sign-Datenbank-Shard enthält. Das Format der URL ist:

      https://<shard>/api/gateway/adobesignauthservice/api/v1/token

      Zum Beispiel:
      https://secure.na1.adobesign.us/api/gateway/adobesignauthservice/api/v1/token

    Hierbei gilt:

    na1 bezieht sich auf die Standarddatenbank-Shard. Sie können den Wert für die Datenbank-Shard ändern. Stellen Sie sicher, dass die ​ Adobe Acrobat Sign-Cloud-Konfigurationen auf die korrekte Shard verweisen.

    note note
    NOTE
    • Navigieren Sie nach der Anmeldung bei Ihrem Adobe Sign-Konto zu  Acrobat Sign-API > API-Informationen  > Dokumentation zu REST-API-Methoden  > OAuth-Zugriffs-Token, um auf Informationen im Zusammenhang mit der OAuth-URL und der Zugriffs-Token-URL für Adobe Sign zuzugreifen.

  6. Verwenden Sie die Anmeldeinformationen, die die Kontaktperson für Adobe Acrobat Sign for Government Solutions ([Mitglied des Adobe Professional Services-Teams]) im vorherigen Abschnitt als [Client-ID und Client-Geheimnis] geteilt hat.

  7. Wählen Sie die Option Adobe Acrobat Sign für Anhänge aktivieren, um Dateien, die an einem adaptiven Formular angehängt sind, an ein entsprechendes Adobe Acrobat Sign-Dokument anzuhängen, das zum Signieren versandt wird.

  8. Wählen Sie Mit Adobe Sign verbinden aus. Geben Sie bei Aufforderung zur Eingabe der Anmeldeinformationen den Benutzernamen und das Kennwort des Kontos an, die bei der Erstellung der Adobe Acrobat Sign-Anwendung verwendet wurden. Sobald Sie aufgefordert werden, den Zugriff für your developer account zu bestätigen, klicken Sie auf Zugriff erlauben. Wenn die Anmeldeinformationen korrekt sind und Sie AEM Forms erlauben, auf Ihr Adobe Acrobat Sign-Entwicklerkonto zuzugreifen, wird eine Erfolgsmeldung wie folgende angezeigt.

    Cloud-Konfiguration für Adobe Acrobat Sign erfolgreich

  9. Wählen Sie Erstellen, um die Konfiguration zu erstellen.

  10. Wählen Sie die Konfiguration aus und klicken Sie auf Veröffentlichen, wählen Sie die Konfiguration aus und klicken Sie auf Veröffentlichen. Dadurch wird die Konfiguration in den entsprechenden Publishing-Umgebungen repliziert.

  11. Wiederholen Sie alle oben genannten Schritte für Ihre Entwicklungs-, Staging- und Produktionsinstanzen (je nachdem, welche noch übrig sind), um die Konfiguration von Adobe Acrobat Sign Solutions for Government mit AEM Forms für Ihre Umgebung abzuschließen.

Sie können jetzt Adobe Acrobat Sign-Felder in einem adaptiven Formular oder einem AEM-Workflow hinzufügen. Stellen Sie sicher, dass Sie den für die Cloud-Service-Konfiguration verwendeten Konfigurations-Container zu allen adaptiven Formularen hinzufügen, die für Adobe Acrobat Sign aktiviert sind. Sie können einen Konfigurations-Container in den Eigenschaften eines adaptiven Formulars angeben.

Konfigurieren der Adobe Acrobat Sign-Planung, um den Signaturstatus zu synchronisieren configure-adobe-sign-scheduler-to-sync-the-signing-status

AEM Forms as a Cloud Service bietet einen Planungs-Service, der den Status von Unterzeichnenden in definierten Intervallen überprüft. Die Szenarien, in denen Sie den Planungs-Service konfigurieren:

Standardmäßig überprüfen die Adobe Acrobat Sign-Planungs-Services die Unterzeichnerreaktionen alle 24 Stunden. Sie können das Standardintervall für Ihre Umgebung ändern.

Um das Standardintervall zu ändern, geben Sie einen Cron-Ausdruck für die Eigenschaft sign.status.exp der Konfiguration des Adobe Acrobat Sign-Konfigurationsdienstes an.

Um beispielsweise den Konfigurationsdienst täglich um 0:00 Uhr auszuführen, setzen Sie die Eigenschaft sign.status.exp des Adobe Sign-Konfigurationsdienstes auf 0 0 0 1/1 * ? *. Folgende JSON-Datei zeigt das Beispiel einer täglichen Ausführung des Konfigurations-Service um 0:00 Uhr:

{
  "sign.status.exp":"0 0 0 1/1 * ? *"
}

Um Konfigurationswerte festzulegen, generieren Sie OSGi-Konfigurationen mit dem AEM-SDK und stellen Sie die Konfiguration in Ihrer Cloud Service-Instanz bereit.

Häufig gestellte Fragen

  • Q: Kann ich die Adobe Sign GovCloud-Signaturseite in einem iframe rendern?
  • A: Ja, Sie können die Adobe Sign GovCloud-Signaturseite in einem iframe rendern.
Related Articles
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab