Informazioni sul servizio di crittografia
Il servizio di cifratura consente di cifrare e decrittografare i documenti. Quando un documento viene crittografato, il suo contenuto diventa illeggibile. Un utente autorizzato può decrittografare il documento per ottenere l'accesso ai contenuti. Se un documento PDF è crittografato con una password, è necessario specificare la password aperta prima di poter visualizzare il documento in Adobe Reader o Adobe Acrobat. Analogamente, se un documento PDF è crittografato con un certificato, l’utente deve decrittografare il documento PDF con la chiave pubblica corrispondente al certificato (chiave privata) utilizzato per cifrare il documento PDF.
Puoi eseguire queste attività utilizzando il servizio di cifratura:
Crittografare un documento PDF con una password. (Vedere Cifratura di documenti PDF con una password.)
Cifrare un documento PDF con un certificato. (Vedere Cifratura di documenti PDF con certificati.)
Rimuovere la crittografia basata su password da un documento PDF. (Vedere Rimozione della crittografia della password.)
Rimuovere la cifratura basata su certificato da un documento PDF. (Vedere Rimozione della crittografia basata su certificato.)
Sblocca il documento PDF in modo da poter eseguire altre operazioni di servizio. Ad esempio, dopo lo sblocco di un documento PDF crittografato con password, è possibile apporvi una firma digitale. (Consultare Sblocco di documenti PDF crittografati.)
Determinare il tipo di crittografia di un documento PDF protetto. (Consultare Determinazione del tipo di cifratura.)
Per ulteriori informazioni sul servizio di cifratura, consulta Guida di riferimento dei servizi per AEM Forms.
Quando si crittografa un documento PDF con una password, l’utente deve specificare la password per aprire il documento PDF in Adobe Reader o Acrobat. Inoltre, prima di poter eseguire un’altra operazione AEM Forms, ad esempio la firma digitale del documento PDF, è necessario sbloccare un documento PDF crittografato con password.
Se carichi un documento PDF crittografato nell’archivio AEM Forms, non sarà possibile decrittografare il documento PDF ed estrarre il contenuto XDP. È consigliabile non crittografare un documento prima di caricarlo nell’archivio AEM Forms. (Vedere Risorse di scrittura.)
Per ulteriori informazioni sul servizio di cifratura, consulta Guida di riferimento dei servizi per AEM Forms.
Per crittografare un documento PDF con una password, eseguire le operazioni seguenti:
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 della classe del progetto:
Creare un oggetto API client di crittografia
Per eseguire un'operazione del servizio di cifratura a livello di programmazione, è necessario creare un client del servizio di cifratura.
Ottenere un documento PDF da crittografare
Per crittografare il documento con una password, è necessario ottenere un documento PDF non crittografato. Se si tenta di proteggere un documento PDF già crittografato, viene generata un'eccezione.
Impostare le opzioni di esecuzione della crittografia
Per crittografare un documento PDF con una password, è necessario specificare quattro valori, inclusi due valori password. Il primo valore password viene utilizzato per cifrare il documento PDF e deve essere specificato all’apertura del documento PDF. Il secondo valore della password, denominato valore della password master, viene utilizzato per rimuovere la crittografia dal documento PDF. I valori delle password sono sensibili all'uso di maiuscole e minuscole e questi due valori non possono essere gli stessi.
È necessario specificare le risorse del documento PDF da crittografare. È possibile crittografare l’intero documento PDF, tutti gli elementi eccetto i metadati del documento o solo gli allegati del documento. Se si crittografano solo gli allegati del documento, all'utente viene richiesta una password quando tenta di accedere agli allegati del file.
Durante la cifratura di un documento PDF, è possibile specificare le autorizzazioni associate al documento protetto. Specificando le autorizzazioni, è possibile controllare le azioni che un utente che apre un documento PDF crittografato con password può eseguire. Ad esempio, per estrarre correttamente i dati del modulo, è necessario impostare le seguenti autorizzazioni:
Le autorizzazioni sono specificate come valori di enumerazione PasswordEncryptionPermission
.
Aggiungi la password
Dopo aver recuperato un documento PDF non protetto e impostato i valori di esecuzione della crittografia, è possibile aggiungere una password al documento PDF.
Salvare il documento PDF crittografato come file PDF
È possibile salvare il documento PDF crittografato con password come file PDF.
Consulta anche
Crittografare un documento PDF utilizzando l’API Java
Crittografia di un documento PDF tramite l’API del servizio Web
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API del servizio di crittografia
Cifratura di documenti PDF con certificati
Crittografare un documento PDF con una password utilizzando l’API di cifratura (Java):
Includi file di progetto.
Includi file JAR client, come adobe-encryption-client.jar, nel percorso di classe del progetto Java.
Creare un’API client di crittografia.
ServiceClientFactory
contenente le proprietà di connessione.EncryptionServiceClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Ottenere un documento PDF da crittografare.
java.io.FileInputStream
che rappresenta il documento PDF da crittografare utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento PDF.com.adobe.idp.Document
utilizzando il relativo costruttore e passando l'oggetto java.io.FileInputStream
.Impostare le opzioni di esecuzione della crittografia.
PasswordEncryptionOptionSpec
richiamando il relativo costruttore.setEncryptOption
dell'oggetto PasswordEncryptionOptionSpec
e passando un valore di enumerazione PasswordEncryptionOption
che specifica le risorse del documento da crittografare. Ad esempio, per cifrare l’intero documento PDF, inclusi i relativi metadati e i relativi allegati, specificare PasswordEncryptionOption.ALL
.java.util.List
che memorizza le autorizzazioni di crittografia utilizzando il costruttore ArrayList
.java.util.List
dell'oggetto add
e passando un valore di enumerazione corrispondente all'autorizzazione che si desidera impostare. Ad esempio, per impostare l’autorizzazione che consente all’utente di copiare i dati presenti nel documento PDF, specificare PasswordEncryptionPermission.PASSWORD_EDIT_COPY
. (Ripeti questo passaggio per ogni autorizzazione da impostare).setCompatability
dell’oggetto PasswordEncryptionOptionSpec
e passando un valore di enumerazione che specifica il livello di compatibilità Acrobat. Ad esempio, puoi specificare PasswordEncryptionCompatability.ACRO_7
.setDocumentOpenPassword
dell'oggetto PasswordEncryptionOptionSpec
e passando un valore di stringa che rappresenta la password aperta.setPermissionPassword
dell'oggetto PasswordEncryptionOptionSpec
e passando un valore di stringa che rappresenta la password master.Aggiungi la password.
Crittografare il documento PDF richiamando il metodo encryptPDFUsingPassword
dell’oggetto EncryptionServiceClient
e passando i seguenti valori:
com.adobe.idp.Document
che contiene il documento PDF da crittografare con la password.PasswordEncryptionOptionSpec
contenente le opzioni di esecuzione della crittografia.Il metodo encryptPDFUsingPassword
restituisce un oggetto com.adobe.idp.Document
contenente un documento PDF crittografato con password.
Salvare il documento PDF crittografato come file PDF.
java.io.File
e assicurati che l'estensione del file sia .pdf.copyToFile
dell'oggetto com.adobe.idp.Document
per copiare nel file il contenuto dell'oggetto com.adobe.idp.Document
. Assicurarsi di utilizzare l'oggetto com.adobe.idp.Document
restituito dal metodo encryptPDFUsingPassword
.Consulta anche
Avvio rapido (modalità SOAP): Crittografia di un documento PDF tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Crittografare un documento PDF con una password utilizzando l’API di cifratura (servizio Web):
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1
.
Sostituisci localhost
con l'indirizzo IP del server che ospita AEM Forms.
Creare un oggetto API client di crittografia.
Creare un oggetto EncryptionServiceClient
utilizzando il relativo costruttore predefinito.
Creare un oggetto EncryptionServiceClient.Endpoint.Address
utilizzando il costruttore System.ServiceModel.EndpointAddress
. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/EncryptionService?WSDL
). Non è necessario utilizzare l'attributo lc_version
. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
Crea un oggetto System.ServiceModel.BasicHttpBinding
ottenendo il valore del campo EncryptionServiceClient.Endpoint.Binding
. Imposta il valore restituito su BasicHttpBinding
.
Impostare il campo MessageEncoding
dell'oggetto System.ServiceModel.BasicHttpBinding
su WSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM.
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
EncryptionServiceClient.ClientCredentials.UserName.UserName
.EncryptionServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Ottenere un documento PDF da crittografare.
BLOB
utilizzando il relativo costruttore. L'oggetto BLOB
viene utilizzato per memorizzare un documento PDF crittografato con una password.System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF da cifrare e la modalità di apertura del file.System.IO.FileStream
. È possibile determinare le dimensioni dell'array di byte ottenendo la proprietà Length
dell'oggetto System.IO.FileStream
.Read
dell’oggetto System.IO.FileStream
e passando l’array di byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
assegnando il contenuto dell'array di byte al membro dati BLOB
dell'oggetto MTOM
.Impostare le opzioni di esecuzione della crittografia.
PasswordEncryptionOptionSpec
utilizzando il relativo costruttore.PasswordEncryptionOption
al membro dati PasswordEncryptionOptionSpec
dell'oggetto encryptOption
. Per cifrare l’intero PDF, inclusi i relativi metadati e i relativi allegati, assegna PasswordEncryptionOption.ALL
a questo membro dati.PasswordEncryptionCompatability
al membro dati PasswordEncryptionOptionSpec
dell’oggetto compatability
. Ad esempio, assegna PasswordEncryptionCompatability.ACRO_7
a questo membro dati.documentOpenPassword
dell'oggetto PasswordEncryptionOptionSpec
.permissionPassword
dell'oggetto PasswordEncryptionOptionSpec
.Aggiungi la password.
Crittografare il documento PDF richiamando il metodo encryptPDFUsingPassword
dell’oggetto EncryptionServiceClient
e passando i seguenti valori:
BLOB
che contiene il documento PDF da crittografare con la password.PasswordEncryptionOptionSpec
contenente le opzioni di esecuzione della crittografia.Il metodo encryptPDFUsingPassword
restituisce un oggetto BLOB
contenente un documento PDF crittografato con password.
Salvare il documento PDF crittografato come file PDF.
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF protetto.BLOB
restituito dal metodo encryptPDFUsingPassword
. Compilare l'array di byte ottenendo il valore del membro dati BLOB
dell'oggetto MTOM
.System.IO.BinaryWriter
richiamandone il costruttore e passando l'oggetto System.IO.FileStream
.Write
dell’oggetto System.IO.BinaryWriter
e passando l’array di byte.Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
La crittografia basata su certificato consente di crittografare un documento per destinatari specifici tramite la tecnologia a chiave pubblica. A diversi destinatari possono essere assegnate autorizzazioni diverse per il documento. Molti aspetti della crittografia sono resi possibili dalla tecnologia a chiave pubblica. Un algoritmo viene utilizzato per generare due numeri grandi, noti come chiavi, con le seguenti proprietà:
Una delle chiavi funge da chiave privata dell’utente. È importante che solo l’utente abbia accesso a questa chiave. L’altra chiave è la chiave pubblica dell’utente, che può essere condivisa con altri utenti.
Un certificato a chiave pubblica contiene la chiave pubblica di un utente e le informazioni di identificazione. Il formato X.509 viene utilizzato per memorizzare i certificati. I certificati sono generalmente rilasciati e firmati digitalmente da un’autorità di certificazione (CA), un’entità riconosciuta che fornisce una misura di affidabilità nella validità del certificato. I certificati hanno una data di scadenza, dopo la quale non sono più validi. Inoltre, gli elenchi di revoche di certificati (CRL) forniscono informazioni sui certificati revocati prima della data di scadenza. I LCR sono pubblicati periodicamente dalle autorità di certificazione. Lo stato di revoca di un certificato può essere recuperato anche tramite il protocollo OCSP (Online Certificate Status Protocol) in rete.
Se carichi un documento PDF crittografato nell’archivio AEM Forms, non sarà possibile decrittografare il documento PDF ed estrarre il contenuto XDP. È consigliabile non crittografare un documento prima di caricarlo nell’archivio AEM Forms. (Vedere Risorse di scrittura.)
Prima di poter crittografare un documento PDF con un certificato, è necessario assicurarsi di aggiungere il certificato ad AEM Forms. Un certificato viene aggiunto tramite la console di amministrazione o a livello di programmazione utilizzando l’API di Trust Manager. (Vedere Importazione delle credenziali tramite l'API di Trust Manager.)
Per ulteriori informazioni sul servizio di cifratura, consulta Guida di riferimento dei servizi per AEM Forms.
Per crittografare un documento PDF con un certificato, eseguire le operazioni seguenti:
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 della classe del progetto:
Creare un oggetto API client di crittografia
Per eseguire un'operazione del servizio di cifratura a livello di programmazione, è necessario creare un client del servizio di cifratura. Se utilizzi l’API Java Encryption Service, crea un oggetto EncrytionServiceClient
. Se utilizzi l’API del servizio Web Encryption Service, crea un oggetto EncryptionServiceService
.
Ottenere un documento PDF da crittografare
Per eseguire la cifratura è necessario ottenere un documento PDF non crittografato. Se si tenta di proteggere un documento PDF già crittografato, viene generata un'eccezione.
Riferimento al certificato
Per cifrare un documento PDF con un certificato, fare riferimento a un certificato utilizzato per cifrare un documento PDF. Il certificato è un file .cer, un file .crt o un file .pem. Un file PKCS#12 viene utilizzato per memorizzare le chiavi private con i certificati corrispondenti.
Durante la cifratura di un documento PDF con un certificato, specificare le autorizzazioni associate al documento protetto. Specificando le autorizzazioni, è possibile controllare le azioni che possono essere eseguite da un utente che apre un documento PDF crittografato con certificato.
Impostare le opzioni di esecuzione della crittografia
Specificare le risorse del documento PDF da crittografare. È possibile crittografare l’intero documento PDF, tutti gli elementi eccetto i metadati del documento o solo gli allegati del documento.
Creare un documento PDF crittografato con certificato
Dopo aver recuperato un documento PDF non protetto, fatto riferimento al certificato e impostato le opzioni di esecuzione, è possibile creare un documento PDF crittografato con certificato. Una volta crittografato il documento PDF, è necessario disporre della chiave pubblica corrispondente per decrittografarlo.
Salvare il documento PDF crittografato come file PDF
È possibile salvare il documento PDF crittografato come file PDF.
Consulta anche
Crittografare un documento PDF con un certificato utilizzando l’API Java
Crittografare un documento PDF con un certificato utilizzando l’API del servizio Web
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API del servizio di crittografia
Cifratura di documenti PDF con password
Crittografare un documento PDF con un certificato utilizzando l’API di cifratura (Java):
Includi file di progetto.
Includi file JAR client, come adobe-encryption-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto API client di crittografia.
ServiceClientFactory
contenente le proprietà di connessione.EncryptionServiceClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Ottenere un documento PDF da crittografare.
java.io.FileInputStream
che rappresenta il documento PDF da crittografare utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento PDF.com.adobe.idp.Document
utilizzando il relativo costruttore e passando l'oggetto java.io.FileInputStream
.Fai riferimento al certificato.
java.util.List
che memorizza le informazioni sulle autorizzazioni utilizzando il relativo costruttore.add
dell'oggetto java.util.List
e passando un valore di enumerazione CertificateEncryptionPermissions
che rappresenta le autorizzazioni concesse all'utente che apre il documento PDF protetto. Ad esempio, per specificare tutte le autorizzazioni, passare CertificateEncryptionPermissions.PKI_ALL_PERM
.Recipient
utilizzando il relativo costruttore.java.io.FileInputStream
che rappresenta il certificato utilizzato per cifrare il documento PDF utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del certificato.com.adobe.idp.Document
utilizzando il relativo costruttore e passando l'oggetto java.io.FileInputStream
che rappresenta il certificato.setX509Cert
dell'oggetto Recipient
e passa l'oggetto com.adobe.idp.Document
che contiene il certificato. (Inoltre, l'oggetto Recipient
può avere un alias di certificato Truststore o un URL LDAP come origine del certificato.)CertificateEncryptionIdentity
che memorizza le informazioni sulle autorizzazioni e sui certificati utilizzando il relativo costruttore.setPerms
dell'oggetto CertificateEncryptionIdentity
e passare l'oggetto java.util.List
che memorizza le informazioni sulle autorizzazioni.setRecipient
dell'oggetto CertificateEncryptionIdentity
e passare l'oggetto Recipient
che memorizza le informazioni sul certificato.java.util.List
che memorizza le informazioni sul certificato utilizzando il relativo costruttore.java.util.List
e passare l'oggetto CertificateEncryptionIdentity
. (Questo oggetto java.util.List
viene passato come parametro al metodo encryptPDFUsingCertificates
.)Impostare le opzioni di esecuzione della crittografia.
CertificateEncryptionOptionSpec
richiamando il relativo costruttore.setOption
dell'oggetto CertificateEncryptionOptionSpec
e passando un valore di enumerazione CertificateEncryptionOption
che specifica le risorse del documento da crittografare. Ad esempio, per cifrare l’intero documento PDF, inclusi i relativi metadati e i relativi allegati, specificare CertificateEncryptionOption.ALL
.setCompat
dell’oggetto CertificateEncryptionOptionSpec
e passando un valore di enumerazione CertificateEncryptionCompatibility
che specifica il livello di compatibilità Acrobat. Ad esempio, puoi specificare CertificateEncryptionCompatibility.ACRO_7
.Creare un documento PDF crittografato con certificato.
Crittografare il documento PDF con un certificato richiamando il metodo encryptPDFUsingCertificates
dell’oggetto EncryptionServiceClient
e passando i seguenti valori:
com.adobe.idp.Document
che contiene il documento PDF da cifrare.java.util.List
che memorizza le informazioni sul certificato.CertificateEncryptionOptionSpec
contenente le opzioni di esecuzione della crittografia.Il metodo encryptPDFUsingCertificates
restituisce un oggetto com.adobe.idp.Document
contenente un documento PDF crittografato con certificato.
Salvare il documento PDF crittografato come file PDF.
java.io.File
e assicurati che l'estensione del nome file sia .pdf.copyToFile
dell'oggetto com.adobe.idp.Document
per copiare nel file il contenuto dell'oggetto com.adobe.idp.Document
. Assicurarsi di utilizzare l'oggetto com.adobe.idp.Document
restituito dal metodo encryptPDFUsingCertificates
.Consulta anche
Avvio rapido (modalità SOAP): Crittografia di un documento PDF con un certificato tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Crittografare un documento PDF con un certificato utilizzando l’API di cifratura (servizio Web):
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1
.
Sostituisci localhost
con l'indirizzo IP del server che ospita AEM Forms.
Creare un oggetto API client di crittografia.
Creare un oggetto EncryptionServiceClient
utilizzando il relativo costruttore predefinito.
Creare un oggetto EncryptionServiceClient.Endpoint.Address
utilizzando il costruttore System.ServiceModel.EndpointAddress
. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/EncryptionService?WSDL
). Non è necessario utilizzare l'attributo lc_version
. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
Crea un oggetto System.ServiceModel.BasicHttpBinding
ottenendo il valore del campo EncryptionServiceClient.Endpoint.Binding
. Imposta il valore restituito su BasicHttpBinding
.
Impostare il campo MessageEncoding
dell'oggetto System.ServiceModel.BasicHttpBinding
su WSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM.
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
EncryptionServiceClient.ClientCredentials.UserName.UserName
.EncryptionServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Ottenere un documento PDF da crittografare.
BLOB
utilizzando il relativo costruttore. L'oggetto BLOB
viene utilizzato per memorizzare un documento PDF crittografato con un certificato.System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF da cifrare e la modalità di apertura del file.System.IO.FileStream
. È possibile determinare le dimensioni dell'array di byte ottenendo la proprietà Length
dell'oggetto System.IO.FileStream
.Read
dell’oggetto System.IO.FileStream
e passando l’array di byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
assegnando la relativa proprietà MTOM
con il contenuto dell'array di byte.Fai riferimento al certificato.
Recipient
utilizzando il relativo costruttore. Questo oggetto memorizzerà le informazioni sul certificato.BLOB
utilizzando il relativo costruttore. Questo oggetto BLOB
memorizzerà il certificato che crittografa il documento PDF.System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del certificato e la modalità di apertura del file.System.IO.FileStream
. È possibile determinare le dimensioni dell'array di byte ottenendo la proprietà Length
dell'oggetto System.IO.FileStream
.Read
dell’oggetto System.IO.FileStream
e passando l’array di byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
assegnando il contenuto dell'array di byte al membro dati BLOB
dell'oggetto MTOM
.BLOB
che memorizza il certificato al membro dati Recipient
dell'oggetto x509Cert
.CertificateEncryptionIdentity
che memorizza le informazioni sul certificato utilizzando il relativo costruttore.Recipient
che memorizza il certificato al membro dati del destinatario dell'oggetto CertificateEncryptionIdentity
.Object
e assegnare l'oggetto CertificateEncryptionIdentity
al primo elemento dell'array Object
. Questa matrice Object
viene passata come parametro al metodo encryptPDFUsingCertificates
.Impostare le opzioni di esecuzione della crittografia.
CertificateEncryptionOptionSpec
utilizzando il relativo costruttore.CertificateEncryptionOption
al membro dati CertificateEncryptionOptionSpec
dell'oggetto option
. Per crittografare l’intero documento PDF, inclusi i relativi metadati e i relativi allegati, assegnare CertificateEncryptionOption.ALL
al membro dati.CertificateEncryptionCompatibility
al membro dati CertificateEncryptionOptionSpec
dell’oggetto compat
. Ad esempio, assegna CertificateEncryptionCompatibility.ACRO_7
a questo membro dati.Creare un documento PDF crittografato con certificato.
Crittografare il documento PDF con un certificato richiamando il metodo encryptPDFUsingCertificates
dell’oggetto EncryptionServiceService
e passando i seguenti valori:
BLOB
che contiene il documento PDF da cifrare.Object
in cui sono memorizzate le informazioni sul certificato.CertificateEncryptionOptionSpec
contenente le opzioni di esecuzione della crittografia.Il metodo encryptPDFUsingCertificates
restituisce un oggetto BLOB
contenente un documento PDF crittografato con certificato.
Salvare il documento PDF crittografato come file PDF.
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF protetto.BLOB
restituito dal metodo encryptPDFUsingCertificates
. Compilare l'array di byte ottenendo il valore del membro dati BLOB
dell'oggetto binaryData
.System.IO.BinaryWriter
richiamandone il costruttore e passando l'oggetto System.IO.FileStream
.Write
dell’oggetto System.IO.BinaryWriter
e passando l’array di byte.Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
È possibile rimuovere la cifratura basata su certificato da un documento PDF per consentire agli utenti di aprire il documento PDF in Adobe Reader o Acrobat. Per rimuovere la crittografia da un documento PDF crittografato con un certificato, è necessario fare riferimento a una chiave pubblica. Dopo la rimozione della cifratura da un documento PDF, la cifratura non è più protetta.
Per ulteriori informazioni sul servizio di cifratura, consulta Guida di riferimento dei servizi per AEM Forms.
Per rimuovere la cifratura basata su certificato da un documento PDF, eseguire le operazioni seguenti:
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 della classe del progetto:
Creare un client del servizio di crittografia
Per eseguire un'operazione del servizio di cifratura a livello di programmazione, è necessario creare un client del servizio di cifratura. Se utilizzi l’API Java Encryption Service, crea un oggetto EncrytionServiceClient
. Se utilizzi l’API del servizio Web Encryption Service, crea un oggetto EncryptionServiceService
.
Ottenere il documento PDF crittografato
Per rimuovere la crittografia basata su certificato, è necessario ottenere un documento PDF crittografato. Se si tenta di rimuovere la crittografia da un documento PDF non crittografato, viene generata un'eccezione. Analogamente, se si tenta di rimuovere la crittografia basata su certificato da un documento crittografato con password, viene generata un'eccezione.
Rimuovi crittografia
Per rimuovere la cifratura basata su certificato da un documento PDF crittografato, è necessario disporre sia di un documento PDF crittografato sia della chiave privata corrispondente alla chiave utilizzata per cifrare il documento PDF. Il valore alias della chiave privata viene specificato durante la rimozione della crittografia basata su certificato da un documento PDF crittografato. Per informazioni sulla chiave pubblica, vedere Cifratura di documenti PDF con certificati.
Una chiave privata viene memorizzata nell'archivio attendibilità di AEM Forms. Quando un certificato è posizionato in tale posizione, viene specificato un valore di alias.
Salvare il documento PDF
Dopo la rimozione della cifratura basata su certificato da un documento PDF crittografato, è possibile salvare il documento PDF come file PDF. Gli utenti possono aprire il documento PDF in Adobe Reader o Acrobat.
Consulta anche
Rimuovere la crittografia basata su certificato utilizzando l’API Java
Rimuovere la crittografia basata su certificato utilizzando l’API del servizio Web
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API del servizio di crittografia
È possibile rimuovere la cifratura basata su certificato da un documento PDF utilizzando l’API di cifratura (Java):
Includi file di progetto.
Includi file JAR client, come adobe-encryption-client.jar, nel percorso di classe del progetto Java.
Crea un client del servizio di crittografia.
ServiceClientFactory
contenente le proprietà di connessione.EncryptionServiceClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Ottenere il documento PDF crittografato.
java.io.FileInputStream
che rappresenta il documento PDF crittografato utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento PDF crittografato.com.adobe.idp.Document
utilizzando il relativo costruttore e passando l'oggetto java.io.FileInputStream
.Rimuovi crittografia.
Rimuovere la crittografia basata su certificato dal documento PDF richiamando il metodo removePDFCertificateSecurity
dell’oggetto EncryptionServiceClient
e passando i seguenti valori:
com.adobe.idp.Document
che contiene il documento PDF crittografato.Il metodo removePDFCertificateSecurity
restituisce un oggetto com.adobe.idp.Document
contenente un documento PDF non protetto.
Salvare il documento PDF.
java.io.File
e assicurati che l'estensione del file sia .pdf.copyToFile
dell'oggetto com.adobe.idp.Document
per copiare nel file il contenuto dell'oggetto Document
. Assicurarsi di utilizzare l'oggetto com.adobe.idp.Document
restituito dal metodo removePDFCredentialSecurity
.Consulta anche
Avvio rapido (modalità SOAP): Rimozione della crittografia basata su certificato tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Rimuovi la crittografia basata su certificato utilizzando l’API di cifratura (servizio Web):
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1
.
Sostituisci localhost
con l'indirizzo IP del server che ospita AEM Forms.
Crea un client del servizio di crittografia.
Creare un oggetto EncryptionServiceClient
utilizzando il relativo costruttore predefinito.
Creare un oggetto EncryptionServiceClient.Endpoint.Address
utilizzando il costruttore System.ServiceModel.EndpointAddress
. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/EncryptionService?WSDL
). Non è necessario utilizzare l'attributo lc_version
. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
Crea un oggetto System.ServiceModel.BasicHttpBinding
ottenendo il valore del campo EncryptionServiceClient.Endpoint.Binding
. Imposta il valore restituito su BasicHttpBinding
.
Impostare il campo MessageEncoding
dell'oggetto System.ServiceModel.BasicHttpBinding
su WSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM.
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
EncryptionServiceClient.ClientCredentials.UserName.UserName
.EncryptionServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Ottenere il documento PDF crittografato.
BLOB
utilizzando il relativo costruttore. L'oggetto BLOB
viene utilizzato per memorizzare il documento PDF crittografato.System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF crittografato e la modalità di apertura del file.System.IO.FileStream
. È possibile determinare le dimensioni dell'array di byte ottenendo la proprietà Length
dell'oggetto System.IO.FileStream
.Read
dell’oggetto System.IO.FileStream
e passando l’array di byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
assegnando il contenuto dell'array di byte al membro dati BLOB
dell'oggetto MTOM
.Rimuovi crittografia.
Richiama il metodo removePDFCertificateSecurity
dell'oggetto EncryptionServiceClient
e passa i seguenti valori:
BLOB
che contiene i dati del flusso di file che rappresenta un documento PDF crittografato.Il metodo removePDFCredentialSecurity
restituisce un oggetto BLOB
contenente un documento PDF non protetto.
Salvare il documento PDF.
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF non protetto.BLOB
restituito dal metodo removePDFPasswordSecurity
. Compilare l'array di byte ottenendo il valore del membro dati BLOB
dell'oggetto MTOM
.System.IO.BinaryWriter
richiamandone il costruttore e passando l'oggetto System.IO.FileStream
.Write
dell’oggetto System.IO.BinaryWriter
e passando l’array di byte.Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
È possibile rimuovere la cifratura basata su password da un documento PDF per consentire agli utenti di aprire il documento PDF in Adobe Reader o Acrobat senza dover specificare una password. Dopo la rimozione della cifratura basata su password da un documento PDF, il documento non è più protetto.
Per ulteriori informazioni sul servizio di cifratura, consulta Guida di riferimento dei servizi per AEM Forms.
Per rimuovere la cifratura basata su password da un documento PDF, eseguire le operazioni seguenti:
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 della classe del progetto:
Creare un client del servizio di crittografia
Per eseguire un'operazione del servizio di cifratura a livello di programmazione, è necessario creare un client del servizio di cifratura. Se utilizzi l’API Java Encryption Service, crea un oggetto EncrytionServiceClient
. Se utilizzi l’API del servizio Web Encryption Service, crea un oggetto EncryptionServiceService
.
Ottenere il documento PDF crittografato
Per rimuovere la crittografia basata su password, è necessario ottenere un documento PDF crittografato. Se si tenta di rimuovere la crittografia da un documento PDF non crittografato, viene generata un'eccezione.
Rimuovere la password
Per rimuovere la cifratura basata su password da un documento PDF crittografato, è necessario disporre sia di un documento PDF crittografato sia di un valore password master utilizzato per rimuovere la cifratura dal documento PDF. La password utilizzata per aprire un documento PDF crittografato con password non può essere utilizzata per rimuovere la crittografia. Una password master viene specificata quando il documento PDF è crittografato con una password. (Vedere Cifratura di documenti PDF con una password.)
Salvare il documento PDF
Dopo la rimozione della cifratura basata su password da un documento PDF, è possibile salvare il documento PDF come file PDF. Gli utenti possono aprire il documento PDF in Adobe Reader o Acrobat senza specificare una password.
Consulta anche
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API del servizio di crittografia
Cifratura di documenti PDF con password
È possibile rimuovere la cifratura basata su password da un documento PDF utilizzando l’API di cifratura (Java):
Includi file di progetto.
Includi file JAR client, come adobe-encryption-client.jar, nel percorso di classe del progetto Java.
Crea un client del servizio di crittografia.
ServiceClientFactory
contenente le proprietà di connessione.EncryptionServiceClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Ottenere il documento PDF crittografato.
java.io.FileInputStream
che rappresenta il documento PDF crittografato utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento PDF.com.adobe.idp.Document
utilizzando il relativo costruttore e passando l'oggetto java.io.FileInputStream
.Rimuovi la password.
Rimuovere la crittografia basata su password dal documento PDF richiamando il metodo removePDFPasswordSecurity
dell'oggetto EncryptionServiceClient
e passando i seguenti valori:
com.adobe.idp.Document
contenente il documento PDF crittografato.Il metodo removePDFPasswordSecurity
restituisce un oggetto com.adobe.idp.Document
contenente un documento PDF non protetto.
Salvare il documento PDF.
java.io.File
e assicurati che l'estensione del nome file sia .pdf.copyToFile
dell'oggetto com.adobe.idp.Document
per copiare nel file il contenuto dell'oggetto Document
. Assicurarsi di utilizzare l'oggetto Document
restituito dal metodo removePDFPasswordSecurity
.Consulta anche
Avvio rapido (modalità SOAP): Rimozione della crittografia basata su password tramite l’API Java
È possibile rimuovere la crittografia basata su password utilizzando l’API di cifratura (servizio Web):
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1
.
Sostituisci localhost
con l'indirizzo IP del server che ospita AEM Forms.
Crea un client del servizio di crittografia.
Creare un oggetto EncryptionServiceClient
utilizzando il relativo costruttore predefinito.
Creare un oggetto EncryptionServiceClient.Endpoint.Address
utilizzando il costruttore System.ServiceModel.EndpointAddress
. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/EncryptionService?WSDL
). Non è necessario utilizzare l'attributo lc_version
. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
Crea un oggetto System.ServiceModel.BasicHttpBinding
ottenendo il valore del campo EncryptionServiceClient.Endpoint.Binding
. Imposta il valore restituito su BasicHttpBinding
.
Impostare il campo MessageEncoding
dell'oggetto System.ServiceModel.BasicHttpBinding
su WSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM.
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
EncryptionServiceClient.ClientCredentials.UserName.UserName
.EncryptionServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Ottenere il documento PDF crittografato.
BLOB
utilizzando il relativo costruttore. L'oggetto BLOB
viene utilizzato per memorizzare un documento PDF crittografato con password.System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF crittografato e la modalità di apertura del file.System.IO.FileStream
. È possibile determinare le dimensioni dell'array di byte ottenendo la proprietà Length
dell'oggetto System.IO.FileStream
.Read
dell’oggetto System.IO.FileStream
e passando l’array di byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
assegnando il contenuto dell'array di byte al membro dati BLOB
dell'oggetto MTOM
.Rimuovi la password.
Richiama il metodo removePDFPasswordSecurity
dell'oggetto EncryptionServiceService
e passa i seguenti valori:
BLOB
che contiene i dati del flusso di file che rappresenta un documento PDF crittografato.Il metodo removePDFPasswordSecurity
restituisce un oggetto BLOB
contenente un documento PDF non protetto.
Salvare il documento PDF.
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF non protetto.BLOB
restituito dal metodo removePDFPasswordSecurity
. Compilare l'array di byte ottenendo il valore del membro dati BLOB
dell'oggetto MTOM
.System.IO.BinaryWriter
richiamandone il costruttore e passando l'oggetto System.IO.FileStream
.Write
dell’oggetto System.IO.BinaryWriter
e passando l’array di byte.Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
È necessario sbloccare un documento PDF crittografato con password o certificato prima di eseguire un’altra operazione AEM Forms. Se si tenta di eseguire un'operazione su un documento PDF crittografato, verrà generata un'eccezione. Dopo aver sbloccato un documento PDF crittografato, è possibile eseguire una o più operazioni su di esso. Queste operazioni possono appartenere ad altri servizi, ad esempio il servizio Acrobat Reader DC extensions.
Per ulteriori informazioni sul servizio di cifratura, consulta Guida di riferimento dei servizi per AEM Forms.
Per sbloccare un documento PDF crittografato, eseguire le operazioni seguenti:
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 della classe del progetto:
Creare un client del servizio di crittografia
Per eseguire un'operazione del servizio di cifratura a livello di programmazione, è necessario creare un client del servizio di cifratura. Se utilizzi l’API Java Encryption Service, crea un oggetto EncrytionServiceClient
. Se utilizzi l’API del servizio Web Encryption Service, crea un oggetto EncryptionServiceService
.
Ottenere il documento PDF crittografato
Per sbloccarlo, è necessario ottenere un documento PDF crittografato. Se si tenta di sbloccare un documento PDF non crittografato, viene generata un'eccezione.
Sblocca il documento
Per sbloccare un documento PDF crittografato con password, è necessario disporre sia di un documento PDF crittografato sia di un valore di password utilizzato per aprire un documento PDF crittografato con password. Questo valore viene specificato durante la cifratura del documento PDF con una password. (Vedere Cifratura di documenti PDF con una password.)
Per sbloccare un documento PDF crittografato con certificato, è necessario disporre sia di un documento PDF crittografato sia del valore alias della chiave pubblica corrispondente alla chiave privata utilizzata per cifrare il documento PDF.
Eseguire un’operazione AEM Forms
Quando un documento PDF crittografato viene sbloccato, è possibile eseguire un'altra operazione del servizio, ad esempio l'applicazione di diritti di utilizzo. Questa operazione appartiene al servizio Acrobat Reader DC Extensions.
Consulta anche
Sblocca un documento PDF crittografato utilizzando l’API Java
Sblocca un documento PDF crittografato utilizzando l’API del servizio Web
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API del servizio di crittografia
Sblocca un documento PDF crittografato utilizzando l’API di cifratura (Java):
Includi file di progetto.
Includi file JAR client, come adobe-encryption-client.jar, nel percorso di classe del progetto Java.
Crea un client del servizio di crittografia.
ServiceClientFactory
contenente le proprietà di connessione.EncryptionServiceClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Ottenere il documento PDF crittografato.
java.io.FileInputStream
che rappresenta il documento PDF crittografato utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento PDF crittografato.com.adobe.idp.Document
utilizzando il relativo costruttore e passando l'oggetto java.io.FileInputStream
.Sblocca il documento.
Sblocca un documento PDF crittografato richiamando il metodo unlockPDFUsingPassword
dell'oggetto EncryptionServiceClient
o unlockPDFUsingCredential
.
Per sbloccare un documento PDF crittografato con una password, richiama il metodo unlockPDFUsingPassword
e passa i seguenti valori:
com.adobe.idp.Document
che contiene il documento PDF crittografato con password.Per sbloccare un documento PDF crittografato con un certificato, richiamare il metodo unlockPDFUsingCredential
e passare i seguenti valori:
com.adobe.idp.Document
contenente il documento PDF crittografato con certificato.I metodi unlockPDFUsingPassword
e unlockPDFUsingCredential
restituiscono entrambi un oggetto com.adobe.idp.Document
passato a un altro metodo Java di AEM Forms per eseguire un’operazione.
Esegui un’operazione AEM Forms.
Eseguire un'operazione AEM Forms sul documento PDF sbloccato per soddisfare i requisiti aziendali. Ad esempio, supponendo di voler applicare diritti di utilizzo a un documento PDF sbloccato, passare l'oggetto com.adobe.idp.Document
restituito dai metodi unlockPDFUsingPassword
o unlockPDFUsingCredential
al metodo ReaderExtensionsServiceClient
dell'oggetto applyUsageRights
.
Consulta anche
Avvio rapido (modalità SOAP): Sblocco di un documento PDF crittografato tramite l’API Java (modalità SOAP)
Applicazione dei diritti di utilizzo ai documenti PDF
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Sblocca un documento PDF crittografato utilizzando l’API di cifratura (servizio Web):
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1
.
Sostituisci localhost
con l'indirizzo IP del server che ospita AEM Forms.
Crea un client del servizio di crittografia.
Creare un oggetto EncryptionServiceClient
utilizzando il relativo costruttore predefinito.
Creare un oggetto EncryptionServiceClient.Endpoint.Address
utilizzando il costruttore System.ServiceModel.EndpointAddress
. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/EncryptionService?WSDL
). Non è necessario utilizzare l'attributo lc_version
. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
Crea un oggetto System.ServiceModel.BasicHttpBinding
ottenendo il valore del campo EncryptionServiceClient.Endpoint.Binding
. Imposta il valore restituito su BasicHttpBinding
.
Impostare il campo MessageEncoding
dell'oggetto System.ServiceModel.BasicHttpBinding
su WSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM.
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
EncryptionServiceClient.ClientCredentials.UserName.UserName
.EncryptionServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Ottenere un documento PDF crittografato.
BLOB
utilizzando il relativo costruttore.System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF crittografato e la modalità di apertura del file.System.IO.FileStream
. È possibile determinare le dimensioni dell'array di byte ottenendo la proprietà Length
dell'oggetto System.IO.FileStream
.Read
dell’oggetto System.IO.FileStream
e passando l’array di byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
assegnando il contenuto dell'array di byte al membro dati BLOB
dell'oggetto MTOM
.Sblocca il documento.
Sblocca un documento PDF crittografato richiamando il metodo unlockPDFUsingPassword
dell'oggetto EncryptionServiceClient
o unlockPDFUsingCredential
.
Per sbloccare un documento PDF crittografato con una password, richiama il metodo unlockPDFUsingPassword
e passa i seguenti valori:
BLOB
che contiene il documento PDF crittografato con password.Per sbloccare un documento PDF crittografato con un certificato, richiamare il metodo unlockPDFUsingCredential
e passare i seguenti valori:
BLOB
contenente il documento PDF crittografato con certificato.I metodi unlockPDFUsingPassword
e unlockPDFUsingCredential
restituiscono entrambi un oggetto com.adobe.idp.Document
passato a un altro metodo AEM Forms per eseguire un'operazione.
Esegui un’operazione AEM Forms.
Eseguire un'operazione AEM Forms sul documento PDF sbloccato per soddisfare i requisiti aziendali. Ad esempio, supponendo di voler applicare diritti di utilizzo al documento PDF sbloccato, passare l'oggetto BLOB
restituito dai metodi unlockPDFUsingPassword
o unlockPDFUsingCredential
al metodo ReaderExtensionsServiceClient
dell'oggetto applyUsageRights
.
Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
È possibile determinare programmaticamente il tipo di crittografia che protegge un documento PDF utilizzando l’API Java Encryption Service o il servizio Web Encryption Service API. A volte è necessario determinare in modo dinamico se un documento PDF è crittografato e, in tal caso, il tipo di crittografia. Ad esempio, è possibile determinare se un documento PDF è protetto tramite crittografia basata su password o criteri di Rights Management.
Un documento PDF può essere protetto dai seguenti tipi di cifratura:
Per ulteriori informazioni sul servizio di cifratura, consulta Guida di riferimento dei servizi per AEM Forms.
Per determinare il tipo di crittografia che protegge un documento PDF, eseguire le operazioni seguenti:
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 della classe del progetto:
Creare un client di servizio
Per eseguire un'operazione del servizio di cifratura a livello di programmazione, è necessario creare un client del servizio di cifratura. Se utilizzi l’API Java Encryption Service, crea un oggetto EncrytionServiceClient
. Se utilizzi l’API del servizio Web Encryption Service, crea un oggetto EncryptionServiceService
.
Ottenere il documento PDF crittografato
È necessario ottenere un documento PDF per determinare il tipo di crittografia che lo protegge.
Determinare il tipo di crittografia
È possibile determinare il tipo di crittografia che protegge un documento PDF. Se il documento PDF non è protetto, il servizio di cifratura informa che il documento PDF non è protetto.
Consulta anche
Determinare il tipo di crittografia utilizzando l’API Java
Determinare il tipo di crittografia utilizzando l’API del servizio Web
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API del servizio di crittografia
Protezione dei documenti con i criteri
Determinare il tipo di crittografia che protegge un documento PDF utilizzando l’API di cifratura (Java):
Includi file di progetto.
Includi file JAR client, come adobe-encryption-client.jar, nel percorso di classe del progetto Java.
Crea un client di servizio.
ServiceClientFactory
contenente le proprietà di connessione.EncryptionServiceClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Ottenere il documento PDF crittografato.
java.io.FileInputStream
che rappresenta il documento PDF utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento PDF.com.adobe.idp.Document
utilizzando il relativo costruttore e passando l'oggetto java.io.FileInputStream
.Determina il tipo di crittografia.
getPDFEncryption
dell’oggetto EncryptionServiceClient
e passando l’oggetto com.adobe.idp.Document
che contiene il documento PDF. Questo metodo restituisce un oggetto EncryptionTypeResult
.getEncryptionType
dell'oggetto EncryptionTypeResult
. Questo metodo restituisce un valore enum EncryptionType
che specifica il tipo di crittografia. Ad esempio, se il documento PDF è protetto con crittografia basata su password, questo metodo restituisce EncryptionType.PASSWORD
.Consulta anche
Avvio rapido (modalità SOAP): Determinazione del tipo di crittografia tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Determinare il tipo di crittografia che protegge un documento PDF utilizzando l’API di cifratura (servizio Web):
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1
.
Sostituisci localhost
con l'indirizzo IP del server che ospita AEM Forms.
Crea un client di servizio.
Creare un oggetto EncryptionServiceClient
utilizzando il relativo costruttore predefinito.
Creare un oggetto EncryptionServiceClient.Endpoint.Address
utilizzando il costruttore System.ServiceModel.EndpointAddress
. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/EncryptionService?WSDL
). Non è necessario utilizzare l'attributo lc_version
. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
Crea un oggetto System.ServiceModel.BasicHttpBinding
ottenendo il valore del campo EncryptionServiceClient.Endpoint.Binding
. Imposta il valore restituito su BasicHttpBinding
.
Impostare il campo MessageEncoding
dell'oggetto System.ServiceModel.BasicHttpBinding
su WSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM.
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
EncryptionServiceClient.ClientCredentials.UserName.UserName
.EncryptionServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Ottenere il documento PDF crittografato.
BLOB
utilizzando il relativo costruttore.System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF crittografato e la modalità di apertura del file.System.IO.FileStream
. È possibile determinare le dimensioni dell'array di byte ottenendo la proprietà Length
dell'oggetto System.IO.FileStream
.Read
dell’oggetto System.IO.FileStream
e passando l’array di byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
assegnando il contenuto dell'array di byte al membro dati BLOB
dell'oggetto MTOM
.Determina il tipo di crittografia.
getPDFEncryption
dell'oggetto EncryptionServiceClient
e passare l'oggetto BLOB
che contiene il documento PDF. Questo metodo restituisce un oggetto EncryptionTypeResult
.encryptionType
dell'oggetto EncryptionTypeResult
. Ad esempio, se il documento PDF è protetto con crittografia basata su password, il valore di questo membro dati è EncryptionType.PASSWORD
.Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef