Crittografia e decrittografia dei documenti di PDF

Crittografia di documenti PDF con certificati

Crittografare un documento PDF utilizzando l’API Java

Crittografa un documento PDF con una password utilizzando l’API di crittografia (Java):

Includi file di progetto.

Includi i file JAR dei client, ad esempio adobe-encryption-client.jar, nel percorso di classe del progetto Java.
Creare un'API client di crittografia.
- Creare un ServiceClientFactory oggetto che contiene proprietà di connessione.
- Creare un EncryptionServiceClient mediante il costruttore e passando il ServiceClientFactory oggetto.
Ottieni un documento PDF da crittografare.
- Creare un java.io.FileInputStream oggetto che rappresenta il documento PDF da crittografare utilizzando il relativo costruttore e passando un valore stringa che specifica la posizione del documento PDF.
- Creare un com.adobe.idp.Document mediante il costruttore e passando il java.io.FileInputStream oggetto.
Impostare le opzioni di runtime della crittografia.
- Creare un PasswordEncryptionOptionSpec richiamando il relativo costruttore.
- Specificare le risorse del documento PDF da crittografare richiamando PasswordEncryptionOptionSpec dell'oggetto setEncryptOption e il passaggio di un PasswordEncryptionOption valore di enumerazione che specifica le risorse del documento da crittografare. Ad esempio, per crittografare l'intero documento PDF, inclusi i metadati e gli allegati, specificare PasswordEncryptionOption.ALL.
- Creare un java.util.List oggetto che memorizza le autorizzazioni di crittografia utilizzando ArrayList costruttore.
- Specificare un'autorizzazione richiamando java.util.List oggetto "s add e passando un valore di enumerazione che corrisponde all'autorizzazione da impostare. Ad esempio, per impostare l’autorizzazione che consente a un utente di copiare i dati nel documento PDF, specifica PasswordEncryptionPermission.PASSWORD_EDIT_COPY. (Ripeti questo passaggio per ogni autorizzazione da impostare).
- Specifica l’opzione di compatibilità per Acrobat richiamando PasswordEncryptionOptionSpec dell'oggetto setCompatability e passando un valore di enumerazione che specifica il livello di compatibilità di Acrobat. Ad esempio, puoi specificare PasswordEncryptionCompatability.ACRO_7.
- Specificare il valore della password che consente a un utente di aprire il documento PDF crittografato richiamando PasswordEncryptionOptionSpec dell'oggetto setDocumentOpenPassword e passando un valore stringa che rappresenta la password di apertura.
- Specificare il valore della password master che consente a un utente di rimuovere la crittografia dal documento PDF richiamando PasswordEncryptionOptionSpec dell'oggetto setPermissionPassword e passando un valore stringa che rappresenta la password principale.
Aggiungi la password.

Crittografare il documento PDF richiamando EncryptionServiceClient dell'oggetto encryptPDFUsingPassword e fornendo i seguenti valori:
- Il com.adobe.idp.Document oggetto che contiene il documento PDF da crittografare con la password.
- Il PasswordEncryptionOptionSpec oggetto contenente opzioni di crittografia in fase di esecuzione.
Il encryptPDFUsingPassword il metodo restituisce un com.adobe.idp.Document oggetto contenente un documento PDF crittografato con password.
Salvare il documento PDF crittografato come file PDF.
- Creare un java.io.File e assicurarsi che l'estensione del file sia .pdf.
- Richiama com.adobe.idp.Document dell'oggetto copyToFile metodo per copiare il contenuto del com.adobe.idp.Document al file. Assicurati di utilizzare com.adobe.idp.Document oggetto restituito da encryptPDFUsingPassword metodo.

Consulta anche

Quick Start (modalità SOAP): crittografia di un documento PDF tramite l’API Java

Inclusione dei file della libreria Java di AEM Forms

Crittografia di un documento PDF tramite l’API del servizio web

Crittografa un documento PDF con una password utilizzando l’API di crittografia (servizio web):

Includi file di progetto.

Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1.

NOTA

Sostituisci localhost con l’indirizzo IP del server che ospita AEM Forms.
Creare un oggetto API client di crittografia.
- Creare un EncryptionServiceClient utilizzando il costruttore predefinito.
- Creare un EncryptionServiceClient.Endpoint.Address oggetto utilizzando System.ServiceModel.EndpointAddress costruttore. Passa un valore stringa che specifica il file WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/EncryptionService?WSDL.) Non è necessario utilizzare il lc_version attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
- Creare un System.ServiceModel.BasicHttpBinding dell'oggetto ottenendo il valore del EncryptionServiceClient.Endpoint.Binding campo. Invia il valore restituito a BasicHttpBinding.
- Imposta il System.ServiceModel.BasicHttpBinding dell'oggetto MessageEncoding campo a WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.
- Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
  - Assegna al campo il nome utente dei moduli AEM EncryptionServiceClient.ClientCredentials.UserName.UserName.
  - Assegna il valore password corrispondente al campo EncryptionServiceClient.ClientCredentials.UserName.Password.
  - Assegna il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.
Ottieni un documento PDF da crittografare.
- Creare un BLOB mediante il costruttore. Il BLOB L'oggetto viene utilizzato per memorizzare un documento PDF crittografato con una password.
- Creare un System.IO.FileStream richiamando il costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF da crittografare e la modalità di apertura del file.
- Creare una matrice di byte che memorizza il contenuto della System.IO.FileStream oggetto. È possibile determinare le dimensioni della matrice di byte ottenendo System.IO.FileStream dell'oggetto Length proprietà.
- Compilare la matrice di byte con i dati di flusso richiamando System.IO.FileStream dell'oggetto Read e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
- Popolare il BLOB mediante l'assegnazione del contenuto della matrice di byte BLOB dell'oggetto MTOM membro dati.
Impostare le opzioni di runtime della crittografia.
- Creare un PasswordEncryptionOptionSpec mediante il costruttore.
- Specificare le risorse del documento PDF da crittografare assegnando un PasswordEncryptionOption valore di enumerazione per PasswordEncryptionOptionSpec dell'oggetto encryptOption membro dati. Per crittografare l'intero PDF, inclusi i metadati e gli allegati, assegnare PasswordEncryptionOption.ALL a questo membro dati.
- Specifica l’opzione di compatibilità per Acrobat assegnando un PasswordEncryptionCompatability valore di enumerazione per PasswordEncryptionOptionSpec dell'oggetto compatability membro dati. Ad esempio, assegna PasswordEncryptionCompatability.ACRO_7 a questo membro dati.
- Specifica il valore della password che consente a un utente di aprire il documento PDF crittografato assegnando un valore stringa che rappresenta la password di apertura al PasswordEncryptionOptionSpec dell'oggetto documentOpenPassword membro dati.
- Specificare il valore della password che consente a un utente di rimuovere la crittografia dal documento PDF assegnando un valore stringa che rappresenta la password master al PasswordEncryptionOptionSpec dell'oggetto permissionPassword membro dati.
Aggiungi la password.

