Protezione dei documenti con criteri

Informazioni su Document Security Service

Il servizio Document Security consente agli utenti di applicare dinamicamente le impostazioni di riservatezza ai documenti Adobe PDF e di mantenere il controllo sui documenti, indipendentemente dalla loro diffusione.

Il servizio Document Security impedisce che le informazioni si diffondano oltre la portata dell'utente consentendo agli utenti di mantenere il controllo sul modo in cui i destinatari utilizzano il documento PDF protetto tramite criterio. Un utente può specificare chi può aprire un documento, limitare il suo utilizzo e monitorare il documento dopo averlo distribuito. Un utente può inoltre controllare in modo dinamico l'accesso a un documento protetto tramite criterio e può revocare l'accesso al documento anche in modo dinamico.

Il servizio Document Security protegge anche altri tipi di file come i file Microsoft Word (file DOC). Potete utilizzare l'API client di Document Security per lavorare con questi tipi di file. Sono supportate le versioni seguenti:

• File di Microsoft Office 2003 (DOC, XLS, PPT)
• File di Microsoft Office 2007 (DOCX, XLSX, PPTX)
• PTC Pro/E, file

Per maggiore chiarezza, nelle due sezioni seguenti viene illustrato come utilizzare i documenti Word:

• Applicazione dei criteri ai documenti Word
• Rimozione di criteri dai documenti di Word

Potete eseguire le seguenti attività utilizzando il servizio Document Security:

• Creare criteri. Per informazioni, vedere Creazione di criteri.
• Modificare i criteri. Per informazioni, vedere Modifica dei criteri.
• Eliminare i criteri. Per informazioni, vedere Eliminazione dei criteri.
• Applicare criteri ai documenti PDF. Per ulteriori informazioni, vedere Applicazione dei criteri ai documenti PDF.
• Rimuovere i criteri dai documenti PDF. Per ulteriori informazioni, vedere Rimozione di criteri dai documenti PDF.
• documenti protetti tramite criterio Inspect. Per ulteriori informazioni, vedere Analisi dei documenti PDF protetti tramite criterio.
• Revoca l'accesso ai documenti PDF. Per informazioni, vedere Revoca dell'accesso ai documenti.
• Ripristinare l'accesso ai documenti revocati. Per ulteriori informazioni, vedere Ripristino dell'accesso ai documenti revisionati.
• Creare filigrane. Per informazioni, vedere Creazione di filigrane.
• Cercare gli eventi. Per informazioni, vedere Ricerca di eventi.

Creazione di criteri

Potete creare criteri a livello di programmazione utilizzando l'API Java di Document Security o l'API del servizio Web. Una policy è una raccolta di informazioni che include le impostazioni di protezione dei documenti, gli utenti autorizzati e i diritti di utilizzo. Potete creare e salvare un numero qualsiasi di criteri, utilizzando le impostazioni di protezione appropriate per situazioni e utenti diversi.

I criteri consentono di eseguire le operazioni seguenti:

• Specificate gli utenti che possono aprire il documento. I destinatari possono appartenere o essere esterni all'organizzazione.
• Specificare il modo in cui i destinatari possono utilizzare il documento. Potete limitare l'accesso a diverse funzioni di Acrobat e Adobe Reader. Queste funzioni includono la possibilità di stampare e copiare il testo, aggiungere firme e aggiungere commenti a un documento.
• Modificate le impostazioni di accesso e protezione in qualsiasi momento, anche dopo la distribuzione del documento protetto tramite criterio.
• Monitorare l’uso del documento dopo averlo distribuito. È possibile vedere come viene utilizzato il documento e chi lo sta utilizzando. Ad esempio, è possibile verificare quando un utente ha aperto il documento.

Creazione di un criterio tramite i servizi Web

Quando create un criterio utilizzando l'API del servizio Web, fate riferimento a un file XML PDF (Portable Document Rights Language) esistente che descrive il criterio. Le autorizzazioni per i criteri e l'entità sono definite nel documento PDRL. Il seguente documento XML è un esempio di documento PDRL.

 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
 <Policy PolicyInstanceVersion="1" PolicyID="5DA3F847-DE76-F9CC-63EA-49A8D59154DE" PolicyCreationTime="2004-08-30T00:02:28.294+00:00" PolicyType="1" PolicySchemaVersion="1.0" PolicyName="SDK Test Policy -4344050357301573237" PolicyDescription="An SDK Test policy" xmlns="https://www.adobe.com/schema/1.0/pdrl"> 
       <PolicyEntry> 
          <ns1:Permission PermissionName="com.adobe.aps.onlineOpen" Access="ALLOW" xmlns:ns1="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" /> 
  
          <ns2:Permission PermissionName="com.adobe.aps.offlineOpen" Access="ALLOW" xmlns:ns2="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" /> 
  
          <ns3:Permission PermissionName="com.adobe.aps.pdf.editNotes" Access="ALLOW" xmlns:ns3="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" /> 
  
          <ns4:Permission PermissionName="com.adobe.aps.pdf.fillAndSign" Access="ALLOW" xmlns:ns4="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" /> 
          <Principal PrincipalNameType="SYSTEM"> 
             <PrincipalDomain>EDC_SPECIAL</PrincipalDomain> 
  
             <PrincipalName>all_internal_users</PrincipalName> 
          </Principal> 
       </PolicyEntry> 
       <PolicyEntry> 
          <ns5:Permission PermissionName="com.adobe.aps.onlineOpen" Access="ALLOW" xmlns:ns5="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" /> 
  
          <ns6:Permission PermissionName="com.adobe.aps.offlineOpen" Access="ALLOW" xmlns:ns6="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" /> 
  
          <ns7:Permission PermissionName="com.adobe.aps.pdf.copy" Access="ALLOW" xmlns:ns7="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" /> 
  
          <ns8:Permission PermissionName="com.adobe.aps.pdf.printLow" Access="ALLOW" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" xmlns:ns8="https://www.adobe.com/schema/1.0/pdrl" /> 
  
          <ns9:Permission PermissionName="com.adobe.aps.policySwitch" Access="ALLOW" xmlns:ns9="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" /> 
  
          <ns10:Permission PermissionName="com.adobe.aps.revoke" Access="ALLOW" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" xmlns:ns10="https://www.adobe.com/schema/1.0/pdrl" /> 
  
          <ns11:Permission PermissionName="com.adobe.aps.pdf.edit" Access="ALLOW" xmlns:ns11="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" /> 
  
          <ns12:Permission PermissionName="com.adobe.aps.pdf.editNotes" Access="ALLOW" xmlns:ns12="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" /> 
  
          <ns13:Permission PermissionName="com.adobe.aps.pdf.fillAndSign" Access="ALLOW" xmlns:ns13="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" /> 
  
          <ns14:Permission PermissionName="com.adobe.aps.pdf.printHigh" Access="ALLOW" xmlns:ns14="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" /> 
  
          <Principal PrincipalNameType="SYSTEM"> 
             <PrincipalDomain>EDC_SPECIAL</PrincipalDomain> 
  
             <PrincipalName>publisher</PrincipalName> 
          </Principal> 
       </PolicyEntry> 
  
       <OfflineLeasePeriod> 
          <Duration>P31D</Duration> 
       </OfflineLeasePeriod> 
  
       <AuditSettings isTracked="true" /> 
  
       <PolicyValidityPeriod isAbsoluteTime="false"> 
          <ValidityPeriodRelative> 
             <NotBeforeRelative>PT0S</NotBeforeRelative> 
  
             <NotAfterRelative>P20D</NotAfterRelative> 
          </ValidityPeriodRelative> 
       </PolicyValidityPeriod> 
 </Policy> 
 

Riepilogo dei passaggi

Per creare un criterio, effettuare le seguenti operazioni:

1. Includere i file di progetto.
2. Creare un oggetto Document Security Client API.
3. Impostate gli attributi del criterio.
4. Creare una voce del criterio.
5. Registra il criterio.

Includi file di progetto

Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.

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

• adobe-rightsmanagement-client.jar
• namespace.jar (se AEM Forms è distribuito su JBoss)
• jaxb-api.jar (se AEM Forms è distribuito su JBoss)
• jaxb-impl.jar (se AEM Forms è distribuito su JBoss)
• jaxb-libs.jar (se AEM Forms è distribuito su JBoss)
• jaxb-xjc.jar (se AEM Forms è distribuito su JBoss)
• relaxngData.jar (se AEM Forms è distribuito su JBoss)
• xsdlib.jar (se AEM Forms è distribuito su JBoss)
• adobe-livecycle-client.jar
• adobe-usermanager-client.jar
• adobe-utilities.jar
• jbossall-client.jar (utilizzate un file JAR diverso se AEM Forms non è distribuito su JBoss)

Per informazioni sulla posizione di questi file JAR, vedere Inclusione file libreria Java AEM Forms.

Creare un oggetto API client Document Security

Prima di eseguire un'operazione del servizio Document Security a livello di programmazione, create un oggetto client del servizio Document Security.

Impostare gli attributi del criterio

Per creare un criterio, impostate gli attributi del criterio. Un attributo obbligatorio è il nome del criterio. I nomi dei criteri devono essere univoci per ciascun set di criteri. Un set di criteri è semplicemente una raccolta di criteri. Possono essere presenti due criteri con lo stesso nome se i criteri appartengono a set di criteri separati. Tuttavia, due criteri all'interno di un singolo set di criteri non possono avere lo stesso nome.

Un altro attributo utile da impostare è il periodo di validità. Un periodo di validità è il periodo di tempo durante il quale un documento protetto tramite criterio è accessibile ai destinatari autorizzati. Se non impostate questo attributo, il criterio è sempre valido.

Un periodo di validità può essere impostato su una delle seguenti opzioni:

• Numero impostato di giorni in cui il documento è accessibile a partire dal momento in cui viene pubblicato
• Una data di fine dopo la quale il documento non è accessibile
• Un intervallo di date specifico per il quale il documento è accessibile
• Always valid

È possibile specificare solo una data di inizio, che determina la validità del criterio dopo la data di inizio. Se si specifica solo una data di fine, il criterio è valido fino alla data di fine. Tuttavia, viene generata un'eccezione se non sono definite sia una data di inizio che una data di fine.

Quando impostate gli attributi che appartengono a un criterio, potete anche impostare le impostazioni di cifratura. Queste impostazioni di cifratura hanno effetto quando il criterio viene applicato a un documento. È possibile specificare i seguenti valori di cifratura:

