Protezione di documenti con criteri protecting-documents-with-policies

Includi file di progetto.

Includi i file JAR dei client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.

Crea un oggetto API client di Document Security.

• Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
• Creare un oggetto DocumentSecurityClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

Impostare gli attributi del criterio.

• Creare un oggetto Policy richiamando il metodo createPolicy statico dell'oggetto InfomodelObjectFactory. Questo metodo restituisce un oggetto Policy.
• Impostare l'attributo name del criterio richiamando il metodo setName dell'oggetto Policy e passando un valore stringa che specifica il nome del criterio.
• Impostare la descrizione del criterio richiamando il metodo setDescription dell'oggetto Policy e passando un valore stringa che specifica la descrizione del criterio.
• Specificare il set di criteri a cui appartiene il nuovo criterio richiamando il metodo setPolicySetName dell'oggetto Policy e passando un valore stringa che specifica il nome del set di criteri. È possibile specificare null per il valore di questo parametro che determina l'aggiunta del criterio al set di criteri Criteri personali.
• Creare il periodo di validità del criterio richiamando il metodo createValidityPeriod statico dell'oggetto InfomodelObjectFactory. Questo metodo restituisce un oggetto ValidityPeriod.
• Impostare il numero di giorni per i quali un documento protetto tramite policy è accessibile richiamando il metodo setRelativeExpirationDays dell'oggetto ValidityPeriod e passando un valore intero che specifica il numero di giorni.
• Impostare il periodo di validità del criterio richiamando il metodo setValidityPeriod dell'oggetto Policy e passando l'oggetto ValidityPeriod.

Crea una voce criterio.

• Creare una voce dei criteri richiamando il metodo createPolicyEntry statico dell'oggetto InfomodelObjectFactory. Questo metodo restituisce un oggetto PolicyEntry.
• Specificare le autorizzazioni del criterio richiamando il metodo createPermission statico dell'oggetto InfomodelObjectFactory. Passa un membro dati statico che appartiene all'interfaccia Permission che rappresenta l'autorizzazione. Questo metodo restituisce un oggetto Permission. Per aggiungere ad esempio l'autorizzazione che consente agli utenti di copiare dati da un documento PDF protetto tramite policy, passare Permission.COPY. (Ripeti questo passaggio per ogni autorizzazione da aggiungere).
• Aggiungere l'autorizzazione alla voce dei criteri richiamando il metodo addPermission dell'oggetto PolicyEntry e passando l'oggetto Permission. Ripetere questo passaggio per ogni oggetto Permission creato.
• Creare l'entità criterio richiamando il metodo createSpecialPrincipal statico dell'oggetto InfomodelObjectFactory. Passare un membro dati appartenente all'oggetto InfomodelObjectFactory che rappresenta l'entità. Questo metodo restituisce un oggetto Principal. Ad esempio, per aggiungere l'editore del documento come entità principale, passare InfomodelObjectFactory.PUBLISHER_PRINCIPAL.
• Aggiungere l'entità alla voce dei criteri richiamando il metodo setPrincipal dell'oggetto PolicyEntry e passando l'oggetto Principal.
• Aggiungere la voce del criterio richiamando il metodo addPolicyEntry dell'oggetto Policy e passando l'oggetto PolicyEntry.

Registra il criterio.

• Creare un oggetto PolicyManager richiamando il metodo getPolicyManager dell'oggetto DocumentSecurityClient.

• Registrare il criterio richiamando il metodo registerPolicy dell'oggetto PolicyManager e passando i valori seguenti:

  • Oggetto Policy che rappresenta il criterio da registrare.

• Valore stringa che rappresenta il set di criteri a cui appartiene il criterio.

Se si utilizza un account amministratore di AEM forms nelle impostazioni di connessione per creare l'oggetto DocumentSecurityClient, specificare il nome del set di criteri quando si richiama il metodo registerPolicy. Se si passa un valore null per il set di criteri, il criterio verrà creato nel set di criteri Criteri personali degli amministratori.

Se utilizzi un utente di Document Security nelle impostazioni di connessione, puoi richiamare il metodo registerPolicy sovraccarico che accetta solo i criteri. In altre parole, non è necessario specificare il nome del set di criteri. Tuttavia, il criterio viene aggiunto al set di criteri denominato Criteri personali. Se non si desidera aggiungere il nuovo criterio a questo set di criteri, specificare un nome per il set di criteri quando si richiama il metodo registerPolicy.

Includi file di progetto.

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

Crea un oggetto API client di Document Security.

• Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto DocumentSecurityServiceClient.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/RightsManagementService?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 RightsManagementServiceClient.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 RightsManagementServiceClient.ClientCredentials.UserName.UserName.
  • Assegnare il valore della password corrispondente al campo RightsManagementServiceClient.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.

Impostare gli attributi del criterio.

