Crittografia e decrittografia dei documenti di PDF encrypting-and-decrypting-pdf-documents

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 oggetto ServiceClientFactory contenente le proprietà di connessione.
• Creare un oggetto EncryptionServiceClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

Ottieni un documento PDF da crittografare.

• Creare un oggetto java.io.FileInputStream 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 oggetto com.adobe.idp.Document utilizzando il relativo costruttore e passando l'oggetto java.io.FileInputStream.

Impostare le opzioni di runtime della crittografia.

• Creare un oggetto PasswordEncryptionOptionSpec richiamando il relativo costruttore.
• Specificare le risorse documento PDF da crittografare richiamando il metodo setEncryptOption dell'oggetto PasswordEncryptionOptionSpec e passando un valore di enumerazione PasswordEncryptionOption che specifica le risorse documento da crittografare. Per crittografare, ad esempio, l'intero documento di PDF, inclusi i metadati e gli allegati, specificare PasswordEncryptionOption.ALL.
• Creare un oggetto java.util.List che memorizza le autorizzazioni di crittografia utilizzando il costruttore ArrayList.
• Specificare un'autorizzazione richiamando il metodo add dell'oggetto java.util.List e passando un valore di enumerazione corrispondente all'autorizzazione che si desidera impostare. Per impostare ad esempio l'autorizzazione che consente a un utente di copiare i dati nel documento PDF, specificare PasswordEncryptionPermission.PASSWORD_EDIT_COPY. (Ripeti questo passaggio per ogni autorizzazione da impostare).
• Specificare l'opzione di compatibilità Acrobat richiamando il metodo setCompatability dell'oggetto PasswordEncryptionOptionSpec e passando un valore di enumerazione che specifica il livello di compatibilità Acrobat. Ad esempio, è possibile specificare PasswordEncryptionCompatability.ACRO_7.
• Specificare il valore della password che consente a un utente di aprire il documento PDF crittografato richiamando il metodo setDocumentOpenPassword dell'oggetto PasswordEncryptionOptionSpec 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 il metodo setPermissionPassword dell'oggetto PasswordEncryptionOptionSpec e passando un valore stringa che rappresenta la password master.

Aggiungi la password.

Crittografare il documento PDF richiamando il metodo encryptPDFUsingPassword dell'oggetto EncryptionServiceClient e passando i valori seguenti:

• L'oggetto com.adobe.idp.Document che contiene il documento PDF da crittografare con la password.
• L'oggetto PasswordEncryptionOptionSpec che contiene le opzioni di runtime della crittografia.

Il metodo encryptPDFUsingPassword restituisce un oggetto com.adobe.idp.Document contenente un documento PDF crittografato con password.

Salvare il documento PDF crittografato come file PDF.

• Creare un oggetto java.io.File e verificare che l'estensione del file sia .pdf.
• Richiama il metodo copyToFile dell'oggetto com.adobe.idp.Document per copiare il contenuto dell'oggetto com.adobe.idp.Document nel file. Assicurarsi di utilizzare l'oggetto com.adobe.idp.Document restituito dal metodo encryptPDFUsingPassword.

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.

Creare un oggetto API client di crittografia.

• Creare un oggetto EncryptionServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto EncryptionServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/EncryptionService?WSDL). Non è necessario utilizzare l'attributo lc_version. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)

• Creare un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo EncryptionServiceClient.Endpoint.Binding. Eseguire il cast del valore restituito in BasicHttpBinding.

• Impostare il campo MessageEncoding dell'oggetto System.ServiceModel.BasicHttpBinding su WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.

• Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:

  • Assegnare il nome utente dei moduli AEM al campo EncryptionServiceClient.ClientCredentials.UserName.UserName.
  • Assegnare il valore della password corrispondente al campo EncryptionServiceClient.ClientCredentials.UserName.Password.
  • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

Ottieni un documento PDF da crittografare.

• Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare un documento PDF crittografato con una password.
• Creare un oggetto System.IO.FileStream richiamandone 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 dell'oggetto System.IO.FileStream. È possibile determinare le dimensioni della matrice di byte ottenendo la proprietà Length dell'oggetto System.IO.FileStream.
• Compilare la matrice di byte con i dati di flusso richiamando il metodo Read dell'oggetto System.IO.FileStream e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
• Compilare l'oggetto BLOB assegnando il contenuto della matrice di byte al membro dati MTOM dell'oggetto BLOB.

Impostare le opzioni di runtime della crittografia.

• Creare un oggetto PasswordEncryptionOptionSpec utilizzando il relativo costruttore.
• Specificare le risorse del documento PDF da crittografare assegnando un valore di enumerazione PasswordEncryptionOption al membro dati encryptOption dell'oggetto PasswordEncryptionOptionSpec. Per crittografare l'intero PDF, inclusi i metadati e gli allegati, assegnare PasswordEncryptionOption.ALL a questo membro dati.
• Specificare l'opzione di compatibilità di Acrobat assegnando un valore di enumerazione PasswordEncryptionCompatability al membro dati compatability dell'oggetto PasswordEncryptionOptionSpec. Ad esempio, assegnare PasswordEncryptionCompatability.ACRO_7 a questo membro dati.
• Specificare 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 membro dati documentOpenPassword dell'oggetto PasswordEncryptionOptionSpec.
• 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 membro dati permissionPassword dell'oggetto PasswordEncryptionOptionSpec.

Aggiungi la password.

Crittografare il documento PDF richiamando il metodo encryptPDFUsingPassword dell'oggetto EncryptionServiceClient e passando i valori seguenti:

• L'oggetto BLOB che contiene il documento PDF da crittografare con la password.
• L'oggetto PasswordEncryptionOptionSpec che contiene le opzioni di runtime della crittografia.

Il metodo encryptPDFUsingPassword restituisce un oggetto BLOB contenente un documento PDF crittografato con password.

Salvare il documento PDF crittografato come file PDF.

• Creare un oggetto System.IO.FileStream richiamandone il 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 dell'oggetto BLOB restituito dal metodo encryptPDFUsingPassword. Popolare la matrice di byte ottenendo il valore del membro dati MTOM dell'oggetto BLOB.
• Creare un oggetto System.IO.BinaryWriter richiamandone il costruttore e passando l'oggetto System.IO.FileStream.
• Scrivere il contenuto della matrice di byte in un file PDF richiamando il metodo Write dell'oggetto System.IO.BinaryWriter e passando la matrice di byte.

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 oggetto ServiceClientFactory contenente le proprietà di connessione.
• Creare un oggetto EncryptionServiceClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

Ottieni un documento PDF da crittografare.

• Creare un oggetto java.io.FileInputStream 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 oggetto com.adobe.idp.Document utilizzando il relativo costruttore e passando l'oggetto java.io.FileInputStream.

Fai riferimento al certificato.

• Creare un oggetto java.util.List che memorizza le informazioni sulle autorizzazioni utilizzando il relativo costruttore.
• Specificare l'autorizzazione associata al documento crittografato richiamando il metodo add dell'oggetto java.util.List e passando un valore di enumerazione CertificateEncryptionPermissions che rappresenta le autorizzazioni concesse all'utente che apre il documento PDF protetto. Ad esempio, per specificare tutte le autorizzazioni, passare CertificateEncryptionPermissions.PKI_ALL_PERM.
• Creare un oggetto Recipient utilizzando il relativo costruttore.
• Creare un oggetto java.io.FileInputStream 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 oggetto com.adobe.idp.Document utilizzando il relativo costruttore e passando l'oggetto java.io.FileInputStream che rappresenta il certificato.
• Richiama il metodo setX509Cert dell'oggetto Recipient e passa l'oggetto com.adobe.idp.Document che contiene il certificato. Inoltre, l'oggetto Recipient può avere un alias di certificato Truststore o un URL LDAP come origine di certificato.
• Creare un oggetto CertificateEncryptionIdentity che memorizza le informazioni sulle autorizzazioni e sui certificati utilizzando il relativo costruttore.
• Richiama il metodo setPerms dell'oggetto CertificateEncryptionIdentity e passa l'oggetto java.util.List che memorizza le informazioni sulle autorizzazioni.
• Richiama il metodo setRecipient dell'oggetto CertificateEncryptionIdentity e passa l'oggetto Recipient che memorizza le informazioni sul certificato.
• Creare un oggetto java.util.List che memorizza le informazioni sul certificato utilizzando il relativo costruttore.
• Richiama il metodo add dell'oggetto java.util.List e passa l'oggetto CertificateEncryptionIdentity. L'oggetto java.util.List viene passato come parametro al metodo encryptPDFUsingCertificates.