• AES256: Rappresenta l’algoritmo di cifratura AES con una chiave a 256 bit.
• AES128: Rappresenta l’algoritmo di cifratura AES con una chiave a 128 bit.
• NoEncryption: Non rappresenta la cifratura.

Quando si specifica l'opzione NoEncryption, non è possibile impostare l'opzione PlaintextMetadata su false. Se tentate di farlo, viene generata un'eccezione.

Creare una voce di criterio

Una voce di criterio associa entità, che sono gruppi e utenti, e autorizzazioni a un criterio. Un criterio deve avere almeno una voce del criterio. Si supponga, ad esempio, di eseguire le seguenti operazioni:

• Create e registrate una voce del criterio che consente a un gruppo di visualizzare solo un documento mentre è in linea e impedisce ai destinatari di copiarlo.
• Associate l'immissione dei criteri al criterio.
• Proteggere un documento con il criterio utilizzando Acrobat.

Queste azioni consentono ai destinatari di visualizzare il documento solo online e non di copiarlo. Il documento rimane protetto finché non viene rimossa la protezione.

Registrazione del criterio

Per poter utilizzare un nuovo criterio, è necessario registrarlo. Dopo aver registrato un criterio, potete utilizzarlo per proteggere i documenti.

Creare un criterio utilizzando l'API Java

Create un criterio utilizzando l'API di Document Security (Java):

1. Includere i file di progetto.

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

2. Creare un oggetto Document Security Client API.

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

3. Impostate gli attributi del criterio.

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

4. Creare una voce del criterio.

   • Creare una voce di criterio richiamando il metodo statico createPolicyEntry dell'oggetto InfomodelObjectFactory. Questo metodo restituisce un oggetto PolicyEntry.
   • Specificare le autorizzazioni del criterio richiamando il metodo statico InfomodelObjectFactory dell'oggetto createPermission. Passa un membro di dati statici appartenente all'interfaccia Permission che rappresenta l'autorizzazione. Questo metodo restituisce un oggetto Permission. Ad esempio, per aggiungere l'autorizzazione che consente agli utenti di copiare dati da un documento PDF protetto tramite criterio, passare Permission.COPY. Ripetete questo passaggio per ogni autorizzazione da aggiungere.
   • Aggiungete l'autorizzazione alla voce del criterio richiamando il metodo addPermission dell'oggetto Permission e passando l'oggetto PolicyEntry. (Ripetere questo passaggio per ogni oggetto Permission creato).
   • Creare l'entità del criterio richiamando il metodo statico createSpecialPrincipal dell'oggetto InfomodelObjectFactory. Passa un membro di 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à, passare InfomodelObjectFactory.PUBLISHER_PRINCIPAL.
   • Aggiungete l'entità alla voce del criterio richiamando il metodo setPrincipal dell'oggetto Principal e passando l'oggetto PolicyEntry.
   • Aggiungete la voce del criterio richiamando il metodo addPolicyEntry dell'oggetto PolicyEntry e passando l'oggetto Policy.

5. Registra il criterio.

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

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

     • L'oggetto Policy che rappresenta il criterio da registrare.

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

   Se nelle impostazioni di connessione si utilizza un account amministratore di moduli AEM 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 viene creato nel set di criteri Criteri personali degli amministratori.

   Se utilizzate un utente di Document Security nelle impostazioni di connessione, potete richiamare il metodo sovraccarico registerPolicy 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 di set di criteri quando si richiama il metodo registerPolicy.

   NOTA

   Quando create un criterio, fate riferimento a un set di criteri esistente. Se si specifica un set di criteri che non esiste, viene generata un'eccezione.

Per esempi di codice che utilizzano il servizio Document Security, consultate quanto segue:

• "Avvio rapido (modalità SOAP): Creazione di un criterio tramite l'API Java"

Creare un criterio utilizzando l'API del servizio Web

Create un criterio utilizzando l'API di Document Security (servizio Web):

1. Includere i 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.

   NOTA

   Sostituire localhost con l'indirizzo IP del server che ospita AEM Forms.

2. Creare un oggetto Document Security Client API.

   • Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

   • Creare un oggetto DocumentSecurityServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passate un valore di 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 create un riferimento a un servizio.

   • Creare un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo RightsManagementServiceClient.Endpoint.Binding. Inserite il valore restituito in BasicHttpBinding.

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

   • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:

     • Assegnare il nome utente del modulo 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.

3. Impostate gli attributi del criterio.

   • Creare un oggetto PolicySpec utilizzando il relativo costruttore.
   • Impostate il nome del criterio assegnando un valore stringa al membro di dati PolicySpec dell'oggetto name.
   • Impostate la descrizione del criterio assegnando un valore stringa al membro di dati PolicySpec dell'oggetto description.
   • Impostare il criterio a cui apparterrà il criterio assegnando un valore stringa al membro di dati PolicySpec dell'oggetto policySetName. È necessario specificare un nome di set di criteri esistente. (È possibile specificare null per questo valore di parametro che determina l'aggiunta del criterio a My Policies.)
   • Impostare il periodo di tempo consentito per il criterio offline assegnando un valore intero al membro di dati PolicySpec dell'oggetto offlineLeasePeriod.
   • Impostare il membro di dati PolicySpec dell'oggetto policyXml con un valore di stringa che rappresenta i dati XML PDRL. Per eseguire questa operazione, creare un oggetto .NET StreamReader utilizzando il relativo costruttore. Trasmettere la posizione di un file PDRL XML che rappresenta il criterio al costruttore StreamReader. Quindi, richiamare il metodo StreamReader dell'oggetto ReadLine e assegnare il valore restituito a una variabile di stringa. Iterate l'oggetto StreamReader fino a quando il metodo ReadLine restituisce null. Assegnare la variabile stringa al membro di dati PolicySpec dell'oggetto policyXml.

4. Creare una voce del criterio.

   Non è necessario creare una voce del criterio al momento della creazione di un criterio tramite l'API del servizio Web di Document Security. La voce del criterio è definita nel documento PDF.

5. Registra il criterio.

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

   • L'oggetto PolicySpec che rappresenta il criterio da registrare.
   • Una 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 MyPolices.

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

   Se utilizzate un utente Document Security all'interno delle impostazioni di connessione, potete richiamare il metodo sovraccarico registerPolicy 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 di set di criteri quando si richiama il metodo registerPolicy.

   NOTA

   Quando create un criterio e specificate un set di criteri, accertatevi di specificare un set di criteri esistente. Se si specifica un set di criteri che non esiste, viene generata un'eccezione.

Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:

• "Avvio rapido (MTOM): Creazione di un criterio tramite l'API del servizio Web"
• "Avvio rapido (SwaRef): Creazione di un criterio tramite l'API del servizio Web"

Modifica dei criteri

Potete modificare un criterio esistente utilizzando l'API Java di Document Security o l'API del servizio Web. Per apportare modifiche a un criterio esistente, è necessario recuperarlo, modificarlo e quindi aggiornare il criterio sul server. Ad esempio, si supponga di recuperare un criterio esistente e di estenderne il periodo di validità. Prima che la modifica abbia effetto, è necessario aggiornare il criterio.

Potete modificare un criterio quando i requisiti aziendali cambiano e il criterio non riflette più tali requisiti. Invece di creare un nuovo criterio, potete semplicemente aggiornare un criterio esistente.

Per modificare gli attributi del criterio utilizzando un servizio Web (ad esempio, utilizzando classi proxy Java create con JAX-WS), è necessario verificare che il criterio sia registrato con il servizio Document Security. Potete quindi fare riferimento al criterio esistente utilizzando il metodo PolicySpec.getPolicyXml e modificare gli attributi del criterio utilizzando i metodi applicabili. Ad esempio, potete modificare il periodo di tempo consentito per l'utilizzo non in linea richiamando il metodo PolicySpec.setOfflineLeasePeriod.

Riepilogo dei passaggi

Per modificare un criterio esistente, effettuare le seguenti operazioni:

1. Includere i file di progetto.
2. Creare un oggetto Document Security Client API.
3. Recuperare un criterio esistente.
4. Modificare gli attributi dei criteri.
5. Aggiornare il criterio.

Includi file di progetto

Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.

Creare un oggetto API client Document Security

Prima di poter eseguire un'operazione Document Security Service a livello di programmazione, è necessario creare un oggetto client del servizio Document Security. Se utilizzate l'API Java, create un oggetto RightsManagementClient. Se utilizzate l'API del servizio Web di Document Security, create un oggetto RightsManagementServiceService.

Recuperare un criterio esistente

È necessario recuperare un criterio esistente per modificarlo. Per recuperare un criterio, specificate il nome del criterio e il set al quale il criterio appartiene. Se si specifica un valore null per il nome del set di criteri, il criterio viene recuperato dal set di criteri Criteri personali.

Impostare gli attributi del criterio

Per modificare un criterio, modificate il valore degli attributi del criterio. L'unico attributo di criterio che non potete modificare è l'attributo name. Ad esempio, per modificare il periodo di tempo consentito dal criterio per l'utilizzo non in linea, potete modificare il valore dell'attributo del periodo consentito non in linea del criterio.

Quando si modifica il periodo di tempo consentito per un criterio offline utilizzando un servizio Web, il campo offlineLeasePeriod nell'interfaccia PolicySpec viene ignorato. Per aggiornare il periodo di tempo consentito per l'utilizzo non in linea, modificare l'elemento OfflineLeasePeriod nel documento XML PDRL. Fare quindi riferimento al documento PDF XML aggiornato utilizzando il membro di dati policyXML dell'interfaccia PolicySpec.

Aggiornare il criterio

Prima che le modifiche apportate a un criterio vengano applicate, è necessario aggiornare il criterio con il servizio Document Security. Le modifiche ai criteri di protezione dei documenti vengono aggiornate al successivo aggiornamento della sincronizzazione del documento protetto tramite criterio con il servizio Document Security.

Modificare i criteri esistenti utilizzando l'API Java

Modificate un criterio esistente utilizzando l'API di Document Security (Java):

1. Includere i file di progetto.

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

2. Creare un oggetto Document Security Client API.

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

3. Recuperare un criterio esistente.

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

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

     • Una 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.
     • Una stringa che rappresenta il nome del criterio.