• Creare un oggetto PolicySpec utilizzando il relativo costruttore.
• Impostare il nome del criterio assegnando un valore stringa al membro dati name dell'oggetto PolicySpec.
• Impostare la descrizione del criterio assegnando un valore stringa al membro dati description dell'oggetto PolicySpec.
• Specificare il set di criteri a cui appartiene il criterio assegnando un valore stringa al membro dati policySetName dell'oggetto PolicySpec. Specificare un nome di set di criteri esistente. È possibile specificare null per il valore di questo parametro che determina l'aggiunta del criterio a Criteri personali.
• Impostare il periodo di lease offline del criterio assegnando un valore intero al membro dati offlineLeasePeriod dell'oggetto PolicySpec.
• Impostare il membro dati policyXml dell'oggetto PolicySpec con un valore stringa che rappresenta i dati XML PDRL. Per eseguire questa attività, creare un oggetto .NET StreamReader utilizzando il relativo costruttore. Passare la posizione di un file XML PDRL che rappresenta il criterio al costruttore StreamReader. Quindi, richiamare il metodo ReadLine dell'oggetto StreamReader e assegnare il valore restituito a una variabile stringa. Scorrere l'oggetto StreamReader fino a quando il metodo ReadLine non restituisce null. Assegnare la variabile stringa al membro dati policyXml dell'oggetto PolicySpec.

Crea una voce criterio.

Non è necessario creare una voce policy durante la creazione di una policy utilizzando l’API del servizio web di Document Security. La voce del criterio è definita nel documento PDRL.

Registra il criterio.

Registrare il criterio richiamando il metodo registerPolicy dell'oggetto DocumentSecurityServiceClient e passando i valori seguenti:

• Oggetto PolicySpec che rappresenta il criterio da registrare.
• Valore stringa che rappresenta il set di criteri a cui appartiene il criterio. È possibile specificare un valore null che determina l'aggiunta del criterio al set di criteri MyPolicy.

Se si utilizza un account amministratore di AEM forms nelle impostazioni di connessione per creare l'oggetto DocumentSecurityClient, specificare il nome del set di criteri quando si richiama il metodo registerPolicy.

Se utilizzi un utente di Document SecurityDocument Security nelle impostazioni di connessione, puoi richiamare il metodo registerPolicy sovraccarico che accetta solo il criterio. In altre parole, non è necessario specificare il nome del set di criteri. Tuttavia, il criterio viene aggiunto al set di criteri denominato Criteri personali. Se non si desidera aggiungere il nuovo criterio a questo set di criteri, specificare un nome per il set di criteri quando si richiama il metodo registerPolicy.

Includi file di progetto.

Includi i file JAR dei client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.

Crea un oggetto API client di Document Security.

• Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
• Creare un oggetto RightsManagementClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

Recupera un criterio esistente.

• Creare un oggetto PolicyManager richiamando il metodo getPolicyManager dell'oggetto RightsManagementClient.

• Creare un oggetto Policy che rappresenta il criterio da aggiornare richiamando il metodo getPolicy dell'oggetto PolicyManager e passando i valori seguenti"

  • Valore stringa che rappresenta il nome del set di criteri a cui appartiene il criterio. È possibile specificare null che determina l'utilizzo del set di criteri MyPolicies.
  • Valore stringa che rappresenta il nome del criterio.

Impostare gli attributi del criterio.

Modifica gli attributi della policy per soddisfare i requisiti aziendali. Ad esempio, per modificare il periodo di lease offline del criterio, richiamare il metodo setOfflineLeasePeriod dell'oggetto Policy.

Aggiorna il criterio.

Aggiornare il criterio richiamando il metodo updatePolicy dell'oggetto PolicyManager. Passa l'oggetto Policy che rappresenta il criterio da aggiornare.

Includi file di progetto.

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

Crea un oggetto API client di Document Security.

• Creare un oggetto RightsManagementServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto RightsManagementServiceClient.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/RightsManagementService?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 RightsManagementServiceClient.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 RightsManagementServiceClient.ClientCredentials.UserName.UserName.
  • Assegnare il valore della password corrispondente al campo RightsManagementServiceClient.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.

Recupera un criterio esistente.

Creare un oggetto PolicySpec che rappresenta il criterio da modificare richiamando il metodo getPolicy dell'oggetto RightsManagementServiceClient e passando i valori seguenti:

• Valore stringa che specifica il nome del set di criteri a cui appartiene il criterio. È possibile specificare null che determina l'utilizzo del set di criteri MyPolicies.
• Valore stringa che specifica il nome del criterio.

Impostare gli attributi del criterio.

Modifica gli attributi della policy per soddisfare i requisiti aziendali.

Aggiorna il criterio.

Aggiornare il criterio richiamando il metodo updatePolicyFromSDK dell'oggetto RightsManagementServiceClient e passando l'oggetto PolicySpec che rappresenta il criterio da aggiornare.

Includi file di progetto.

Includi i file JAR dei client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.

Crea un oggetto API client di Document Security.

• Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
• Creare un oggetto RightsManagementClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

Elimina il criterio.

• Creare un oggetto PolicyManager richiamando il metodo getPolicyManager dell'oggetto RightsManagementClient.

• Eliminare il criterio richiamando il metodo deletePolicy dell'oggetto PolicyManager e passando i valori seguenti:

  • Valore stringa che specifica il nome del set di criteri a cui appartiene il criterio. È possibile specificare null che determina l'utilizzo del set di criteri MyPolicies.
  • Valore stringa che specifica il nome del criterio da eliminare.

Includi file di progetto.

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

Crea un oggetto API client di Document Security.

• Creare un oggetto RightsManagementServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto RightsManagementServiceClient.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/RightsManagementService?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 RightsManagementServiceClient.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 RightsManagementServiceClient.ClientCredentials.UserName.UserName.
  • Assegnare il valore della password corrispondente al campo RightsManagementServiceClient.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.

Elimina il criterio.

Eliminare un criterio richiamando il metodo deletePolicy dell'oggetto RightsManagementServiceClient e passando i valori seguenti:

• Valore stringa che specifica il nome del set di criteri a cui appartiene il criterio. È possibile specificare null che determina l'utilizzo del set di criteri MyPolicies.
• Valore stringa che specifica il nome del criterio da eliminare.

Includi file di progetto.

Includi i file JAR dei client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.

Crea un oggetto API client di Document Security.

• Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
• Creare un oggetto RightsManagementClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

Recuperare un documento PDF.

• Creare un oggetto java.io.FileInputStream che rappresenta il documento PDF utilizzando il relativo costruttore. Passa 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.

Applica una policy esistente al documento PDF.

• Creare un oggetto DocumentManager richiamando il metodo getDocumentManager dell'oggetto RightsManagementClient.

• Applicare una policy al documento PDF richiamando il metodo protectDocument dell'oggetto DocumentManager e passando i valori seguenti:

  • L'oggetto com.adobe.idp.Document che contiene il documento PDF a cui viene applicato il criterio.
  • Valore stringa che specifica il nome del documento.
  • Valore stringa che specifica il nome del set di criteri a cui appartiene il criterio. È possibile specificare un valore null che determina l'utilizzo del set di criteri MyPolicies.
  • Valore stringa che specifica il nome del criterio.
  • Valore string che rappresenta il nome del dominio del gestore utenti dell'utente che è l'autore del documento. Il valore di questo parametro è facoltativo e può essere null (se il parametro è null, il valore del parametro successivo deve essere null).
  • Valore stringa che rappresenta il nome canonico dell'utente responsabile dell'utente che è l'autore del documento. Il valore del parametro è facoltativo e può essere null (se il parametro è null, il valore del parametro precedente deve essere null).
  • com.adobe.livecycle.rightsmanagement.Locale che rappresenta le impostazioni locali utilizzate per la selezione del modello di MS Office. Questo valore di parametro è facoltativo e non viene utilizzato per i documenti PDF. Per proteggere un documento PDF, specificare null.

  Il metodo protectDocument restituisce un oggetto RMSecureDocumentResult contenente il documento PDF protetto tramite policy.

Salvare il documento PDF.

• Richiama il metodo getProtectedDoc dell'oggetto RMSecureDocumentResult per ottenere il documento PDF protetto tramite policy. Questo metodo restituisce un oggetto com.adobe.idp.Document.
• Creare un oggetto java.io.File e assicurarsi che l'estensione del file sia PDF.
• Richiamare 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 getProtectedDoc).

Includi file di progetto.

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

Crea un oggetto API client di Document Security.