Impostare le opzioni di runtime della crittografia.

• Creare un oggetto CertificateEncryptionOptionSpec richiamando il relativo costruttore.
• Specificare le risorse documento PDF da crittografare richiamando il metodo setOption dell'oggetto CertificateEncryptionOptionSpec e passando un valore di enumerazione CertificateEncryptionOption che specifica le risorse documento da crittografare. Per crittografare, ad esempio, l'intero documento di PDF, inclusi i metadati e gli allegati, specificare CertificateEncryptionOption.ALL.
• Specificare l'opzione di compatibilità Acrobat richiamando il metodo setCompat dell'oggetto CertificateEncryptionOptionSpec e passando un valore di enumerazione CertificateEncryptionCompatibility che specifica il livello di compatibilità Acrobat. Ad esempio, è possibile specificare CertificateEncryptionCompatibility.ACRO_7.

Crea un documento PDF crittografato con certificato.

Crittografare il documento PDF con un certificato richiamando il metodo encryptPDFUsingCertificates dell'oggetto EncryptionServiceClient e passando i valori seguenti:

• L'oggetto com.adobe.idp.Document che contiene il documento PDF da crittografare.
• Oggetto java.util.List che memorizza le informazioni sul certificato.
• L'oggetto CertificateEncryptionOptionSpec che contiene le opzioni di runtime della crittografia.

Il metodo encryptPDFUsingCertificates restituisce un oggetto com.adobe.idp.Document contenente un documento PDF crittografato con certificato.

Salvare il documento PDF crittografato come file PDF.

• Creare un oggetto java.io.File e verificare che l'estensione del nome file sia pdf.
• Richiama il metodo copyToFile dell'oggetto com.adobe.idp.Document per copiare il contenuto dell'oggetto com.adobe.idp.Document nel file. Assicurarsi di utilizzare l'oggetto com.adobe.idp.Document restituito dal metodo encryptPDFUsingCertificates.

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.

Creare un oggetto API client di crittografia.

• Creare un oggetto EncryptionServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto EncryptionServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/EncryptionService?WSDL). Non è necessario utilizzare l'attributo lc_version. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)

• Creare un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo EncryptionServiceClient.Endpoint.Binding. Eseguire il cast del valore restituito in BasicHttpBinding.

• Impostare il campo MessageEncoding dell'oggetto System.ServiceModel.BasicHttpBinding su WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.

• Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:

  • Assegnare il nome utente dei moduli AEM al campo EncryptionServiceClient.ClientCredentials.UserName.UserName.
  • Assegnare il valore della password corrispondente al campo EncryptionServiceClient.ClientCredentials.UserName.Password.
  • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

Ottieni un documento PDF da crittografare.

• Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per archiviare un documento PDF crittografato con un certificato.
• Creare un oggetto System.IO.FileStream richiamandone 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 dell'oggetto System.IO.FileStream. È possibile determinare le dimensioni della matrice di byte ottenendo la proprietà Length dell'oggetto System.IO.FileStream.
• Compilare la matrice di byte con i dati di flusso richiamando il metodo Read dell'oggetto System.IO.FileStream e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
• Compilare l'oggetto BLOB assegnando la relativa proprietà MTOM al contenuto della matrice di byte.

Fai riferimento al certificato.