4. Impostate gli attributi del criterio.

   Modificate gli attributi del criterio per soddisfare i requisiti aziendali. Ad esempio, per modificare il periodo di tempo consentito dal criterio per l'utilizzo offline, richiamare il metodo Policy dell'oggetto setOfflineLeasePeriod.

5. Aggiornare il criterio.

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

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, consultate Avvio rapido (modalità SOAP): Modifica di un criterio tramite la sezione Java API.

Modificare i criteri esistenti utilizzando l'API del servizio Web

Modificate un criterio esistente utilizzando l'API di Document Security (servizio Web):

1. Includere i 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.

   NOTA

   Sostituire localhost con l'indirizzo IP del server che ospita AEM Forms.

2. Creare un oggetto Document Security Client API.

   • Creare un oggetto RightsManagementServiceClient utilizzando il relativo costruttore predefinito.

   • Creare un oggetto RightsManagementServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passate un valore di 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 create un riferimento a un servizio.

   • Creare un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo RightsManagementServiceClient.Endpoint.Binding. Inserite il valore restituito in BasicHttpBinding.

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

   • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:

     • Assegnare il nome utente del modulo 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.

3. Recuperare un criterio esistente.

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

   • Una 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.
   • Un valore di stringa che specifica il nome del criterio.

4. Impostate gli attributi del criterio.

   Modificate gli attributi del criterio per soddisfare i requisiti aziendali.

5. Aggiornare il criterio.

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

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:

• "Avvio rapido (MTOM): Modifica di un criterio tramite l'API del servizio Web"
• "Avvio rapido (SwaRef): Modifica di un criterio tramite l'API del servizio Web"

Eliminazione dei criteri

Potete eliminare un criterio esistente utilizzando l'API Java di Document Security o l'API del servizio Web. Una volta eliminato, un criterio non può più essere utilizzato per proteggere i documenti. Tuttavia, i documenti protetti tramite criterio esistenti che utilizzano il criterio sono ancora protetti. Potete eliminare un criterio quando diventa disponibile un criterio più recente.

Riepilogo dei passaggi

Per eliminare un criterio esistente, eseguire le operazioni seguenti:

1. Includi file di progetto
2. Creare un oggetto Document Security Client API.
3. Eliminate il criterio.

Includi file di progetto

Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.

Creare un oggetto API client Document Security

Prima di poter eseguire un'operazione del servizio Document Security a livello di programmazione, è necessario creare un oggetto client del servizio Document Security. Se utilizzate l'API Java, create un oggetto RightsManagementClient. Se utilizzate l'API del servizio Web di Document Security, create un oggetto RightsManagementServiceService.

Eliminare il criterio

Per eliminare un criterio, è necessario specificare il criterio da eliminare e il set al quale il criterio appartiene. L'utente le cui impostazioni sono utilizzate per richiamare AEM Forms deve disporre dell'autorizzazione per eliminare il criterio; in caso contrario si verifica un'eccezione. Analogamente, se si tenta di eliminare un criterio che non esiste, si verifica un'eccezione.

Eliminare i criteri utilizzando l'API Java

Eliminate un criterio utilizzando l'API di Document Security (Java):

1. Includere i file di progetto.

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

2. Creare un oggetto Document Security Client API.

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

3. Eliminate il criterio.

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

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

     • Una 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.
     • Un valore di stringa che specifica il nome del criterio da eliminare.

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:

• "Avvio rapido (modalità SOAP): Eliminazione di un criterio tramite l'API Java"

Eliminare i criteri utilizzando l'API del servizio Web

Eliminate un criterio utilizzando l'API di Document Security (servizio Web):

1. Includere i 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.

   NOTA

   Sostituire localhost con l'indirizzo IP del server che ospita AEM Forms.

2. Creare un oggetto Document Security Client API.

   • Creare un oggetto RightsManagementServiceClient utilizzando il relativo costruttore predefinito.

   • Creare un oggetto RightsManagementServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passate un valore di 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 create un riferimento a un servizio.

   • Creare un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo RightsManagementServiceClient.Endpoint.Binding. Inserite il valore restituito in BasicHttpBinding.

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

   • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:

     • Assegnare il nome utente del modulo 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.

3. Eliminate il criterio.

   Per eliminare un criterio, richiamate il metodo RightsManagementServiceClient dell'oggetto deletePolicy e passate i seguenti valori:

   • Una 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.
   • Un valore di stringa che specifica il nome del criterio da eliminare.

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:

• "Avvio rapido (MTOM): Eliminazione di un criterio tramite l'API del servizio Web"
• "Avvio rapido (SwaRef): Eliminazione di un criterio tramite l'API del servizio Web"

Applicazione dei criteri ai documenti PDF

È possibile applicare un criterio a un documento PDF per proteggere il documento. Applicando un criterio a un documento PDF, è possibile limitare l'accesso al documento. Non è possibile applicare un criterio a un documento se il documento è già protetto con un criterio.

Mentre il documento è aperto, è inoltre possibile limitare l'accesso alle funzioni di Acrobat e Adobe Reader, inclusa la possibilità di stampare e copiare il testo, apportare modifiche e aggiungere firme e commenti a un documento. Inoltre, è possibile revocare un documento PDF protetto tramite criterio quando non si desidera più che gli utenti accedano al documento.

È possibile monitorare l'utilizzo di un documento protetto tramite criterio dopo averlo distribuito. In altre parole, potete vedere come viene utilizzato il documento e chi lo sta utilizzando. Ad esempio, è possibile verificare quando un utente ha aperto il documento.

Riepilogo dei passaggi

Per applicare un criterio a un documento PDF, effettuare le seguenti operazioni:

1. Includere i file di progetto.
2. Creare un oggetto Document Security Client API.
3. Recuperare un documento PDF a cui viene applicato un criterio.
4. Applicare un criterio esistente al documento PDF.
5. Salvate il documento PDF protetto tramite criterio.

Includi file di progetto

Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.

Creare un oggetto API client Document Security

Prima di eseguire un'operazione del servizio Document Security a livello di programmazione, create un oggetto client del servizio Document Security. Se utilizzate l'API Java, create un oggetto DocumentSecurityClient. Se utilizzate l'API del servizio Web di Document Security, create un oggetto DocumentSecurityServiceService.

Recupero di un documento PDF

È possibile recuperare un documento PDF per applicare un criterio. Dopo aver applicato un criterio al documento PDF, gli utenti possono utilizzare il documento con restrizioni. Ad esempio, se il criterio non consente l'apertura del documento offline, gli utenti devono essere online per aprire il documento.

Applicare un criterio esistente al documento PDF

Per applicare un criterio a un documento PDF, fare riferimento a un criterio esistente e specificare a quale set di criteri appartiene il criterio. L'utente che sta impostando le proprietà di connessione deve avere accesso al criterio specificato. In caso contrario, si verifica un'eccezione.

Salvare il documento PDF

Dopo che il servizio Document Security ha applicato un criterio a un documento PDF, potete salvare il documento PDF protetto tramite criterio come file PDF.

Consulta anche

Inclusione file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Revoca dell'accesso ai documenti

Applicazione di un criterio a un documento PDF tramite l'API Java

Applicare un criterio a un documento PDF utilizzando l'API Document Security (Java):

1. Includere i file di progetto.

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

2. Creare un oggetto Document Security Client API.

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

3. Recuperare un documento PDF.

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

4. Applicare un criterio esistente al documento PDF.

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

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

     • L'oggetto com.adobe.idp.Document che contiene il documento PDF a cui viene applicato il criterio.
     • Una stringa che specifica il nome del documento.
     • Un valore di stringa che specifica il nome dell'insieme di criteri a cui appartiene il criterio. È possibile specificare un valore null che determina l'utilizzo del set di criteri MyPolicies.
     • Una stringa che specifica il nome del criterio.
     • Una stringa che rappresenta il nome del dominio di gestione utenti dell'utente che è l'editore del documento. Questo valore del parametro è facoltativo e può essere nullo (se questo parametro è nullo, il valore successivo del parametro deve essere null).
     • Una stringa che rappresenta il nome del nome canonico dell'utente manager utente che è l'editore del documento. Questo valore del parametro è facoltativo e può essere null (se questo parametro è nullo, il valore del parametro precedente deve essere null).
     • Un com.adobe.livecycle.rightsmanagement.Locale che rappresenta le impostazioni internazionali utilizzate per selezionare il modello di MS Office. Questo valore del 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 criterio.

5. Salvare il documento PDF.

   • Richiamare il metodo RMSecureDocumentResult dell'oggetto getProtectedDoc per ottenere il documento PDF protetto tramite criterio. 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 com.adobe.idp.Document dell'oggetto copyToFile per copiare nel file il contenuto dell'oggetto Document (assicurarsi di utilizzare l'oggetto Document restituito dal metodo getProtectedDoc).

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:

• "Avvio rapido (modalità EJB): Applicazione di un criterio a un documento PDF tramite l'API Java"
• "Avvio rapido (modalità SOAP): Applicazione di un criterio a un documento PDF tramite l'API Java"

Consulta anche

Inclusione file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Applicazione di un criterio a un documento PDF tramite l'API del servizio Web

Applicare un criterio a un documento PDF utilizzando l'API di Document Security (servizio Web):

1. Includere i 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.

   NOTA

   Sostituire localhost con l'indirizzo IP del server che ospita AEM Forms.

2. Creare un oggetto Document Security Client API.

   • Creare un oggetto RightsManagementServiceClient utilizzando il relativo costruttore predefinito.

   • Creare un oggetto RightsManagementServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passate un valore di 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 create un riferimento a un servizio.

   • Creare un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo RightsManagementServiceClient.Endpoint.Binding. Inserite il valore restituito in BasicHttpBinding.

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

   • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:

     • Assegnare il nome utente del modulo 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.

3. 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 richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF e la modalità di apertura del file.
   • Creare un array di byte che memorizza il contenuto dell'oggetto System.IO.FileStream. Determinare la dimensione dell'array di byte ottenendo la proprietà Length dell'oggetto System.IO.FileStream.
   • Compilare l'array di byte con i dati del flusso richiamando il metodo System.IO.FileStream dell'oggetto Read. Passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
   • Compilare l'oggetto BLOB assegnando il relativo campo MTOM con il contenuto dell'array di byte.

4. Applicare un criterio esistente al documento PDF.

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

   • L'oggetto BLOB che contiene il documento PDF a cui viene applicato il criterio.
   • Una stringa che specifica il nome del documento.
   • Un valore di stringa che specifica il nome dell'insieme di criteri a cui appartiene il criterio. È possibile specificare un valore null che determina l'utilizzo del set di criteri MyPolicies.
   • Una stringa che specifica il nome del criterio.
   • Una stringa che rappresenta il nome del dominio di gestione utenti dell'utente che è l'editore del documento. Questo valore del parametro è facoltativo e può essere nullo (se questo parametro è nullo, il valore successivo del parametro deve essere null).
   • Una stringa che rappresenta il nome del nome canonico dell'utente manager utente che è l'editore del documento. Questo valore del parametro è facoltativo e può essere nullo (se questo parametro è nullo, il valore del parametro precedente deve essere null).
   • Un valore RMLocale che specifica il valore delle impostazioni internazionali (ad esempio, RMLocale.en).
   • Un parametro di output della stringa utilizzato per memorizzare il valore dell'identificatore del criterio.
   • Parametro di output della stringa utilizzato per memorizzare il valore dell'identificatore protetto tramite criterio.
   • Un parametro di output della stringa utilizzato per memorizzare il tipo mime (ad esempio, application/pdf).

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

5. Salvare il documento PDF.

   • Creare un oggetto System.IO.FileStream richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF protetto tramite criterio.
   • Creare un array di byte che memorizza il contenuto dei dati dell'oggetto BLOB restituito dal metodo protectDocument. Compilare l'array di byte ottenendo il valore del membro di dati BLOB dell'oggetto MTOM.
   • Creare un oggetto System.IO.BinaryWriter richiamandone il costruttore e passando l'oggetto System.IO.FileStream.
   • Scrivere il contenuto dell'array di byte in un file PDF richiamando il metodo System.IO.BinaryWriter dell'oggetto Write e passando l'array di byte.

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:

• "Avvio rapido (MTOM): Applicazione di un criterio a un documento PDF tramite l'API del servizio Web"
• "Avvio rapido (SwaRef): Applicazione di un criterio a un documento PDF tramite l'API del servizio Web"

Rimozione di criteri dai documenti PDF

È possibile rimuovere un criterio da un documento protetto tramite criterio per rimuovere la protezione dal documento. Se non si desidera più che il documento sia protetto tramite un criterio. Se desiderate aggiornare un documento protetto tramite criterio con un criterio più recente, invece di rimuovere il criterio e aggiungere il criterio aggiornato, è più efficiente cambiare il criterio.

Riepilogo dei passaggi

Per rimuovere un criterio da un documento PDF protetto tramite criterio, effettuare le seguenti operazioni:

1. Includi file di progetto
2. Creare un oggetto Document Security Client API.
3. Recuperare un documento PDF protetto tramite criterio.
4. Rimuovere il criterio dal documento PDF.
5. Salvare il documento PDF non protetto.

Includi file di progetto

Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.

Creare un oggetto API client Document Security

Prima di eseguire un'operazione del servizio Document Security a livello di programmazione, create un oggetto client del servizio Document Security.

Recuperare un documento PDF protetto tramite criterio

È possibile recuperare un documento PDF protetto tramite criterio per rimuovere un criterio. Se tentate di rimuovere un criterio da un documento PDF non protetto da un criterio, causerete un'eccezione.

Rimuovere il criterio dal documento PDF

È possibile rimuovere un criterio da un documento PDF protetto tramite criterio a condizione che nelle impostazioni di connessione sia specificato un amministratore. In caso contrario, il criterio utilizzato per proteggere un documento deve contenere l'autorizzazione SWITCH_POLICY per rimuovere un criterio da un documento PDF. Inoltre, anche l'utente specificato nelle impostazioni di connessione di AEM Forms deve disporre di tale autorizzazione. In caso contrario, viene generata un'eccezione.

Salvare il documento PDF non protetto

Dopo che il servizio Document Security ha rimosso un criterio da un documento PDF, potete salvare il documento PDF non protetto come file PDF.

Consulta anche

Inclusione file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Applicazione dei criteri ai documenti PDF

Rimuovere un criterio da un documento PDF utilizzando l'API Java

Rimuovere un criterio da un documento PDF protetto tramite criterio utilizzando l'API Document Security (Java):

1. Includere i file di progetto.

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

2. Creare un oggetto Document Security Client API.

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

3. Recuperare un documento PDF protetto tramite criterio.

   • Creare un oggetto java.io.FileInputStream che rappresenti il documento PDF protetto tramite criterio utilizzando il relativo costruttore e passando un valore di 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.

4. Rimuovere il criterio dal documento PDF.

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

5. Salvare il documento PDF non protetto.

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

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:

• "Avvio rapido (modalità SOAP): Rimozione di un criterio da un documento PDF tramite l'API Java"

Rimozione di un criterio tramite l'API del servizio Web

Rimuovere un criterio da un documento PDF protetto tramite criterio utilizzando l'API di Document Security (servizio Web):

1. Includere i 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.

   NOTA

   Sostituire localhost con l'indirizzo IP del server che ospita AEM Forms.

2. Creare un oggetto Document Security Client API.

   • Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

   • Creare un oggetto DocumentSecurityServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passate un valore di 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 create un riferimento a un servizio.

   • Creare un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo DocumentSecurityServiceClient.Endpoint.Binding. Inserite il valore restituito in BasicHttpBinding.

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

   • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:

     • Assegnare il nome utente del modulo 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.

3. Recuperare un documento PDF protetto tramite criterio.

   • Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare il documento PDF protetto tramite criterio dal quale viene rimosso il criterio.
   • Creare un oggetto System.IO.FileStream richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF e la modalità di apertura del file.
   • Creare un array di byte che memorizza il contenuto dell'oggetto System.IO.FileStream. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà System.IO.FileStream dell'oggetto Length.
   • Compilare l'array di byte con i dati del flusso richiamando il metodo Read dell'oggetto System.IO.FileStream e passando l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
   • Compilare l'oggetto BLOB assegnando il relativo campo MTOM con il contenuto dell'array di byte.

4. Rimuovere il criterio dal documento PDF.

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

5. Salvare il documento PDF non protetto.

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

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:

• "Avvio rapido (MTOM): Rimozione di un criterio da un documento PDF tramite l'API del servizio Web"
• "Avvio rapido (SwaRef): Rimozione di un criterio da un documento PDF tramite l'API del servizio Web"

Consulta anche

Chiamata AEM Forms tramite MTOM

Chiamata AEM Forms tramite SwaRef

Revoca dell'accesso ai documenti

È possibile revocare l'accesso a un documento PDF protetto tramite criterio in modo che tutte le copie del documento non siano accessibili agli utenti. Quando un utente tenta di aprire un documento PDF revocato, viene reindirizzato a un URL specificato in cui è possibile visualizzare un documento modificato. È necessario specificare a livello di programmazione l'URL al quale l'utente viene reindirizzato. Quando revocate l'accesso a un documento, la modifica ha effetto alla successiva sincronizzazione dell'utente con il servizio Document Security aprendo il documento protetto tramite criterio online.

La capacità di revocare l'accesso a un documento offre ulteriore protezione. Ad esempio, si supponga che sia disponibile una versione più recente di un documento e che non si desideri più che qualcuno visualizzi la versione obsoleta. In questa situazione, l'accesso al documento precedente può essere revocato e nessuno può visualizzare il documento a meno che non venga ripristinato l'accesso.

Riepilogo dei passaggi

Per revocare un documento protetto tramite criterio, effettuare le seguenti operazioni:

1. Includere i file di progetto.
2. Creare un oggetto Document Security Client API.
3. Recuperare un documento PDF protetto tramite criterio.
4. Revoca del documento protetto tramite criterio.

Includi file di progetto

Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.

Creare un oggetto API client Document Security

Prima di poter eseguire un'operazione del servizio Document Security a livello di programmazione, è necessario creare un oggetto client del servizio Document Security.

Recuperare un documento PDF protetto tramite criterio

È necessario recuperare un documento PDF protetto tramite criterio per revocarlo. Non è possibile revocare un documento già revocato o non protetto tramite criterio.

Se si conosce il valore dell'identificatore di licenza del documento protetto tramite criterio, non è necessario recuperare il documento PDF protetto tramite criterio. Tuttavia, nella maggior parte dei casi, è necessario recuperare il documento PDF per ottenere il valore dell'identificatore di licenza.

Revoca del documento protetto tramite criterio

Per revocare un documento protetto tramite criterio, specificate l'identificatore di licenza del documento protetto tramite criterio. Inoltre, è possibile specificare l'URL di un documento che l'utente può visualizzare quando cerca di aprire il documento revocato. Si supponga quindi che venga revocato un documento obsoleto. Quando un utente tenta di aprire il documento revocato, visualizzerà un documento aggiornato invece del documento revocato.

Consulta anche

Inclusione file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Applicazione dei criteri ai documenti PDF

Ripristino dell'accesso ai documenti revocati

Revoca l'accesso ai documenti tramite l'API Java

Revocare l'accesso a un documento PDF protetto tramite criterio utilizzando l'API Document Security (Java):

1. Includi file di progetto

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

2. Creare un oggetto API client Document Security

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

3. Recuperare un documento PDF protetto tramite criterio

   • Creare un oggetto java.io.FileInputStream che rappresenti il documento PDF protetto tramite criterio utilizzando il relativo costruttore e passando un valore di 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.

4. Revoca del documento protetto tramite criterio

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

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

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

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

     • Un valore di stringa che specifica il valore dell'identificatore di licenza del documento protetto tramite criterio (specificare il valore restituito dal metodo DocumentManager dell'oggetto getLicenseId).
     • Un membro di dati statici dell'interfaccia License che specifica il motivo della revoca del documento. Ad esempio, è possibile specificare License.DOCUMENT_REVISED.
     • Un valore java.net.URL che specifica la posizione in cui si trova un documento modificato. Se non si desidera reindirizzare un utente a un altro URL, è possibile passare null.

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:

• "Avvio rapido (modalità SOAP): Revoca di un documento tramite l'API Java"

Revoca l'accesso ai documenti tramite l'API del servizio Web

Revocare l'accesso a un documento PDF protetto tramite criterio utilizzando l'API di Document Security (servizio Web):

1. 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.

   NOTA

   Sostituire localhost con l'indirizzo IP del server che ospita AEM Forms.

