AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.
Über den Berechtigungs-Service
Eine Berechtigung enthält Informationen zu Ihrem privaten Schlüssel, der zum Signieren bzw. Identifizieren von Dokumenten benötigt wird. Ein Zertifikat enthält Informationen zum öffentlichen Schlüssel, den Sie für die Trust Store-Verwaltung konfigurieren. AEM Forms verwendet Zertifikate und Berechtigungen für mehrere Zwecke:
Mithilfe der Java-API von Trust Manager können Sie programmgesteuert mit dem Berechtigungs-Service interagieren. Sie können die folgenden Aufgaben ausführen:
Sie können Zertifikate auch über Administration-Console importieren bzw. löschen. (Siehe Administration-Hilfe.)
Mithilfe der Trust-Manager-API können Sie programmgesteuert eine Berechtigung in AEM Forms importieren. Sie können beispielsweise eine Berechtigung importieren, die zum Signieren eines PDF-Dokuments verwendet wird. (Siehe Digitales Signieren von PDF-Dokumenten.)
Beim Importieren einer Berechtigung geben Sie einen Alias für die Berechtigung an. Der Alias wird verwendet, um einen Forms-Vorgang auszuführen, für den eine Berechtigung erforderlich ist. Nachdem sie importiert worden ist, kann eine Berechtigung in Administration-Console angezeigt werden, wie in der folgenden Abbildung dargestellt. Beachten Sie, dass der Alias für die Berechtigung sicher ist.
Es ist nicht möglich, eine Berechtigung mithilfe von Web-Services in AEM Forms zu importieren.
Um eine Berechtigung in AEM Forms zu importieren, führen Sie die folgenden Schritte aus:
Schließen Sie Projektdateien ein
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie ein Client-Programm mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Web-Services verwenden, stellen Sie sicher, dass Sie die Proxy-Dateien einschließen.
Die folgenden JAR-Dateien müssen zum Klassenpfad Ihres Projekts hinzugefügt werden:
Weitere Informationen über den Speicherort dieser JAR-Dateien finden Sie unter Einbeziehung von AEM Forms Java-Bibliotheksdateien.
Erstellen eines Berechtigungs-Service-Clients
Bevor Sie eine Berechtigung programmgesteuert in AEM Forms importieren können, müssen Sie einen Client für den Berechtigungs-Service erstellen. Weitere Informationen finden Sie unter Festlegen von Verbindungseigenschaften.
Referenzieren der Berechtigung
Referenzieren Sie eine Berechtigung, die Sie in AEM Forms importieren möchten. Der Schnellstart für diesen Abschnitt verweist auf eine P12-Datei im Dateisystem.
Durchführen des Importvorgangs
Nachdem Sie auf die Berechtigung verwiesen haben, importieren Sie die Berechtigung in AEM Forms. Wenn die Berechtigung nicht erfolgreich importiert wurde, wird eine Ausnahme ausgelöst. Beim Importieren einer Berechtigung geben Sie einen Alias für die Berechtigung an.
Siehe auch
Importieren von Berechtigungen mithilfe der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Berechtigungs-Service-API – Schnellstarts
Löschen von Berechtigungen mithilfe der Trust Manager-API
So importieren Sie eine Berechtigung mithilfe der Trust Manager-API (Java) in AEM Forms:
Projektdateien einschließen
Fügen Sie Client-JAR-Dateien wie beispielsweise adobe-truststore-client.jar in den Klassenpfad Ihres Java-Projekts ein.
Erstellen eines Berechtigungs-Service-Clients
ServiceClientFactory
-Objekt, das Verbindungseigenschaften enthält.CredentialServiceClient
-Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory
-Objekt übergeben.Angabe der Berechtigung
java.io.FileInputStream
, indem Sie den Konstruktor verwenden. Übergeben Sie einen Zeichenfolgenwert, der den Speicherort der Berechtigung angibt.com.adobe.idp.Document
-Konstruktors ein com.adobe.idp.Document
-Objekt, in dem die Berechtigung gespeichert wird. Übergeben Sie das java.io.FileInputStream
-Objekt, das die Berechtigung enthält, an den Konstruktor enthält.Ausführen des Importvorgangs
Erstellen Sie ein Zeichenfolgen-Array, das ein Element enthält. Weisen Sie den Wert truststore.usage.type.sign
dem Element zu.
Rufen Sie die importCredential
-Methode des CredentialServiceClient
-Objekts auf und übergeben Sie die folgenden Werte:
com.adobe.idp.Document
-Instanz, in der die Berechtigung gespeichert ist.truststore.usage.type.sign
angeben. Um eine Reader Extension-Berechtigung zu importieren, geben Sie truststore.usage.type.lcre
an.Siehe auch
Importieren von Berechtigungen mithilfe der Trust Manager-API
Kurzanleitung (SOAP-Modus): Importieren von Berechtigungen mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Sie können eine Berechtigung programmgesteuert löschen, indem Sie die Trust Manager-API verwenden. Um eine Berechtigung zu löschen, müssen Sie den Alias der Berechtigung angeben. Nachdem eine Berechtigung gelöscht wurde, kann sie nicht mehr zum Ausführen eines Vorgangs verwendet werden.
Sie können eine Berechtigung für AEM Forms nicht mithilfe des Web-Services löschen.
Um eine Berechtigung zu löschen, führen Sie die folgenden Schritte aus:
Einschließen von Projektdateien
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie ein Client-Programm mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Die folgenden JAR-Dateien müssen zum Klassenpfad Ihres Projekts hinzugefügt werden:
Weitere Informationen über den Speicherort dieser JAR-Dateien finden Sie unter Einbeziehung von AEM Forms Java-Bibliotheksdateien.
Erstellen eines Service-Clients für die Berechtigung
Bevor Sie eine Berechtigung programmgesteuert löschen können, müssen Sie einen Client des Data Integration-Service erstellen. Beim Erstellen eines Service-Clients bestimmen Sie Verbindungseinstellungen, die zum Aufrufen eines Services erforderlich sind. Weitere Informationen finden Sie unter Einrichten von Verbindungseigenschaften.
Ausführen des Löschvorgangs
Um eine Berechtigung zu löschen, müssen Sie den Alias der Berechtigung angeben. Wenn Sie einen Alias angeben, der nicht existiert, wird eine Ausnahme ausgelöst.
Siehe auch
Importieren von Berechtigungen mithilfe der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Importieren von Berechtigungen mithilfe der Java-API
So löschen Sie mithilfe der Trust Manager-API (Java) eine Berechtigung aus AEM Forms:
Projektdateien einschließen
Fügen Sie Client-JAR-Dateien wie beispielsweise adobe-truststore-client.jar in den Klassenpfad Ihres Java-Projekts ein.
Erstellen eines Berechtigungs-Service-Clients
ServiceClientFactory
-Objekt, das Verbindungseigenschaften enthält.CredentialServiceClient
-Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory
-Objekt übergeben.Durchführen des Löschvorgangs
Rufen Sie die deleteCredential
-Methode des CredentialServiceClient
-Objekt auf und übergeben Sie einen Zeichenfolgewert, der den Alias-Wert angibt.
Siehe auch
Löschen von Berechtigungen mithilfe der Trust Manager-API
Schnellstart (SOAP-Modus): Löschen von Berechtigungen mithilfe der Java-API