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

Gli esempi e gli esempi contenuti in questo documento sono solo per AEM Forms in ambiente JEE.

Informazioni sul servizio Document Security

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

Il servizio Document Security impedisce la diffusione di informazioni al di fuori della portata dell’utente, consentendo agli utenti di mantenere il controllo sul modo in cui i destinatari utilizzano il documento PDF protetto tramite policy. Un utente può specificare chi può aprire un documento, limitare le modalità di utilizzo e monitorare il documento dopo la distribuzione. Un utente può inoltre controllare in modo dinamico l’accesso a un documento protetto tramite policy e può persino revocare in modo dinamico l’accesso al documento.

Il servizio Document Security protegge anche altri tipi di file, come i file Word di Microsoft (file DOC). Per utilizzare questi tipi di file è possibile utilizzare l’API client di Document Security. Sono supportate le seguenti versioni:

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

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

Puoi eseguire queste attività utilizzando il servizio Document Security:

NOTE
Per ulteriori informazioni sul servizio Document Security, consulta Riferimento ai servizi per AEM Forms.

Creazione di criteri creating-policies

Puoi creare policy a livello di programmazione utilizzando l’API Java di Document Security o l’API di servizio web. Un criterio è una raccolta di informazioni che include impostazioni di protezione dei documenti, utenti autorizzati e diritti di utilizzo. È possibile 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 seguenti attività:

  • Specificare gli utenti autorizzati ad aprire il documento. I destinatari possono appartenere o essere esterni alla tua organizzazione.
  • Specificare come i destinatari possono utilizzare il documento. Puoi limitare l’accesso a diverse funzioni di Acrobat e Adobe Reader. Queste funzionalità includono la possibilità di stampare e copiare testo, aggiungere firme e aggiungere commenti a un documento.
  • Modificare le impostazioni di accesso e protezione in qualsiasi momento, anche dopo la distribuzione del documento protetto tramite policy.
  • Monitorare l'utilizzo 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 una policy tramite servizi web creating-a-policy-using-web-services

Quando si crea una policy utilizzando l’API del servizio Web, fare riferimento a un file XML Portable Document Rights Language (PDRL) esistente che descrive la policy. Le autorizzazioni dei criteri e l'entità principale 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>
NOTE
Per ulteriori informazioni sul servizio Document Security, consulta Riferimento ai servizi per AEM Forms.

Riepilogo dei passaggi summary-of-steps

Per creare un criterio, effettuare le seguenti operazioni:

  1. Includi file di progetto.
  2. Crea un oggetto API client di Document Security.
  3. Impostare gli attributi del criterio.
  4. Crea una voce criterio.
  5. Registra il criterio.

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.

I seguenti file JAR devono essere aggiunti al percorso 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)
  • relaxDatatype.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 (utilizza un file JAR diverso se AEM Forms non è distribuito su JBoss)

Per informazioni sul percorso di questi file JAR, vedi Inclusi i file della libreria Java di AEM Forms.

Creare un oggetto API client di Document Security

Prima di poter eseguire un’operazione del servizio Document Security a livello di programmazione, crea un oggetto client del servizio Document Security.

Imposta gli attributi del criterio

Per creare un criterio, impostare gli attributi del criterio. Un attributo obbligatorio è il nome del criterio. I nomi dei criteri devono essere univoci per ogni set di criteri. Un set di criteri è semplicemente una raccolta di criteri. Se i criteri appartengono a set di criteri separati, è possibile che siano presenti due criteri con lo stesso nome. 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 policy è accessibile ai destinatari autorizzati. Se non si imposta questo attributo, il criterio è sempre valido.

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

  • Un numero di giorni impostato per l'accesso al documento dal momento in cui il documento viene pubblicato
  • Data di fine dopo la quale il documento non è accessibile
  • Un intervallo di date specifico per il quale il documento è accessibile
  • Sempre valido

È possibile specificare solo una data di inizio, che determina la validità del criterio dopo la data di inizio. Se specifichi 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 si impostano gli attributi che appartengono a un criterio, è inoltre possibile impostare le impostazioni di crittografia. Queste impostazioni di crittografia hanno effetto quando la policy viene applicata a un documento. È possibile specificare i seguenti valori di crittografia:

  • AES256: rappresenta l'algoritmo di crittografia AES con una chiave a 256 bit.
  • AES128: rappresenta l'algoritmo di crittografia AES con una chiave a 128 bit.
  • NoEncryption: non rappresenta alcuna crittografia.

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

NOTE
Per informazioni sugli altri attributi che è possibile impostare, vedere la descrizione dell'interfaccia Policy in Riferimento API di AEM Forms.

Crea una voce di criterio

Una voce criterio consente di associare entità, ovvero gruppi e utenti, e autorizzazioni a un criterio. Un criterio deve avere almeno una voce di criterio. Si supponga, ad esempio, di eseguire i task riportati di seguito.

  • Creare e registrare una voce di criterio che consente a un gruppo di visualizzare un documento solo mentre è online e impedisce ai destinatari di copiarlo.
  • Allega la voce del criterio al criterio.
  • Proteggi un documento con la policy utilizzando Acrobat.

Di conseguenza, i destinatari possono solo visualizzare il documento online e non possono copiarlo. Il documento rimane protetto finché non viene rimossa la protezione.

Registra il criterio

È necessario registrare un nuovo criterio prima di poterlo utilizzare. Dopo aver registrato una policy, è possibile utilizzarla per proteggere i documenti.

Creare un criterio utilizzando l’API Java create-a-policy-using-the-java-api

Crea una policy utilizzando Document Security API (Java):

  1. Includi file di progetto.

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

  2. Crea un oggetto API client di Document Security.

    • Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
    • Creare un oggetto DocumentSecurityClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.
  3. Impostare gli attributi del criterio.

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

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

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

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

      • Oggetto Policy che rappresenta il criterio da registrare.
    • Valore stringa che rappresenta il set di criteri a cui appartiene il criterio.

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

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

    note note
    NOTE
    Quando crei un criterio, fai 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 con il servizio Document Security, consulta:

  • "Guida rapida (modalità SOAP): creazione di una policy tramite API Java"

Creare un criterio utilizzando l’API del servizio web create-a-policy-using-the-web-service-api

