Arbeiten mit Anmeldeinformationen

Beispiele und Beispiele in diesem Dokument gelten nur für die AEM Forms on JEE-Umgebung.

Über den 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 programmgesteuert mit dem Berechtigungsdienst über die Java-API von Trust Manager interagieren. Sie können die folgenden Aufgaben ausführen:

HINWEIS

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

Importing Credentials by using the Trust Manager API

Sie können eine Berechtigung programmgesteuert mit der Trust Manager-API in AEM Forms importieren. Sie können beispielsweise eine Berechtigung importieren, die zum Signieren eines PDF-Dokuments verwendet wird. (Siehe PDF-Dokumente digital signieren).

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

Um eine Berechtigung in AEM Forms zu importieren, führen Sie die folgenden Schritte aus:

  1. Projektdateien einschließen.
  2. Erstellen Sie einen Client für den Berechtigungsdienst.
  3. Verweisen Sie auf die Berechtigung.
  4. Führen Sie den Importvorgang durch.

Projektdateien einschließen

Fügen 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 Proxy-Dateien einschließen.

Die folgenden JAR-Dateien müssen zum 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 auf JBoss bereitgestellt wird)
  • jbossall-client.jar (erforderlich, wenn AEM Forms auf JBoss bereitgestellt wird)

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

Erstellen eines Berechtigungsdienstclients

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

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

Importvorgang durchführen

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

Schnellstarts zur API für Credential Service

Löschen von Anmeldeinformationen mithilfe der Trust Manager-API

Importieren Sie Anmeldeinformationen mit der Java-API

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

  1. Projektdateien einschließen

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

  2. Erstellen eines Berechtigungsdienstclients

    • 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: Berechtigung

    • Erstellen Sie ein Objekt java.io.FileInputStream, indem Sie den Konstruktor verwenden. Übergeben Sie einen string -Wert, 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. Importvorgang durchführen

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

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

      • Ein string -Wert, der den Alias-Wert für die Berechtigung angibt.
      • Die com.adobe.idp.Document-Instanz, in der die Berechtigung gespeichert wird.
      • Ein string -Wert, der das Kennwort angibt, das mit der Berechtigung verknüpft ist.
      • Das Zeichenfolgen-Array, das den Nutzungswert enthält. Sie können beispielsweise den Wert truststore.usage.type.sign angeben. Um eine Berechtigung für die Reader-Erweiterung zu importieren, geben Sie truststore.usage.type.lcre an.

Siehe auch

Importieren von Anmeldeinformationen mithilfe der Trust Manager-API

Schnellstart (SOAP-Modus): Importieren von Anmeldeinformationen mit der Java-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Löschen von Anmeldeinformationen mithilfe der Trust Manager-API

Sie können eine Berechtigung programmgesteuert löschen, indem Sie die Trust Manager-API verwenden. Beim Löschen einer Berechtigung geben Sie einen Alias an, der der Berechtigung entspricht. Nach dem Löschen kann eine Berechtigung nicht mehr zum Ausführen eines Vorgangs verwendet werden.

HINWEIS

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

Zusammenfassung der Schritte

Um eine Berechtigung zu löschen, führen Sie die folgenden Schritte aus:

  1. Projektdateien einschließen.
  2. Erstellen Sie einen Client für den Berechtigungsdienst.
  3. Führen Sie den Löschvorgang durch.

Projektdateien einschließen

Fügen 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 zum 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 auf JBoss bereitgestellt wird)
  • jbossall-client.jar (erforderlich, wenn AEM Forms auf JBoss bereitgestellt wird)

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

Erstellen eines Berechtigungsdienstclients

Bevor Sie eine Berechtigung programmgesteuert löschen können, erstellen Sie einen Client des Data Integration Service. Beim Erstellen eines Service-Clients definieren Sie Verbindungseinstellungen, die zum Aufrufen eines Dienstes erforderlich sind. Weitere Informationen finden Sie unter Festlegen von Verbindungseigenschaften.

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 Anmeldeinformationen mithilfe der Java-API

Löschen Sie mithilfe der Trust Manager-API (Java) eine Berechtigung aus AEM Forms:

  1. Projektdateien einschließen

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

  2. Erstellen eines Berechtigungsdienstclients

    • 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 deleteCredential -Methode des Objekts CredentialServiceClient auf und übergeben Sie einen string -Wert, der den Aliaswert angibt.

Siehe auch

Löschen von Anmeldeinformationen mithilfe der Trust Manager-API

Schnellstart (SOAP-Modus): Löschen von Anmeldeinformationen mithilfe der Java-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Auf dieser Seite