Verbinden von AEM Forms as a Cloud Service mit Adobe Acrobat Sign

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
• Verbinden von AEM Forms mit Adobe Acrobat Sign Solutions für Behörden

Verbinden von AEM Forms mit Adobe Acrobat 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

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

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  > Allgemein > Konfigurations-Browser.

2. Im Konfigurationsbrowser Seite, auswählen Erstellen.

3. Im Konfiguration erstellen Dialogfeld angeben, Titel für die Konfiguration aktivieren Cloud-Konfigurationen und wählen Sie Erstellen. 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 > Cloud Services > Adobe Acrobat Sign und öffnen Sie den Konfigurations-Container, den Sie im vorherigen Schritt erstellt haben.

   HINWEIS

   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 erstellen Adobe Acrobat Sign Konfiguration in AEM Forms.

6. Im Allgemein des Adobe Acrobat Sign-Konfiguration erstellen Seite, geben Sie eine Name für die Konfiguration und wählen Sie Nächste. 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.

   

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. Im Einstellungen Registerkarte,

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

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

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

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

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

     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.

   HINWEIS

   • 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-Zugriffstoken , um auf Informationen im Zusammenhang mit der OAuth-URL von Adobe Sign und der Zugriffstoken-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 Anwendung aus, die für AEM Formsund 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

    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.

    

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

13. Auswählen 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.

    

14. Auswählen Erstellen , um Adobe Acrobat Sign Konfiguration.

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

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

Verbinden von AEM Forms mit Adobe Acrobat Sign Solutions für Behörden

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

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

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

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

1. Gehen Sie in der Authoring-Instanz von Forms as a Cloud Service zu Werkzeuge > Allgemein > Konfigurations-Browser.
2. Im Konfigurationsbrowser Seite, auswählen Erstellen.
3. Im Konfiguration erstellen Dialogfeld angeben, Titel für die Konfiguration aktivieren Cloud-Konfigurationen und wählen Sie 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 > 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 Erstellen erstellen Adobe Acrobat Sign Konfiguration in AEM Forms.
6. Kopieren Sie die URL Ihres aktuellen Browser-Fensters in einen Text-Editor und entfernen Sie /ui#/aem aus der URL. Diese URL wird als re-direct URL.
   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. Im Allgemein des Adobe Sign-Konfiguration erstellen Seite, geben Sie eine Name für die Konfiguration und wählen Sie Nächste. 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.

   

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. Im Einstellungen Registerkarte,

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

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

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

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

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

     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.

   HINWEIS

   • Navigieren Sie nach der Anmeldung bei Ihrem Adobe Sign-Konto zu Acrobat Sign-API > API-Informationen > Dokumentation zu REST-API-Methoden > OAuth-Zugriffstoken , um auf Informationen im Zusammenhang mit der OAuth-URL von Adobe Sign und der Zugriffstoken-URL 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. Auswählen Verbindung zu Adobe Sign herstellen. Geben Sie bei Aufforderung zur Eingabe der Anmeldeinformationen Benutzername und Kennwort des Kontos an, die bei der Erstellung des Adobe Acrobat Sign-Programms 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.

   

9. Auswählen 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.

(Nur für AEM-Workflows) Konfigurieren der Adobe Acrobat Sign-Planung, um den Unterzeichnungsstatus zu synchronisieren

Wenn Sie zum Unterzeichnen eines adaptiven Formulars den Adobe Acrobat Sign-Workflow-Schritt verwenden, kann das Formular je nach Konfiguration des Workflow-Schritts nacheinander an jeweils einen Unterzeichner oder gleichzeitig an alle Unterzeichner gesendet werden. Adaptive Formulare für Adobe Acrobat Sign werden erst dann an den Experience Manager-Formular-Server weitergeleitet, nachdem alle Unterzeichner den Unterzeichnungsvorgang abgeschlossen haben.

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.