Crea una policy utilizzando Document Security API (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.

    note note
    NOTE
    Sostituisci localhost con l'indirizzo IP del server che ospita AEM Forms.
  2. Crea un oggetto API client di Document Security.

    • Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

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

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

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

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

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

  3. Impostare gli attributi del criterio.

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

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

  5. Registra il criterio.

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

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

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

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

    note note
    NOTE
    Quando crei un criterio e specifichi un set di criteri, accertati 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 con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:

  • "Guida rapida (MTOM): creazione di un criterio utilizzando l’API del servizio web"
  • "Guida rapida (SwaRef): creazione di un criterio utilizzando l’API del servizio web"

Modifica dei criteri modifying-policies

Puoi modificare una policy esistente utilizzando l’API Java di Document Security o l’API di servizio web. Per modificare un criterio esistente, recuperarlo, modificarlo e quindi aggiornare il criterio sul server. Si supponga, ad esempio, di recuperare un criterio esistente e di estenderne il periodo di validità. Prima che la modifica entri in vigore, devi aggiornare il criterio.

È possibile modificare un criterio quando cambiano i requisiti aziendali e il criterio non riflette più questi requisiti. Invece di creare un criterio, puoi semplicemente aggiornare un criterio esistente.

Per modificare gli attributi dei criteri utilizzando un servizio web (ad esempio, utilizzando le classi proxy Java create con JAX-WS), è necessario assicurarsi che i criteri siano registrati nel servizio Document Security. È quindi possibile fare riferimento al criterio esistente utilizzando il metodo PolicySpec.getPolicyXml e modificare gli attributi del criterio utilizzando i metodi applicabili. Ad esempio, è possibile modificare il periodo di lease offline richiamando il metodo PolicySpec.setOfflineLeasePeriod.

NOTE
Per ulteriori informazioni sul servizio Document Security, consulta Riferimento ai servizi per AEM Forms.

Riepilogo dei passaggi summary_of_steps-1

Per modificare un criterio esistente, effettuare le seguenti operazioni:

  1. Includi file di progetto.
  2. Crea un oggetto API client di Document Security.
  3. Recupera un criterio esistente.
  4. Modificare gli attributi dei criteri.
  5. Aggiorna il criterio.

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.

Creare un oggetto API client di 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 si utilizza l'API Java, creare un oggetto RightsManagementClient. Se utilizzi l’API del servizio web Document Security, crea un oggetto RightsManagementServiceService.

Recupera un criterio esistente

Recuperare un criterio esistente per modificarlo. Per recuperare un criterio, specificare il nome del criterio e il set di criteri a cui appartiene il criterio. Se si specifica un valore null per il nome del set di criteri, il criterio verrà recuperato dal set di criteri Criteri personali.

Imposta gli attributi del criterio

Per modificare un criterio, è necessario modificare il valore degli attributi del criterio. L’unico attributo del criterio che non può essere modificato è l’attributo name. Ad esempio, per modificare il periodo di lease offline del criterio, è possibile modificare il valore dell'attributo del periodo di lease offline del criterio.

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

NOTE
Per informazioni sugli altri attributi che è possibile impostare, vedere la descrizione dell'interfaccia Policy in Riferimento API di AEM Forms.

Aggiorna il criterio

Prima di poter applicare le modifiche apportate a una policy, è necessario aggiornarla con il servizio Document Security. Le modifiche alle policy che proteggono i documenti vengono aggiornate alla successiva sincronizzazione del documento protetto con il servizio Document Security.

Modificare i criteri esistenti utilizzando l’API Java modify-existing-policies-using-the-java-api

Modifica una policy esistente utilizzando Document Security API (Java):

  1. Includi file di progetto.

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

  2. Crea un oggetto API client di Document Security.

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

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

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

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

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

  5. Aggiorna il criterio.

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

Esempi di codice

Per esempi di codice con il servizio Document Security, consulta la sezione Guida rapida (modalità SOAP): modificare una policy utilizzando l’API Java.

Modificare i criteri esistenti utilizzando l’API del servizio web modify-existing-policies-using-the-web-service-api

Modifica una policy esistente utilizzando Document Security API (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.

    note note
    NOTE
    Sostituisci localhost con l'indirizzo IP del server che ospita AEM Forms.
  2. Crea un oggetto API client di Document Security.

    • Creare un oggetto RightsManagementServiceClient utilizzando il relativo costruttore predefinito.

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

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

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

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

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

  3. Recupera un criterio esistente.

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

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

    Modifica gli attributi della policy per soddisfare i requisiti aziendali.

  5. Aggiorna il criterio.

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

Esempi di codice

Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:

  • "Guida rapida (MTOM): modifica di un criterio tramite l’API del servizio web"
  • "Guida rapida (SwaRef): modifica di un criterio tramite l’API del servizio web"

Eliminazione dei criteri deleting-policies

Puoi eliminare una policy esistente utilizzando l’API Java di Document Security o l’API di servizio web. Una volta eliminata, una policy non può più essere utilizzata per proteggere i documenti. Tuttavia, i documenti protetti tramite policy esistenti che utilizzano la policy sono ancora protetti. È possibile eliminare un criterio quando ne diventa disponibile uno più recente.

NOTE
Per ulteriori informazioni sul servizio Document Security, consulta Riferimento ai servizi per AEM Forms.

Riepilogo dei passaggi summary_of_steps-2

Per eliminare un criterio esistente, effettuare le seguenti operazioni:

  1. Includi file di progetto
  2. Crea un oggetto API client di Document Security.
  3. Elimina il criterio.

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.

Creare un oggetto API client di 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 si utilizza l'API Java, creare un oggetto RightsManagementClient. Se utilizzi l’API del servizio web Document Security, crea un oggetto RightsManagementServiceService.

Elimina il criterio

Per eliminare un criterio, specificare il criterio da eliminare e il set di criteri a cui appartiene il criterio. L’utente le cui impostazioni vengono 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 inesistente, si verifica un'eccezione.

Eliminare i criteri utilizzando l’API Java delete-policies-using-the-java-api

Elimina una policy utilizzando Document Security API (Java):

  1. Includi file di progetto.

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

  2. Crea un oggetto API client di Document Security.

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

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

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

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

Esempi di codice

Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:

  • "Guida rapida (modalità SOAP): eliminazione di un criterio utilizzando l’API Java"

Eliminare i criteri utilizzando l’API del servizio web delete-policies-using-the-web-service-api

Elimina una policy 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.

    note note
    NOTE
    Sostituisci localhost con l'indirizzo IP del server che ospita AEM Forms.
  2. Crea un oggetto API client di Document Security.

    • Creare un oggetto RightsManagementServiceClient utilizzando il relativo costruttore predefinito.

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

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

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

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

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

  3. Elimina il criterio.

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

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

Esempi di codice

Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:

  • "Guida rapida (MTOM): eliminazione di un criterio tramite l’API del servizio web"
  • "Guida rapida (SwaRef): eliminazione di un criterio tramite l’API del servizio web"

Applicazione delle policy ai documenti di PDF applying-policies-to-pdf-documents

È possibile applicare una policy a un documento PDF per proteggere il documento. Applicando una policy a un documento PDF, si limita l’accesso al documento. Non è possibile applicare una policy a un documento se il documento è già protetto con una policy.

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

È possibile monitorare l’utilizzo di un documento protetto tramite policy dopo averlo distribuito. In altre parole, è possibile vedere come viene utilizzato il documento e chi lo sta utilizzando. Ad esempio, è possibile scoprire quando qualcuno ha aperto il documento.

NOTE
Per ulteriori informazioni sul servizio Document Security, consulta Riferimento ai servizi per AEM Forms.

Riepilogo dei passaggi summary_of_steps-3

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

  1. Includi file di progetto.
  2. Crea un oggetto API client di Document Security.
  3. Recuperare un documento PDF a cui è applicato un criterio.
  4. Applica una policy esistente al documento PDF.
  5. Salva il documento PDF protetto tramite policy.

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.

Creare un oggetto API client di Document Security

Prima di poter eseguire un’operazione del servizio Document Security a livello di programmazione, crea un oggetto client del servizio Document Security. Se si utilizza l'API Java, creare un oggetto DocumentSecurityClient. Se utilizzi l’API del servizio web Document Security, crea un oggetto DocumentSecurityServiceService.

Recuperare un documento PDF

È possibile recuperare un documento PDF per applicare una policy. Dopo aver applicato una policy al documento PDF, gli utenti vengono limitati quando utilizzano il documento. Se, ad esempio, la policy non consente l'apertura del documento in modalità non in linea, gli utenti devono essere in linea per aprire il documento.

Applica un criterio esistente al documento PDF

Per applicare una policy a un documento PDF, fai riferimento a una policy esistente e specifica a quale set di policy appartiene la policy. L'utente che sta impostando le proprietà di connessione deve avere accesso al criterio specificato. In caso contrario, si verificherà un'eccezione.

Salva il documento PDF

Dopo che il servizio Document Security ha applicato una policy a un documento PDF PDF, puoi salvarlo come file PDF.

Consulta anche

Inclusione dei file della libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Revoca dell'accesso ai documenti

Applicare una policy a un documento PDF utilizzando l’API Java apply-a-policy-to-a-pdf-document-using-the-java-api

Applica una policy a un documento PDF utilizzando Document Security API (Java):

  1. Includi file di progetto.

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

  2. Crea un oggetto API client di Document Security.

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

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

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

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

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

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

  5. Salvare il documento PDF.

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

Esempi di codice

Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:

  • "Guida rapida (modalità EJB): applicazione di una policy a un documento PDF tramite l’API Java"
  • "Guida rapida (modalità SOAP): applicazione di una policy a un documento PDF tramite l’API Java"

Consulta anche

Inclusione dei file della libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Applicare una policy a un documento PDF utilizzando l’API del servizio web apply-a-policy-to-a-pdf-document-using-the-web-service-api

Applicare una policy a un documento PDF utilizzando Document Security API (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.

    note note
    NOTE
    Sostituisci localhost con l'indirizzo IP del server che ospita AEM Forms.
  2. Crea un oggetto API client di Document Security.

    • Creare un oggetto RightsManagementServiceClient utilizzando il relativo costruttore predefinito.

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

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

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

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

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

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

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

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

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

  5. Salvare il documento PDF.

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

Esempi di codice

Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:

  • "Guida rapida (MTOM): applicazione di una policy a un documento PDF tramite l’API del servizio web"
  • "Guida rapida (SwaRef): applicazione di una policy a un documento PDF tramite l’API del servizio web"

Rimozione di criteri dai documenti di PDF removing-policies-from-pdf-documents

È possibile rimuovere una policy da un documento protetto tramite policy per rimuovere la protezione dal documento. In altre parole, se non desideri più che il documento sia protetto da una policy. Se si desidera aggiornare un documento protetto tramite policy con una policy più recente, invece di rimuovere la policy e aggiungere la policy aggiornata, è più efficiente cambiare la policy.

NOTE
Per ulteriori informazioni sul servizio Document Security, consulta Riferimento ai servizi per AEM Forms.

Riepilogo dei passaggi summary_of_steps-4

Per rimuovere una policy da un documento PDF protetto tramite policy, attenersi alla seguente procedura:

  1. Includi file di progetto
  2. Crea un oggetto API client di Document Security.
  3. Recuperare un documento PDF protetto tramite policy.
  4. Rimuovi il criterio dal documento PDF.
  5. Salvare il documento PDF non protetto.

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.

Creare un oggetto API client di Document Security

Prima di poter eseguire un’operazione del servizio Document Security a livello di programmazione, crea un oggetto client del servizio Document Security.

Recuperare un documento PDF protetto tramite policy

Per rimuovere una policy, è possibile recuperare un documento PDF protetto tramite policy. Se tenti di rimuovere una policy da un documento PDF non protetto da una policy, viene generata un’eccezione.

Rimuovi il criterio dal documento PDF

È possibile rimuovere una policy da un documento PDF protetto tramite policy 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 di PDF non protetto

Dopo che il servizio Document Security ha rimosso una policy da un documento PDF, puoi salvare il documento PDF non protetto come file PDF.

Consulta anche

Inclusione dei file della libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Applicazione delle policy ai documenti di PDF

Rimuovere una policy da un documento PDF utilizzando l’API Java remove-a-policy-from-a-pdf-document-using-the-java-api

Rimuovi una policy da un documento PDF protetto tramite policy utilizzando Document Security API (Java):

  1. Includi file di progetto.

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

  2. Crea un oggetto API client di Document Security.

    • Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
    • Creare un oggetto DocumentSecurityClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.
  3. Recuperare un documento PDF protetto tramite policy.

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

    • Creare un oggetto DocumentManager richiamando il metodo getDocumentManager dell'oggetto DocumentSecurityClient.
    • Rimuovere un criterio dal documento PDF richiamando il metodo removeSecurity dell'oggetto DocumentManager e passando l'oggetto com.adobe.idp.Document che contiene il documento PDF protetto tramite criteri. Questo metodo restituisce un oggetto com.adobe.idp.Document contenente un documento PDF non protetto.
  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 copyToFile dell'oggetto Document per copiare il contenuto dell'oggetto Document nel file (assicurarsi di utilizzare l'oggetto Document restituito dal metodo removeSecurity).

Esempi di codice

Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:

  • "Guida rapida (modalità SOAP): rimozione di una policy da un documento PDF tramite l’API Java"

Rimuovere un criterio utilizzando l’API del servizio web remove-a-policy-using-the-web-service-api

Rimuovi una policy da un documento PDF protetto tramite policy utilizzando Document Security API (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.

    note note
    NOTE
    Sostituisci localhost con l'indirizzo IP del server che ospita AEM Forms.
  2. Crea un oggetto API client di Document Security.

    • Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

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

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

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

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

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

  3. Recuperare un documento PDF protetto tramite policy.

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

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

  5. Salvare il documento PDF non protetto.

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

Esempi di codice

Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:

  • "Guida rapida (MTOM): rimozione di una policy da un documento PDF tramite l’API del servizio web"
  • "Guida rapida (SwaRef): rimozione di una policy da un documento PDF tramite l’API del servizio web"

Consulta anche

Richiamare AEM Forms tramite MTOM

Richiamare AEM Forms con SwaRef

Revoca dell'accesso ai documenti revoking-access-to-documents

È possibile revocare l’accesso a un documento di PDF protetto tramite policy in modo che tutte le copie del documento siano inaccessibili agli utenti. Quando un utente cerca di aprire un documento PDF revocato, viene reindirizzato a un URL specificato in cui è possibile visualizzare un documento revisionato. L'URL a cui l'utente viene reindirizzato deve essere specificato a livello di programmazione. Quando revochi l’accesso a un documento, la modifica entra in vigore alla successiva sincronizzazione dell’utente con il servizio Document Security, quando il documento protetto tramite policy viene aperto online.

La possibilità di revocare l'accesso a un documento offre una protezione aggiuntiva. Si supponga, ad esempio, che sia disponibile una versione più recente di un documento e che non si desideri più visualizzare la versione obsoleta. In questo caso, è possibile revocare l'accesso al documento precedente e non è possibile visualizzare il documento a meno che non venga ripristinato l'accesso.

NOTE
Per ulteriori informazioni sul servizio Document Security, consulta Riferimento ai servizi per AEM Forms.

Riepilogo dei passaggi summary_of_steps-5

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

  1. Includi file di progetto.
  2. Crea un oggetto API client di Document Security.
  3. Recuperare un documento PDF protetto tramite policy.
  4. Revoca del documento protetto tramite policy.

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.

Creare un oggetto API client di 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 policy

Recupera un documento PDF protetto tramite policy per revocarlo. Non è possibile revocare un documento già revocato o non protetto tramite policy.

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

Revoca del documento protetto tramite policy

Per revocare un documento protetto tramite policy, specifica l’identificatore di licenza del documento protetto tramite policy. È inoltre possibile specificare l'URL di un documento che l'utente può visualizzare quando tenta di aprire il documento revocato. In altre parole, si supponga che un documento non aggiornato venga revocato. Quando un utente cerca di aprire il documento revocato, visualizza un documento aggiornato invece del documento revocato.

NOTE
Se si tenta di revocare un documento già revocato, viene generata un'eccezione.

Consulta anche

Inclusione dei file della libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Applicazione delle policy ai documenti di PDF

Ripristino dell’accesso ai documenti revocati

Revocare l’accesso ai documenti utilizzando l’API Java revoke-access-to-documents-using-the-java-api

Revoca dell’accesso a un documento PDF protetto tramite policy utilizzando Document Security API (Java):

  1. Includi file di progetto

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

  2. Creare un oggetto API client di Document Security

    • Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
    • Creare un oggetto DocumentSecurityClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.
  3. Recuperare un documento PDF protetto tramite policy

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

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

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

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

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

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

Esempi di codice

Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:

  • "Guida rapida (modalità SOAP): revoca di un documento tramite API Java"

Revoca dell’accesso ai documenti tramite l’API del servizio web revoke-access-to-documents-using-the-web-service-api

Revoca dell’accesso a un documento PDF protetto tramite policy utilizzando Document Security API (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.

    note note
    NOTE
    Sostituisci localhost con l'indirizzo IP del server che ospita AEM Forms.
  2. Creare un oggetto API client di Document Security

    • Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

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

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

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

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

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

  3. Recuperare un documento PDF protetto tramite policy

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

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

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

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

Esempi di codice

Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:

  • "Guida rapida (MTOM): revoca di un documento tramite l’API del servizio web"
  • "Guida rapida (SwaRef): revoca di un documento tramite l’API del servizio web"

Consulta anche

Rimozione di criteri da documenti di Word

Richiamare AEM Forms tramite MTOM

Richiamare AEM Forms con SwaRef

Ripristino dell’accesso ai documenti revocati reinstating-access-to-revoked-documents

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

NOTE
Per ulteriori informazioni sul servizio Document Security, consulta Riferimento ai servizi per AEM Forms.

Riepilogo dei passaggi summary_of_steps-6

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

  1. Includi file di progetto.
  2. Crea un oggetto API client di Document Security.
  3. Recuperare l'identificatore di licenza del documento PDF revocato.
  4. Ripristinare l'accesso al documento PDF revocato.

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.

Creare un oggetto API client di 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 si utilizza l'API Java, creare un oggetto DocumentSecurityClient. Se utilizzi l’API del servizio web Document Security, crea un oggetto DocumentSecurityServiceService.

Recuperare l'identificatore di licenza del documento di PDF revocato

Recuperare l'identificatore di licenza del documento PDF revocato per ripristinare un documento PDF revocato. Dopo aver ottenuto il valore dell'identificatore di licenza, è possibile ripristinare un documento revocato. Se si tenta di ripristinare un documento non revocato, verrà generata un'eccezione.

Ripristina l'accesso al documento di PDF revocato

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

Consulta anche

Inclusione dei file della libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Applicazione delle policy ai documenti di PDF

Revoca dell'accesso ai documenti

Ripristinare l’accesso ai documenti revocati utilizzando l’API Java reinstate-access-to-revoked-documents-using-the-java-api

Ripristinare l’accesso a un documento revocato utilizzando Document Security API (Java):

  1. Includi file di progetto.

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

  2. Crea un oggetto API client di Document Security.

    • Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
    • Creare un oggetto DocumentSecurityClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.
  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 stringa che specifica la posizione del documento PDF.
    • Creare un oggetto com.adobe.idp.Document utilizzando il relativo costruttore e passando l'oggetto java.io.FileInputStream.
    • Creare un oggetto DocumentManager richiamando il metodo getDocumentManager dell'oggetto DocumentSecurityClient.
    • Recuperare il valore dell'identificatore di licenza del documento revocato richiamando il metodo getLicenseId dell'oggetto DocumentManager e passando l'oggetto com.adobe.idp.Document che rappresenta il documento revocato. Questo metodo restituisce un valore stringa che rappresenta l'identificatore della licenza.
  4. Ripristinare l'accesso al documento PDF revocato.

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

Esempi di codice

Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:

  • "Guida rapida (modalità SOAP): ripristino dell’accesso a un documento revocato tramite l’API del servizio web"

Ripristinare l’accesso ai documenti revocati tramite l’API del servizio web reinstate-access-to-revoked-documents-using-the-web-service-api

Ripristinare l’accesso a un documento revocato utilizzando Document Security API (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.

    note note
    NOTE
    Sostituisci localhost con l'indirizzo IP del server che ospita AEM Forms.
  2. Crea un oggetto API client di Document Security.

    • Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

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

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

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

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

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

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

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

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

Esempi di codice

Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:

  • "Guida rapida (MTOM): ripristino dell’accesso a un documento revocato tramite l’API del servizio web"
  • "Guida rapida (SwaRef): ripristino dell’accesso a un documento revocato tramite l’API del servizio web"

Consulta anche

Richiamare AEM Forms tramite MTOM

Richiamare AEM Forms con SwaRef

Verifica dei documenti di PDF protetti tramite policy inspecting-policy-protected-pdf-documents

Puoi usare l’API Document Security Service (Java e servizio web) per esaminare i documenti PDF protetti tramite policy. L’ispezione dei documenti di PDF protetti tramite policy restituisce informazioni sul documento di PDF protetto tramite policy. È possibile, ad esempio, determinare la policy utilizzata per proteggere il documento e la data in cui è stato protetto.

Non è possibile eseguire questa attività se la versione del LiveCycle in uso è 8.x o precedente. In AEM Forms è stato aggiunto il supporto per l’ispezione di documenti protetti tramite policy. Se si tenta di esaminare un documento protetto tramite policy utilizzando LiveCycle 8.x (o versioni precedenti), viene generata un'eccezione.

NOTE
Per ulteriori informazioni sul servizio Document Security, consulta Riferimento ai servizi per AEM Forms.

Riepilogo dei passaggi summary_of_steps-7

Per esaminare un documento PDF protetto tramite policy, effettua le seguenti operazioni:

  1. Includi file di progetto.
  2. Crea un oggetto API client di Document Security.
  3. Recuperare un documento protetto tramite policy da esaminare.
  4. Ottenere informazioni sul documento protetto tramite policy.

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.

Creare un oggetto API client di Document Security

Prima di poter eseguire un’operazione del servizio Document Security a livello di programmazione, crea un oggetto client del servizio Document Security. Se si utilizza l'API Java, creare un oggetto RightsManagementClient. Se utilizzi l’API del servizio web Document Security, crea un oggetto RightsManagementServiceService.

Recuperare un documento protetto tramite policy da ispezionare

Per esaminare un documento protetto tramite policy, recuperalo. Se si tenta di ispezionare un documento non protetto con una policy o revocato, viene generata un'eccezione.

Inspect il documento

Dopo aver recuperato un documento protetto tramite policy, è possibile esaminarlo.

Ottieni informazioni sul documento protetto tramite policy

Dopo aver esaminato un documento PDF protetto tramite policy, puoi ottenere informazioni al riguardo. È ad esempio possibile determinare il criterio utilizzato per proteggere il documento.

Se si protegge un documento con un criterio che appartiene a Criteri utente e si chiama RMInspectResult.getPolicysetName o RMInspectResult.getPolicysetId, verrà restituito null.

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

Consulta anche

Inclusione dei file della libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Documenti di Inspect Policy Protected PDF tramite l’API Java inspect-policy-protected-pdf-documents-using-the-java-api

Inspect è un documento PDF protetto tramite policy utilizzando Document Security Service API (Java):

  1. Includi file di progetto.

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

  2. Crea un oggetto API client di Document Security.

    • Creare un oggetto ServiceClientFactory contenente le proprietà di connessione. (Vedere Impostazione delle proprietà di connessione.)
    • Creare un oggetto RightsManagementClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.
  3. Recuperare un documento protetto tramite policy da esaminare.

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

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

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

Esempi di codice

Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:

  • "Guida rapida (modalità SOAP): ispezione dei documenti PDF protetti tramite policy tramite l’API Java"

Documenti di Inspect Policy Protected PDF che utilizzano l’API del servizio web inspect-policy-protected-pdf-documents-using-the-web-service-api

Inspect è un documento PDF protetto tramite policy utilizzando l’API Document Security Service (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.

    note note
    NOTE
    Sostituisci localhost con l'indirizzo IP del server che ospita AEM Forms.
  2. Crea un oggetto API client di Document Security.

    • Creare un oggetto RightsManagementServiceClient utilizzando il relativo costruttore predefinito.

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

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

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

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

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

  3. Recuperare un documento protetto tramite policy da esaminare.

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

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

  5. Ottenere informazioni sul documento protetto tramite policy.

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

Esempi di codice

Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:

  • "Guida rapida (MTOM): controllo dei documenti PDF protetti tramite policy tramite l’API del servizio web"
  • "Guida rapida (SwaRef): controllo dei documenti PDF protetti tramite policy tramite l’API del servizio web"

Consulta anche

Richiamare AEM Forms tramite MTOM

Richiamare AEM Forms con SwaRef

Creazione di filigrane creating-watermarks

Le filigrane contribuiscono a garantire la sicurezza di un documento identificandolo in modo univoco e controllando la violazione del copyright. Ad esempio, è possibile creare e inserire una filigrana che indichi Riservato su tutte le pagine di un documento. Dopo aver creato una filigrana, puoi includerla come parte di una policy. In altre parole, è possibile impostare l’attributo della filigrana del criterio con la filigrana appena creata. Dopo aver applicato a un documento una policy contenente una filigrana, questa viene visualizzata nel documento protetto tramite policy.

NOTE
Solo gli utenti con privilegi amministrativi di Document Security possono creare filigrane. In altre parole, è necessario specificare un utente di questo tipo quando si definiscono le impostazioni di connessione necessarie per creare un oggetto client del servizio Document Security.
NOTE
Per ulteriori informazioni sul servizio Document Security, consulta Riferimento ai servizi per AEM Forms.

Riepilogo dei passaggi summary_of_steps-8

Per creare una filigrana, effettuare le seguenti operazioni:

  1. Includi file di progetto.
  2. Crea un oggetto API client di Document Security.
  3. Impostare gli attributi delle filigrane.
  4. Registra la filigrana presso il servizio Document Security.

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.

Creare un oggetto API client di 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 si utilizza l'API Java, creare un oggetto RightsManagementClient. Se utilizzi l’API del servizio web Document Security, crea un oggetto RightsManagementServiceService.

Imposta gli attributi delle filigrane

Per creare una 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
  • DateIncluded
  • UserIdIncluded
  • UserNameIncluded

Nella tabella seguente sono elencate le coppie chiave-valore necessarie 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.
Vero o Falso
WaterBackCmd:IS_USERID_ENABLED
Specifica se l'identificazione dell'utente che apre il documento fa parte della filigrana.
Vero o Falso
WaterBackCmd:IS_CURRENTDATE_ENABLED
Specifica se la data corrente fa parte della filigrana.
Vero o Falso
WaterBackCmd:IS_CUSTOMTEXT_ENABLED
Se questo valore è true, il valore del testo personalizzato deve essere specificato utilizzando WaterBackCmd:SRCTEXT.
Vero o Falso
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 è specificato, WaterBackCmd:IS_SIZE_ENABLED deve essere presente e il valore deve essere true. Se questo attributo non è specificato, il comportamento predefinito è Adatta alla pagina.
Un valore maggiore di 0,0 e minore 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.
superiore, centrale o inferiore
WaterBackCmd:IS_USE_BACKGROUND
Specifica se la filigrana è uno sfondo. Il valore predefinito è false.
Vero o Falso
WaterBackCmd:IS_SIZE_ENABLED
True se viene specificata una scala personalizzata. Se questo valore è true, è necessario specificare anche SCALE. Se questo valore è false, l’impostazione predefinita è adatta alla pagina.
Vero o Falso
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.
Vero o Falso

Per tutte le filigrane deve essere definito uno dei seguenti attributi:

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

Tutti gli altri attributi sono facoltativi.

Registra filigrana

Prima di poter essere utilizzata, una nuova filigrana deve essere registrata presso il servizio Document Security. Dopo aver registrato una filigrana, puoi utilizzarla all’interno dei criteri.

Consulta anche

Inclusione dei file della libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Applicazione delle policy ai documenti di PDF

Creare filigrane utilizzando l’API Java create-watermarks-using-the-java-api

Crea una filigrana utilizzando Document Security API (Java):

  1. Includi file di progetto.

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

  2. Crea un oggetto API client di Document Security.

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

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

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

Esempi di codice

Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:

  • "Guida rapida (modalità SOAP): creazione di una filigrana tramite l’API Java"

Creare filigrane utilizzando l’API del servizio web create-watermarks-using-the-web-service-api

Crea una filigrana utilizzando Document Security API (servizio web):

  1. Crea un oggetto API client di Document Security.

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

    note note
    NOTE
    Sostituisci localhost con l'indirizzo IP del server che ospita AEM Forms.
  2. Crea un oggetto API client di Document Security.

    • Creare un oggetto RightsManagementServiceClient utilizzando il relativo costruttore predefinito.

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

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

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

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

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

  3. Impostare gli attributi della filigrana.

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

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

Esempi di codice

Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:

  • "Guida rapida (MTOM): creazione di una filigrana tramite l’API del servizio web"
  • "Guida rapida (SwaRef): creazione di una filigrana tramite l’API del servizio web"

Consulta anche

Richiamare AEM Forms tramite MTOM

Richiamare AEM Forms con SwaRef

Modifica delle filigrane modifying-watermarks

Puoi modificare una filigrana esistente utilizzando l’API Java di Document Security o l’API di servizio web. Per modificare una filigrana esistente, recuperarla, modificarne gli attributi e quindi aggiornarla sul server. Si supponga, ad esempio, di recuperare una filigrana e di modificarne l'attributo di opacità. Prima di applicare la modifica, è necessario aggiornare la filigrana.

Quando si modifica una filigrana, la modifica ha effetto sui documenti futuri a cui è applicata la filigrana. In altre parole, i documenti PDF esistenti che contengono la filigrana non vengono interessati.

NOTE
Solo gli utenti con privilegi amministrativi di Document Security possono modificare le filigrane. In altre parole, è necessario specificare un utente di questo tipo quando si definiscono le impostazioni di connessione necessarie per creare un oggetto client del servizio Document Security.
NOTE
Per ulteriori informazioni sul servizio Document Security, consulta Riferimento ai servizi per AEM Forms.

Riepilogo dei passaggi summary_of_steps-9

Per modificare una filigrana, effettuare le seguenti operazioni:

  1. Includi file di progetto.
  2. Crea un oggetto API client di Document Security.
  3. Recuperate la filigrana da modificare.
  4. Impostare gli attributi delle filigrane.
  5. Aggiorna la filigrana.

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.

Creare un oggetto API client di 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 si utilizza l'API Java, creare un oggetto DocumentSecurityClient. Se utilizzi l’API del servizio web Document Security, crea un oggetto DocumentSecurityServiceService.

Recupera la filigrana da modificare

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

Imposta gli attributi delle filigrane

Per modificare una filigrana esistente, modificare 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 in origine, anche se il valore non cambia. Si supponga, ad esempio, che siano impostati i seguenti attributi di filigrana: WaterBackCmd:IS_USERID_ENABLED, WaterBackCmd:IS_CUSTOMTEXT_ENABLED, WaterBackCmd:OPACITY e WaterBackCmd:SRCTEXT. Sebbene l'unico attributo che si desidera modificare sia WaterBackCmd:OPACITY, è necessario impostare gli altri valori in modo corretto.

NOTE
Quando si utilizza l’API Java per modificare una filigrana, non è necessario specificare tutti gli attributi. Impostare l'attributo della filigrana che si desidera modificare.
NOTE
Per informazioni sui nomi degli attributi della filigrana, vedere Creazione delle filigrane.

Aggiorna filigrana

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

Consulta anche

Inclusione dei file della libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Creazione di filigrane

Modificare le filigrane utilizzando l’API Java modify-watermarks-using-the-java-api

Modifica una filigrana utilizzando Document Security API (Java):

  1. Includi file di progetto.

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

  2. Crea un oggetto API client di Document Security.

    • Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
    • Creare un oggetto DocumentSecurityClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.
  3. Recuperate la filigrana da modificare.

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

  4. Impostare gli attributi della filigrana.

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

    note note
    NOTE
    In questo esempio viene modificato solo l'attributo di opacità.
  5. Aggiorna la filigrana.

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

Esempi di codice

Per esempi di codice con il servizio Document Security, consulta la sezione Guida rapida (modalità SOAP): modifica di una filigrana tramite API Java.

Modificare le filigrane utilizzando l’API del servizio web modify-watermarks-using-the-web-service-api

Modifica una filigrana utilizzando Document Security API (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.

    note note
    NOTE
    Sostituisci localhost con l'indirizzo IP del server che ospita AEM Forms.
  2. Crea un oggetto API client di Document Security.

    • Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

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

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

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

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

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

  3. Recuperate la filigrana da modificare.

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

  4. Impostare gli attributi della filigrana.

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

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

Esempi di codice

Per esempi di codice con il servizio Document Security, consulta la Guida introduttiva seguente:

  • "Guida rapida (MTOM): modifica di una filigrana tramite l’API del servizio web"

Ricerca di eventi searching-for-events

Il servizio di Rights Management tiene traccia di azioni specifiche nel momento in cui si verificano, ad esempio l’applicazione di una policy a un documento, l’apertura di un documento protetto tramite policy e la revoca dell’accesso ai documenti. Il controllo degli eventi deve essere abilitato per il servizio di Rights Management oppure non è possibile tenere traccia degli eventi.

Gli eventi rientrano in una delle seguenti categorie:

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

Puoi cercare eventi specifici utilizzando l’API Java di Rights Management o l’API di servizio web. La ricerca di eventi consente di eseguire attività quali la creazione di un file di registro di determinati eventi.

NOTE
Per ulteriori informazioni sul servizio di Rights Management, vedere Riferimento ai servizi per AEM Forms.

Riepilogo dei passaggi summary_of_steps-10

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

  1. Includi file di progetto.
  2. Crea un oggetto API client di Rights Management.
  3. Specifica l’evento per il quale eseguire la ricerca.
  4. Cerca l’evento.

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.

Crea un oggetto API client di Rights Management

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

Specificare gli eventi da cercare

Specifica l’evento da cercare. Ad esempio, è possibile cercare l’evento di creazione del criterio, che si verifica quando viene creato un nuovo criterio.

Cerca evento

Dopo aver specificato l’evento da cercare, puoi utilizzare l’API Java di Rights Management o l’API del servizio web di Rights Management per cercare l’evento.

Consulta anche

Inclusione dei file della libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Cercare gli eventi utilizzando l’API Java search-for-events-using-the-java-api

Cerca gli eventi utilizzando l’API di Rights Management (Java):

  1. Includi file di progetto

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

  2. Creazione di un oggetto API client di Rights Management

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

  3. Specificare gli eventi da cercare

    • Creare un oggetto EventManager richiamando il metodo getEventManager dell'oggetto DocumentSecurityClient. Questo metodo restituisce un oggetto EventManager.
    • Creare un oggetto EventSearchFilter richiamando il relativo costruttore.
    • Specificare l'evento per il quale eseguire la ricerca richiamando il metodo setEventCode dell'oggetto EventSearchFilter e passando un membro dati statico appartenente alla classe EventManager che rappresenta l'evento per il quale eseguire la ricerca. Ad esempio, per cercare l'evento di creazione dei criteri, passare EventManager.POLICY_CREATE_EVENT.
    note note
    NOTE
    È possibile definire ulteriori criteri di ricerca richiamando EventSearchFilter metodi di oggetto. Ad esempio, richiamare il metodo setUserName per specificare un utente associato all'evento.
  4. Cerca l’evento

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

Esempi di codice

Per esempi di codice relativi all'utilizzo del servizio di Rights Management, vedere la Guida introduttiva seguente:

  • "Guida rapida (SOAP): ricerca di eventi tramite l’API Java"

Cercare gli eventi utilizzando l’API del servizio web search-for-events-using-the-web-service-api

Cerca gli eventi utilizzando l’API di 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.

    note note
    NOTE
    Sostituisci localhost con l'indirizzo IP del server che ospita AEM Forms.
  2. Creazione di un oggetto API client di Rights Management

    • Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

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

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

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

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

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

  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 dati firstTime.date dell'oggetto EventSpec con istanza DataTime che rappresenta l'inizio dell'intervallo di date in cui si è verificato l'evento.
    • Assegnare il valore true al membro dati firstTime.dateSpecified dell'oggetto EventSpec.
    • Specificare la fine del periodo di tempo durante il quale si è verificato l'evento impostando il membro dati lastTime.date dell'oggetto EventSpec con istanza DataTime che rappresenta la fine dell'intervallo di date in cui si è verificato l'evento.
    • Assegnare il valore true al membro dati lastTime.dateSpecified dell'oggetto EventSpec.
    • Impostare l'evento da cercare assegnando un valore stringa al membro dati eventCode dell'oggetto EventSpec. Nella tabella seguente sono elencati i valori numerici che è possibile assegnare a questa proprietà:
    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 18-row-2 19-row-2 20-row-2 21-row-2 22-row-2 23-row-2 24-row-2 25-row-2 26-row-2 27-row-2 28-row-2 29-row-2 30-row-2 31-row-2 32-row-2 33-row-2 34-row-2 35-row-2 36-row-2 37-row-2 38-row-2 39-row-2 40-row-2 41-row-2 42-row-2 43-row-2 44-row-2 45-row-2 46-row-2 47-row-2
    Tipo di 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. Cerca l’evento

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

Esempi di codice

Per esempi di codice relativi all'utilizzo del servizio di Rights Management, vedere la Guida introduttiva seguente:

  • "Guida rapida (MTOM): ricerca di eventi tramite l’API del servizio web"
  • "Quick Start (SwaRef): ricerca di eventi tramite l’API del servizio web"

Consulta anche

Richiamare AEM Forms tramite MTOM

Richiamare AEM Forms con SwaRef

Applicazione di criteri ai documenti di Word applying-policies-to-word-documents

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

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

NOTE
Per ulteriori informazioni sul servizio Document Security, consulta Riferimento ai servizi per AEM Forms.

Riepilogo dei passaggi summary_of_steps-11

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

  1. Includi file di progetto.
  2. Crea un oggetto API client di Document Security.
  3. Recuperare un documento di Word a cui è applicato un criterio.
  4. Applicare una policy esistente al documento di Word.
  5. Salvare il documento Word protetto tramite policy.

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.

Creare un oggetto API client di 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 di Word

Recuperare un documento di Word per applicare una policy. Dopo aver applicato una policy al documento di Word, gli utenti saranno soggetti a restrizioni quando utilizzano il documento. Se, ad esempio, la policy non consente l'apertura del documento in modalità non in linea, gli utenti devono essere in linea per aprire il documento.

Applicare un criterio esistente al documento di Word

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

Salva documento di Word

Dopo che il servizio Document Security ha applicato una policy a un documento di Word, è possibile salvarlo come file DOC.

Consulta anche

Inclusione dei file della libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Revoca dell'accesso ai documenti

Applicare una policy a un documento Word utilizzando l’API Java apply-a-policy-to-a-word-document-using-the-java-api

Applicare una policy a un documento di Word utilizzando l’API Document Security (Java):

  1. Includi file di progetto.

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

  2. Crea un oggetto API client di Document Security.

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

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

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

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

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

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

  5. Salvare il documento di Word.

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

Esempi di codice

Per esempi di codice con il servizio Document Security, consulta la Guida introduttiva seguente:

  • "Guida rapida (modalità SOAP): applicazione di una policy a un documento Word tramite l’API Java"

Applicare una policy a un documento Word utilizzando l’API del servizio web apply-a-policy-to-a-word-document-using-the-web-service-api

Applicare una policy a un documento di Word utilizzando Document Security API (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/DocumentSecurityService?WSDL&lc_version=9.0.1.

    note note
    NOTE
    Sostituisci localhost con l'indirizzo IP del server che ospita AEM Forms.
  2. Crea un oggetto API client di Document Security.

    • Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

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

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

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

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

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

  3. Recuperare un documento di Word.

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

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

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

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

  5. Salvare il documento di Word.

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

Esempi di codice

Per esempi di codice con il servizio Document Security, consulta la Guida introduttiva seguente:

  • "Guida rapida (MTOM): applicazione di una policy a un documento Word tramite l’API del servizio web"

Rimozione di criteri da documenti di Word removing-policies-from-word-documents

È possibile rimuovere una policy da un documento Word protetto tramite policy per rimuovere la protezione dal documento. In altre parole, se non desideri più che il documento sia protetto da una policy. Se si desidera aggiornare un documento Word protetto tramite policy con una policy più recente, invece di rimuovere la policy e aggiungere la policy aggiornata, è più efficiente cambiare la policy.

NOTE
Per ulteriori informazioni sul servizio Document Security, consulta Riferimento ai servizi per AEM Forms.

Riepilogo dei passaggi summary_of_steps-12

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

  1. Includi file di progetto
  2. Crea un oggetto API client di Document Security.
  3. Recuperare un documento Word protetto tramite policy.
  4. Rimuovere la policy dal documento di Word.
  5. Salva i documenti Word non protetti

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.

Creare un oggetto API client di Document Security

Prima di poter eseguire un’operazione del servizio Document Security a livello di programmazione, crea un oggetto client del servizio Document Security.

Recuperare un documento Word protetto tramite policy

Recuperare un documento Word protetto tramite policy per rimuovere una policy. Se si tenta di rimuovere una policy da un documento di Word non protetto da una policy, verrà generata un'eccezione.

Rimuovi il criterio dal documento di Word

È possibile rimuovere una policy da un documento Word protetto tramite policy 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 di 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 ha rimosso una policy da un documento Word, puoi salvare il documento Word non protetto come file DOC.

Consulta anche

Inclusione dei file della libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Applicazione di criteri ai documenti di Word

Rimuovere una policy da un documento Word utilizzando l’API Java remove-a-policy-from-a-word-document-using-the-java-api

Rimuovi una policy da un documento Word protetto tramite policy utilizzando Document Security API (Java):

  1. Includi file di progetto

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

  2. Creare un oggetto API client di Document Security

    • Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
    • Creare un oggetto RightsManagementClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.
  3. Recuperare un documento Word protetto tramite policy

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

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

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

Esempi di codice

Per esempi di codice con il servizio Document Security, consulta la Guida introduttiva seguente:

  • "Guida rapida (modalità SOAP): rimozione di una policy da un documento Word tramite l’API Java"

Rimuovere una policy da un documento di Word utilizzando l’API del servizio web remove-a-policy-from-a-word-document-using-the-web-service-api

Rimuovi una policy da un documento Word protetto tramite policy utilizzando Document Security API (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.

    note note
    NOTE
    Sostituisci localhost con l'indirizzo IP del server che ospita AEM Forms.
  2. Creare un oggetto API client di Document Security

    • Creare un oggetto RightsManagementServiceClient utilizzando il relativo costruttore predefinito.

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

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

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

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

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

  3. Recuperare un documento Word protetto tramite policy

    • Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare il documento Word protetto tramite policy da cui viene rimossa la policy.
    • Creare un oggetto System.IO.FileStream richiamandone il costruttore e passando un valore stringa che rappresenta la posizione del file del documento di Word e la modalità di apertura del file.
    • Creare una matrice di byte che memorizza il contenuto dell'oggetto System.IO.FileStream. È possibile determinare le dimensioni della matrice di byte ottenendo la proprietà Length dell'oggetto System.IO.FileStream.
    • Compilare la matrice di byte con i dati di flusso richiamando il metodo Read dell'oggetto System.IO.FileStream e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l'oggetto BLOB assegnando il relativo campo MTOM al contenuto della matrice di byte.
  4. Rimuovere la policy dal documento di Word

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

  5. Salvare il documento Word non protetto

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

Esempi di codice

Per esempi di codice con il servizio Document Security, consulta la Guida introduttiva seguente:

  • "Guida rapida (MTOM): rimozione di una policy da un documento Word tramite l’API del servizio web"

Consulta anche

Richiamare AEM Forms tramite MTOM

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2