Crittografare il documento PDF richiamando EncryptionServiceClient dell'oggetto encryptPDFUsingPassword e fornendo i seguenti valori:
- Il BLOB oggetto che contiene il documento PDF da crittografare con la password.
- Il PasswordEncryptionOptionSpec oggetto contenente opzioni di crittografia in fase di esecuzione.
Il encryptPDFUsingPassword il metodo restituisce un BLOB oggetto contenente un documento PDF crittografato con password.
Salvare il documento PDF crittografato come file PDF.
- Creare un System.IO.FileStream richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF protetto.
- Creare una matrice di byte che memorizza il contenuto dei dati BLOB oggetto restituito da encryptPDFUsingPassword metodo. Popolare la matrice di byte ottenendo il valore della BLOB dell'oggetto MTOM membro dati.
- Creare un System.IO.BinaryWriter oggetto richiamando il relativo costruttore e passando il System.IO.FileStream oggetto.
- Scrivere il contenuto della matrice di byte in un file PDF richiamando System.IO.BinaryWriter dell'oggetto Write e passando la matrice di byte.

Consulta anche

Crittografare un documento PDF con un certificato utilizzando l’API Java

Crittografia di documenti PDF con certificati

La crittografia basata su certificato consente di crittografare un documento per destinatari specifici tramite la tecnologia a chiave pubblica. È possibile assegnare a diversi destinatari 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 tasti, che hanno le seguenti proprietà:

Una chiave viene utilizzata per crittografare un set di dati. Successivamente, solo l'altra chiave può essere utilizzata per decrittografare i dati.
È impossibile distinguere una chiave dall'altra.

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 e le informazioni di identificazione di un utente. Il formato X.509 viene utilizzato per l’archiviazione dei certificati. I certificati vengono 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 CRL vengono 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.

NOTA

Prima di poter crittografare un documento PDF con un certificato, è necessario assicurarsi di aggiungere il certificato ad AEM Forms. Un certificato viene aggiunto utilizzando la console di amministrazione o a livello di programmazione utilizzando l’API di Trust Manager. (vedere Importazione delle credenziali tramite l'API di Gestione trust.)

NOTA

Per ulteriori informazioni sul servizio Encryption, vedere Guida di riferimento dei servizi per AEM Forms.

Riepilogo dei passaggi

Per crittografare un documento PDF con un certificato, effettuare le seguenti operazioni:

Includi file di progetto.
Creare un oggetto API client di crittografia.
Ottieni un documento PDF da crittografare.
Fai riferimento al certificato.
Impostare le opzioni di runtime della crittografia.
Crea un documento PDF crittografato con certificato.
Salvare il documento PDF crittografato come file PDF.

Includi file di progetto

I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-encryption-client.jar
adobe-utilities.jar (richiesto se AEM Forms è distribuito sul server applicazioni JBoss)
jbossall-client.jar (richiesto se AEM Forms è distribuito sul server applicazioni JBoss)

Creare un oggetto API client di crittografia

Per eseguire un'operazione del servizio di crittografia a livello di programmazione, è necessario creare un client del servizio di crittografia. Se utilizzi l’API Java Encryption Service, crea un’ EncrytionServiceClient oggetto. Se utilizzi l’API del servizio Web Encryption Service, crea un’ EncryptionServiceService oggetto.

Ottieni un documento PDF da crittografare

Ottieni un documento PDF non crittografato da crittografare. Se si tenta di proteggere un documento PDF già crittografato, viene generata un'eccezione.

Fai riferimento al certificato

Per crittografare un documento PDF con un certificato, fare riferimento a un certificato utilizzato per crittografare un documento PDF. Il certificato è un file cer, crt o pem. Un file PKCS#12 viene utilizzato per memorizzare le chiavi private con i certificati corrispondenti.

Quando si crittografa un documento PDF con un certificato, specificare le autorizzazioni associate al documento protetto. Specificando le autorizzazioni, è possibile controllare le azioni che un utente che apre un documento PDF crittografato con certificato può eseguire.

Impostare le opzioni di runtime della crittografia

Specificare le risorse del documento PDF da crittografare. È possibile crittografare l’intero documento PDF, tutto tranne i metadati del documento o solo gli allegati del documento.

Creazione di un documento PDF crittografato con certificato

Dopo aver recuperato un documento di PDF non protetto, aver fatto riferimento al certificato e aver impostato le opzioni di runtime, è possibile creare un documento di PDF crittografato con certificato. Dopo aver crittografato il documento PDF, è necessario utilizzare la 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 del servizio web

Inclusione dei file della libreria Java di AEM Forms

Crittografia di documenti PDF con una password

Crittografare un documento PDF con un certificato utilizzando l’API Java

Crittografa un documento PDF con un certificato utilizzando l’API di crittografia (Java):

Includi file di progetto.

Includi i file JAR dei client, ad esempio adobe-encryption-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto API client di crittografia.
- Creare un ServiceClientFactory oggetto che contiene proprietà di connessione.
- Creare un EncryptionServiceClient mediante il costruttore e passando il ServiceClientFactory oggetto.
Ottieni un documento PDF da crittografare.
- Creare un java.io.FileInputStream oggetto che rappresenta il documento PDF da crittografare utilizzando il relativo costruttore e passando un valore stringa che specifica la posizione del documento PDF.
- Creare un com.adobe.idp.Document mediante il costruttore e passando il java.io.FileInputStream oggetto.
Fai riferimento al certificato.
- Creare un java.util.List oggetto che memorizza le informazioni sulle autorizzazioni utilizzando il relativo costruttore.
- Specificare l'autorizzazione associata al documento crittografato richiamando java.util.List dell'oggetto add e il passaggio di un CertificateEncryptionPermissions valore di enumerazione 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.
- Creare un Recipient mediante il costruttore.
- Creare un java.io.FileInputStream oggetto che rappresenta il certificato utilizzato per crittografare il documento PDF utilizzando il relativo costruttore e passando un valore stringa che specifica la posizione del certificato.
- Creare un com.adobe.idp.Document mediante il costruttore e passando il java.io.FileInputStream oggetto che rappresenta il certificato.
- Richiama Recipient dell'oggetto setX509Cert e trasmettere il com.adobe.idp.Document oggetto che contiene il certificato. (Inoltre, il RecipientL'oggetto può avere un alias del certificato Truststore o un URL LDAP come origine del certificato.)
- Creare un CertificateEncryptionIdentity oggetto che memorizza le informazioni su autorizzazioni e certificati utilizzando il relativo costruttore.
- Richiama CertificateEncryptionIdentity dell'oggetto setPerms e trasmettere il java.util.List oggetto che memorizza le informazioni sulle autorizzazioni.
- Richiama CertificateEncryptionIdentity dell'oggetto setRecipient e trasmettere il Recipient oggetto che memorizza le informazioni sul certificato.
- Creare un java.util.List oggetto che memorizza le informazioni sul certificato utilizzando il relativo costruttore.
- Richiama java.util.List metodo add dell'oggetto e passare il CertificateEncryptionIdentity oggetto. (Questo java.util.List l'oggetto viene passato come parametro al encryptPDFUsingCertificates metodo.)
Impostare le opzioni di runtime della crittografia.
- Creare un CertificateEncryptionOptionSpec richiamando il relativo costruttore.
- Specificare le risorse del documento PDF da crittografare richiamando CertificateEncryptionOptionSpec dell'oggetto setOption e il passaggio di un CertificateEncryptionOption valore di enumerazione che specifica le risorse del documento da crittografare. Ad esempio, per crittografare l'intero documento PDF, inclusi i metadati e gli allegati, specificare CertificateEncryptionOption.ALL.
- Specifica l’opzione di compatibilità per Acrobat richiamando CertificateEncryptionOptionSpec dell'oggetto setCompat e il passaggio di un CertificateEncryptionCompatibility valore di enumerazione che specifica il livello di compatibilità di Acrobat. Ad esempio, puoi specificare CertificateEncryptionCompatibility.ACRO_7.
Crea un documento PDF crittografato con certificato.