• Creare un oggetto Recipient utilizzando il relativo costruttore. Questo oggetto memorizzerà le informazioni sul certificato.
• Creare un oggetto BLOB utilizzando il relativo costruttore. Questo oggetto BLOB memorizzerà il certificato che crittografa il documento PDF.
• Creare un oggetto System.IO.FileStream richiamandone 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 dell'oggetto System.IO.FileStream. È possibile determinare le dimensioni della matrice di byte ottenendo la proprietà Length dell'oggetto System.IO.FileStream.
• Compilare la matrice di byte con i dati di flusso richiamando il metodo Read dell'oggetto System.IO.FileStream e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
• Compilare l'oggetto BLOB assegnando il contenuto della matrice di byte al membro dati MTOM dell'oggetto BLOB.
• Assegnare l'oggetto BLOB che memorizza il certificato al membro dati x509Cert dell'oggetto Recipient.
• Creare un oggetto CertificateEncryptionIdentity che memorizza le informazioni sul certificato utilizzando il relativo costruttore.
• Assegnare l'oggetto Recipient che memorizza il certificato al membro dati destinatario dell'oggetto CertificateEncryptionIdentity.
• Creare un array Object e assegnare l'oggetto CertificateEncryptionIdentity al primo elemento dell'array Object. Questo array Object è passato come parametro al metodo encryptPDFUsingCertificates.

Impostare le opzioni di runtime della crittografia.

• Creare un oggetto CertificateEncryptionOptionSpec utilizzando il relativo costruttore.
• Specificare le risorse del documento PDF da crittografare assegnando un valore di enumerazione CertificateEncryptionOption al membro dati option dell'oggetto CertificateEncryptionOptionSpec. Per crittografare l'intero documento PDF, inclusi i metadati e gli allegati, assegnare CertificateEncryptionOption.ALL a questo membro dati.
• Specificare l'opzione di compatibilità di Acrobat assegnando un valore di enumerazione CertificateEncryptionCompatibility al membro dati compat dell'oggetto CertificateEncryptionOptionSpec. Ad esempio, assegnare CertificateEncryptionCompatibility.ACRO_7 a questo membro dati.

Crea un documento PDF crittografato con certificato.

Crittografare il documento PDF con un certificato richiamando il metodo encryptPDFUsingCertificates dell'oggetto EncryptionServiceService e passando i valori seguenti:

• L'oggetto BLOB che contiene il documento PDF da crittografare.
• L'array Object che memorizza le informazioni sul certificato.
• L'oggetto CertificateEncryptionOptionSpec che contiene le opzioni di runtime della crittografia.

Il metodo encryptPDFUsingCertificates restituisce un oggetto BLOB contenente un documento PDF crittografato con certificato.

Salvare il documento PDF crittografato come file PDF.

• Creare un oggetto System.IO.FileStream richiamandone il 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 dell'oggetto BLOB restituito dal metodo encryptPDFUsingCertificates. Popolare la matrice di byte ottenendo il valore del membro dati binaryData dell'oggetto BLOB.
• Creare un oggetto System.IO.BinaryWriter richiamandone il costruttore e passando l'oggetto System.IO.FileStream.
• Scrivere il contenuto della matrice di byte in un file PDF richiamando il metodo Write dell'oggetto System.IO.BinaryWriter e passando la matrice di byte.

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 oggetto ServiceClientFactory contenente le proprietà di connessione.
• Creare un oggetto EncryptionServiceClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

Ottieni il documento PDF crittografato.

• Creare un oggetto java.io.FileInputStream 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 oggetto com.adobe.idp.Document utilizzando il relativo costruttore e passando l'oggetto java.io.FileInputStream.

Rimuovi la crittografia.

Rimuovere la crittografia basata su certificato dal documento PDF richiamando il metodo removePDFCertificateSecurity dell'oggetto EncryptionServiceClient e passando i valori seguenti:

• L'oggetto com.adobe.idp.Document 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 metodo removePDFCertificateSecurity restituisce un oggetto com.adobe.idp.Document contenente un documento PDF non protetto.

Salvare il documento PDF.

