Show Menu
ARGOMENTI×

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:
  • Le estensioni Acrobat Reader DC utilizzano una credenziale per abilitare i diritti di utilizzo di Adobe Reader nei documenti PDF. Consultate Applicazione dei diritti di utilizzo ai documenti PDF.
  • Il servizio Signature accede a certificati e credenziali mentre esegue operazioni quali la firma digitale di documenti PDF. (Vedere Firma digitale di documenti PDF.)
È possibile interagire in modo programmatico con il servizio Credential utilizzando l'API Java di Trust Manager. È possibile effettuare le seguenti operazioni:
È 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. L'alias della credenziale è Protetto .
Non è possibile importare una credenziale in AEM Forms utilizzando i servizi Web.

Riepilogo dei passaggi

Per importare una credenziale in AEM Forms, effettua 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, consultate Inclusione di file libreria Java AEM Forms.
Creare un client di servizio credenziali
Prima di importare una credenziale in AEM Forms a livello di programmazione, crea un client di servizi di credenziale. Per ulteriori 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, importa 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

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 ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un CredentialServiceClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Riferimento alla credenziale
    • Creare un java.io.FileInputStream oggetto utilizzando il relativo costruttore. Passa un valore di stringa che specifica la posizione della credenziale.
    • Creare un com.adobe.idp.Document oggetto che memorizza le credenziali utilizzando il com.adobe.idp.Document costruttore. Trasmettere 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.
    • Richiama il metodo dell’ CredentialServiceClient oggetto importCredential e passa i seguenti valori:
      • Un valore di stringa che specifica il valore alias per la credenziale.
      • L' com.adobe.idp.Document istanza che memorizza la credenziale.
      • Valore stringa che specifica la password associata alla credenziale.
      • La matrice stringa che contiene il valore di utilizzo. Ad esempio, potete specificare questo valore truststore.usage.type.sign . Per importare una credenziale di Reader Extension, specificate truststore.usage.type.lcre .
Consulta anche

Eliminazione delle credenziali tramite l'API Trust Manager

È possibile eliminare una credenziale a livello di programmazione utilizzando l'API Trust Manager. Quando eliminate una credenziale, specificate un alias corrispondente alla credenziale. Una volta eliminata, non è possibile utilizzare una credenziale per eseguire un'operazione.
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, consultate Inclusione di 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 ulteriori 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

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 ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un CredentialServiceClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Eseguire l'operazione di eliminazione
    Richiama il metodo dell' CredentialServiceClient oggetto deleteCredential e passa un valore di stringa che specifica il valore alias.
Consulta anche