• Creare un oggetto RightsManagementServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto RightsManagementServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Trasmettere un valore stringa che specifica il WSDL al servizio Forms (ad esempio, http://localhost:8080/soap/services/RightsManagementService?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 RightsManagementServiceClient.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 RightsManagementServiceClient.ClientCredentials.UserName.UserName.
  • Assegnare il valore della password corrispondente al campo RightsManagementServiceClient.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.

Recuperare un documento PDF.

• Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare un documento PDF a cui viene applicato un criterio.
• Creare un oggetto System.IO.FileStream richiamandone il costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF e la modalità di apertura del file.
• Creare una matrice di byte che memorizza il contenuto dell'oggetto System.IO.FileStream. Determinare la dimensione 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. Passare la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
• Compilare l'oggetto BLOB assegnando il relativo campo MTOM al contenuto della matrice di byte.

Applica una policy esistente al documento PDF.

Applicare una policy al documento PDF richiamando il metodo protectDocument dell'oggetto RightsManagementServiceClient e passando i valori seguenti:

• L'oggetto BLOB che contiene il documento PDF a cui viene applicato il criterio.
• Valore stringa che specifica il nome del documento.
• Valore stringa che specifica il nome del set di criteri a cui appartiene il criterio. È possibile specificare un valore null che determina l'utilizzo del set di criteri MyPolicies.
• Valore stringa che specifica il nome del criterio.
• Valore string che rappresenta il nome del dominio del gestore utenti dell'utente che è l'autore del documento. Il valore di questo parametro è facoltativo e può essere null (se il parametro è null, il valore del parametro successivo deve essere null).
• Valore stringa che rappresenta il nome canonico dell'utente responsabile dell'utente che è l'autore del documento. Il valore del parametro è facoltativo e può essere null (se il parametro è null, il valore del parametro precedente deve essere null).
• Valore RMLocale che specifica il valore delle impostazioni locali, ad esempio RMLocale.en.
• Parametro di output stringa utilizzato per memorizzare il valore dell'identificatore dei criteri.
• Parametro di output stringa utilizzato per memorizzare il valore dell'identificatore protetto tramite policy.
• Parametro di output stringa utilizzato per memorizzare il tipo MIME (ad esempio, application/pdf).

Il metodo protectDocument restituisce un oggetto BLOB contenente il documento PDF protetto tramite policy.

Salvare il documento 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 tramite policy.
• Creare una matrice di byte che memorizza il contenuto dei dati dell'oggetto BLOB restituito dal metodo protectDocument. 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-rightsmanagement-client.jar, nel percorso di classe del progetto Java.

Crea un oggetto API client di Document Security.

• Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
• Creare un oggetto DocumentSecurityClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

Recuperare un documento PDF protetto tramite policy.

• Creare un oggetto java.io.FileInputStream che rappresenta il documento PDF protetto tramite policy 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 il criterio dal documento PDF.

• Creare un oggetto DocumentManager richiamando il metodo getDocumentManager dell'oggetto DocumentSecurityClient.
• Rimuovere un criterio dal documento PDF richiamando il metodo removeSecurity dell'oggetto DocumentManager e passando l'oggetto com.adobe.idp.Document che contiene il documento PDF protetto tramite criteri. Questo metodo restituisce un oggetto com.adobe.idp.Document contenente un documento PDF non protetto.

Salvare il documento PDF non protetto.

• Creare un oggetto java.io.File e assicurarsi che l'estensione del file sia PDF.
• Richiamare il metodo copyToFile dell'oggetto Document per copiare il contenuto dell'oggetto Document nel file (assicurarsi di utilizzare l'oggetto Document restituito dal metodo removeSecurity).

Includi file di progetto.

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

Crea un oggetto API client di Document Security.

• Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto DocumentSecurityServiceClient.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/RightsManagementService?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 DocumentSecurityServiceClient.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 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
  • Assegnare il valore della password corrispondente al campo DocumentSecurityServiceClient.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.

Recuperare un documento PDF protetto tramite policy.

• Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per archiviare il documento PDF protetto tramite policy da cui viene rimosso il criterio.
• Creare un oggetto System.IO.FileStream richiamandone il costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF 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 relativo campo MTOM al contenuto della matrice di byte.

Rimuovi il criterio dal documento PDF.

Rimuovere il criterio dal documento PDF richiamando il metodo removePolicySecurity dell'oggetto DocumentSecurityServiceClient e passando l'oggetto BLOB che contiene il documento PDF protetto tramite criteri. Questo metodo restituisce un oggetto BLOB contenente un documento PDF non protetto.

Salvare il documento PDF non protetto.

• 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 dei dati dell'oggetto BLOB restituito dal metodo removePolicySecurity. Compilare la matrice di byte ottenendo il valore del campo MTOM dell'oggetto BLOB.
• Creare un oggetto System.IO.BinaryWriter richiamandone il costruttore e passando l'oggetto System.IO.FileStream.

Includi file di progetto

Includi i file JAR dei client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.

Creare un oggetto API client di Document Security

• Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
• Creare un oggetto DocumentSecurityClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

Recuperare un documento PDF protetto tramite policy

• Creare un oggetto java.io.FileInputStream che rappresenta il documento PDF protetto tramite policy 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.

Revoca del documento protetto tramite policy

• Creare un oggetto DocumentManager richiamando il metodo getDocumentManager dell'oggetto DocumentSecurityClient.

• Recuperare il valore dell'identificatore di licenza del documento protetto tramite policy richiamando il metodo getLicenseId dell'oggetto DocumentManager. Passa l'oggetto com.adobe.idp.Document che rappresenta il documento protetto tramite policy. Questo metodo restituisce un valore stringa che rappresenta il valore dell'identificatore di licenza.

• Creare un oggetto LicenseManager richiamando il metodo getLicenseManager dell'oggetto DocumentSecurityClient.

• Revocare il documento protetto tramite policy richiamando il metodo revokeLicense dell'oggetto LicenseManager e passando i valori seguenti:

  • Valore stringa che specifica il valore dell'identificatore di licenza del documento protetto tramite policy (specificare il valore restituito del metodo getLicenseId dell'oggetto DocumentManager).
  • Membro dati statico dell'interfaccia License che specifica il motivo della revoca del documento. Ad esempio, è possibile specificare License.DOCUMENT_REVISED.
  • Valore java.net.URL che specifica il percorso in cui si trova un documento revisionato. Se non desideri reindirizzare un utente a un altro URL, puoi passare null.

Includi file di progetto

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

Creare un oggetto API client di Document Security

• Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto DocumentSecurityServiceClient.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/RightsManagementService?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 DocumentSecurityServiceClient.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 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
  • Assegnare il valore della password corrispondente al campo DocumentSecurityServiceClient.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.

Recuperare un documento PDF protetto tramite policy

• Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per archiviare un documento PDF protetto tramite policy revocato.
• Creare un oggetto System.IO.FileStream richiamandone il costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF protetto tramite policy da revocare 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 relativo campo MTOM al contenuto della matrice di byte.

Revoca del documento protetto tramite policy

• Recuperare il valore dell'identificatore di licenza del documento protetto tramite policy richiamando il metodo getLicenseID dell'oggetto DocumentSecurityServiceClient e passando l'oggetto BLOB che rappresenta il documento protetto tramite policy. Questo metodo restituisce un valore stringa che rappresenta l'identificatore della licenza.

• Revocare il documento protetto tramite policy richiamando il metodo revokeLicense dell'oggetto DocumentSecurityServiceClient e passando i valori seguenti:

  • Valore stringa che specifica il valore dell'identificatore di licenza del documento protetto tramite policy (specificare il valore restituito del metodo getLicenseId dell'oggetto DocumentSecurityServiceService).
  • Membro dati statico dell'enumerazione Reason che specifica il motivo della revoca del documento. Ad esempio, è possibile specificare Reason.DOCUMENT_REVISED.
  • Valore string che specifica la posizione URL in cui si trova un documento revisionato. Se non desideri reindirizzare un utente a un altro URL, puoi passare null.

Includi file di progetto.

Includi i file JAR dei client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.

Crea un oggetto API client di Document Security.

• Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
• Creare un oggetto DocumentSecurityClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

Recuperare l'identificatore di licenza del documento PDF revocato.

