Arbeiten mit Anmeldeinformationen

Ü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 Hilfe zur Administration.)

Importieren von Anmeldeinformationen mithilfe der 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 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. 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.

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

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 von 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 eine com.adobe.idp.Document -Objekt, das die Berechtigung mithilfe der com.adobe.idp.Document -Konstruktor. Übergeben Sie die java.io.FileInputStream -Objekt, das die Berechtigung für den Konstruktor enthält.
  4. Importvorgang durchführen

    • Erstellen Sie ein Zeichenfolgen-Array, das ein Element enthält. Wert zuweisen truststore.usage.type.sign zum Element hinzu.

    • Rufen Sie die CredentialServiceClient -Objekt importCredential -Methode verwenden und die folgenden Werte übergeben:

      • Ein string -Wert, der den Alias-Wert für die Berechtigung angibt.
      • Die com.adobe.idp.Document -Instanz, die die Berechtigung speichert.
      • 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 diesen Wert beispielsweise angeben truststore.usage.type.sign. Um eine Berechtigung für die Reader-Erweiterung zu importieren, geben Sie truststore.usage.type.lcre.

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 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 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 CredentialServiceClient -Objekt deleteCredential -Methode und übergeben Sie einen string -Wert, der den Alias-Wert 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