Crittografare il documento PDF con un certificato richiamando il EncryptionServiceClient dell'oggetto encryptPDFUsingCertificates e fornendo i seguenti valori:
- Il com.adobe.idp.Document oggetto che contiene il documento PDF da crittografare.
- Il java.util.List oggetto che memorizza le informazioni sul certificato.
- Il CertificateEncryptionOptionSpec oggetto contenente opzioni di crittografia in fase di esecuzione.
Il encryptPDFUsingCertificates il metodo restituisce un com.adobe.idp.Document oggetto contenente un documento PDF crittografato con certificato.
Salvare il documento PDF crittografato come file PDF.
- Creare un java.io.File e assicurarsi che l'estensione del nome file sia .pdf.
- Richiama com.adobe.idp.Document dell'oggetto copyToFile metodo per copiare il contenuto del com.adobe.idp.Document al file. Assicurati di utilizzare com.adobe.idp.Document oggetto restituito da encryptPDFUsingCertificates metodo.

Consulta anche

Guida rapida (modalità SOAP): crittografia di un documento PDF con un certificato tramite l’API Java

Inclusione dei file della libreria Java di AEM Forms

Crittografare un documento PDF con un certificato utilizzando l’API del servizio web

Crittografa un documento PDF con un certificato utilizzando l’API di crittografia (servizio web):

Includi file di progetto.

Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1.

NOTA

Sostituisci localhost con l’indirizzo IP del server che ospita AEM Forms.
Creare un oggetto API client di crittografia.
- Creare un EncryptionServiceClient utilizzando il costruttore predefinito.
- Creare un EncryptionServiceClient.Endpoint.Address oggetto utilizzando System.ServiceModel.EndpointAddress costruttore. Passa un valore stringa che specifica il file WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/EncryptionService?WSDL.) Non è necessario utilizzare il lc_version attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
- Creare un System.ServiceModel.BasicHttpBinding dell'oggetto ottenendo il valore del EncryptionServiceClient.Endpoint.Binding campo. Invia il valore restituito a BasicHttpBinding.
- Imposta il System.ServiceModel.BasicHttpBinding dell'oggetto MessageEncoding campo a WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.
- Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
  - Assegna al campo il nome utente dei moduli AEM EncryptionServiceClient.ClientCredentials.UserName.UserName.
  - Assegna il valore password corrispondente al campo EncryptionServiceClient.ClientCredentials.UserName.Password.
  - Assegna il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.