• Creare un oggetto java.io.FileInputStream che rappresenta il documento PDF revocato 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.
• Creare un oggetto DocumentManager richiamando il metodo getDocumentManager dell'oggetto DocumentSecurityClient.
• Recuperare il valore dell'identificatore di licenza del documento revocato richiamando il metodo getLicenseId dell'oggetto DocumentManager e passando l'oggetto com.adobe.idp.Document che rappresenta il documento revocato. Questo metodo restituisce un valore stringa che rappresenta l'identificatore della licenza.

Ripristinare l'accesso al documento PDF revocato.

• Creare un oggetto LicenseManager richiamando il metodo getLicenseManager dell'oggetto DocumentSecurityClient.
• Ripristinare l'accesso al documento PDF revocato richiamando il metodo unrevokeLicense dell'oggetto LicenseManager e passando il valore dell'identificatore di licenza del documento revocato.

Includi file di progetto.

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

Crea un oggetto API client di Document Security.

• Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto DocumentSecurityServiceClient.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/RightsManagementService?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 DocumentSecurityServiceClient.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 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
  • Assegnare il valore della password corrispondente al campo DocumentSecurityServiceClient.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.

Recuperare l'identificatore di licenza del documento PDF revocato.

• Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per archiviare un documento PDF revocato a cui viene ripristinato l'accesso.
• Creare un oggetto System.IO.FileStream richiamandone il costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF revocato 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 relativo campo MTOM al contenuto della matrice di byte.

Ripristinare l'accesso al documento PDF revocato.

• Recuperare il valore dell'identificatore di licenza del documento revocato richiamando il metodo getLicenseID dell'oggetto DocumentSecurityServiceClient e passando l'oggetto BLOB che rappresenta il documento revocato. Questo metodo restituisce un valore stringa che rappresenta l'identificatore della licenza.
• Ripristinare l'accesso al documento PDF revocato richiamando il metodo unrevokeLicense dell'oggetto DocumentSecurityServiceClient e passando un valore stringa che specifica il valore dell'identificatore di licenza del documento PDF revocato (passare il valore restituito del metodo getLicenseId dell'oggetto DocumentSecurityServiceClient).

Includi file di progetto.

Includi i file JAR dei client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java. Per informazioni sul percorso di questi file, vedere Inclusi i file della libreria Java di AEM Forms.

Crea un oggetto API client di Document Security.

• Creare un oggetto ServiceClientFactory contenente le proprietà di connessione. (Vedere Impostazione delle proprietà di connessione.)
• Creare un oggetto RightsManagementClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

Recuperare un documento protetto tramite policy da esaminare.

• Creare un oggetto java.io.FileInputStream che rappresenta il documento PDF protetto tramite policy utilizzando il relativo costruttore. Passa 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.

Inspect il documento.

• Creare un oggetto DocumentManager richiamando il metodo getDocumentManager dell'oggetto RightsManagementClient.
• Inspect ha protetto il documento tramite policy richiamando il metodo inspectDocument dell'oggetto LicenseManager. Passa l'oggetto com.adobe.idp.Document che contiene il documento PDF protetto tramite policy. Questo metodo restituisce un oggetto RMInspectResult contenente informazioni sul documento protetto tramite policy.

Ottenere informazioni sul documento protetto tramite policy.

Per ottenere informazioni sul documento protetto tramite policy, richiamare il metodo appropriato che appartiene all'oggetto RMInspectResult. Ad esempio, per recuperare il nome del criterio, richiamare il metodo getPolicyName dell'oggetto RMInspectResult.

Includi file di progetto.

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

Crea un oggetto API client di Document Security.

• Creare un oggetto RightsManagementServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto RightsManagementServiceClient.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/RightsManagementService?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 RightsManagementServiceClient.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 RightsManagementServiceClient.ClientCredentials.UserName.UserName.
  • Assegnare il valore della password corrispondente al campo RightsManagementServiceClient.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.

Recuperare un documento protetto tramite policy da esaminare.

• Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare un documento PDF da verificare.
• Creare un oggetto System.IO.FileStream richiamando il relativo costruttore. Passa un valore stringa che rappresenta la posizione del file del documento PDF e la modalità di apertura del file in.
• 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. Passare la matrice di byte, la posizione iniziale e la lunghezza del flusso per la lettura.
• Compilare l'oggetto BLOB assegnando il relativo campo MTOM al contenuto della matrice di byte.

Inspect il documento.

Inspect ha protetto il documento tramite policy richiamando il metodo inspectDocument dell'oggetto RightsManagementServiceClient. Passa l'oggetto BLOB che contiene il documento PDF protetto tramite policy. Questo metodo restituisce un oggetto RMInspectResult contenente informazioni sul documento protetto tramite policy.

Ottenere informazioni sul documento protetto tramite policy.

Per ottenere informazioni sul documento protetto tramite policy, ottenere il valore del campo appropriato che appartiene all'oggetto RMInspectResult. Ad esempio, per recuperare il nome del criterio, ottenere il valore del campo policyName dell'oggetto RMInspectResult.

Includi file di progetto.

Includi i file JAR client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.

Crea un oggetto API client di Document Security.

• Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
• Creare un oggetto RightsManagementClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

Imposta attributi filigrana

