Utilizzo delle credenziali

Informazioni sul servizio credenziali

Una credenziale contiene le informazioni di chiave privata necessarie per firmare o identificare i documenti. Un certificato è un'informazione di chiave pubblica configurata 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. È possibile effettuare le seguenti operazioni:

NOTA

È inoltre possibile importare ed eliminare i certificati utilizzando la console di amministrazione. (Vedere guida di amministrazione.)

Importazione di credenziali tramite l'API di Trust Manager

È possibile importare una credenziale in AEM Forms a livello di programmazione utilizzando l'API di Trust Manager. Ad esempio, è possibile importare una credenziale utilizzata per firmare un documento PDF. (Vedere Firma digitale di documenti PDF).

Quando importate una credenziale, specificate un alias per la credenziale. L'alias viene utilizzato per eseguire un'operazione Forms che richiede una credenziale. Una volta importata, una credenziale può essere visualizzata nella console di amministrazione, come illustrato nella figura seguente. Tenere presente che l'alias della credenziale è Secure.

ww_ww_truststore

NOTA

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

Riepilogo dei passaggi

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

  1. Includere i file di progetto.
  2. Creare un client del servizio delle credenziali.
  3. Fare riferimento alla credenziale.
  4. Eseguire l’operazione di importazione.

Includi file di progetto

Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi 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 è distribuito su JBoss)
  • jbossall-client.jar (richiesto se AEM Forms è distribuito su JBoss)

Per informazioni sulla posizione di questi file JAR, vedere Inclusione file libreria Java AEM Forms.

Creare un client di servizio credenziali

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

Riferimento alla credenziale

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

Eseguire l'operazione di importazione

Dopo aver fatto riferimento alla credenziale, importate la credenziale in AEM Forms. Se la credenziale non viene importata correttamente, viene generata un'eccezione. Quando importate una credenziale, specificate un alias per la credenziale.

Consulta anche

Importare le credenziali tramite l'API Java

Inclusione file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Avvio rapido API Servizio credenziali

Eliminazione delle credenziali tramite l'API di Trust Manager

Importare le credenziali tramite l'API Java

Importare una credenziale in AEM Forms utilizzando l'API Trust Manager (Java):

  1. Includi file di progetto

    Includete file JAR client, ad esempio adobe-trust-store-client.jar, nel percorso di classe del progetto Java.

  2. Creare un client di servizio credenziali

    • Creare un oggetto ServiceClientFactory che contiene le proprietà di connessione.
    • Creare un oggetto CredentialServiceClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.
  3. Riferimento alla credenziale

    • Creare un oggetto java.io.FileInputStream utilizzando il relativo costruttore. Passa un valore di stringa che specifica la posizione della credenziale.
    • Creare un oggetto com.adobe.idp.Document che memorizza le credenziali utilizzando il costruttore com.adobe.idp.Document. Passare l'oggetto java.io.FileInputStream che contiene la credenziale 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.

    • Richiamare il metodo CredentialServiceClient dell'oggetto importCredential e trasmettere i seguenti valori:

      • Un valore di stringa che specifica il valore alias per la credenziale.
      • L'istanza com.adobe.idp.Document che memorizza la credenziale.
      • Valore stringa che specifica la password associata alla credenziale.
      • La matrice stringa che contiene il valore di utilizzo. Ad esempio, è possibile specificare questo valore truststore.usage.type.sign. Per importare una credenziale di estensione Reader, specificate truststore.usage.type.lcre.

Consulta anche

Importazione di credenziali tramite l'API di Trust Manager

Avvio rapido (modalità SOAP): Importazione di credenziali tramite l'API Java

Inclusione file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Eliminazione delle credenziali tramite l'API di Trust Manager

È possibile eliminare una credenziale a livello di programmazione utilizzando l'API di Trust Manager. Quando eliminate una credenziale, specificate un alias corrispondente alla credenziale. Una volta eliminata, non è possibile utilizzare una credenziale per eseguire un'operazione.

NOTA

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

Riepilogo dei passaggi

Per eliminare una credenziale, effettuare le seguenti operazioni:

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

Includi file di progetto

Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete 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 è distribuito su JBoss)
  • jbossall-client.jar (richiesto se AEM Forms è distribuito su JBoss)

Per informazioni sulla posizione di questi file JAR, vedere Inclusione file libreria Java AEM Forms.

Creare un client di servizio credenziali

Prima di eliminare una credenziale a livello di programmazione, creare un client di servizi di integrazione dati. Quando create un client di servizi, definite le impostazioni di connessione necessarie per richiamare un servizio. Per informazioni, vedere Impostazione delle proprietà di connessione.

Eseguire l'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 l'API Java

Inclusione file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Importare le credenziali tramite l'API Java

Eliminazione delle credenziali tramite l'API Java

Eliminate una credenziale da AEM Forms utilizzando l'API Trust Manager (Java):

  1. Includi file di progetto

    Includete file JAR client, ad esempio adobe-trust-store-client.jar, nel percorso di classe del progetto Java.

  2. Creare un client di servizio credenziali

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

    Richiamare il metodo CredentialServiceClient dell'oggetto deleteCredential e passare un valore di stringa che specifica il valore alias.

Consulta anche

Eliminazione delle credenziali tramite l'API di Trust Manager

Avvio rapido (modalità SOAP): Eliminazione delle credenziali tramite l'API Java

Inclusione file libreria Java AEM Forms

Impostazione delle proprietà di connessione

In questa pagina