Ottieni un documento PDF da crittografare.
- Creare un BLOB mediante il costruttore. Il BLOB L'oggetto viene utilizzato per memorizzare un documento PDF crittografato con un certificato.
- Creare un System.IO.FileStream richiamando il costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF da crittografare e la modalità di apertura del file.
- Creare una matrice di byte che memorizza il contenuto della System.IO.FileStream oggetto. È possibile determinare le dimensioni della matrice di byte ottenendo System.IO.FileStream dell'oggetto Length proprietà.
- Compilare la matrice di byte con i dati di flusso richiamando System.IO.FileStream dell'oggetto Read e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
- Popolare il BLOB oggetto assegnando il relativo MTOM con il contenuto della matrice di byte.
Fai riferimento al certificato.
- Creare un Recipient mediante il costruttore. Questo oggetto memorizzerà le informazioni sul certificato.
- Creare un BLOB mediante il costruttore. Questo BLOB L'oggetto memorizzerà il certificato che crittografa il documento PDF.
- Creare un System.IO.FileStream richiamando il costruttore e passando un valore stringa che rappresenta la posizione del file del certificato e la modalità di apertura del file.
- Creare una matrice di byte che memorizza il contenuto della System.IO.FileStream oggetto. È possibile determinare le dimensioni della matrice di byte ottenendo System.IO.FileStream dell'oggetto Length proprietà.
- Compilare la matrice di byte con i dati di flusso richiamando System.IO.FileStream dell'oggetto Read e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
- Popolare il BLOB mediante l'assegnazione del contenuto della matrice di byte BLOB dell'oggetto MTOM membro dati.
- Assegna la BLOB oggetto che memorizza il certificato in Recipient dell'oggetto x509Cert membro dati.
- Creare un CertificateEncryptionIdentity oggetto che memorizza le informazioni sul certificato utilizzando il relativo costruttore.
- Assegna la Recipient oggetto che memorizza il certificato in CertificateEncryptionIdentitymembro dati destinatario dell'oggetto.
- Creare un Object e assegna il CertificateEncryptionIdentity oggetto al primo elemento del Object array. Questo Object viene passato come parametro al encryptPDFUsingCertificates metodo.
Impostare le opzioni di runtime della crittografia.
- Creare un CertificateEncryptionOptionSpec mediante il costruttore.
- Specificare le risorse del documento PDF da crittografare assegnando un CertificateEncryptionOption valore di enumerazione per CertificateEncryptionOptionSpec dell'oggetto option membro dati. Per crittografare l'intero documento PDF, inclusi i metadati e gli allegati, assegnare CertificateEncryptionOption.ALL a questo membro dati.
- Specifica l’opzione di compatibilità per Acrobat assegnando un CertificateEncryptionCompatibility valore di enumerazione per CertificateEncryptionOptionSpec dell'oggetto compat membro dati. Ad esempio, assegna CertificateEncryptionCompatibility.ACRO_7 a questo membro dati.
Crea un documento PDF crittografato con certificato.

Crittografare il documento PDF con un certificato richiamando il EncryptionServiceService dell'oggetto encryptPDFUsingCertificates e fornendo i seguenti valori:
- Il BLOB oggetto che contiene il documento PDF da crittografare.
- Il Object array che memorizza le informazioni sui certificati.
- Il CertificateEncryptionOptionSpec oggetto contenente opzioni di crittografia in fase di esecuzione.
Il encryptPDFUsingCertificates il metodo restituisce un BLOB oggetto contenente un documento PDF crittografato con certificato.
Salvare il documento PDF crittografato come file PDF.
- Creare un System.IO.FileStream richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF protetto.
- Creare una matrice di byte che memorizza il contenuto dei dati BLOB oggetto restituito da encryptPDFUsingCertificates metodo. Popolare la matrice di byte ottenendo il valore della BLOB dell'oggetto binaryData membro dati.
- Creare un System.IO.BinaryWriter oggetto richiamando il relativo costruttore e passando il System.IO.FileStream oggetto.
- Scrivere il contenuto della matrice di byte in un file PDF richiamando System.IO.BinaryWriter dell'oggetto Write e passando la matrice di byte.

Consulta anche

Rimuovere la crittografia basata su certificati utilizzando l’API Java

Rimozione della crittografia basata su certificati

La crittografia basata su certificato può essere rimossa da un documento PDF PDF in modo che gli utenti possano aprirlo in Adobe Reader o Acrobat. Per rimuovere la crittografia da un documento PDF crittografato con un certificato, è necessario fare riferimento a una chiave pubblica. Una volta rimossa da un documento PDF, la crittografia non è più protetta.

NOTA

Per ulteriori informazioni sul servizio Encryption, vedere Guida di riferimento dei servizi per AEM Forms.

Riepilogo dei passaggi

Per rimuovere la crittografia basata su certificato da un documento PDF, effettuare le seguenti operazioni:

Includi file di progetto.
Creare un client del servizio di crittografia.
Ottieni il documento PDF crittografato.
Rimuovi la crittografia.
Salvare il documento PDF come file PDF.

Includi file di progetto

I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-encryption-client.jar
adobe-utilities.jar (richiesto se AEM Forms è distribuito sul server applicazioni JBoss)
jbossall-client.jar (richiesto se AEM Forms è distribuito sul server applicazioni JBoss)

Creare un client del servizio di crittografia

Ottieni il documento PDF crittografato

Ottieni un documento PDF crittografato per rimuovere la crittografia basata su certificati. 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 crittografia basata su certificato da un documento PDF crittografato, è necessario disporre di un documento PDF crittografato e della chiave privata corrispondente alla chiave utilizzata per crittografare il documento PDF. Il valore alias della chiave privata viene specificato quando si rimuove la crittografia basata su certificati da un documento di PDF crittografato. Per informazioni sulla chiave pubblica, vedi Crittografia di documenti PDF con certificati.

NOTA

Una chiave privata viene memorizzata nell'archivio fonti attendibili di AEM Forms. Quando viene inserito un certificato, viene specificato un valore alias.

Salva il documento PDF

Dopo aver rimosso la crittografia basata su certificati 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

Rimuovi la crittografia basata su certificati utilizzando l’API del servizio web

Inclusione dei file della libreria Java di AEM Forms

Rimuovere la crittografia basata su certificati utilizzando l’API Java

Rimuovi la crittografia basata su certificato da un documento PDF utilizzando l’API di crittografia (Java):

Includi file di progetto.

Includi i file JAR dei client, ad esempio adobe-encryption-client.jar, nel percorso di classe del progetto Java.
Creare un client del servizio di crittografia.
- Creare un ServiceClientFactory oggetto che contiene proprietà di connessione.
- Creare un EncryptionServiceClient mediante il costruttore e passando il ServiceClientFactory oggetto.
Ottieni il documento PDF crittografato.
- Creare un java.io.FileInputStream oggetto che rappresenta il documento PDF crittografato utilizzando il relativo costruttore e passando un valore stringa che specifica la posizione del documento PDF crittografato.
- Creare un com.adobe.idp.Document mediante il costruttore e passando il java.io.FileInputStream oggetto.
Rimuovi la crittografia.