• Creare un oggetto Watermark richiamando il metodo createWatermark statico dell'oggetto InfomodelObjectFactory. Questo metodo restituisce un oggetto Watermark.
• Impostare l'attributo name della filigrana richiamando il metodo setName dell'oggetto Watermark e passando un valore stringa che specifica il nome del criterio.
• Impostare l'attributo background della filigrana richiamando il metodo setBackground dell'oggetto Watermark e passando true. Impostando questo attributo, la filigrana viene visualizzata sullo sfondo del documento.
• Impostare l'attributo di testo personalizzato della filigrana richiamando il metodo setCustomText dell'oggetto Watermark e passando un valore stringa che rappresenta il testo della filigrana.
• Impostare l'attributo di opacità della filigrana richiamando il metodo setOpacity dell'oggetto Watermark e passando un valore intero che specifica il livello di opacità. Il valore 100 indica che la filigrana è completamente opaca e il valore 0 indica che è completamente trasparente.

Registrare la filigrana.

• Creare un oggetto WatermarkManager richiamando il metodo getWatermarkManager dell'oggetto RightsManagementClient. Questo metodo restituisce un oggetto WatermarkManager.
• Registrare la filigrana richiamando il metodo registerWatermark dell'oggetto WatermarkManager e passando l'oggetto Watermark che rappresenta la filigrana da registrare. Questo metodo restituisce un valore stringa che rappresenta il valore di identificazione della filigrana.

Crea un oggetto API client di Document Security.

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

Crea un oggetto API client di Document Security.

• Creare un oggetto RightsManagementServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto RightsManagementServiceClient.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/RightsManagementService?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 RightsManagementServiceClient.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 RightsManagementServiceClient.ClientCredentials.UserName.UserName.
  • Assegnare il valore della password corrispondente al campo RightsManagementServiceClient.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.

Impostare gli attributi della filigrana.

• Creare un oggetto WatermarkSpec richiamando il costruttore WatermarkSpec.
• Impostare il nome della filigrana assegnando un valore stringa al membro dati name dell'oggetto WatermarkSpec.
• Impostare l'attributo id della filigrana assegnando un valore stringa al membro dati id dell'oggetto WatermarkSpec.
• Per ogni proprietà filigrana da impostare, creare un oggetto MyMapOf_xsd_string_To_xsd_anyType_Item separato.
• Impostare il valore chiave assegnando un valore al membro dati key dell'oggetto MyMapOf_xsd_string_To_xsd_anyType_Item (ad esempio, WaterBackCmd:OPACITY).
• Impostare il valore assegnando un valore al membro dati value dell'oggetto MyMapOf_xsd_string_To_xsd_anyType_Item, ad esempio .25.
• Creare un oggetto MyArrayOf_xsd_anyType. Per ogni oggetto MyMapOf_xsd_string_To_xsd_anyType_Item, richiamare il metodo Add dell'oggetto MyArrayOf_xsd_anyType. Passa l'oggetto MyMapOf_xsd_string_To_xsd_anyType_Item.
• Assegnare l'oggetto MyArrayOf_xsd_anyType al membro dati values dell'oggetto WatermarkSpec.

Registrare la filigrana.

Registrare la filigrana richiamando il metodo registerWatermark dell'oggetto RightsManagementServiceClient e passando l'oggetto WatermarkSpec che rappresenta la filigrana da registrare.

Includi file di progetto.

Includi i file JAR dei client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.

Crea un oggetto API client di Document Security.

• Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
• Creare un oggetto DocumentSecurityClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

Recuperate la filigrana da modificare.

Creare un oggetto WatermarkManager richiamando il metodo getWatermarkManager dell'oggetto DocumentSecurityClient e passare un valore stringa che specifichi il nome della filigrana. Questo metodo restituisce un oggetto Watermark che rappresenta la filigrana da modificare.

Impostare gli attributi della filigrana.

Impostare l'attributo di opacità della filigrana richiamando il metodo setOpacity dell'oggetto Watermark e passando un valore intero che specifica il livello di opacità. Il valore 100 indica che la filigrana è completamente opaca e il valore 0 indica che è completamente trasparente.

Aggiorna la filigrana.

• Aggiornare la filigrana richiamando il metodo updateWatermark dell'oggetto WatermarkManager e passare l'oggetto Watermark il cui attributo è stato modificato.

Includi file di progetto.

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

Crea un oggetto API client di Document Security.

• Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto RightsManagementServiceClient.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/DocumentSecurityService?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 DocumentSecurityServiceClient.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 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
  • Assegnare il valore della password corrispondente al campo DocumentSecurityServiceClient.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.

Recuperate la filigrana da modificare.

Recuperare la filigrana da modificare richiamando il metodo getWatermarkByName dell'oggetto DocumentSecurityServiceClient. Passa un valore stringa che specifica il nome della filigrana. Questo metodo restituisce un oggetto WatermarkSpec che rappresenta la filigrana da modificare.

Impostare gli attributi della filigrana.

• Per ogni proprietà filigrana da aggiornare, creare un oggetto MyMapOf_xsd_string_To_xsd_anyType_Item separato.
• Impostare il valore chiave assegnando un valore al membro dati key dell'oggetto MyMapOf_xsd_string_To_xsd_anyType_Item (ad esempio, WaterBackCmd:OPACITY).
• Impostare il valore assegnando un valore al membro dati value dell'oggetto MyMapOf_xsd_string_To_xsd_anyType_Item, ad esempio .50.
• Creare un oggetto MyArrayOf_xsd_anyType. Per ogni oggetto MyMapOf_xsd_string_To_xsd_anyType_Item, richiamare il metodo Add dell'oggetto MyArrayOf_xsd_anyType. Passa l'oggetto MyMapOf_xsd_string_To_xsd_anyType_Item.
• Assegnare l'oggetto MyArrayOf_xsd_anyType al membro dati values dell'oggetto WatermarkSpec.