• Creare un oggetto java.io.File e verificare che l'estensione del file sia .pdf.
• Richiama il metodo copyToFile dell'oggetto com.adobe.idp.Document per copiare il contenuto dell'oggetto Document nel file. Assicurarsi di utilizzare l'oggetto com.adobe.idp.Document restituito dal metodo removePDFCredentialSecurity.

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.

Creare un client del servizio di crittografia.

• Creare un oggetto EncryptionServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto EncryptionServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/EncryptionService?WSDL). Non è necessario utilizzare l'attributo lc_version. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)

• Creare un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo EncryptionServiceClient.Endpoint.Binding. Eseguire il cast del valore restituito in BasicHttpBinding.

• Impostare il campo MessageEncoding dell'oggetto System.ServiceModel.BasicHttpBinding su WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.

• Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:

  • Assegnare il nome utente dei moduli AEM al campo EncryptionServiceClient.ClientCredentials.UserName.UserName.
  • Assegnare il valore della password corrispondente al campo EncryptionServiceClient.ClientCredentials.UserName.Password.
  • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

Ottieni il documento PDF crittografato.

• Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per archiviare il documento PDF crittografato.
• Creare un oggetto System.IO.FileStream richiamandone il 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 dell'oggetto System.IO.FileStream. È possibile determinare le dimensioni della matrice di byte ottenendo la proprietà Length dell'oggetto System.IO.FileStream.
• Compilare la matrice di byte con i dati di flusso richiamando il metodo Read dell'oggetto System.IO.FileStream e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
• Compilare l'oggetto BLOB assegnando il contenuto della matrice di byte al membro dati MTOM dell'oggetto BLOB.

Rimuovi la crittografia.

Richiama il metodo removePDFCertificateSecurity dell'oggetto EncryptionServiceClient e passa i seguenti valori:

• L'oggetto BLOB che contiene i dati del 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 metodo removePDFCredentialSecurity restituisce un oggetto BLOB contenente un documento PDF non protetto.

Salvare il documento PDF.

• Creare un oggetto System.IO.FileStream richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF non protetto.
• Creare una matrice di byte che memorizza il contenuto dell'oggetto BLOB restituito dal metodo removePDFPasswordSecurity. Popolare la matrice di byte ottenendo il valore del membro dati MTOM dell'oggetto BLOB.
• Creare un oggetto System.IO.BinaryWriter richiamandone il costruttore e passando l'oggetto System.IO.FileStream.
• Scrivere il contenuto della matrice di byte in un file PDF richiamando il metodo Write dell'oggetto System.IO.BinaryWriter e passando la matrice di byte.

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 oggetto ServiceClientFactory contenente le proprietà di connessione.
• Creare un oggetto EncryptionServiceClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

Ottieni il documento PDF crittografato.

• Creare un oggetto java.io.FileInputStream che rappresenta il documento PDF crittografato utilizzando il relativo costruttore e passando un valore stringa che specifica la posizione del documento PDF.
• Creare un oggetto com.adobe.idp.Document utilizzando il relativo costruttore e passando l'oggetto java.io.FileInputStream.

Rimuovi la password.

Rimuovere la crittografia basata su password dal documento PDF richiamando il metodo removePDFPasswordSecurity dell'oggetto EncryptionServiceClient e passando i valori seguenti:

• Oggetto com.adobe.idp.Document contenente il documento PDF crittografato.
• Valore string che specifica il valore della password master utilizzato per rimuovere la crittografia dal documento PDF.

Il metodo removePDFPasswordSecurity restituisce un oggetto com.adobe.idp.Document contenente un documento PDF non protetto.

Salvare il documento PDF.

• Creare un oggetto java.io.File e verificare che l'estensione del nome file sia pdf.
• Richiama il metodo copyToFile dell'oggetto com.adobe.idp.Document per copiare il contenuto dell'oggetto Document nel file. Assicurarsi di utilizzare l'oggetto Document restituito dal metodo removePDFPasswordSecurity.

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.

Creare un client del servizio di crittografia.

• Creare un oggetto EncryptionServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto EncryptionServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/EncryptionService?WSDL). Non è necessario utilizzare l'attributo lc_version. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)