Rimuovere la crittografia basata su certificato dal documento PDF richiamando EncryptionServiceClient dell'oggetto removePDFCertificateSecurity e fornendo i seguenti valori:
- Il com.adobe.idp.Document oggetto che contiene il documento PDF crittografato.
- Valore stringa che specifica il nome alias della chiave privata corrispondente alla chiave utilizzata per crittografare il documento PDf.
Il removePDFCertificateSecurity il metodo restituisce un com.adobe.idp.Document oggetto contenente un documento PDF non protetto.
Salvare il documento PDF.
- Creare un java.io.File e assicurarsi che l'estensione del file sia .pdf.
- Richiama com.adobe.idp.Document dell'oggetto copyToFile metodo per copiare il contenuto del Document al file. Assicurati di utilizzare com.adobe.idp.Document oggetto restituito da removePDFCredentialSecurity metodo.

Consulta anche

Quick Start (modalità SOAP): rimozione della crittografia basata su certificati tramite l’API Java

Inclusione dei file della libreria Java di AEM Forms

Rimuovi la crittografia basata su certificati utilizzando l’API del servizio web

Rimuovi la crittografia basata su certificato utilizzando l’API di crittografia (servizio web):

Includi file di progetto.

Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1.

NOTA

Sostituisci localhost con l’indirizzo IP del server che ospita AEM Forms.
Creare un client del servizio di crittografia.
- Creare un EncryptionServiceClient utilizzando il costruttore predefinito.
- Creare un EncryptionServiceClient.Endpoint.Address oggetto utilizzando System.ServiceModel.EndpointAddress costruttore. Passa un valore stringa che specifica il file WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/EncryptionService?WSDL.) Non è necessario utilizzare il lc_version attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
- Creare un System.ServiceModel.BasicHttpBinding dell'oggetto ottenendo il valore del EncryptionServiceClient.Endpoint.Binding campo. Invia il valore restituito a BasicHttpBinding.
- Imposta il System.ServiceModel.BasicHttpBinding dell'oggetto MessageEncoding campo a WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.
- Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
  - Assegna al campo il nome utente dei moduli AEM EncryptionServiceClient.ClientCredentials.UserName.UserName.
  - Assegna il valore password corrispondente al campo EncryptionServiceClient.ClientCredentials.UserName.Password.
  - Assegna il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.
Ottieni il documento PDF crittografato.
- Creare un BLOB mediante il costruttore. Il BLOB L'oggetto viene utilizzato per memorizzare il documento PDF crittografato.
- Creare un System.IO.FileStream oggetto richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF crittografato e la modalità di apertura del file.
- Creare una matrice di byte che memorizza il contenuto della System.IO.FileStream oggetto. È possibile determinare le dimensioni della matrice di byte ottenendo System.IO.FileStream dell'oggetto Length proprietà.
- Compilare la matrice di byte con i dati di flusso richiamando System.IO.FileStream dell'oggetto Read e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
- Popolare il BLOB mediante l'assegnazione del contenuto della matrice di byte BLOB dell'oggetto MTOM membro dati.
Rimuovi la crittografia.

Richiama EncryptionServiceClient dell'oggetto removePDFCertificateSecurity e trasmettere i seguenti valori:
- Il BLOB oggetto contenente dati di flusso di file che rappresenta un documento PDF crittografato.
- Valore string che specifica il nome alias della chiave pubblica corrispondente alla chiave privata utilizzata per crittografare il documento PDf.
Il removePDFCredentialSecurity il metodo restituisce un BLOB oggetto contenente un documento PDF non protetto.
Salvare il documento PDF.
- Creare un System.IO.FileStream richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento di PDF non protetto.
- Creare una matrice di byte che memorizza il contenuto della BLOB oggetto restituito da removePDFPasswordSecurity metodo. Popolare la matrice di byte ottenendo il valore della BLOB dell'oggetto MTOM membro dati.
- Creare un System.IO.BinaryWriter oggetto richiamando il relativo costruttore e passando il System.IO.FileStream oggetto.
- Scrivere il contenuto della matrice di byte in un file PDF richiamando System.IO.BinaryWriter dell'oggetto Write e passando la matrice di byte.

Consulta anche

Inclusione dei file della libreria Java di AEM Forms

Rimozione di Crittografia password

La crittografia basata su password può essere rimossa da un documento PDF PDF in modo che gli utenti possano aprirlo in Adobe Reader o Acrobat senza dover specificare una password. Dopo la rimozione della crittografia basata su password da un documento PDF, il documento non è più protetto.

NOTA

Per ulteriori informazioni sul servizio Encryption, vedere Guida di riferimento dei servizi per AEM Forms.

Riepilogo dei passaggi

Per rimuovere la crittografia basata su password da un documento PDF, effettuare le seguenti operazioni:

Includi file di progetto
Creare un client del servizio di crittografia.
Ottieni il documento PDF crittografato.
Rimuovi la password.
Salvare il documento PDF come file PDF.

Includi file di progetto

I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-encryption-client.jar
adobe-utilities.jar (richiesto se AEM Forms è implementato su JBoss)
jbossall-client.jar (obbligatorio se AEM Forms è distribuito su JBoss)

Creare un client del servizio di crittografia

Ottieni il documento PDF crittografato

Ottieni un documento PDF crittografato per rimuovere la crittografia basata su password. Se si tenta di rimuovere la crittografia da un documento PDF non crittografato, viene generata un'eccezione.

Rimuovi la password

Per rimuovere la crittografia basata su password da un documento PDF crittografato, è necessario disporre di un documento PDF crittografato e di un valore di password master utilizzato per rimuovere la crittografia dal documento PDF. La password utilizzata per aprire un documento PDF crittografato con password non può essere utilizzata per rimuovere la crittografia. Quando il documento PDF viene crittografato con una password, viene specificata una password master. (vedere Crittografia di documenti PDF con una password.)

Salva il documento PDF

Dopo che il servizio Crittografia rimuove la crittografia 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

Crittografia di documenti PDF con una password

Rimuovere la crittografia basata su password utilizzando l’API Java

Rimuovi la crittografia basata su password da un documento PDF utilizzando l’API di crittografia (Java):

Includi file di progetto.