Aggiorna la filigrana.

Aggiornare la filigrana richiamando il metodo updateWatermark dell'oggetto DocumentSecurityServiceClient e passando l'oggetto WatermarkSpec che rappresenta la filigrana da modificare.

Includi file di progetto

Includi i file JAR dei client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.

Creazione di un oggetto API client di Rights Management

Creare un oggetto DocumentSecurityClient utilizzando il relativo costruttore e passando un oggetto ServiceClientFactory che contiene proprietà di connessione.

Specificare gli eventi da cercare

• Creare un oggetto EventManager richiamando il metodo getEventManager dell'oggetto DocumentSecurityClient. Questo metodo restituisce un oggetto EventManager.
• Creare un oggetto EventSearchFilter richiamando il relativo costruttore.
• Specificare l'evento per il quale eseguire la ricerca richiamando il metodo setEventCode dell'oggetto EventSearchFilter e passando un membro dati statico appartenente alla classe EventManager che rappresenta l'evento per il quale eseguire la ricerca. Ad esempio, per cercare l'evento di creazione dei criteri, passare EventManager.POLICY_CREATE_EVENT.

Cerca l’evento

Cercare l'evento richiamando il metodo searchForEvents dell'oggetto EventManager e passando l'oggetto EventSearchFilter che definisce i criteri di ricerca dell'evento. Questo metodo restituisce una matrice di Event oggetti.

Includi file di progetto

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

Creazione di un oggetto API client di Rights Management

• Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto DocumentSecurityServiceClient.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/RightsManagementService?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 DocumentSecurityServiceClient.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 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
  • Assegnare il valore della password corrispondente al campo DocumentSecurityServiceClient.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.

Specificare gli eventi da cercare

• Creare un oggetto EventSpec utilizzando il relativo costruttore.
• Specificare l'inizio del periodo di tempo durante il quale si è verificato l'evento impostando il membro dati firstTime.date dell'oggetto EventSpec con istanza DataTime che rappresenta l'inizio dell'intervallo di date in cui si è verificato l'evento.
• Assegnare il valore true al membro dati firstTime.dateSpecified dell'oggetto EventSpec.
• Specificare la fine del periodo di tempo durante il quale si è verificato l'evento impostando il membro dati lastTime.date dell'oggetto EventSpec con istanza DataTime che rappresenta la fine dell'intervallo di date in cui si è verificato l'evento.
• Assegnare il valore true al membro dati lastTime.dateSpecified dell'oggetto EventSpec.
• Impostare l'evento da cercare assegnando un valore stringa al membro dati eventCode dell'oggetto EventSpec. Nella tabella seguente sono elencati i valori numerici che è possibile assegnare a questa proprietà:

Cerca l’evento

Cercare l'evento richiamando il metodo searchForEvents dell'oggetto DocumentSecurityServiceClient e passando l'oggetto EventSpec che rappresenta l'evento per il quale eseguire la ricerca e il numero massimo di risultati. Questo metodo restituisce un insieme MyArrayOf_xsd_anyType in cui ogni elemento è un'istanza AuditSpec. Utilizzando un'istanza di AuditSpec, è possibile ottenere informazioni sull'evento, ad esempio l'ora in cui si è verificato. L'istanza AuditSpec contiene un membro dati timestamp che specifica queste informazioni.

Includi file di progetto.

Includi i file JAR dei client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.

Crea un oggetto API client di Document Security.

• Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
• Creare un oggetto DocumentSecurityClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

Recuperare un documento di Word.

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

Applicare una policy esistente al documento di Word.

• Creare un oggetto DocumentManager richiamando il metodo getDocumentManager dell'oggetto DocumentSecurityClient.

• Applicare una policy al documento di Word richiamando il metodo protectDocument dell'oggetto DocumentManager e passando i valori seguenti:

  • L'oggetto com.adobe.idp.Document che contiene il documento di Word a cui viene applicato il criterio.
  • Valore stringa che specifica il nome del documento.
  • Valore stringa che specifica il nome del set di criteri a cui appartiene il criterio. È possibile specificare un valore null che determina l'utilizzo del set di criteri MyPolicies.
  • Valore stringa che specifica il nome del criterio.
  • Valore string che rappresenta il nome del dominio del gestore utenti dell'utente che è l'autore del documento. Il valore di questo parametro è facoltativo e può essere null (se il parametro è null, il valore del parametro successivo deve essere null).
  • Valore stringa che rappresenta il nome canonico dell'utente responsabile dell'utente che è l'autore del documento. Il valore del parametro è facoltativo e può essere null (se il parametro è null, il valore del parametro precedente deve essere null).
  • com.adobe.livecycle.rightsmanagement.Locale che rappresenta le impostazioni locali utilizzate per la selezione del modello di MS Office. Il valore di questo parametro è facoltativo ed è possibile specificare null.

  Il metodo protectDocument restituisce un oggetto RMSecureDocumentResult che contiene il documento Word protetto tramite policy.

Salvare il documento di Word.

