Gli esempi e gli esempi contenuti in questo documento sono solo per l’ambiente AEM Forms su JEE.
Informazioni sul servizio Encryption
Il servizio Crittografia consente di crittografare 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 al contenuto. Se un documento PDF è crittografato con una password, l’utente deve specificare la password di apertura prima che il documento possa essere visualizzato 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 crittografare il documento PDF.
È possibile eseguire queste operazioni utilizzando il servizio Crittografia:
Per ulteriori informazioni sul servizio Encryption, vedere Guida di riferimento dei servizi per AEM Forms.
Quando crittografi un documento PDF con una password, un utente deve specificare la password per aprire il documento PDF in Adobe Reader o Acrobat. Inoltre, prima di poter eseguire sul documento un’altra operazione di AEM Forms, ad esempio la firma digitale del documento di PDF, è necessario sbloccare un documento di PDF crittografato con password.
Se carichi un documento PDF crittografato nell’archivio AEM Forms, non può decrittografare il documento PDF ed estrarre il contenuto XDP. È consigliabile non crittografare un documento prima di caricarlo nell’archivio AEM Forms. (vedere Scrittura delle risorse.)
Per ulteriori informazioni sul servizio Encryption, vedere Guida di riferimento dei servizi per AEM Forms.
Per crittografare un documento PDF con una password, effettuare le seguenti operazioni:
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:
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.
Ottieni un documento PDF da crittografare
Ottieni un documento PDF non crittografato per crittografare il documento con una password. Se si tenta di proteggere un documento PDF già crittografato, viene generata un'eccezione.
Impostare le opzioni di runtime della crittografia
Per crittografare un documento PDF con una password, è necessario specificare quattro valori, inclusi due valori di password. Il primo valore della password viene utilizzato per crittografare il documento PDF e deve essere specificato all'apertura del documento PDF. Il secondo valore della password, denominato password master, viene utilizzato per rimuovere la crittografia dal documento PDF. I valori delle password fanno distinzione tra maiuscole e minuscole e non possono essere uguali.
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. Se si crittografano solo gli allegati del documento, a un utente viene richiesta una password quando tenta di accedere ai file allegati.
Quando si crittografa 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 PasswordEncryptionPermission
valori di enumerazione.
Aggiungi la password
Dopo aver recuperato un documento di PDF non protetto e aver impostato i valori di runtime della crittografia, è possibile aggiungere una password al documento di 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 della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API servizio di crittografia
Crittografia di documenti PDF con certificati
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.
ServiceClientFactory
oggetto che contiene proprietà di connessione.EncryptionServiceClient
mediante il costruttore e passando il ServiceClientFactory
oggetto.Ottieni un documento PDF da crittografare.
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.com.adobe.idp.Document
mediante il costruttore e passando il java.io.FileInputStream
oggetto.Impostare le opzioni di runtime della crittografia.
PasswordEncryptionOptionSpec
richiamando il relativo costruttore.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
.java.util.List
oggetto che memorizza le autorizzazioni di crittografia utilizzando ArrayList
costruttore.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).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
.PasswordEncryptionOptionSpec
dell'oggetto setDocumentOpenPassword
e passando un valore stringa che rappresenta la password di apertura.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:
com.adobe.idp.Document
oggetto che contiene il documento PDF da crittografare con la password.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.
java.io.File
e assicurarsi che l'estensione del file sia .pdf.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
Impostazione delle proprietà di connessione
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
.
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à:
EncryptionServiceClient.ClientCredentials.UserName.UserName
.EncryptionServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Ottieni un documento PDF da crittografare.
BLOB
mediante il costruttore. Il BLOB
L'oggetto viene utilizzato per memorizzare un documento PDF crittografato con una password.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.System.IO.FileStream
oggetto. È possibile determinare le dimensioni della matrice di byte ottenendo System.IO.FileStream
dell'oggetto Length
proprietà.System.IO.FileStream
dell'oggetto Read
e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
mediante l'assegnazione del contenuto della matrice di byte BLOB
dell'oggetto MTOM
membro dati.Impostare le opzioni di runtime della crittografia.
PasswordEncryptionOptionSpec
mediante il costruttore.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.PasswordEncryptionCompatability
valore di enumerazione per PasswordEncryptionOptionSpec
dell'oggetto compatability
membro dati. Ad esempio, assegna PasswordEncryptionCompatability.ACRO_7
a questo membro dati.PasswordEncryptionOptionSpec
dell'oggetto documentOpenPassword
membro dati.PasswordEncryptionOptionSpec
dell'oggetto permissionPassword
membro dati.Aggiungi la password.
Crittografare il documento PDF richiamando EncryptionServiceClient
dell'oggetto encryptPDFUsingPassword
e fornendo i seguenti valori:
BLOB
oggetto che contiene il documento PDF da crittografare con la password.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.
System.IO.FileStream
richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF protetto.BLOB
oggetto restituito da encryptPDFUsingPassword
metodo. Popolare la matrice di byte ottenendo il valore della BLOB
dell'oggetto MTOM
membro dati.System.IO.BinaryWriter
oggetto richiamando il relativo costruttore e passando il System.IO.FileStream
oggetto.System.IO.BinaryWriter
dell'oggetto Write
e passando la matrice di byte.Consulta anche
Richiamare AEM Forms tramite MTOM
Richiamare AEM Forms con SwaRef
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 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.
Se carichi un documento PDF crittografato nell’archivio AEM Forms, non può decrittografare il documento PDF ed estrarre il contenuto XDP. È consigliabile non crittografare un documento prima di caricarlo nell’archivio AEM Forms. (vedere Scrittura delle risorse.)
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.)
Per ulteriori informazioni sul servizio Encryption, vedere Guida di riferimento dei servizi per AEM Forms.
Per crittografare un documento PDF con un certificato, effettuare le seguenti operazioni:
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:
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 Java
Crittografare un documento PDF con un certificato utilizzando l’API del servizio web
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API servizio di crittografia
Crittografia di documenti PDF con una password
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.
ServiceClientFactory
oggetto che contiene proprietà di connessione.EncryptionServiceClient
mediante il costruttore e passando il ServiceClientFactory
oggetto.Ottieni un documento PDF da crittografare.
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.com.adobe.idp.Document
mediante il costruttore e passando il java.io.FileInputStream
oggetto.Fai riferimento al certificato.
java.util.List
oggetto che memorizza le informazioni sulle autorizzazioni utilizzando il relativo costruttore.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
.Recipient
mediante il costruttore.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.com.adobe.idp.Document
mediante il costruttore e passando il java.io.FileInputStream
oggetto che rappresenta il certificato.Recipient
dell'oggetto setX509Cert
e trasmettere il com.adobe.idp.Document
oggetto che contiene il certificato. (Inoltre, il Recipient
L'oggetto può avere un alias del certificato Truststore o un URL LDAP come origine del certificato.)CertificateEncryptionIdentity
oggetto che memorizza le informazioni su autorizzazioni e certificati utilizzando il relativo costruttore.CertificateEncryptionIdentity
dell'oggetto setPerms
e trasmettere il java.util.List
oggetto che memorizza le informazioni sulle autorizzazioni.CertificateEncryptionIdentity
dell'oggetto setRecipient
e trasmettere il Recipient
oggetto che memorizza le informazioni sul certificato.java.util.List
oggetto che memorizza le informazioni sul certificato utilizzando il relativo costruttore.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.
CertificateEncryptionOptionSpec
richiamando il relativo costruttore.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
.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:
com.adobe.idp.Document
oggetto che contiene il documento PDF da crittografare.java.util.List
oggetto che memorizza le informazioni sul certificato.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.
java.io.File
e assicurarsi che l'estensione del nome file sia .pdf.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
Impostazione delle proprietà di connessione
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
.
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à:
EncryptionServiceClient.ClientCredentials.UserName.UserName
.EncryptionServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Ottieni un documento PDF da crittografare.
BLOB
mediante il costruttore. Il BLOB
L'oggetto viene utilizzato per memorizzare un documento PDF crittografato con un certificato.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.System.IO.FileStream
oggetto. È possibile determinare le dimensioni della matrice di byte ottenendo System.IO.FileStream
dell'oggetto Length
proprietà.System.IO.FileStream
dell'oggetto Read
e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
oggetto assegnando il relativo MTOM
con il contenuto della matrice di byte.Fai riferimento al certificato.
Recipient
mediante il costruttore. Questo oggetto memorizzerà le informazioni sul certificato.BLOB
mediante il costruttore. Questo BLOB
L'oggetto memorizzerà il certificato che crittografa il documento PDF.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.System.IO.FileStream
oggetto. È possibile determinare le dimensioni della matrice di byte ottenendo System.IO.FileStream
dell'oggetto Length
proprietà.System.IO.FileStream
dell'oggetto Read
e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
mediante l'assegnazione del contenuto della matrice di byte BLOB
dell'oggetto MTOM
membro dati.BLOB
oggetto che memorizza il certificato in Recipient
dell'oggetto x509Cert
membro dati.CertificateEncryptionIdentity
oggetto che memorizza le informazioni sul certificato utilizzando il relativo costruttore.Recipient
oggetto che memorizza il certificato in CertificateEncryptionIdentity
membro dati destinatario dell'oggetto.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.
CertificateEncryptionOptionSpec
mediante il costruttore.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.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:
BLOB
oggetto che contiene il documento PDF da crittografare.Object
array che memorizza le informazioni sui certificati.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.
System.IO.FileStream
richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF protetto.BLOB
oggetto restituito da encryptPDFUsingCertificates
metodo. Popolare la matrice di byte ottenendo il valore della BLOB
dell'oggetto binaryData
membro dati.System.IO.BinaryWriter
oggetto richiamando il relativo costruttore e passando il System.IO.FileStream
oggetto.System.IO.BinaryWriter
dell'oggetto Write
e passando la matrice di byte.Consulta anche
Richiamare AEM Forms tramite MTOM
Richiamare AEM Forms con SwaRef
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.
Per ulteriori informazioni sul servizio Encryption, vedere Guida di riferimento dei servizi per AEM Forms.
Per rimuovere la crittografia basata su certificato da un documento PDF, effettuare le seguenti operazioni:
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:
Creare un client del servizio 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 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.
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
Rimuovere la crittografia basata su certificati utilizzando l’API Java
Rimuovi la crittografia basata su certificati utilizzando l’API del servizio web
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API servizio di crittografia
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.
ServiceClientFactory
oggetto che contiene proprietà di connessione.EncryptionServiceClient
mediante il costruttore e passando il ServiceClientFactory
oggetto.Ottieni il documento PDF crittografato.
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.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:
com.adobe.idp.Document
oggetto che contiene il documento PDF crittografato.Il removePDFCertificateSecurity
il metodo restituisce un com.adobe.idp.Document
oggetto contenente un documento PDF non protetto.
Salvare il documento PDF.
java.io.File
e assicurarsi che l'estensione del file sia .pdf.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
Impostazione delle proprietà di connessione
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
.
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à:
EncryptionServiceClient.ClientCredentials.UserName.UserName
.EncryptionServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Ottieni il documento PDF crittografato.
BLOB
mediante il costruttore. Il BLOB
L'oggetto viene utilizzato per memorizzare il documento PDF crittografato.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.System.IO.FileStream
oggetto. È possibile determinare le dimensioni della matrice di byte ottenendo System.IO.FileStream
dell'oggetto Length
proprietà.System.IO.FileStream
dell'oggetto Read
e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.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:
BLOB
oggetto contenente dati di flusso di file che rappresenta un documento PDF crittografato.Il removePDFCredentialSecurity
il metodo restituisce un BLOB
oggetto contenente un documento PDF non protetto.
Salvare il documento PDF.
System.IO.FileStream
richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento di PDF non protetto.BLOB
oggetto restituito da removePDFPasswordSecurity
metodo. Popolare la matrice di byte ottenendo il valore della BLOB
dell'oggetto MTOM
membro dati.System.IO.BinaryWriter
oggetto richiamando il relativo costruttore e passando il System.IO.FileStream
oggetto.System.IO.BinaryWriter
dell'oggetto Write
e passando la matrice di byte.Consulta anche
Richiamare AEM Forms tramite MTOM
Richiamare AEM Forms con SwaRef
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.
Per ulteriori informazioni sul servizio Encryption, vedere Guida di riferimento dei servizi per AEM Forms.
Per rimuovere la crittografia basata su password da un documento PDF, effettuare le seguenti operazioni:
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:
Creare un client del servizio 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 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
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API servizio di crittografia
Crittografia di documenti PDF con una password
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.
ServiceClientFactory
oggetto che contiene proprietà di connessione.EncryptionServiceClient
mediante il costruttore e passando il ServiceClientFactory
oggetto.Ottieni il documento PDF crittografato.
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.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:
com.adobe.idp.Document
oggetto che contiene il documento PDF crittografato.Il removePDFPasswordSecurity
il metodo restituisce un com.adobe.idp.Document
oggetto contenente un documento PDF non protetto.
Salvare il documento PDF.
java.io.File
e assicurarsi che l'estensione del nome file sia .pdf.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 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
.
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à:
EncryptionServiceClient.ClientCredentials.UserName.UserName
.EncryptionServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Ottieni il documento PDF crittografato.
BLOB
mediante il costruttore. Il BLOB
L'oggetto viene utilizzato per memorizzare un documento PDF crittografato con password.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.System.IO.FileStream
oggetto. È possibile determinare le dimensioni della matrice di byte ottenendo System.IO.FileStream
dell'oggetto Length
proprietà.System.IO.FileStream
dell'oggetto Read
e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.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:
BLOB
oggetto contenente dati di flusso di file che rappresenta un documento PDF crittografato.Il removePDFPasswordSecurity
il metodo restituisce un BLOB
oggetto contenente un documento PDF non protetto.
Salvare il documento PDF.
System.IO.FileStream
richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento di PDF non protetto.BLOB
oggetto restituito da removePDFPasswordSecurity
metodo. Popolare la matrice di byte ottenendo il valore della BLOB
dell'oggetto MTOM
membro dati.System.IO.BinaryWriter
oggetto richiamando il relativo costruttore e passando il System.IO.FileStream
oggetto.System.IO.BinaryWriter
dell'oggetto Write
e passando la matrice di byte.Consulta anche
Richiamare AEM Forms tramite MTOM
Richiamare AEM Forms con SwaRef
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.
Per ulteriori informazioni sul servizio Encryption, vedere Guida di riferimento dei servizi per AEM Forms.
Per sbloccare un documento PDF crittografato, effettuare le seguenti operazioni:
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:
Creare un client del servizio 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 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
Sbloccare un documento PDF crittografato utilizzando l’API Java
Sblocca un documento PDF crittografato utilizzando l’API del servizio web
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API servizio di crittografia
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.
ServiceClientFactory
oggetto che contiene proprietà di connessione.EncryptionServiceClient
mediante il costruttore e passando il ServiceClientFactory
oggetto.Ottieni il documento PDF crittografato.
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.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:
com.adobe.idp.Document
oggetto contenente il documento PDF crittografato con password.Per sbloccare un documento PDF crittografato con un certificato, richiama unlockPDFUsingCredential
e trasmettere i seguenti valori:
com.adobe.idp.Document
oggetto che contiene il documento PDF crittografato con certificato.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
Guida rapida (modalità SOAP): sblocco di un documento PDF crittografato tramite l’API Java (modalità SOAP)
Applicazione dei diritti di utilizzo ai documenti di PDF
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
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
.
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à:
EncryptionServiceClient.ClientCredentials.UserName.UserName
.EncryptionServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Ottieni un documento PDF crittografato.
BLOB
mediante il costruttore.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.System.IO.FileStream
oggetto. È possibile determinare le dimensioni della matrice di byte ottenendo System.IO.FileStream
dell'oggetto Length
proprietà.System.IO.FileStream
dell'oggetto Read
e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.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:
BLOB
oggetto contenente il documento PDF crittografato con password.Per sbloccare un documento PDF crittografato con un certificato, richiama unlockPDFUsingCredential
e trasmettere i seguenti valori:
BLOB
oggetto che contiene il documento PDF crittografato con certificato.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
Richiamare AEM Forms tramite MTOM
Richiamare AEM Forms con SwaRef
È 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:
Per ulteriori informazioni sul servizio Encryption, vedere Guida di riferimento dei servizi per AEM Forms.
Per determinare il tipo di crittografia che protegge un documento PDF, effettuare le seguenti operazioni:
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:
Creare un client di servizio
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 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 Java
Determinare il tipo di crittografia utilizzando l’API del servizio web
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API servizio di crittografia
Protezione di documenti con criteri
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.
ServiceClientFactory
oggetto che contiene proprietà di connessione.EncryptionServiceClient
mediante il costruttore e passando il ServiceClientFactory
oggetto.Ottieni il documento PDF crittografato.
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.com.adobe.idp.Document
mediante il costruttore e passando il java.io.FileInputStream
oggetto.Determinare il tipo di crittografia.
EncryptionServiceClient
dell'oggetto getPDFEncryption
e passando il com.adobe.idp.Document
oggetto che contiene il documento PDF. Questo metodo restituisce un EncryptionTypeResult
oggetto.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
Impostazione delle proprietà di connessione
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
.
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à:
EncryptionServiceClient.ClientCredentials.UserName.UserName
.EncryptionServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Ottieni il documento PDF crittografato.
BLOB
mediante il costruttore.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.System.IO.FileStream
oggetto. È possibile determinare le dimensioni della matrice di byte ottenendo System.IO.FileStream
dell'oggetto Length
proprietà.System.IO.FileStream
dell'oggetto Read
e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
mediante l'assegnazione del contenuto della matrice di byte BLOB
dell'oggetto MTOM
membro dati.Determinare il tipo di crittografia.
EncryptionServiceClient
dell'oggetto getPDFEncryption
e trasmettere il BLOB
oggetto che contiene il documento PDF. Questo metodo restituisce un EncryptionTypeResult
oggetto.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