Includi i file JAR dei client, come adobe-encryption-client.jar, nel percorso di classe del progetto Java.
Creare un client del servizio di crittografia.
- Creare un ServiceClientFactory oggetto che contiene proprietà di connessione.
- Creare un EncryptionServiceClient mediante il costruttore e passando il ServiceClientFactory oggetto.
Ottieni il documento PDF crittografato.
- Creare un java.io.FileInputStream oggetto che rappresenta il documento PDF crittografato utilizzando il relativo costruttore e passando un valore stringa che specifica la posizione del documento PDF.
- Creare un com.adobe.idp.Document mediante il costruttore e passando il java.io.FileInputStream oggetto.
Rimuovi la password.

Rimuovere la crittografia basata su password dal documento PDF richiamando EncryptionServiceClient dell'oggetto removePDFPasswordSecurity e fornendo i seguenti valori:
- A com.adobe.idp.Document oggetto che contiene il documento PDF crittografato.
- Valore string che specifica il valore della password master utilizzato per rimuovere la crittografia dal documento PDF.
Il removePDFPasswordSecurity il metodo restituisce un com.adobe.idp.Document oggetto contenente un documento PDF non protetto.
Salvare il documento PDF.
- Creare un java.io.File e assicurarsi che l'estensione del nome file sia .pdf.
- Richiama com.adobe.idp.Document dell'oggetto copyToFile metodo per copiare il contenuto del Document al file. Assicurati di utilizzare Document oggetto restituito da removePDFPasswordSecurity metodo.

Consulta anche

Quick Start (modalità SOAP): rimozione della crittografia basata su password tramite API Java

Rimuovi la crittografia basata su password tramite l’API del servizio web

Rimuovi la crittografia basata su password utilizzando l’API di crittografia (servizio web):

Includi file di progetto.

Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1.

NOTA

Sostituisci localhost con l’indirizzo IP del server che ospita AEM Forms.
Creare un client del servizio di crittografia.
- Creare un EncryptionServiceClient utilizzando il costruttore predefinito.
- Creare un EncryptionServiceClient.Endpoint.Address oggetto utilizzando System.ServiceModel.EndpointAddress costruttore. Passa un valore stringa che specifica il file WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/EncryptionService?WSDL.) Non è necessario utilizzare il lc_version attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
- Creare un System.ServiceModel.BasicHttpBinding dell'oggetto ottenendo il valore del EncryptionServiceClient.Endpoint.Binding campo. Invia il valore restituito a BasicHttpBinding.
- Imposta il System.ServiceModel.BasicHttpBinding dell'oggetto MessageEncoding campo a WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.
- Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
  - Assegna al campo il nome utente dei moduli AEM EncryptionServiceClient.ClientCredentials.UserName.UserName.
  - Assegna il valore password corrispondente al campo EncryptionServiceClient.ClientCredentials.UserName.Password.
  - Assegna il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.
Ottieni il documento PDF crittografato.
- Creare un BLOB mediante il costruttore. Il BLOB L'oggetto viene utilizzato per memorizzare un documento PDF crittografato con password.
- Creare un System.IO.FileStream oggetto richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF crittografato e la modalità di apertura del file.
- Creare una matrice di byte che memorizza il contenuto della System.IO.FileStream oggetto. È possibile determinare le dimensioni della matrice di byte ottenendo System.IO.FileStream dell'oggetto Length proprietà.
- Compilare la matrice di byte con i dati di flusso richiamando System.IO.FileStream dell'oggetto Read e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
- Popolare il BLOB mediante l'assegnazione del contenuto della matrice di byte BLOB dell'oggetto MTOM membro dati.
Rimuovi la password.

Richiama EncryptionServiceService dell'oggetto removePDFPasswordSecurity e trasmettere i seguenti valori:
- Il BLOB oggetto contenente dati di flusso di file che rappresenta un documento PDF crittografato.
- Valore stringa che specifica il valore della password utilizzato per rimuovere la crittografia dal documento PDF. Questo valore viene specificato quando si crittografa il documento PDF con una password.
Il removePDFPasswordSecurity il metodo restituisce un BLOB oggetto contenente un documento PDF non protetto.
Salvare il documento PDF.
- Creare un System.IO.FileStream richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento di PDF non protetto.
- Creare una matrice di byte che memorizza il contenuto della BLOB oggetto restituito da removePDFPasswordSecurity metodo. Popolare la matrice di byte ottenendo il valore della BLOB dell'oggetto MTOM membro dati.
- Creare un System.IO.BinaryWriter oggetto richiamando il relativo costruttore e passando il System.IO.FileStream oggetto.
- Scrivere il contenuto della matrice di byte in un file PDF richiamando System.IO.BinaryWriter dell'oggetto Write e passando la matrice di byte.

Consulta anche

Sbloccare un documento PDF crittografato utilizzando l’API Java

Sblocco di documenti PDF crittografati

Un documento PDF crittografato con password o con certificato deve essere sbloccato prima di poter essere sottoposto a un’altra operazione AEM Forms. Se si tenta di eseguire un'operazione su un documento di PDF crittografato, verrà generata un'eccezione. Dopo aver sbloccato un documento PDF crittografato, è possibile eseguirvi una o più operazioni. Queste operazioni possono appartenere ad altri servizi, come il servizio Acrobat Reader DC extensions.

NOTA

Per ulteriori informazioni sul servizio Encryption, vedere Guida di riferimento dei servizi per AEM Forms.

Riepilogo dei passaggi

Per sbloccare un documento PDF crittografato, effettuare le seguenti operazioni:

Includi file di progetto.
Creare un client del servizio di crittografia.
Ottieni il documento PDF crittografato.
Sblocca il documento.
Eseguire un’operazione AEM Forms.

Includi file di progetto

I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-encryption-client.jar
adobe-utilities.jar (richiesto se AEM Forms è distribuito sul server applicazioni JBoss)
jbossall-client.jar (richiesto se AEM Forms è distribuito sul server applicazioni JBoss)

Creare un client del servizio di crittografia

Ottieni il documento PDF crittografato

Ottieni un documento PDF crittografato per sbloccarlo. 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 di un documento PDF crittografato e di un valore di password utilizzato per aprire un documento PDF crittografato con password. Questo valore viene specificato quando si crittografa il documento PDF con una password. (vedere Crittografia di documenti PDF con una password.)

Per sbloccare un documento PDF crittografato con certificato, è necessario sia un documento PDF crittografato che il valore alias della chiave pubblica corrispondente alla chiave privata utilizzata per crittografare il documento PDF.

Eseguire un’operazione AEM Forms

Dopo lo sblocco di un documento PDF crittografato, è possibile eseguire un'altra operazione di servizio su di esso, ad esempio l'applicazione dei diritti di utilizzo. Questa operazione appartiene al servizio Acrobat Reader DC Extensions.

Consulta anche

Sblocca un documento PDF crittografato utilizzando l’API del servizio web

Inclusione dei file della libreria Java di AEM Forms

Sbloccare un documento PDF crittografato utilizzando l’API Java

Sblocca un documento PDF crittografato utilizzando l’API di crittografia (Java):

Includi file di progetto.

Includi i file JAR dei client, ad esempio adobe-encryption-client.jar, nel percorso di classe del progetto Java.
Creare un client del servizio di crittografia.
- Creare un ServiceClientFactory oggetto che contiene proprietà di connessione.
- Creare un EncryptionServiceClient mediante il costruttore e passando il ServiceClientFactory oggetto.
Ottieni il documento PDF crittografato.
- Creare un java.io.FileInputStream oggetto che rappresenta il documento PDF crittografato utilizzando il relativo costruttore e passando un valore stringa che specifica la posizione del documento PDF crittografato.
- Creare un com.adobe.idp.Document mediante il costruttore e passando il java.io.FileInputStream oggetto.
Sblocca il documento.

Sblocca un documento PDF crittografato richiamando EncryptionServiceClient dell'oggetto unlockPDFUsingPassword o unlockPDFUsingCredential metodo.

Per sbloccare un documento PDF crittografato con una password, richiamare unlockPDFUsingPassword e trasmettere i seguenti valori:
- A com.adobe.idp.Document oggetto contenente il documento PDF crittografato con password.
- Valore string che specifica il valore della password utilizzato per aprire un documento PDF crittografato con password. Questo valore viene specificato quando si crittografa il documento PDF con una password.
Per sbloccare un documento PDF crittografato con un certificato, richiama unlockPDFUsingCredential e trasmettere i seguenti valori:
- A com.adobe.idp.Document oggetto che contiene il documento PDF crittografato con certificato.
- Valore string che specifica il nome alias della chiave pubblica corrispondente alla chiave privata utilizzata per crittografare il documento PDF.
Il unlockPDFUsingPassword e unlockPDFUsingCredential entrambi i metodi restituiscono un com.adobe.idp.Document oggetto passato a un altro metodo Java AEM Forms per eseguire un'operazione.
Eseguire un’operazione AEM Forms.

Esegui un’operazione AEM Forms sul documento PDF sbloccato per soddisfare i requisiti aziendali. Se ad esempio si desidera applicare i diritti di utilizzo a un documento di PDF non bloccato, passare il com.adobe.idp.Document oggetto restituito da uno dei due unlockPDFUsingPassword o unlockPDFUsingCredential metodi per ReaderExtensionsServiceClient dell'oggetto applyUsageRights metodo.

Consulta anche

Applicazione dei diritti di utilizzo ai documenti di PDF

Guida rapida (modalità SOAP): sblocco di un documento PDF crittografato tramite l’API Java (modalità SOAP)

Inclusione dei file della libreria Java di AEM Forms

Sblocca un documento PDF crittografato utilizzando l’API del servizio web

Sblocca un documento PDF crittografato utilizzando l’API di crittografia (servizio web):

Includi file di progetto.

Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1.

NOTA

Sostituisci localhost con l’indirizzo IP del server che ospita AEM Forms.
Creare un client del servizio di crittografia.
- Creare un EncryptionServiceClient utilizzando il costruttore predefinito.
- Creare un EncryptionServiceClient.Endpoint.Address oggetto utilizzando System.ServiceModel.EndpointAddress costruttore. Passa un valore stringa che specifica il file WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/EncryptionService?WSDL.) Non è necessario utilizzare il lc_version attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
- Creare un System.ServiceModel.BasicHttpBinding dell'oggetto ottenendo il valore del EncryptionServiceClient.Endpoint.Binding campo. Invia il valore restituito a BasicHttpBinding.
- Imposta il System.ServiceModel.BasicHttpBinding dell'oggetto MessageEncoding campo a WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.
- Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
  - Assegna al campo il nome utente dei moduli AEM EncryptionServiceClient.ClientCredentials.UserName.UserName.
  - Assegna il valore password corrispondente al campo EncryptionServiceClient.ClientCredentials.UserName.Password.
  - Assegna il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.
Ottieni un documento PDF crittografato.
- Creare un BLOB mediante il costruttore.
- Creare un System.IO.FileStream oggetto richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF crittografato e la modalità di apertura del file.
- Creare una matrice di byte che memorizza il contenuto della System.IO.FileStream oggetto. È possibile determinare le dimensioni della matrice di byte ottenendo System.IO.FileStream dell'oggetto Length proprietà.
- Compilare la matrice di byte con i dati di flusso richiamando System.IO.FileStream dell'oggetto Read e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
- Popolare il BLOB mediante l'assegnazione del contenuto della matrice di byte BLOB dell'oggetto MTOM membro dati.
Sblocca il documento.

Sblocca un documento PDF crittografato richiamando EncryptionServiceClient dell'oggetto unlockPDFUsingPassword o unlockPDFUsingCredential metodo.

Per sbloccare un documento PDF crittografato con una password, richiamare unlockPDFUsingPassword e trasmettere i seguenti valori:
- A BLOB oggetto contenente il documento PDF crittografato con password.
- Valore string che specifica il valore della password utilizzato per aprire un documento PDF crittografato con password. Questo valore viene specificato quando si crittografa il documento PDF con una password.
Per sbloccare un documento PDF crittografato con un certificato, richiama unlockPDFUsingCredential e trasmettere i seguenti valori:
- A BLOB oggetto che contiene il documento PDF crittografato con certificato.
- Valore string che specifica il nome alias della chiave pubblica corrispondente alla chiave privata utilizzata per crittografare il documento PDf.
Il unlockPDFUsingPassword e unlockPDFUsingCredential entrambi i metodi restituiscono un com.adobe.idp.Document oggetto passato a un altro metodo AEM Forms per eseguire un'operazione.
Eseguire un’operazione AEM Forms.

