Gli esempi e gli esempi contenuti in questo documento sono solo per l’ambiente AEM Forms su 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à:
È inoltre possibile importare ed eliminare certificati utilizzando la console di amministrazione. (vedere assistenza per l’amministrazione.)
È 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. (vedere Firma digitale dei documenti di 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 importata, è possibile visualizzare una credenziale nella console di amministrazione, come illustrato nella figura seguente. L'alias della credenziale è Protetto.
Non è possibile importare credenziali in AEM Forms utilizzando i servizi Web.
Per importare una credenziale in AEM Forms, effettuare 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, accertati 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 della libreria Java di AEM Forms.
Creare un client del servizio delle credenziali
Prima di importare a livello di programmazione una credenziale in AEM Forms, creare un client del servizio delle credenziali. Per informazioni, consulta 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 che si trova nel file system.
Eseguire l'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
Importa una credenziale in AEM Forms utilizzando l’API di Trust Manager (Java):
Includi file di progetto
Includi i file JAR dei client, ad esempio adobe-truststore-client.jar, nel percorso di classe del progetto Java.
Creare un client del servizio delle credenziali
ServiceClientFactory
oggetto che contiene proprietà di connessione.CredentialServiceClient
mediante il costruttore e passando il ServiceClientFactory
oggetto.Fai riferimento alle credenziali
java.io.FileInputStream
mediante il costruttore. Passa un valore stringa che specifica la posizione delle credenziali.com.adobe.idp.Document
oggetto che memorizza le credenziali utilizzando com.adobe.idp.Document
costruttore. Passa il java.io.FileInputStream
oggetto che contiene le credenziali del costruttore.Eseguire l'operazione di importazione
Creare una matrice di stringhe contenente un elemento. Assegna il valore truststore.usage.type.sign
all'elemento.
Richiama CredentialServiceClient
dell'oggetto importCredential
e trasmettere i seguenti valori:
com.adobe.idp.Document
istanza che memorizza le credenziali.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
È 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.
Non è possibile eliminare una credenziale in AEM Forms utilizzando i servizi Web.
Per eliminare una credenziale, effettuare 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 della libreria Java di AEM Forms.
Creare un client del servizio delle 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, consulta 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 API Java
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Importare le credenziali tramite API Java
Eliminare una credenziale da AEM Forms utilizzando l’API di gestione del trust (Java):
Includi file di progetto
Includi i file JAR dei client, ad esempio adobe-truststore-client.jar, nel percorso di classe del progetto Java.
Creare un client del servizio delle credenziali
ServiceClientFactory
oggetto che contiene proprietà di connessione.CredentialServiceClient
mediante il costruttore e passando il ServiceClientFactory
oggetto.Eseguire l'operazione di eliminazione
Richiama CredentialServiceClient
dell'oggetto deleteCredential
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