Utilizzo delle credenziali working-with-credentials

Gli esempi e gli esempi contenuti in questo documento sono solo per AEM Forms in ambiente JEE.

Informazioni sul servizio credenziali

Una credenziale contiene le informazioni sulla chiave privata necessarie per la firma o l'identificazione dei documenti. Un certificato è costituito da informazioni sulla chiave pubblica configurate per l'attendibilità. AEM Forms utilizza certificati e credenziali per diversi scopi:

È possibile interagire in modo programmatico con il servizio Credential utilizzando l’API Java di Trust Manager. Puoi eseguire le seguenti attività:

NOTE
È inoltre possibile importare ed eliminare certificati utilizzando la console di amministrazione. (Vedi guida per l'amministrazione.)

Importazione delle credenziali tramite l'API di Gestione trust importing-credentials-by-using-the-trust-manager-api

È possibile importare in modo programmatico una credenziale in AEM Forms utilizzando l’API di Trust Manager. È ad esempio possibile importare le credenziali utilizzate per firmare un documento PDF. (Vedi Documenti Di PDF Con Firma Digitale).

Quando si importa una credenziale, è necessario specificare un alias per la credenziale. L'alias viene utilizzato per eseguire un'operazione Forms che richiede una credenziale. Una volta importata, è possibile visualizzare una credenziale nella console di amministrazione, come illustrato nella figura seguente. L'alias per le credenziali è Secure.

ww_ww_truststore

NOTE
Non è possibile importare credenziali in AEM Forms utilizzando i servizi Web.

Riepilogo dei passaggi summary-of-steps

Per importare una credenziale in AEM Forms, effettuare le seguenti operazioni:

  1. Includi file di progetto.
  2. Creare un client del servizio delle credenziali.
  3. Fai riferimento alle credenziali.
  4. Eseguire l'operazione di importazione.

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.

I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-truststore-client.jar
  • adobe-utilities.jar (richiesto se AEM Forms è implementato su JBoss)
  • jbossall-client.jar (obbligatorio se AEM Forms è distribuito su JBoss)

Per informazioni sul percorso di questi file JAR, vedi Inclusi i file della libreria Java di AEM Forms.

Creare un client del servizio credenziali

Prima di importare a livello di programmazione una credenziale in AEM Forms, creare un client del servizio delle credenziali. Per informazioni, vedere Impostazione delle proprietà di connessione.

Fai riferimento alle credenziali

Fai riferimento a una credenziale da importare in AEM Forms. L'avvio rapido associato a questa sezione fa riferimento a un file P12 nel file system.

Operazione di importazione

Dopo aver fatto riferimento alle credenziali, importale in AEM Forms. Se le credenziali non vengono importate correttamente, viene generata un'eccezione. Quando si importa una credenziale, è necessario specificare un alias per la credenziale.

Consulta anche

Importare le credenziali tramite API Java

Inclusione dei file della libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Avvio rapido API servizio credenziali

Eliminazione delle credenziali tramite l’API di Gestione trust

Importare le credenziali tramite API Java import-credentials-using-the-java-api

Importa una credenziale in AEM Forms utilizzando l’API di Trust Manager (Java):

  1. Includi file di progetto

    Includi i file JAR dei client, ad esempio adobe-truststore-client.jar, nel percorso di classe del progetto Java.

  2. Creare un client del servizio delle credenziali

    • Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
    • Creare un oggetto CredentialServiceClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.
  3. Fai riferimento alle credenziali

    • Creare un oggetto java.io.FileInputStream utilizzando il relativo costruttore. Passa un valore stringa che specifica la posizione delle credenziali.
    • Creare un oggetto com.adobe.idp.Document che memorizza le credenziali utilizzando il costruttore com.adobe.idp.Document. Passa l'oggetto java.io.FileInputStream che contiene le credenziali al costruttore.
  4. Eseguire l'operazione di importazione

    • Creare una matrice di stringhe contenente un elemento. Assegnare il valore truststore.usage.type.sign all'elemento.

    • Richiama il metodo importCredential dell'oggetto CredentialServiceClient e passa i seguenti valori:

      • Valore stringa che specifica il valore alias per le credenziali.
      • L'istanza com.adobe.idp.Document che memorizza le credenziali.
      • Valore stringa che specifica la password associata alle credenziali.
      • Matrice di stringhe contenente il valore di utilizzo. È ad esempio possibile specificare il valore truststore.usage.type.sign. Per importare le credenziali di un'estensione di Reader, specificare truststore.usage.type.lcre.

Consulta anche

Importazione delle credenziali tramite l'API di Gestione trust

Quick Start (modalità SOAP): importazione delle credenziali tramite l’API Java

Inclusione dei file della libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Eliminazione delle credenziali tramite l’API di Gestione trust deleting-credentials-by-using-the-trust-manager-api

È possibile eliminare le credenziali a livello di programmazione utilizzando l'API di Gestione fonti attendibili. Quando si elimina una credenziale, si specifica un alias corrispondente alla credenziale. Una volta eliminate, non è possibile utilizzare le credenziali per eseguire un'operazione.

NOTE
Non è possibile eliminare una credenziale in AEM Forms utilizzando i servizi Web.

Riepilogo dei passaggi summary_of_steps-1

Per eliminare una credenziale, effettuare le seguenti operazioni:

  1. Includi file di progetto.
  2. Creare un client del servizio delle credenziali.
  3. Eseguire l'operazione di eliminazione.

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-truststore-client.jar
  • adobe-utilities.jar (richiesto se AEM Forms è implementato su JBoss)
  • jbossall-client.jar (obbligatorio se AEM Forms è distribuito su JBoss)

Per informazioni sul percorso di questi file JAR, vedi Inclusi i file della libreria Java di AEM Forms.

Creare un client del servizio credenziali

Prima di eliminare programmaticamente una credenziale, creare un client del servizio di integrazione dati. Quando si crea un client di servizio, vengono definite le impostazioni di connessione necessarie per richiamare un servizio. Per informazioni, vedere Impostazione delle proprietà di connessione.

Operazione di eliminazione

Per eliminare una credenziale, specificare l'alias corrispondente alla credenziale. Se si specifica un alias che non esiste, viene generata un'eccezione.

Consulta anche

Importare le credenziali tramite API Java

Inclusione dei file della libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Importare le credenziali tramite API Java

Eliminazione delle credenziali tramite API Java deleting-credentials-using-the-java-api

Eliminare una credenziale da AEM Forms utilizzando l’API di gestione del trust (Java):

  1. Includi file di progetto

    Includi i file JAR dei client, ad esempio adobe-truststore-client.jar, nel percorso di classe del progetto Java.

  2. Creare un client del servizio delle credenziali

    • Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
    • Creare un oggetto CredentialServiceClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.
  3. Eseguire l'operazione di eliminazione

    Richiama il metodo deleteCredential dell'oggetto CredentialServiceClient e passa un valore stringa che specifica il valore alias.

Consulta anche

Eliminazione delle credenziali tramite l’API di Gestione trust

Quick Start (modalità SOAP): eliminazione delle credenziali tramite l’API Java

Inclusione dei file della libreria Java di AEM Forms

Impostazione delle proprietà di connessione

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2