2. Creare un oggetto API client Document Security

   • Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

   • Creare un oggetto DocumentSecurityServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passate un valore di 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 create un riferimento a un servizio.

   • Creare un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo DocumentSecurityServiceClient.Endpoint.Binding. Inserite il valore restituito in BasicHttpBinding.

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

   • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:

     • Assegnare il nome utente del modulo 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.

3. Recuperare un documento PDF protetto tramite criterio

   • Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare un documento PDF protetto tramite criterio revocato.
   • Creare un oggetto System.IO.FileStream richiamando il relativo costruttore e passando un valore di stringa che rappresenta il percorso del file del documento PDF protetto tramite criterio da revocare e la modalità di apertura del file.
   • Creare un array di byte che memorizza il contenuto dell'oggetto System.IO.FileStream. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà System.IO.FileStream dell'oggetto Length.
   • Compilare l'array di byte con i dati del flusso richiamando il metodo Read dell'oggetto System.IO.FileStream e passando l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
   • Compilare l'oggetto BLOB assegnando il relativo campo MTOM con il contenuto dell'array di byte.

4. Revoca del documento protetto tramite criterio

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

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

     • Un valore di stringa che specifica il valore dell'identificatore di licenza del documento protetto tramite criterio (specificare il valore restituito dal metodo DocumentSecurityServiceService dell'oggetto getLicenseId).
     • Un membro di dati statici dell'enum Reason che specifica il motivo della revoca del documento. Ad esempio, è possibile specificare Reason.DOCUMENT_REVISED.
     • Un valore string che specifica la posizione dell'URL in cui si trova il documento rivisto. Se non si desidera reindirizzare un utente a un altro URL, è possibile passare null.

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:

• "Avvio rapido (MTOM): Revoca di un documento tramite l'API del servizio Web"
• "Avvio rapido (SwaRef): Revoca di un documento tramite l'API del servizio Web"

Consulta anche

Rimozione di criteri dai documenti di Word

Chiamata AEM Forms tramite MTOM

Chiamata AEM Forms tramite SwaRef

Ripristino dell'accesso ai documenti revisionati

È possibile ripristinare l'accesso a un documento PDF revocato, in modo che tutte le copie del documento revocato siano accessibili agli utenti. Quando un utente apre un documento ripristinato revocato, può visualizzare il documento.

Riepilogo dei passaggi

Per ripristinare l'accesso a un documento PDF revocato, effettuare le seguenti operazioni:

1. Includere i file di progetto.
2. Creare un oggetto Document Security Client API.
3. Recuperare l'identificatore di licenza del documento PDF revocato.
4. Ripristinare l'accesso al documento PDF revocato.

Includi file di progetto

Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.

Creare un oggetto API client Document Security

Prima di poter eseguire un'operazione del servizio Document Security a livello di programmazione, è necessario creare un oggetto client del servizio Document Security. Se utilizzate l'API Java, create un oggetto DocumentSecurityClient. Se utilizzate l'API del servizio Web di Document Security, create un oggetto DocumentSecurityServiceService.

Recuperare l'identificatore di licenza del documento PDF revocato

Per ripristinare un documento PDF revocato, è necessario recuperare l’identificatore di licenza del documento PDF revocato. Dopo aver ottenuto il valore dell'identificatore di licenza, potete ripristinare un documento revocato. Se si tenta di ripristinare un documento che non viene revocato, verrà generata un'eccezione.

Ripristino dell'accesso al documento PDF revocato

Per ripristinare l'accesso a un documento PDF revocato, è necessario specificare l'identificatore di licenza del documento revocato. Se si tenta di ripristinare l'accesso a un documento PDF non revocato, si verificherà un'eccezione.

Consulta anche

Inclusione file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Applicazione dei criteri ai documenti PDF

Revoca dell'accesso ai documenti

Ripristino dell'accesso ai documenti revocati tramite l'API Java

Ripristinate l'accesso a un documento revocato utilizzando l'API di Document Security (Java):

1. Includere i file di progetto.

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

2. Creare un oggetto Document Security Client API.

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

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

4. Ripristinare l'accesso al documento PDF revocato.

   • Creare un oggetto LicenseManager richiamando il metodo DocumentSecurityClient dell'oggetto getLicenseManager.
   • 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.

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:

• "Avvio rapido (modalità SOAP): Ripristino dell'accesso a un documento revocato tramite l'API del servizio Web"

Ripristino dell'accesso ai documenti revocati tramite l'API del servizio Web

Ripristinate l'accesso a un documento revocato utilizzando l'API di Document Security (servizio Web):

1. Includere i 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.

   NOTA

   Sostituire localhost con l'indirizzo IP del server che ospita AEM Forms.

2. Creare un oggetto Document Security Client API.

   • Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

   • Creare un oggetto DocumentSecurityServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passate un valore di 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 create un riferimento a un servizio.

   • Creare un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo DocumentSecurityServiceClient.Endpoint.Binding. Inserite il valore restituito in BasicHttpBinding.

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

   • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:

     • Assegnare il nome utente del modulo 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.

3. Recuperare l'identificatore di licenza del documento PDF revocato.

   • Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare un documento PDF revocato al quale viene ripristinato l'accesso.
   • Creare un oggetto System.IO.FileStream richiamando il relativo costruttore e passando un valore di stringa che rappresenta il percorso del file del documento PDF revocato e la modalità di apertura del file.
   • Creare un array di byte che memorizza il contenuto dell'oggetto System.IO.FileStream. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà System.IO.FileStream dell'oggetto Length.
   • Compilare l'array di byte con i dati del flusso richiamando il metodo Read dell'oggetto System.IO.FileStream e passando l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
   • Compilare l'oggetto BLOB assegnando il relativo campo MTOM con il contenuto dell'array di byte.