Esegui un’operazione AEM Forms sul documento PDF sbloccato per soddisfare i requisiti aziendali. Se ad esempio si desidera applicare i diritti di utilizzo al documento di PDF sbloccato, passare il BLOB oggetto restituito da uno dei due unlockPDFUsingPassword o unlockPDFUsingCredential metodi per ReaderExtensionsServiceClient dell'oggetto applyUsageRights metodo.

Consulta anche

Determinare il tipo di crittografia utilizzando l’API Java

Determinazione del tipo di crittografia

È possibile determinare a livello di programmazione il tipo di crittografia che protegge un documento PDF utilizzando l'API Servizio di crittografia Java o l'API Servizio di crittografia del servizio Web. A volte è necessario determinare dinamicamente se un documento PDF è crittografato e, in tal caso, il tipo di crittografia. Ad esempio, è possibile determinare se un documento PDF è protetto con una crittografia basata su password o con una policy di Rights Management.

Un documento PDF può essere protetto dai seguenti tipi di crittografia:

Crittografia basata su password
Crittografia basata su certificati
Criterio creato dal servizio di Rights Management
Un altro tipo di crittografia

NOTA

Per ulteriori informazioni sul servizio Encryption, vedere Guida di riferimento dei servizi per AEM Forms.

Riepilogo dei passaggi

Per determinare il tipo di crittografia che protegge un documento PDF, effettuare le seguenti operazioni:

Includi file di progetto.
Creare un client del servizio di crittografia.
Ottieni il documento PDF crittografato.
Determinare il tipo di crittografia.

Includi file di progetto

I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-encryption-client.jar
adobe-utilities.jar (richiesto se AEM Forms è distribuito sul server applicazioni JBoss)
jbossall-client.jar (richiesto se AEM Forms è distribuito sul server applicazioni JBoss)

Creare un client di servizio

Ottieni il documento PDF crittografato

Ottieni 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 crittografia informa che il documento PDF non è protetto.

Consulta anche

Determinare il tipo di crittografia utilizzando l’API del servizio web

Inclusione dei file della libreria Java di AEM Forms

Protezione di documenti con criteri

Determinare il tipo di crittografia utilizzando l’API Java

Determina il tipo di crittografia che protegge un documento PDF utilizzando l’API di crittografia (Java):

Includi file di progetto.

Includi i file JAR dei client, ad esempio adobe-encryption-client.jar, nel percorso di classe del progetto Java.
Crea un client di servizio.
- Creare un ServiceClientFactory oggetto che contiene proprietà di connessione.
- Creare un EncryptionServiceClient mediante il costruttore e passando il ServiceClientFactory oggetto.
Ottieni il documento PDF crittografato.
- Creare un java.io.FileInputStream oggetto che rappresenta il documento PDF utilizzando il relativo costruttore e passando un valore stringa che specifica la posizione del documento PDF.
- Creare un com.adobe.idp.Document mediante il costruttore e passando il java.io.FileInputStream oggetto.
Determinare il tipo di crittografia.
- Determinare il tipo di crittografia richiamando EncryptionServiceClient dell'oggetto getPDFEncryption e passando il com.adobe.idp.Document oggetto che contiene il documento PDF. Questo metodo restituisce un EncryptionTypeResult oggetto.
- Richiama EncryptionTypeResult dell'oggetto getEncryptionType metodo. Questo metodo restituisce un EncryptionType valore enum che specifica il tipo di crittografia. Se, ad esempio, il documento PDF è protetto con la crittografia basata su password, questo metodo restituirà EncryptionType.PASSWORD.

Consulta anche

Quick Start (modalità SOAP): determinazione del tipo di crittografia tramite l’API Java

Inclusione dei file della libreria Java di AEM Forms

Determinare il tipo di crittografia utilizzando l’API del servizio web

Determina il tipo di crittografia che protegge un documento PDF utilizzando l’API di crittografia (servizio web):

Includi file di progetto.

Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1.

NOTA

Sostituisci localhost con l’indirizzo IP del server che ospita AEM Forms.
Crea un client di servizio.
- Creare un EncryptionServiceClient utilizzando il costruttore predefinito.
- Creare un EncryptionServiceClient.Endpoint.Address oggetto utilizzando System.ServiceModel.EndpointAddress costruttore. Passa un valore stringa che specifica il file WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/EncryptionService?WSDL.) Non è necessario utilizzare il lc_version attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
- Creare un System.ServiceModel.BasicHttpBinding dell'oggetto ottenendo il valore del EncryptionServiceClient.Endpoint.Binding campo. Invia il valore restituito a BasicHttpBinding.
- Imposta il System.ServiceModel.BasicHttpBinding dell'oggetto MessageEncoding campo a WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.
- Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
  - Assegna al campo il nome utente dei moduli AEM EncryptionServiceClient.ClientCredentials.UserName.UserName.
  - Assegna il valore password corrispondente al campo EncryptionServiceClient.ClientCredentials.UserName.Password.
  - Assegna il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.
Ottieni il documento PDF crittografato.
- Creare un BLOB mediante il costruttore.
- Creare un System.IO.FileStream oggetto richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF crittografato e la modalità di apertura del file.
- Creare una matrice di byte che memorizza il contenuto della System.IO.FileStream oggetto. È possibile determinare le dimensioni della matrice di byte ottenendo System.IO.FileStream dell'oggetto Length proprietà.
- Compilare la matrice di byte con i dati di flusso richiamando System.IO.FileStream dell'oggetto Read e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
- Popolare il BLOB mediante l'assegnazione del contenuto della matrice di byte BLOB dell'oggetto MTOM membro dati.
Determinare il tipo di crittografia.
- Richiama EncryptionServiceClient dell'oggetto getPDFEncryption e trasmettere il BLOB oggetto che contiene il documento PDF. Questo metodo restituisce un EncryptionTypeResult oggetto.
- Ottieni il valore di EncryptionTypeResult dell'oggetto encryptionType metodo dati. Se, ad esempio, il documento PDF è protetto con la crittografia basata su password, il valore di questo membro dati è EncryptionType.PASSWORD.

Consulta anche