• Creare un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo EncryptionServiceClient.Endpoint.Binding. Eseguire il cast del valore restituito in BasicHttpBinding.

• Impostare il campo MessageEncoding dell'oggetto System.ServiceModel.BasicHttpBinding su WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.

• Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:

  • Assegnare il nome utente dei moduli AEM al campo EncryptionServiceClient.ClientCredentials.UserName.UserName.
  • Assegnare il valore della password corrispondente al campo EncryptionServiceClient.ClientCredentials.UserName.Password.
  • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

Ottieni il documento PDF crittografato.

• Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare un documento PDF crittografato con password.
• Creare un oggetto System.IO.FileStream richiamandone il 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 dell'oggetto System.IO.FileStream. È possibile determinare le dimensioni della matrice di byte ottenendo la proprietà Length dell'oggetto System.IO.FileStream.
• Compilare la matrice di byte con i dati di flusso richiamando il metodo Read dell'oggetto System.IO.FileStream e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
• Compilare l'oggetto BLOB assegnando il contenuto della matrice di byte al membro dati MTOM dell'oggetto BLOB.

Rimuovi la password.

Richiama il metodo removePDFPasswordSecurity dell'oggetto EncryptionServiceService e passa i seguenti valori:

• L'oggetto BLOB che contiene i dati del 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 metodo removePDFPasswordSecurity restituisce un oggetto BLOB contenente un documento PDF non protetto.

Salvare il documento PDF.

• Creare un oggetto System.IO.FileStream richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF non protetto.
• Creare una matrice di byte che memorizza il contenuto dell'oggetto BLOB restituito dal metodo removePDFPasswordSecurity. Popolare la matrice di byte ottenendo il valore del membro dati MTOM dell'oggetto BLOB.
• Creare un oggetto System.IO.BinaryWriter richiamandone il costruttore e passando l'oggetto System.IO.FileStream.
• Scrivere il contenuto della matrice di byte in un file PDF richiamando il metodo Write dell'oggetto System.IO.BinaryWriter e passando la matrice di byte.

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 oggetto ServiceClientFactory contenente le proprietà di connessione.
• Creare un oggetto EncryptionServiceClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

Ottieni il documento PDF crittografato.

• Creare un oggetto java.io.FileInputStream 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 oggetto com.adobe.idp.Document utilizzando il relativo costruttore e passando l'oggetto java.io.FileInputStream.

Sblocca il documento.

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

Per sbloccare un documento PDF crittografato con una password, richiamare il metodo unlockPDFUsingPassword e passare i valori seguenti:

• Oggetto com.adobe.idp.Document 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, richiamare il metodo unlockPDFUsingCredential e passare i valori seguenti:

• Oggetto com.adobe.idp.Document contenente 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.

I metodi unlockPDFUsingPassword e unlockPDFUsingCredential restituiscono entrambi un oggetto com.adobe.idp.Document 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 PDF sbloccato, passare l'oggetto com.adobe.idp.Document restituito dai metodi unlockPDFUsingPassword o unlockPDFUsingCredential al metodo applyUsageRights dell'oggetto ReaderExtensionsServiceClient.

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.

Creare un client del servizio di crittografia.

• Creare un oggetto EncryptionServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto EncryptionServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/EncryptionService?WSDL). Non è necessario utilizzare l'attributo lc_version. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)

• Creare un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo EncryptionServiceClient.Endpoint.Binding. Eseguire il cast del valore restituito in BasicHttpBinding.

• Impostare il campo MessageEncoding dell'oggetto System.ServiceModel.BasicHttpBinding su WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.

• Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:

  • Assegnare il nome utente dei moduli AEM al campo EncryptionServiceClient.ClientCredentials.UserName.UserName.
  • Assegnare il valore della password corrispondente al campo EncryptionServiceClient.ClientCredentials.UserName.Password.
  • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

Ottieni un documento PDF crittografato.