4. Ripristinare l'accesso al documento PDF revocato.

   • Recuperare il valore dell'identificatore di licenza del documento revocato richiamando il metodo getLicenseID dell'oggetto BLOB e passando l'oggetto DocumentSecurityServiceClient che rappresenta il documento revocato. Questo metodo restituisce un valore di 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 di stringa che specifica il valore dell'identificatore di licenza del documento PDF revocato (passare il valore restituito dal metodo DocumentSecurityServiceClient dell'oggetto getLicenseId).

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:

• "Avvio rapido (MTOM): Ripristino dell'accesso a un documento revocato tramite l'API del servizio Web"
• "Avvio rapido (SwaRef): Ripristino dell'accesso a un documento revocato tramite l'API del servizio Web"

Consulta anche

Chiamata AEM Forms tramite MTOM

Chiamata AEM Forms tramite SwaRef

Verifica dei documenti PDF protetti tramite criterio

Potete utilizzare l'API di Document Security Service (Java e il servizio Web) per ispezionare i documenti PDF protetti tramite criterio. L'ispezione dei documenti PDF protetti tramite criterio restituisce informazioni sul documento PDF protetto tramite criterio. È possibile, ad esempio, determinare il criterio utilizzato per proteggere il documento e la data in cui il documento è stato protetto.

Non potete eseguire questa operazione se la versione dell'LiveCycle in uso è 8.x o precedente. In AEM Forms viene aggiunto il supporto per l'ispezione di documenti protetti tramite criterio. Se tentate di ispezionare un documento protetto tramite criterio utilizzando l'LiveCycle 8.x (o versioni precedenti), viene generata un'eccezione.

Riepilogo dei passaggi

Per esaminare un documento PDF protetto tramite criterio, effettuare le seguenti operazioni:

1. Includere i file di progetto.
2. Creare un oggetto Document Security Client API.
3. Recuperare un documento protetto tramite criterio da esaminare.
4. Ottenete informazioni sul documento protetto tramite criterio.

Includi file di progetto

Includete i file necessari nel progetto di sviluppo. Se create un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate i servizi Web, accertatevi di includere i file proxy.

Creare un oggetto API client Document Security

Prima di eseguire un'operazione del servizio Document Security a livello di programmazione, create un oggetto client del servizio Document Security. Se utilizzate l'API Java, create un oggetto RightsManagementClient. Se utilizzate l'API del servizio Web di Document Security, create un oggetto RightsManagementServiceService.

Recuperare un documento protetto tramite criterio da esaminare

Per esaminare un documento protetto tramite criterio, recuperatelo. Se tentate di ispezionare un documento non protetto con un criterio o revocato, viene generata un'eccezione.

Inspect il documento

Dopo aver recuperato un documento protetto tramite criterio, potete controllarlo.

Ottenere informazioni sul documento protetto tramite criterio

Dopo aver esaminato un documento PDF protetto tramite criterio, potete ottenere informazioni su di esso. Ad esempio, è possibile determinare il criterio utilizzato per proteggere il documento.

Se si protegge un documento con un criterio che appartiene a Criteri personali e quindi si chiama RMInspectResult.getPolicysetName o RMInspectResult.getPolicysetId, viene restituito null.

Se il documento è protetto tramite un criterio contenuto in un set di criteri (diverso da Criteri personali), RMInspectResult.getPolicysetName e RMInspectResult.getPolicysetId restituiscono stringhe valide.

Consulta anche

Inclusione file libreria Java AEM Forms

Impostazione delle proprietà di connessione

documenti PDF protetti tramite criterio Inspect utilizzando l'API Java

ad Inspect un documento PDF protetto tramite criterio utilizzando l'API di Document Security Service (Java):

1. Includere i file di progetto.

   Includete file JAR client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java. Per informazioni sulla posizione di questi file, vedere Inclusione file libreria Java AEM Forms.

2. Creare un oggetto Document Security Client API.

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

3. Recuperare un documento protetto tramite criterio da esaminare.

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

4. Inspect il documento.

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

5. Ottenete informazioni sul documento protetto tramite criterio.

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

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:

• "Avvio rapido (modalità SOAP): Ispezione dei documenti PDF protetti tramite criterio tramite l'API Java"

documenti PDF protetti tramite criterio Inspect utilizzando l'API del servizio Web

ad Inspect un documento PDF protetto tramite criterio utilizzando l'API di Document Security Service (servizio Web):

1. Includere i 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.

   NOTA

   Sostituire localhost con l'indirizzo IP del server che ospita AEM Forms.

2. Creare un oggetto Document Security Client API.

   • Creare un oggetto RightsManagementServiceClient utilizzando il relativo costruttore predefinito.

   • Creare un oggetto RightsManagementServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passate un valore di 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 create un riferimento a un servizio.

   • Creare un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo RightsManagementServiceClient.Endpoint.Binding. Inserite il valore restituito in BasicHttpBinding.

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

   • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:

     • Assegnare il nome utente del modulo 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.

3. Recuperare un documento protetto tramite criterio da esaminare.

   • Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare un documento PDF da esaminare.
   • Creare un oggetto System.IO.FileStream richiamandone il costruttore. Passare un valore di stringa che rappresenta la posizione del file del documento PDF e la modalità di apertura del file.
   • Creare un array di byte che memorizza il contenuto dell'oggetto System.IO.FileStream. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà System.IO.FileStream dell'oggetto Length.
   • Compilare l'array di byte con i dati del flusso richiamando il metodo System.IO.FileStream dell'oggetto Read. Passare l'array di byte, la posizione iniziale e la lunghezza del flusso per la lettura.
   • Compilare l'oggetto BLOB assegnando il relativo campo MTOM con il contenuto dell'array di byte.

4. Inspect il documento.

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

5. Ottenete informazioni sul documento protetto tramite criterio.

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

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:

• "Avvio rapido (MTOM): Ispezione dei documenti PDF protetti tramite criterio tramite l'API del servizio Web"
• "Avvio rapido (SwaRef): Ispezione dei documenti PDF protetti tramite criterio tramite l'API del servizio Web"

Consulta anche

Chiamata AEM Forms tramite MTOM

Chiamata AEM Forms tramite SwaRef

Creazione di filigrane

Le filigrane garantiscono la sicurezza di un documento identificando in modo univoco il documento e controllando la violazione del copyright. Ad esempio, è possibile creare e inserire una filigrana con l'indicazione Riservato su tutte le pagine di un documento. Dopo la creazione di una filigrana, potete includerla come parte di un criterio. In altre parole, potete impostare l'attributo della filigrana del criterio con la filigrana appena creata. Dopo che un criterio contenente una filigrana è stato applicato a un documento, la filigrana viene visualizzata nel documento protetto tramite criterio.

Riepilogo dei passaggi

Per creare una filigrana, effettuate le seguenti operazioni:

1. Includere i file di progetto.
2. Creare un oggetto Document Security Client API.
3. Impostare gli attributi delle filigrane.
4. Registra la filigrana con il servizio Document Security.

Includi file di progetto

Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.

Creare un oggetto API client Document Security

Prima di poter eseguire un'operazione del servizio Document Security a livello di programmazione, è necessario creare un oggetto client del servizio Document Security. Se utilizzate l'API Java, create un oggetto RightsManagementClient. Se utilizzate l'API del servizio Web di Document Security, create un oggetto RightsManagementServiceService.

Impostare gli attributi delle filigrane

Per creare una nuova filigrana, è necessario impostare gli attributi della filigrana. L'attributo name deve sempre essere definito. Oltre all'attributo name, è necessario impostare almeno uno dei seguenti attributi:

• Testo personalizzato
• DateIncluso
• UserIdInclused
• NomeUtenteIncluso

Nella tabella seguente sono elencate le coppie chiave-valore richieste per la creazione di una filigrana tramite i servizi Web.

Nome chiave	Descrizione	Valore
WaterBackCmd:IS_USERNAME_ENABLED	Specifica se il nome utente dell'utente che apre il documento fa parte della filigrana.	True o False
WaterBackCmd:IS_USERID_ENABLED	Specifica se l'identificazione dell'utente che apre il documento fa parte della filigrana.	True o False
WaterBackCmd:IS_CURRENTDATE_ENABLED	Specifica se la data corrente fa parte della filigrana.	True o False
WaterBackCmd:IS_CUSTOMTEXT_ENABLED	Se questo valore è true, il valore del testo personalizzato deve essere specificato utilizzando WaterBackCmd:SRCTEXT.	True o False
WaterBackCmd:OPACITY	Specifica l’opacità della filigrana. Il valore predefinito è 0,5 se non è specificato.	Un valore compreso tra 0,0 e 1,0.
WaterBackCmd:ROTATION	Specifica la rotazione della filigrana. Il valore predefinito è 0 gradi.	Un valore compreso tra 0 e 359.
WaterBackCmd:SCALE	Se questo valore viene specificato, WaterBackCmd:IS_SIZE_ENABLED deve essere presente e il valore deve essere true. Se questo attributo non è specificato, il comportamento predefinito è adatto alla pagina.	Un valore maggiore di 0.0 e inferiore o uguale a 1.0.
WaterBackCmd:HORIZ_ALIGN	Specifica l'allineamento orizzontale della filigrana. Il valore predefinito è center.	a sinistra, al centro o a destra
WaterBackCmd:VERT_ALIGN	Specifica l'allineamento verticale della filigrana. Il valore predefinito è center.	top, center o bottom
WaterBackCmd:IS_USE_BACKGROUND	Specifica se la filigrana è uno sfondo. Il valore predefinito è false.	True o False
WaterBackCmd:IS_SIZE_ENABLED	True se viene specificata una scala personalizzata. Se questo valore è true, è necessario specificare anche SCALE. Se questo valore è false, il valore predefinito è adatto alla pagina.	True o False
WaterBackCmd:SRCTEXT	Specifica il testo personalizzato per una filigrana. Se questo valore è presente, anche WaterBackCmd:IS_CUSTOMTEXT_ENABLED deve essere presente e impostato su true.	True o False

Tutte le filigrane devono avere uno dei seguenti attributi definiti:

• WaterBackCmd:IS_USERNAME_ENABLED
• WaterBackCmd:IS_USERID_ENABLED
• WaterBackCmd:IS_CURRENTDATE_ENABLED
• WaterBackCmd:IS_CUSTOMTEXT_ENABLED

Tutti gli altri attributi sono facoltativi.

Registrazione della filigrana

Prima di poter essere utilizzata, è necessario registrare una nuova filigrana con il servizio Document Security. Dopo aver registrato una filigrana, è possibile utilizzarla all'interno dei criteri.

Consulta anche

Inclusione file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Applicazione dei criteri ai documenti PDF

Creare filigrane utilizzando l'API Java

Create una filigrana utilizzando l'API di Document Security (Java):

1. Includere i file di progetto.

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

2. Creare un oggetto Document Security Client API.

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

3. Impostare gli attributi della filigrana

   • Creare un oggetto Watermark richiamando il metodo statico InfomodelObjectFactory dell'oggetto createWatermark. Questo metodo restituisce un oggetto Watermark.
   • Impostate l'attributo nome della filigrana richiamando il metodo setName dell'oggetto Watermark e passando un valore di stringa che specifica il nome del criterio.
   • Impostare l'attributo di sfondo della filigrana richiamando il metodo setBackground dell'oggetto true e passando Watermark. 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 di 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 la filigrana è completamente trasparente.

4. Registra la filigrana.

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

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:

• "Avvio rapido (modalità SOAP): Creazione di una filigrana mediante l'API Java"

Creare filigrane utilizzando l'API del servizio Web

Create una filigrana utilizzando l'API di Document Security (servizio Web):

1. Creare un oggetto Document Security Client API.

   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.

   NOTA

   Sostituire localhost con l'indirizzo IP del server che ospita AEM Forms.

2. Creare un oggetto Document Security Client API.

   • Creare un oggetto RightsManagementServiceClient utilizzando il relativo costruttore predefinito.

   • Creare un oggetto RightsManagementServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passate un valore di 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 create un riferimento a un servizio.

   • Creare un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo RightsManagementServiceClient.Endpoint.Binding. Inserite il valore restituito in BasicHttpBinding.

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

   • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:

     • Assegnare il nome utente del modulo 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.

3. Impostate gli attributi della filigrana.

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

4. Registra la filigrana.

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

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:

• "Avvio rapido (MTOM): Creazione di una filigrana mediante l'API del servizio Web"
• "Avvio rapido (SwaRef): Creazione di una filigrana mediante l'API del servizio Web"

Consulta anche

Chiamata AEM Forms tramite MTOM

Chiamata AEM Forms tramite SwaRef

Modifica delle filigrane

Potete modificare una filigrana esistente utilizzando l'API Java di Document Security o l'API del servizio Web. Per apportare modifiche a una filigrana esistente, recuperarla, modificarne gli attributi e quindi aggiornarla sul server. Ad esempio, supponete di recuperare una filigrana e modificarne l’attributo di opacità. Prima che la modifica abbia effetto, è necessario aggiornare la filigrana.

Quando modificate una filigrana, la modifica ha effetto sui documenti futuri a cui è stata applicata la filigrana. In altre parole, i documenti PDF esistenti contenenti la filigrana non vengono modificati.

Riepilogo dei passaggi

Per modificare una filigrana, effettuare le seguenti operazioni:

1. Includere i file di progetto.
2. Creare un oggetto Document Security Client API.
3. Recuperate la filigrana da modificare.
4. Impostare gli attributi delle filigrane.
5. Aggiorna la filigrana.

Includi file di progetto

Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.

Creare un oggetto API client Document Security

Prima di poter eseguire un'operazione del servizio Document Security a livello di programmazione, è necessario creare un oggetto client del servizio Document Security. Se utilizzate l'API Java, create un oggetto DocumentSecurityClient. Se utilizzate l'API del servizio Web di Document Security, create un oggetto DocumentSecurityServiceService.

Recuperare la filigrana da modificare

Per modificare una filigrana, è necessario recuperare una filigrana esistente. È possibile recuperare una filigrana specificandone il nome o il valore identificativo.

Impostare gli attributi delle filigrane

Per modificare una filigrana esistente, modificate il valore di uno o più attributi della filigrana. Quando si aggiorna una filigrana a livello di programmazione utilizzando un servizio Web, è necessario impostare tutti gli attributi impostati originariamente, anche se il valore non cambia. Ad esempio, si supponga che siano impostati i seguenti attributi di filigrana: WaterBackCmd:IS_USERID_ENABLED, WaterBackCmd:IS_CUSTOMTEXT_ENABLED, WaterBackCmd:OPACITY e WaterBackCmd:SRCTEXT. Anche se l'unico attributo che si desidera modificare è WaterBackCmd:OPACITY, è necessario impostare anche gli altri valori.

Aggiornare la filigrana

Dopo aver modificato gli attributi di una filigrana, è necessario aggiornare la filigrana.

Consulta anche

Inclusione file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Creazione di filigrane

Modificare le filigrane utilizzando l'API Java

Modificare una filigrana utilizzando l'API di Document Security (Java):

1. Includere i file di progetto.

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

2. Creare un oggetto Document Security Client API.

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

3. Recuperate la filigrana da modificare.

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

4. Impostate 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 la filigrana è completamente trasparente.

   NOTA

   In questo esempio viene modificato solo l’attributo opacità.

5. Aggiorna la filigrana.

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

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, consultate Avvio rapido (modalità SOAP): Modifica di una filigrana tramite la sezione Java API.

Modificare le filigrane utilizzando l'API del servizio Web

Modificare una filigrana utilizzando l'API di Document Security (servizio Web):

1. Includere i 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.

   NOTA

   Sostituire localhost con l'indirizzo IP del server che ospita AEM Forms.

2. Creare un oggetto Document Security Client API.

   • Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

   • Creare un oggetto RightsManagementServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passate un valore di 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 create un riferimento a un servizio.

   • Creare un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo DocumentSecurityServiceClient.Endpoint.Binding. Inserite il valore restituito in BasicHttpBinding.

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

   • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:

     • Assegnare il nome utente del modulo 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.

3. Recuperate la filigrana da modificare.

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

4. Impostate gli attributi della filigrana.

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

5. Aggiorna la filigrana.

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

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, consultate la seguente sezione Avvio rapido:

• "Avvio rapido (MTOM): Modifica di una filigrana mediante l'API del servizio Web"

Ricerca di eventi

Il servizio Rights Management tiene traccia delle azioni specifiche eseguite, ad esempio l'applicazione di un criterio a un documento, l'apertura di un documento protetto tramite criterio e la revoca dell'accesso ai documenti. Il controllo degli eventi deve essere abilitato per il servizio di Rights Management o gli eventi non vengono tracciati.

Gli eventi rientrano in una delle seguenti categorie:

• Gli eventi di amministratore sono azioni correlate a un amministratore, ad esempio la creazione di un nuovo account di amministratore.
• Gli eventi del documento sono azioni correlate a un documento, ad esempio la chiusura di un documento protetto tramite criterio.
• Gli eventi dei criteri sono azioni correlate a un criterio, ad esempio la creazione di un nuovo criterio.
• Gli eventi di servizio sono azioni correlate al servizio di Rights Management, ad esempio la sincronizzazione con la directory utente.

Potete cercare eventi specifici utilizzando l'API Java di Rights Management o l'API del servizio Web. Cercando gli eventi, è possibile eseguire attività quali la creazione di un file di registro di determinati eventi.

Riepilogo dei passaggi

Per cercare un evento di Rights Management, effettuate le seguenti operazioni:

1. Includere i file di progetto.
2. Creare un oggetto Client API Rights Management.
3. Specificate l'evento per il quale eseguire la ricerca.
4. Cercate l’evento.

Includi file di progetto

Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.

Creare un oggetto API client Rights Management

Prima di eseguire un'operazione di servizio Rights Management a livello di programmazione, è necessario creare un oggetto client di servizio Rights Management. Se utilizzate l'API Java, create un oggetto DocumentSecurityClient. Se utilizzate l'API del servizio Web di Rights Management, create un oggetto DocumentSecurityServiceService.

Specificare gli eventi da cercare

È necessario specificare l'evento da cercare. Ad esempio, è possibile cercare l'evento policy create, che si verifica quando viene creato un nuovo criterio.

Ricerca dell’evento

Dopo aver specificato l'evento da cercare, potete utilizzare l'API Java di Rights Management o l'API del servizio Web di Rights Management per cercare l'evento.

Consulta anche

Inclusione file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Cercare eventi utilizzando l'API Java

Cercare eventi utilizzando l'API Rights Management (Java):

1. Includi file di progetto

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

2. Creare un oggetto API client Rights Management

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

3. Specificare gli eventi da cercare

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

   È possibile definire criteri di ricerca aggiuntivi richiamando i metodi dell'oggetto EventSearchFilter. Ad esempio, invocate il metodo setUserName per specificare un utente associato all'evento.

4. Ricerca dell’evento

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

Esempi di codice

Per esempi di codice che utilizzano il servizio di Rights Management, consultate i seguenti esempi di avvio rapido:

• "Avvio rapido (SOAP): Ricerca di eventi tramite l'API Java"

Cercare eventi utilizzando l'API del servizio Web

Cercare eventi utilizzando l'API Rights Management (servizio Web):

1. 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.

   NOTA

   Sostituire localhost con l'indirizzo IP del server che ospita AEM Forms.

2. Creare un oggetto API client Rights Management

   • Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

   • Creare un oggetto DocumentSecurityServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passate un valore di 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 create un riferimento a un servizio.

   • Creare un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo DocumentSecurityServiceClient.Endpoint.Binding. Inserite il valore restituito in BasicHttpBinding.

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

   • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:

     • Assegnare il nome utente del modulo 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.

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

   Tipo evento	Valore
   ALL_EVENTS	999
   USER_CHANGE_PASSWORD_EVENT	1000
   USER_REGISTER_EVENT	1001
   USER_PREREGISTER_EVENT	1002
   USER_ACTIVATE_EVENT	1003
   USER_DEACTIVATE_EVENT	1004
   USER_AUTHENTICATE_EVENT	1005
   USER_AUTHENTICATE_DENY_EVENT	1006
   USER_ACCOUNT_LOCK_EVENT	1007
   USER_DELETE_EVENT	1008
   USER_UPDATE_PROFILE_EVENT	1009
   DOCUMENT_VIEW_EVENT	2000
   DOCUMENT_PRINT_LOW_EVENT	2001
   DOCUMENT_PRINT_HIGH_EVENT	2002
   DOCUMENT_SIGN_EVENT	2003
   DOCUMENT_ADD_ANNOTATION_EVENT	2004
   DOCUMENT_FORM_FILL_EVENT	2005
   DOCUMENT_CLOSE_EVENT	2006
   DOCUMENT_MODIFY_EVENT	2007
   DOCUMENT_CHANGE_SECURITY_HANDLER_EVENT	2008
   DOCUMENT_SWITCH_POLICY_EVENT	2009
   DOCUMENT_REVOKE_EVENT	2010
   $1	2011
   DOCUMENT_SECURE_EVENT	2012
   DOCUMENT_UNKNOWN_CLIENT_EVENT	2013
   DOCUMENT_CHANGE_REVOKE_URL_EVENT	2014
   POLICY_CHANGE_EVENT	3000
   POLICY_ENABLE_EVENT	3001
   POLICY_DISABLE_EVENT	3002
   POLICY_CREATE_EVENT	3003
   POLICY_DELETE_EVENT	3004
   POLICY_CHANGE_OWNER_EVENT	3005
   SERVER_CLIENT_SYNC_EVENT	4000
   SERVER_SYNC_DIR_INFO_EVENT	4001
   SERVER_SYNC_DIR_COMPLETE_EVENT	4002
   SERVER_VERSION_MISMATCH_EVENT	4003
   SERVER_CONFIG_CHANGE_EVENT	4004
   SERVER_ENABLE_OFFLINE_ACCESS_EVENT	4005
   ADMIN_ADD_EVENT	5000
   ADMIN_DELETE_EVENT	5001
   ADMIN_EDIT_EVENT	5002
   ADMIN_ACTIVATE_EVENT	5003
   ADMIN_DEACTIVATE_EVENT	5004
   ERROR_DIRECTORY_SERVICE_EVENT	6000
   CREATED_POLICYSET_EVENT	7000
   DELETED_POLICYSET_EVENT	7001
   MODIFIED_POLICYSET_EVENT	7002

4. Ricerca dell’evento

   Cercare l'evento richiamando il metodo DocumentSecurityServiceClient dell'oggetto searchForEvents 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 AuditSpec, potete ottenere informazioni sull'evento, ad esempio l'ora in cui si è verificato. L'istanza AuditSpec contiene un membro di dati timestamp che specifica queste informazioni.

Esempi di codice

Per esempi di codice che utilizzano il servizio di Rights Management, consultate i seguenti esempi di avvio rapido:

• "Avvio rapido (MTOM): Ricerca di eventi tramite l'API del servizio Web"
• "Avvio rapido (SwaRef): Ricerca di eventi tramite l'API del servizio Web"

Consulta anche

Chiamata AEM Forms tramite MTOM

Chiamata AEM Forms tramite SwaRef

Applicazione dei criteri ai documenti di Word

Oltre ai documenti PDF, il servizio Rights Management supporta anche formati di documenti aggiuntivi, ad esempio documenti Microsoft Word (DOC) e altri formati di file Microsoft Office. Ad esempio, è possibile applicare un criterio a un documento Word per proteggerlo. Applicando un criterio a un documento Word, si limita l'accesso al documento. Non è possibile applicare un criterio a un documento se il documento è già protetto con un criterio.

È possibile monitorare l'utilizzo di un documento Word protetto tramite criterio dopo averlo distribuito. In altre parole, potete vedere come viene utilizzato il documento e chi lo sta utilizzando. Ad esempio, è possibile verificare quando un utente ha aperto il documento.

Riepilogo dei passaggi

Per applicare un criterio a un documento di Word, effettuare le seguenti operazioni:

1. Includere i file di progetto.
2. Creare un oggetto Document Security Client API.
3. Recuperare un documento Word a cui viene applicato un criterio.
4. Applicare un criterio esistente al documento Word.
5. Salvare il documento Word protetto tramite criterio.

Includi file di progetto

Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.

Creare un oggetto API client Document Security

Prima di poter eseguire un'operazione del servizio Document Security a livello di programmazione, è necessario creare un oggetto client del servizio Document Security.

Recupero di un documento di Word

Per applicare un criterio è necessario recuperare un documento Word. Dopo aver applicato un criterio al documento Word, gli utenti possono utilizzare il documento con restrizioni. Ad esempio, se il criterio non consente l'apertura del documento offline, gli utenti devono essere online per aprire il documento.

Applicare un criterio esistente al documento Word

Per applicare un criterio a un documento Word, è necessario fare riferimento a un criterio esistente e specificare a quale set di criteri appartiene il criterio. L'utente che sta impostando le proprietà di connessione deve avere accesso al criterio specificato. In caso contrario, si verifica un'eccezione.

Salvare il documento di Word

Dopo che il servizio Document Security applica un criterio a un documento Word, potete salvare il documento Word protetto tramite criterio come file DOC.

Consulta anche

Inclusione file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Revoca dell'accesso ai documenti

Applicare un criterio a un documento Word utilizzando l'API Java

Applicate un criterio a un documento Word utilizzando l'API di Document Security (Java):

1. Includere i file di progetto.

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

2. Creare un oggetto Document Security Client API.

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

3. Recuperare un documento Word.

   • Creare un oggetto java.io.FileInputStream che rappresenta il documento Word utilizzando il relativo costruttore e passando un valore di 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.

4. Applicare un criterio esistente al documento Word.

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

   • Applicare un criterio al documento Word richiamando il metodo protectDocument dell'oggetto DocumentManager e passando i seguenti valori:

     • L'oggetto com.adobe.idp.Document che contiene il documento Word a cui viene applicato il criterio.
     • Una stringa che specifica il nome del documento.
     • Un valore di stringa che specifica il nome dell'insieme di criteri a cui appartiene il criterio. È possibile specificare un valore null che determina l'utilizzo del set di criteri MyPolicies.
     • Una stringa che specifica il nome del criterio.
     • Una stringa che rappresenta il nome del dominio di gestione utenti dell'utente che è l'editore del documento. Questo valore del parametro è facoltativo e può essere nullo (se questo parametro è nullo, il valore successivo del parametro deve essere null).
     • Una stringa che rappresenta il nome del nome canonico dell'utente manager utente che è l'editore del documento. Questo valore del parametro è facoltativo e può essere null (se questo parametro è null, il valore del parametro precedente deve essere null).
     • Un com.adobe.livecycle.rightsmanagement.Locale che rappresenta le impostazioni internazionali utilizzate per selezionare il modello di MS Office. Questo valore del parametro è facoltativo ed è possibile specificare null.

     Il metodo protectDocument restituisce un oggetto RMSecureDocumentResult contenente il documento Word protetto tramite criterio.

5. Salvare il documento Word.

   • Richiamare il metodo RMSecureDocumentResult dell'oggetto getProtectedDoc per ottenere il documento Word protetto tramite criterio. Questo metodo restituisce un oggetto com.adobe.idp.Document.
   • Create un oggetto java.io.File e accertatevi che l'estensione del file sia DOC.
   • Richiamare il metodo com.adobe.idp.Document dell'oggetto copyToFile per copiare nel file il contenuto dell'oggetto Document (assicurarsi di utilizzare l'oggetto Document restituito dal metodo getProtectedDoc).

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, consultate la seguente sezione Avvio rapido:

• "Avvio rapido (modalità SOAP): Applicazione di un criterio a un documento Word tramite l'API Java"

Applicazione di un criterio a un documento Word tramite l'API del servizio Web

Applicare un criterio a un documento Word utilizzando l'API di Document Security (servizio Web):

1. Includere i 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.

   NOTA

   Sostituire localhost con l'indirizzo IP del server che ospita AEM Forms.

2. Creare un oggetto Document Security Client API.

   • Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

   • Creare un oggetto DocumentSecurityServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passate un valore di 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 create un riferimento a un servizio.

   • Creare un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo DocumentSecurityServiceClient.Endpoint.Binding. Inserite il valore restituito in BasicHttpBinding.

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

   • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:

     • Assegnare il nome utente del modulo 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.

3. Recuperare un documento Word.

   • Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare un documento Word a cui viene applicato un criterio.
   • Creare un oggetto System.IO.FileStream richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento di Word e la modalità di apertura del file.
   • Creare un array di byte che memorizza il contenuto dell'oggetto System.IO.FileStream. Determinare la dimensione dell'array di byte ottenendo la proprietà Length dell'oggetto System.IO.FileStream.
   • Compilare l'array di byte con i dati del flusso richiamando il metodo System.IO.FileStream dell'oggetto Read. Passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
   • Compilare l'oggetto BLOB assegnando il relativo campo MTOM con il contenuto dell'array di byte.

4. Applicare un criterio esistente al documento Word.

   Applicare un criterio al documento Word richiamando il metodo protectDocument dell'oggetto DocumentSecurityServiceClient e passando i seguenti valori:

   • L'oggetto BLOB che contiene il documento Word a cui viene applicato il criterio.
   • Una stringa che specifica il nome del documento.
   • Un valore di stringa che specifica il nome dell'insieme di criteri a cui appartiene il criterio. È possibile specificare un valore null che determina l'utilizzo del set di criteri MyPolicies.
   • Una stringa che specifica il nome del criterio.
   • Una stringa che rappresenta il nome del dominio di gestione utenti dell'utente che è l'editore del documento. Questo valore del parametro è facoltativo e può essere nullo (se questo parametro è nullo, il valore successivo del parametro deve essere null).
   • Una stringa che rappresenta il nome del nome canonico dell'utente manager utente che è l'editore del documento. Questo valore del parametro è facoltativo e può essere nullo (se questo parametro è nullo, il valore del parametro precedente deve essere null).
   • Un valore RMLocale che specifica il valore delle impostazioni internazionali (ad esempio, RMLocale.en).
   • Un parametro di output della stringa utilizzato per memorizzare il valore dell'identificatore del criterio.
   • Parametro di output della stringa utilizzato per memorizzare il valore dell'identificatore protetto tramite criterio.
   • Un parametro di output della stringa utilizzato per memorizzare il tipo mime (ad esempio, application/doc).

   Il metodo protectDocument restituisce un oggetto BLOB contenente il documento Word protetto tramite criterio.

5. Salvare il documento Word.

   • Creare un oggetto System.IO.FileStream richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento Word protetto tramite criterio.
   • Creare un array di byte che memorizza il contenuto dei dati dell'oggetto BLOB restituito dal metodo protectDocument. Compilare l'array di byte ottenendo il valore del membro di dati BLOB dell'oggetto MTOM.
   • Creare un oggetto System.IO.BinaryWriter richiamandone il costruttore e passando l'oggetto System.IO.FileStream.
   • Scrivere il contenuto dell'array di byte in un file Word richiamando il metodo System.IO.BinaryWriter dell'oggetto Write e passando l'array di byte.

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, consultate la seguente sezione Avvio rapido:

• "Avvio rapido (MTOM): Applicazione di un criterio a un documento Word tramite l'API del servizio Web"

Rimozione di criteri dai documenti di Word

È possibile rimuovere un criterio da un documento Word protetto tramite criterio per rimuovere la protezione dal documento. Se non si desidera più che il documento sia protetto tramite un criterio. Se si desidera aggiornare un documento Word protetto tramite criterio con un criterio più recente, invece di rimuovere il criterio e aggiungere il criterio aggiornato, è più efficiente cambiare il criterio.

Riepilogo dei passaggi

Per rimuovere un criterio da un documento Word protetto tramite criterio, effettuare le seguenti operazioni:

1. Includi file di progetto
2. Creare un oggetto Document Security Client API.
3. Recuperare un documento Word protetto tramite criterio.
4. Rimuovere il criterio dal documento Word.
5. Salvare i documenti Word non protetti.s

Includi file di progetto

Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.

Creare un oggetto API client Document Security

Prima di eseguire un'operazione del servizio Document Security a livello di programmazione, create un oggetto client del servizio Document Security.

Recupero di un documento Word protetto tramite criterio

Per rimuovere un criterio è necessario recuperare un documento Word protetto tramite criterio. Se tentate di rimuovere un criterio da un documento di Word che non è protetto da un criterio, causerete un'eccezione.

Rimuovere il criterio dal documento Word

È possibile rimuovere un criterio da un documento Word protetto tramite criterio a condizione che nelle impostazioni di connessione sia specificato un amministratore. In caso contrario, il criterio utilizzato per proteggere un documento deve contenere l'autorizzazione SWITCH_POLICY per rimuovere un criterio da un documento Word. Inoltre, anche l'utente specificato nelle impostazioni di connessione di AEM Forms deve disporre di tale autorizzazione. In caso contrario, viene generata un'eccezione.

Salvare il documento Word non protetto

Dopo che il servizio Document Security rimuove un criterio da un documento Word, potete salvare il documento Word non protetto come file DOC.

Consulta anche

Inclusione file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Applicazione dei criteri ai documenti Word

Rimozione di un criterio da un documento Word tramite l'API Java

Rimuovete un criterio da un documento Word protetto tramite criterio utilizzando l'API di Document Security (Java):

1. Includi file di progetto

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

2. Creare un oggetto API client Document Security

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

3. Recupero di un documento Word protetto tramite criterio

   • Creare un oggetto java.io.FileInputStream che rappresenti il documento Word protetto tramite criterio utilizzando il relativo costruttore e passando un valore di 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.

4. Rimuovere il criterio dal documento Word

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

5. Salvare il documento Word non protetto

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

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, consultate la seguente sezione Avvio rapido:

• "Avvio rapido (modalità SOAP): Rimozione di un criterio da un documento Word tramite l'API Java"

Rimozione di un criterio da un documento di Word utilizzando l'API del servizio Web

Rimuovete un criterio da un documento Word protetto tramite criterio utilizzando l'API di Document Security (servizio Web):

1. 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.

   NOTA

   Sostituire localhost con l'indirizzo IP del server che ospita AEM Forms.

2. Creare un oggetto API client Document Security

   • Creare un oggetto RightsManagementServiceClient utilizzando il relativo costruttore predefinito.

   • Creare un oggetto RightsManagementServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passate un valore di 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 create un riferimento a un servizio.

   • Creare un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo RightsManagementServiceClient.Endpoint.Binding. Inserite il valore restituito in BasicHttpBinding.

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

   • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:

     • Assegnare il nome utente del modulo 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.

3. Recupero di un documento Word protetto tramite criterio

   • Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare il documento Word protetto tramite criterio dal quale viene rimosso il criterio.
   • Creare un oggetto System.IO.FileStream richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento di Word e la modalità di apertura del file.
   • Creare un array di byte che memorizza il contenuto dell'oggetto System.IO.FileStream. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà System.IO.FileStream dell'oggetto Length.
   • Compilare l'array di byte con i dati del flusso richiamando il metodo Read dell'oggetto System.IO.FileStream e passando l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
   • Compilare l'oggetto BLOB assegnando il relativo campo MTOM con il contenuto dell'array di byte.

4. Rimuovere il criterio dal documento Word

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

5. Salvare il documento Word non protetto

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

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, consultate la seguente sezione Avvio rapido:

• "Avvio rapido (MTOM): Rimozione di un criterio da un documento Word tramite l'API del servizio Web"

Consulta anche

Chiamata AEM Forms tramite MTOM