Arbeiten mit Berechtigungen

Informationen zum Berechtigungsdienst

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 verschiedene Zwecke:

Sie können mit der Trust Manager Java-API programmgesteuert mit dem Berechtigungsdienst interagieren. Sie können die folgenden Aufgaben durchführen:

HINWEIS

Sie können Zertifikate auch über Administration Console importieren und löschen. (Siehe Administration-Hilfe.)

Berechtigungen mithilfe der Trust Manager-APIimportieren

Sie können eine Berechtigung programmgesteuert mit der Trust Manager-API in AEM Forms importieren. Sie können beispielsweise eine Berechtigung importieren, mit der ein PDF-Dokument signiert 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 durchzuführen, für den eine Berechtigung erforderlich ist. Nach dem Import kann eine Berechtigung in Administration Console angezeigt werden, wie in der folgenden Abbildung dargestellt. Beachten Sie, dass der Alias für die Berechtigung Secure lautet.

ww_ww_truststore

HINWEIS

Sie können eine Berechtigung nicht mit Webdiensten in AEM Forms importieren.

Zusammenfassung der Schritte

So importieren Sie eine Berechtigung in AEM Forms:

  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie einen Berechtigungsdienstclient.
  3. Verweisen Sie auf die Berechtigung.
  4. Führen Sie den Importvorgang durch.

Projektdateien einschließen

Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, stellen Sie sicher, dass Sie die Proxydateien einschließen.

Die folgenden JAR-Dateien müssen dem Klassenpfad Ihres Projekts hinzugefügt werden:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-truststore-client.jar
  • adobe-utilities.jar (Erforderlich, wenn AEM Forms unter JBoss bereitgestellt wird)
  • jbossall-client.jar (Erforderlich, wenn AEM Forms unter JBoss bereitgestellt wird)

Informationen zum Speicherort dieser JAR-Dateien finden Sie unter Einschließen von AEM Forms Java-Bibliotheksdateien.

Berechtigungsdienstclient erstellen

Bevor Sie eine Berechtigung programmgesteuert in AEM Forms importieren können, erstellen Sie einen Berechtigungsdienstclient. Weitere Informationen finden Sie unter Verbindungseigenschaften festlegen.

Referenz zur Berechtigung

Referenzieren Sie eine Berechtigung, die Sie in AEM Forms importieren möchten. Der mit diesem Abschnitt verknüpfte Quick-Beginn 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 Anmeldeinformationen mit der Java-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

API-Beginn für den Berechtigungsdienst

Löschen von Berechtigungen mithilfe der Trust Manager-API

Importieren von Anmeldeinformationen mit der Java-API

Importieren Sie eine Berechtigung mit der Trust Manager-API (Java) in AEM Forms:

  1. Projektdateien einschließen

    Schließen Sie Client-JAR-Dateien wie "adobe-truststore-client.jar"im Klassenpfad Ihres Java-Projekts ein.

  2. Berechtigungsdienstclient erstellen

    • Erstellen Sie ein ServiceClientFactory-" -Objekt, das Verbindungseigenschaften enthält.
    • Erstellen Sie ein CredentialServiceClient-Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory-Objekt übergeben.
  3. Referenz zur Berechtigung

    • Erstellen Sie ein Objekt java.io.FileInputStream, indem Sie den Konstruktor verwenden. Übergeben Sie einen Zeichenfolgenwert, der den Speicherort der Berechtigung angibt.
    • Erstellen Sie ein com.adobe.idp.Document-Objekt, das die Berechtigung mithilfe des Konstruktors com.adobe.idp.Document speichert. Übergeben Sie das java.io.FileInputStream-Objekt, das die Berechtigung enthält, an den Konstruktor.
  4. Durchführen des Importvorgangs

    • Erstellen Sie ein String-Array, das ein Element enthält. Weisen Sie dem Element den Wert truststore.usage.type.sign zu.

    • Rufen Sie die CredentialServiceClient-Methode des Objekts auf und übergeben Sie die folgenden Werte:importCredential

      • Ein Zeichenfolgenwert, der den Aliaswert der Berechtigung angibt.
      • Die com.adobe.idp.Document-Instanz, in der die Berechtigung gespeichert wird.
      • Ein Zeichenfolgenwert, der das mit der Berechtigung verknüpfte Kennwort angibt.
      • Das Zeichenfolgenarray, das den Nutzungswert enthält. Sie können diesen Wert beispielsweise truststore.usage.type.sign angeben. Um eine Reader Extension-Berechtigung zu importieren, geben Sie truststore.usage.type.lcre an.

Siehe auch

Berechtigungen mithilfe der Trust Manager-API importieren

Quick Beginn (SOAP-Modus): Importieren von Berechtigungen mit der Java-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Löschen von Berechtigungen mithilfe der Trust Manager-API

Sie können eine Berechtigung programmgesteuert mithilfe der Trust Manager-API löschen. Beim Löschen einer Berechtigung geben Sie einen Alias an, der der Berechtigung entspricht. Nach dem Löschen kann eine Berechtigung nicht für einen Vorgang verwendet werden.

HINWEIS

Sie können eine Berechtigung nicht mit Webdiensten in AEM Forms löschen.

Zusammenfassung der Schritte

So löschen Sie eine Berechtigung:

  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie einen Berechtigungsdienstclient.
  3. Führen Sie den Löschvorgang durch.

Projektdateien einschließen

Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Die folgenden JAR-Dateien müssen dem Klassenpfad Ihres Projekts hinzugefügt werden:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-truststore-client.jar
  • adobe-utilities.jar (Erforderlich, wenn AEM Forms unter JBoss bereitgestellt wird)
  • jbossall-client.jar (Erforderlich, wenn AEM Forms unter JBoss bereitgestellt wird)

Informationen zum Speicherort dieser JAR-Dateien finden Sie unter Einschließen von AEM Forms Java-Bibliotheksdateien.

Berechtigungsdienstclient erstellen

Bevor Sie eine Berechtigung programmgesteuert löschen können, erstellen Sie einen Data Integration-Dienstclient. Beim Erstellen eines Dienstclients definieren Sie Verbindungseinstellungen, die zum Aufrufen eines Dienstes erforderlich sind. Weitere Informationen finden Sie unter Verbindungseigenschaften festlegen.

Löschvorgang durchführen

Um eine Berechtigung zu löschen, geben Sie den Alias an, der der Berechtigung entspricht. Wenn Sie einen Alias angeben, der nicht vorhanden ist, wird eine Ausnahme ausgelöst.

Siehe auch

Importieren von Anmeldeinformationen mit der Java-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Importieren von Anmeldeinformationen mit der Java-API

Löschen von Berechtigungen mit der Java-API

Eine Berechtigung aus AEM Forms mithilfe der Trust Manager-API (Java) löschen:

  1. Projektdateien einschließen

    Schließen Sie Client-JAR-Dateien wie "adobe-truststore-client.jar"im Klassenpfad Ihres Java-Projekts ein.

  2. Berechtigungsdienstclient erstellen

    • Erstellen Sie ein ServiceClientFactory-" -Objekt, das Verbindungseigenschaften enthält.
    • Erstellen Sie ein CredentialServiceClient-Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory-Objekt übergeben.
  3. Löschvorgang durchführen

    Rufen Sie die CredentialServiceClient-Methode des Objekts auf und übergeben Sie einen Zeichenfolgenwert, der den Aliaswert angibt.deleteCredential

Siehe auch

Löschen von Berechtigungen mithilfe der Trust Manager-API

Quick Beginn (SOAP-Modus): Löschen von Berechtigungen mit der Java-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Auf dieser Seite