• Creare un oggetto BLOB utilizzando il relativo costruttore.
• Creare un oggetto System.IO.FileStream richiamandone il 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 dell'oggetto System.IO.FileStream. È possibile determinare le dimensioni della matrice di byte ottenendo la proprietà Length dell'oggetto System.IO.FileStream.
• Compilare la matrice di byte con i dati di flusso richiamando il metodo Read dell'oggetto System.IO.FileStream e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
• Compilare l'oggetto BLOB assegnando il contenuto della matrice di byte al membro dati MTOM dell'oggetto BLOB.

Sblocca il documento.

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

Per sbloccare un documento PDF crittografato con una password, richiamare il metodo unlockPDFUsingPassword e passare i valori seguenti:

• Oggetto BLOB 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, richiamare il metodo unlockPDFUsingCredential e passare i valori seguenti:

• Oggetto BLOB contenente 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.

I metodi unlockPDFUsingPassword e unlockPDFUsingCredential restituiscono entrambi un oggetto com.adobe.idp.Document 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 PDF sbloccato, passare l'oggetto BLOB restituito dai metodi unlockPDFUsingPassword o unlockPDFUsingCredential al metodo applyUsageRights dell'oggetto ReaderExtensionsServiceClient.

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 oggetto ServiceClientFactory contenente le proprietà di connessione.
• Creare un oggetto EncryptionServiceClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

Ottieni il documento PDF crittografato.

• Creare un oggetto java.io.FileInputStream che rappresenta il documento PDF utilizzando il relativo costruttore e passando un valore stringa che specifica la posizione del documento PDF.
• Creare un oggetto com.adobe.idp.Document utilizzando il relativo costruttore e passando l'oggetto java.io.FileInputStream.

Determinare il tipo di crittografia.

• Determinare il tipo di crittografia richiamando il metodo getPDFEncryption dell'oggetto EncryptionServiceClient e passando l'oggetto com.adobe.idp.Document che contiene il documento PDF. Questo metodo restituisce un oggetto EncryptionTypeResult.
• Richiama il metodo getEncryptionType dell'oggetto EncryptionTypeResult. Questo metodo restituisce un valore enum EncryptionType che specifica il tipo di crittografia. Se ad esempio il documento PDF è protetto con la crittografia basata su password, questo metodo restituisce EncryptionType.PASSWORD.

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.

Crea un client di servizio.

• Creare un oggetto EncryptionServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto EncryptionServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/EncryptionService?WSDL). Non è necessario utilizzare l'attributo lc_version. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)

• Creare un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo EncryptionServiceClient.Endpoint.Binding. Eseguire il cast del valore restituito in BasicHttpBinding.

• Impostare il campo MessageEncoding dell'oggetto System.ServiceModel.BasicHttpBinding su WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.

• Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:

  • Assegnare il nome utente dei moduli AEM al campo EncryptionServiceClient.ClientCredentials.UserName.UserName.
  • Assegnare il valore della password corrispondente al campo EncryptionServiceClient.ClientCredentials.UserName.Password.
  • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

Ottieni il documento PDF crittografato.

• Creare un oggetto BLOB utilizzando il relativo costruttore.
• Creare un oggetto System.IO.FileStream richiamandone il 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 dell'oggetto System.IO.FileStream. È possibile determinare le dimensioni della matrice di byte ottenendo la proprietà Length dell'oggetto System.IO.FileStream.
• Compilare la matrice di byte con i dati di flusso richiamando il metodo Read dell'oggetto System.IO.FileStream e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
• Compilare l'oggetto BLOB assegnando il contenuto della matrice di byte al membro dati MTOM dell'oggetto BLOB.

Determinare il tipo di crittografia.

• Richiama il metodo getPDFEncryption dell'oggetto EncryptionServiceClient e passa l'oggetto BLOB che contiene il documento PDF. Questo metodo restituisce un oggetto EncryptionTypeResult.
• Ottiene il valore del metodo dati encryptionType dell'oggetto EncryptionTypeResult. Se ad esempio il documento PDF è protetto con crittografia basata su password, il valore di questo membro dati è EncryptionType.PASSWORD.