• Richiama il metodo getProtectedDoc dell'oggetto RMSecureDocumentResult per ottenere il documento Word protetto tramite policy. Questo metodo restituisce un oggetto com.adobe.idp.Document.
• Creare un oggetto java.io.File e assicurarsi che l'estensione del file sia DOC.
• Richiamare 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 getProtectedDoc).

Includi file di progetto.

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

Crea un oggetto API client di Document Security.

• Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto DocumentSecurityServiceClient.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/DocumentSecurityService?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 DocumentSecurityServiceClient.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 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
  • Assegnare il valore della password corrispondente al campo DocumentSecurityServiceClient.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.

Recuperare un documento di Word.

• Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare un documento di Word a cui è applicato un criterio.
• Creare un oggetto System.IO.FileStream richiamandone il costruttore e passando un valore stringa che rappresenta la posizione del file del documento di Word e la modalità di apertura del file.
• Creare una matrice di byte che memorizza il contenuto dell'oggetto System.IO.FileStream. Determinare la dimensione 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. Passare la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
• Compilare l'oggetto BLOB assegnando il relativo campo MTOM al contenuto della matrice di byte.

Applicare una policy esistente al documento di Word.

Applicare una policy al documento di Word richiamando il metodo protectDocument dell'oggetto DocumentSecurityServiceClient e passando i valori seguenti:

• L'oggetto BLOB che contiene il documento di Word a cui viene applicato il criterio.
• Valore stringa che specifica il nome del documento.
• Valore stringa che specifica il nome del set di criteri a cui appartiene il criterio. È possibile specificare un valore null che determina l'utilizzo del set di criteri MyPolicies.
• Valore stringa che specifica il nome del criterio.
• Valore string che rappresenta il nome del dominio del gestore utenti dell'utente che è l'autore del documento. Il valore di questo parametro è facoltativo e può essere null (se il parametro è null, il valore del parametro successivo deve essere null).
• Valore stringa che rappresenta il nome canonico dell'utente responsabile dell'utente che è l'autore del documento. Il valore del parametro è facoltativo e può essere null (se il parametro è null, il valore del parametro precedente deve essere null).
• Valore RMLocale che specifica il valore delle impostazioni locali, ad esempio RMLocale.en.
• Parametro di output stringa utilizzato per memorizzare il valore dell'identificatore dei criteri.
• Parametro di output stringa utilizzato per memorizzare il valore dell'identificatore protetto tramite policy.
• Parametro di output stringa utilizzato per memorizzare il tipo MIME (ad esempio, application/doc).

Il metodo protectDocument restituisce un oggetto BLOB che contiene il documento Word protetto tramite policy.

Salvare il documento di Word.

• Creare un oggetto System.IO.FileStream richiamandone il costruttore e passando un valore stringa che rappresenta la posizione del file del documento Word protetto tramite policy.
• Creare una matrice di byte che memorizza il contenuto dei dati dell'oggetto BLOB restituito dal metodo protectDocument. 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 di Word 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-rightsmanagement-client.jar, nel percorso di classe del progetto Java.

Creare un oggetto API client di Document Security

• Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
• Creare un oggetto RightsManagementClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

Recuperare un documento Word protetto tramite policy

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

Rimuovere la policy dal documento di Word

• Creare un oggetto DocumentManager richiamando il metodo getDocumentManager dell'oggetto RightsManagementClient.
• Rimuovere una policy dal documento di Word richiamando il metodo removeSecurity dell'oggetto DocumentManager e passando l'oggetto com.adobe.idp.Document che contiene il documento di Word protetto tramite policy. Questo metodo restituisce un oggetto com.adobe.idp.Document che contiene un documento di Word non protetto.

Salvare il documento Word non protetto

• Creare un oggetto java.io.File e assicurarsi che l'estensione del file sia DOC.
• Richiamare il metodo copyToFile dell'oggetto Document per copiare il contenuto dell'oggetto Document nel file (assicurarsi di utilizzare l'oggetto Document restituito dal metodo removeSecurity).

Includi file di progetto

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

Creare un oggetto API client di Document Security

• Creare un oggetto RightsManagementServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto RightsManagementServiceClient.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/RightsManagementService?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 RightsManagementServiceClient.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 RightsManagementServiceClient.ClientCredentials.UserName.UserName.
  • Assegnare il valore della password corrispondente al campo RightsManagementServiceClient.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.

Recuperare un documento Word protetto tramite policy

• Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare il documento Word protetto tramite policy da cui viene rimossa la policy.
• Creare un oggetto System.IO.FileStream richiamandone il costruttore e passando un valore stringa che rappresenta la posizione del file del documento di Word 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 relativo campo MTOM al contenuto della matrice di byte.

Rimuovere la policy dal documento di Word

Rimuovere la policy dal documento di Word richiamando il metodo removePolicySecurity dell'oggetto RightsManagementServiceClient e passando l'oggetto BLOB che contiene il documento di Word protetto tramite policy. Questo metodo restituisce un oggetto BLOB che contiene un documento di Word non protetto.

Salvare il documento Word non protetto

• Creare un oggetto System.IO.FileStream richiamandone il costruttore e passando un valore stringa che rappresenta la posizione del file del documento di Word non protetto.
• Creare una matrice di byte che memorizza il contenuto dei dati dell'oggetto BLOB restituito dal metodo removePolicySecurity. Compilare la matrice di byte ottenendo il valore del campo MTOM dell'oggetto BLOB.
• Creare un oggetto System.IO.BinaryWriter richiamandone il costruttore e passando l'oggetto System.IO.FileStream.