Esempi ed esempi in questo documento sono solo per AEM Forms in ambiente JEE.
Informazioni sul servizio credenziali
Una credenziale contiene le informazioni di chiave privata necessarie per firmare o identificare i documenti. Un certificato è un'informazione a chiave pubblica configurata per l'attendibilità. AEM Forms utilizza certificati e credenziali per diversi scopi:
È possibile interagire in modo programmatico con il servizio Credenziali utilizzando l'API Java di Trust Manager. È possibile eseguire le seguenti attività:
È inoltre possibile importare ed eliminare i certificati utilizzando la console di amministrazione. (Vedi aiuto amministrativo.)
È 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. (Vedi Firma digitale di documenti PDF).
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 importate, le credenziali possono essere visualizzate nella console di amministrazione, come illustrato di seguito. L’alias della credenziale è Secure.
Non è possibile importare una credenziale in AEM Forms utilizzando i servizi Web.
Per importare una credenziale in AEM Forms, effettua le seguenti operazioni:
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, assicurati di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
Per informazioni sulla posizione di questi file JAR, vedi Inclusione dei file libreria Java di AEM Forms.
Creare un client di servizio delle credenziali
Prima di importare una credenziale in AEM Forms a livello di programmazione, crea un client di servizio delle credenziali. Per informazioni, consulta Impostazione delle proprietà di connessione.
Riferimento alla credenziale
Fai 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.
Esegui l’operazione di importazione
Dopo aver fatto riferimento alla credenziale, importala in AEM Forms. Se la credenziale non viene importata correttamente, viene generata un'eccezione. Quando si importa una credenziale, è necessario specificare un alias per la credenziale.
Consulta anche
Importare credenziali tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API del servizio credenziali
Eliminazione delle credenziali tramite l'API di Trust Manager
Importare una credenziale in AEM Forms utilizzando l’API di Trust Manager (Java):
Includi file di progetto
Includi file JAR client, come adobe-truststore-client.jar, nel percorso di classe del progetto Java.
Creare un client di servizio delle credenziali
ServiceClientFactory
oggetto contenente le proprietà di connessione.CredentialServiceClient
utilizzando il relativo costruttore e passando ServiceClientFactory
oggetto.Riferimento alla credenziale
java.io.FileInputStream
utilizzando il relativo costruttore. Passa un valore stringa che specifica la posizione della credenziale.com.adobe.idp.Document
oggetto che memorizza la credenziale utilizzando com.adobe.idp.Document
costruttore. Passa la java.io.FileInputStream
oggetto che contiene la credenziale del costruttore.Esegui l’operazione di importazione
Creare un array di stringhe contenente un elemento. Assegna il valore truststore.usage.type.sign
all’elemento .
Richiama il CredentialServiceClient
dell’oggetto importCredential
e passare i seguenti valori:
com.adobe.idp.Document
istanza che memorizza le credenziali.truststore.usage.type.sign
. Per importare una credenziale di estensione Reader, specifica truststore.usage.type.lcre
.Consulta anche
Importazione delle credenziali tramite l’API di Trust Manager
Avvio rapido (modalità SOAP): Importazione di credenziali tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
È possibile eliminare in modo programmatico una credenziale utilizzando l'API di Trust Manager. Quando si elimina una credenziale, è necessario specificare 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.
Per eliminare una credenziale, effettua le seguenti operazioni:
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:
Per informazioni sulla posizione di questi file JAR, vedi Inclusione dei file libreria Java di AEM Forms.
Creare un client di servizio delle credenziali
Prima di poter eliminare in modo programmatico una credenziale, crea un client del servizio di integrazione dei dati . Quando crei un client di servizio, definisci le impostazioni di connessione necessarie per richiamare un servizio. Per informazioni, consulta Impostazione delle proprietà di connessione.
Esegui l’operazione di eliminazione
Per eliminare una credenziale, specifica l’alias corrispondente alla credenziale. Se si specifica un alias che non esiste, viene generata un'eccezione.
Consulta anche
Importare credenziali tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Importare credenziali tramite l’API Java
Eliminare una credenziale da AEM Forms utilizzando l’API di Trust Manager (Java):
Includi file di progetto
Includi file JAR client, come adobe-truststore-client.jar, nel percorso di classe del progetto Java.
Creare un client di servizio delle credenziali
ServiceClientFactory
oggetto contenente le proprietà di connessione.CredentialServiceClient
utilizzando il relativo costruttore e passando ServiceClientFactory
oggetto.Esegui l’operazione di eliminazione
Richiama il CredentialServiceClient
dell’oggetto deleteCredential
e passare un valore di stringa che specifica il valore di alias.
Consulta anche
Eliminazione delle credenziali tramite l'API di Trust Manager
Avvio rapido (modalità SOAP): Eliminazione delle credenziali tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione