Protezione dei documenti con i criteri

Esempi ed esempi 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 Adobe PDF e di mantenere il controllo sui documenti, indipendentemente dalla loro diffusione.

Il servizio Document Security impedisce che le informazioni si diffondano oltre la portata dell’utente, consentendo agli utenti di mantenere il controllo sul modo in cui i destinatari utilizzano il documento PDF protetto tramite policy. Un utente può specificare chi può aprire un documento, limitare le modalità di utilizzo e monitorare il documento dopo la sua distribuzione. Un utente può anche controllare dinamicamente l'accesso a un documento protetto da policy e può anche revocare dinamicamente l'accesso al documento.

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

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

Per chiarezza, le due sezioni seguenti illustrano come utilizzare i documenti di Word:

È possibile eseguire queste operazioni utilizzando il servizio Document Security:

NOTA

Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.

Creazione di criteri

Puoi creare criteri in modo programmatico utilizzando l’API Java per la sicurezza dei documenti o l’API del servizio Web. Una policy è una raccolta di informazioni che include le impostazioni di protezione dei documenti, gli utenti autorizzati e i diritti di utilizzo. Puoi creare e salvare un numero qualsiasi di criteri, utilizzando le impostazioni di sicurezza appropriate per situazioni e utenti diversi.

I criteri consentono di eseguire le attività seguenti:

  • Specificare gli utenti che possono aprire il documento. I destinatari possono appartenere o essere esterni alla tua organizzazione.
  • Specifica come i destinatari possono utilizzare il documento. Puoi limitare l’accesso a diverse funzioni di Acrobat e Adobe Reader. Queste funzioni 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 criterio.
  • Monitora l'utilizzo del documento dopo la distribuzione. È possibile vedere come viene utilizzato il documento e chi lo utilizza. Ad esempio, è possibile verificare quando un utente ha aperto il documento.

Creazione di un criterio tramite i servizi Web

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

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

Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

Per creare un criterio, effettua le seguenti operazioni:

  1. Includi file di progetto.
  2. Creare un oggetto API client Document Security.
  3. Imposta gli attributi del criterio.
  4. Crea una voce di 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, assicurati 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 è implementato su JBoss)
  • jaxb-api.jar (se AEM Forms è implementato su JBoss)
  • jaxb-impl.jar (se AEM Forms è implementato su JBoss)
  • jaxb-libs.jar (se AEM Forms è implementato su JBoss)
  • jaxb-xjc.jar (se AEM Forms è implementato su JBoss)
  • relaxngDatype.jar (se AEM Forms è implementato su JBoss)
  • xsdlib.jar (se AEM Forms è implementato su JBoss)
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar
  • jbossall-client.jar (usa un file JAR diverso se AEM Forms non è distribuito su JBoss)

Per informazioni sulla posizione di questi file JAR, consulta Inclusione dei file della libreria Java AEM Forms.

Creare un oggetto API client di sicurezza dei documenti

Prima di eseguire un'operazione del servizio Document Security, creare un oggetto client del servizio Document Security.

Impostare 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 ciascun set di criteri. Un set di criteri è semplicemente una raccolta di criteri. Possono essere presenti due criteri con lo stesso nome se i criteri appartengono a set di criteri separati. Tuttavia, due criteri all'interno di un singolo set di criteri non possono avere lo stesso nome.

Un altro attributo utile da impostare è il periodo di validità. Un periodo di validità è il periodo di tempo durante il quale un documento protetto da 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 impostato di giorni in cui il documento è accessibile dal momento in cui 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 fa sì che il criterio sia valido 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, è anche possibile impostare le impostazioni di crittografia. Queste impostazioni di crittografia hanno effetto quando il criterio viene applicato 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 la crittografia.

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

NOTA

Per informazioni su altri attributi che è possibile impostare, consulta la descrizione dell’interfaccia Policy in Riferimento API di AEM Forms.

Creare una voce di criterio

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

  • Crea e registra una voce di criterio che consente a un gruppo di visualizzare un documento solo mentre è in linea e non consente ai destinatari di copiarlo.
  • Allega l'immissione dei criteri al criterio.
  • Proteggi un documento con il criterio utilizzando Acrobat.

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

Registra il criterio

Prima di poter essere utilizzato, è necessario registrare un nuovo criterio. Dopo aver registrato un criterio, è possibile utilizzarlo per proteggere i documenti.

Creare un criterio utilizzando l'API Java

Crea un criterio utilizzando l’API Document Security (Java):

  1. Includi file di progetto.

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

  2. Creare un oggetto API client 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. Imposta gli attributi del criterio.

    • Creare un oggetto Policy richiamando il metodo statico InfomodelObjectFactory dell'oggetto createPolicy. 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 specifichi il nome del criterio.
    • Impostare la descrizione del criterio richiamando il metodo setDescription dell'oggetto Policy e passando un valore stringa che specifichi la descrizione del criterio.
    • Impostare il criterio a cui appartiene il nuovo criterio richiamando il metodo setPolicySetName dell'oggetto Policy e passando un valore stringa che specifichi il nome del set di criteri. (È possibile specificare null per questo valore di parametro che determina l'aggiunta del criterio al set di criteri Criteri personali.)
    • Crea il periodo di validità del criterio richiamando il metodo statico createValidityPeriod dell'oggetto InfomodelObjectFactory. Questo metodo restituisce un oggetto ValidityPeriod.
    • Impostare il numero di giorni per i quali un documento protetto da 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 ValidityPeriod e passando l'oggetto Policy.
  4. Crea una voce di criterio.

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

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

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

    Se per creare l’oggetto DocumentSecurityClient si utilizza un account amministratore AEM forms all’interno delle impostazioni di connessione, specificare il nome del set di criteri quando si richiama il metodo registerPolicy. Se trasmetti un valore null per il set di criteri, il criterio viene creato nel set di criteri Criteri personali degli amministratori.

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

    NOTA

    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 che utilizzano il servizio Document Security, consulta quanto segue:

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

Crea un criterio utilizzando l'API del servizio Web

Crea un criterio utilizzando l’API Document Security (servizio Web):

  1. Includi file di progetto.

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

    NOTA

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

  2. Creare un oggetto API client Document Security.

    • Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

    • Creare un oggetto DocumentSecurityServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. 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.)

    • Crea un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo RightsManagementServiceClient.Endpoint.Binding . Imposta il valore restituito su 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à:

      • Assegna il nome utente del modulo di AEM al campo RightsManagementServiceClient.ClientCredentials.UserName.UserName.
      • Assegna il valore della password corrispondente al campo RightsManagementServiceClient.ClientCredentials.UserName.Password.
      • Assegna il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
    • Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

  3. Imposta gli attributi del criterio.

    • Creare un oggetto PolicySpec utilizzando il relativo costruttore.
    • Imposta il nome del criterio assegnando un valore stringa al membro dati name dell'oggetto PolicySpec.
    • Imposta la descrizione del criterio assegnando un valore stringa al membro dati description dell'oggetto PolicySpec.
    • Impostare il criterio a cui appartiene il criterio assegnando un valore stringa al membro dati PolicySpec dell'oggetto policySetName. È necessario specificare un nome di set di criteri esistente. (È possibile specificare null per questo valore di parametro che determina l'aggiunta del criterio a Criteri personali.)
    • Imposta il periodo di lease offline del criterio assegnando un valore intero al membro dati PolicySpec dell'oggetto offlineLeasePeriod.
    • Impostare il membro dati policyXml dell'oggetto PolicySpec con un valore stringa che rappresenta i dati XML PDRL. Per eseguire questa operazione, creare un oggetto .NET StreamReader utilizzando il relativo costruttore. Passa 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. Iterare attraverso l'oggetto StreamReader fino a quando il metodo ReadLine restituisce null. Assegna la variabile stringa al membro dati policyXml dell'oggetto PolicySpec.
  4. Crea una voce di criterio.

    Non è necessario creare una voce di criterio durante la creazione di un criterio utilizzando l'API del servizio Web Document Security. La voce dei criteri è definita nel documento PDRL.

  5. Registra il criterio.

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

    • L'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 MyPolices.

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

    Se si utilizza un utente Document SecurityDocument Security all'interno delle impostazioni di connessione, è possibile richiamare il metodo sovraccarico registerPolicy che accetta solo il criterio. In altre parole, non è necessario specificare il nome del set di criteri. Tuttavia, il criterio viene aggiunto al set di criteri denominato Criteri personali. Se non si desidera aggiungere il nuovo criterio al set di criteri, specificare un nome del set di criteri quando si richiama il metodo registerPolicy.

    NOTA

    Quando crei un criterio e specifichi un set di criteri, assicurati di specificare un set di criteri esistente. Se si specifica un set di criteri che non esiste, viene generata un'eccezione.

Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:

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

Modifica dei criteri

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

È possibile modificare un criterio quando i requisiti aziendali cambiano e il criterio non riflette più questi requisiti. Invece di creare un nuovo 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 il criterio sia registrato con il 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, puoi modificare il periodo di lease offline richiamando il metodo PolicySpec.setOfflineLeasePeriod .

NOTA

Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

Per modificare un criterio esistente, esegui i seguenti passaggi:

  1. Includi file di progetto.
  2. Creare un oggetto API client 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, assicurati di includere i file proxy.

Creare un oggetto API client di sicurezza dei documenti

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

Recupera un criterio esistente

È necessario recuperare un criterio esistente per modificarlo. Per recuperare un criterio, specificare il nome 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 viene recuperato dal set di criteri Criteri personali.

Impostare gli attributi del criterio

Per modificare un criterio, è necessario modificare il valore degli attributi del criterio. L'unico attributo di criterio che non è possibile modificare è l'attributo name. Ad esempio, per modificare il periodo di leasing offline del criterio, puoi modificare il valore dell’attributo del periodo di leasing 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, modifica l'elemento OfflineLeasePeriod nel documento XML PDRL. Quindi fai riferimento al documento PDRL XML aggiornato utilizzando il membro dati PolicySpec dell'interfaccia policyXML.

NOTA

Per informazioni su altri attributi che è possibile impostare, consulta la descrizione dell’interfaccia Policy in Riferimento API di AEM Forms.

Aggiornare il criterio

Prima di apportare modifiche a un criterio, è necessario aggiornare il criterio con il servizio Document Security. Le modifiche ai criteri che proteggono i documenti vengono aggiornate al successivo aggiornamento del documento protetto dai criteri con il servizio Document Security.

Modificare i criteri esistenti utilizzando l'API Java

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

  1. Includi file di progetto.

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

  2. Creare un oggetto API client 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 RightsManagementClient dell'oggetto getPolicyManager.

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

      • 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. Imposta gli attributi del criterio.

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

  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 che utilizzano il servizio Document Security, vedere Avvio rapido (modalità SOAP): Modifica di un criterio tramite la sezione API Java .

Modificare i criteri esistenti utilizzando l'API del servizio Web

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

  1. Includi file di progetto.

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

    NOTA

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

  2. Creare un oggetto API client Document Security.

    • Creare un oggetto RightsManagementServiceClient utilizzando il relativo costruttore predefinito.

    • Creare un oggetto RightsManagementServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. 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.)

    • Crea un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo RightsManagementServiceClient.Endpoint.Binding . Imposta il valore restituito su 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à:

      • Assegna il nome utente del modulo di AEM al campo RightsManagementServiceClient.ClientCredentials.UserName.UserName.
      • Assegna il valore della password corrispondente al campo RightsManagementServiceClient.ClientCredentials.UserName.Password.
      • Assegna il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
    • Assegna 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 RightsManagementServiceClient dell'oggetto getPolicy e passando i seguenti valori:

    • 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. Imposta gli attributi del criterio.

    Modifica gli attributi del criterio 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 che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:

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

Eliminazione dei criteri

Puoi eliminare un criterio esistente utilizzando l’API Java per la sicurezza dei documenti o l’API del servizio Web. Una volta eliminato, un criterio non può più essere utilizzato per proteggere i documenti. Tuttavia, i documenti protetti da policy esistenti che utilizzano il criterio sono ancora protetti. È possibile eliminare un criterio quando uno più recente diventa disponibile.

NOTA

Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

Per eliminare un criterio esistente, eseguire le operazioni seguenti:

  1. Includi file di progetto
  2. Creare un oggetto API client 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, assicurati di includere i file proxy.

Creare un oggetto API client di sicurezza dei documenti

Prima di poter eseguire un'operazione del servizio Document Security, è necessario creare un oggetto client del servizio Document Security. Se utilizzi l’API Java, crea un oggetto RightsManagementClient. Se si utilizza l'API del servizio Web Document Security, creare un oggetto RightsManagementServiceService.

Elimina il criterio

Per eliminare un criterio, specificare il criterio da eliminare e il criterio impostato 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. Allo stesso modo, se tenti di eliminare un criterio che non esiste, si verifica un'eccezione.

Eliminare i criteri utilizzando l'API Java

Elimina un criterio utilizzando l’API Document Security (Java):

  1. Includi file di progetto.

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

  2. Creare un oggetto API client 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 RightsManagementClient dell'oggetto getPolicyManager.

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

      • 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 che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:

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

Eliminare i criteri utilizzando l'API del servizio Web

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

  1. Includi file di progetto.

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

    NOTA

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

  2. Creare un oggetto API client Document Security.

    • Creare un oggetto RightsManagementServiceClient utilizzando il relativo costruttore predefinito.

    • Creare un oggetto RightsManagementServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. 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.)

    • Crea un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo RightsManagementServiceClient.Endpoint.Binding . Imposta il valore restituito su 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à:

      • Assegna il nome utente del modulo di AEM al campo RightsManagementServiceClient.ClientCredentials.UserName.UserName.
      • Assegna il valore della password corrispondente al campo RightsManagementServiceClient.ClientCredentials.UserName.Password.
      • Assegna il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
    • Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

  3. Elimina il criterio.

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

    • 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 che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:

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

Applicazione dei criteri ai documenti PDF

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

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 da policy quando si desidera che gli utenti non accedano più al documento.

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

NOTA

Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

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

  1. Includi file di progetto.
  2. Creare un oggetto API client Document Security.
  3. Recupera un documento PDF a cui viene applicato un criterio.
  4. Applicare un criterio esistente al documento PDF.
  5. Salvare il documento PDF protetto tramite 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, assicurati di includere i file proxy.

Creare un oggetto API client Document Security

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

Recuperare un documento PDF

È possibile recuperare un documento PDF per applicare un criterio. Dopo aver applicato un criterio al documento PDF, gli utenti vengono soggetti a restrizioni quando utilizzano il documento. Ad esempio, se il criterio non consente l'apertura del documento in modalità non in linea, per aprire il documento gli utenti devono essere in linea.

Applicare un criterio esistente al documento PDF

Per applicare un criterio a un documento PDF, 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 verifica un'eccezione.

Salvare il documento PDF

Dopo aver applicato un criterio a un documento PDF, è possibile salvare il documento PDF protetto da criteri come file PDF.

Consulta anche

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Revoca dell’accesso ai documenti

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

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

  1. Includi file di progetto.

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

  2. Creare un oggetto API client 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 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. Applicare un criterio esistente al documento PDF.

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

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

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

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

  5. Salvare il documento PDF.

    • Richiamare il metodo getProtectedDoc dell'oggetto RMSecureDocumentResult per ottenere il documento PDF protetto da policy. Questo metodo restituisce un oggetto com.adobe.idp.Document.
    • Crea un oggetto java.io.File e assicurati 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 che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:

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

Consulta anche

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Applicare un criterio a un documento PDF utilizzando l'API del servizio Web

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

  1. Includi file di progetto.

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

    NOTA

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

  2. Creare un oggetto API client Document Security.

    • Creare un oggetto RightsManagementServiceClient utilizzando il relativo costruttore predefinito.

    • Creare un oggetto RightsManagementServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passa 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.)

    • Crea un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo RightsManagementServiceClient.Endpoint.Binding . Imposta il valore restituito su 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à:

      • Assegna il nome utente del modulo di AEM al campo RightsManagementServiceClient.ClientCredentials.UserName.UserName.
      • Assegna il valore della password corrispondente al campo RightsManagementServiceClient.ClientCredentials.UserName.Password.
      • Assegna il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
    • Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

  3. Recupera un documento PDF.

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

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

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

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

  5. Salvare il documento PDF.

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

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:

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

Rimozione di criteri dai documenti PDF

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

NOTA

Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

Per rimuovere un criterio da un documento PDF protetto da policy, eseguire le operazioni seguenti:

  1. Includi file di progetto
  2. Creare un oggetto API client Document Security.
  3. Recuperare un documento PDF protetto da policy.
  4. Rimuovere 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, assicurati di includere i file proxy.

Creare un oggetto API client di sicurezza dei documenti

Prima di eseguire un'operazione del servizio Document Security, creare un oggetto client del servizio Document Security.

Recuperare un documento PDF protetto da policy

È possibile recuperare un documento PDF protetto da policy per rimuovere un criterio. Se si tenta di rimuovere un criterio da un documento PDF non protetto da un criterio, verrà generata un'eccezione.

Rimuovi il criterio dal documento PDF

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

Salvare il documento PDF non protetto

Dopo la rimozione di un criterio da un documento PDF, è possibile salvare il documento PDF non protetto come file PDF.

Consulta anche

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Applicazione dei criteri ai documenti PDF

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

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

  1. Includi file di progetto.

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

  2. Creare un oggetto API client 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 da policy.

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

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

    • Crea un oggetto java.io.File e assicurati 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 che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:

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

Rimuovere un criterio utilizzando l'API del servizio Web

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

  1. Includi file di progetto.

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

    NOTA

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

  2. Creare un oggetto API client Document Security.

    • Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

    • Creare un oggetto DocumentSecurityServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. 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.)

    • Crea un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo DocumentSecurityServiceClient.Endpoint.Binding . Imposta il valore restituito su 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à:

      • Assegna il nome utente del modulo di AEM al campo DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
      • Assegna il valore della password corrispondente al campo DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
      • Assegna il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
    • Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

  3. Recuperare un documento PDF protetto da policy.

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

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

  5. Salvare il documento PDF non protetto.

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

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:

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

Consulta anche

Richiamo di AEM Forms tramite MTOM

Richiamo di AEM Forms tramite SwaRef

Revoca dell'accesso ai documenti

È possibile revocare l'accesso a un documento PDF protetto da policy in modo che tutte le copie del documento risultino inaccessibili agli utenti. Quando un utente tenta di aprire un documento PDF revocato, viene reindirizzato a un URL specifico in cui è possibile visualizzare un documento rivisto. L’URL a cui l’utente viene reindirizzato deve essere specificato a livello di programmazione. Quando si revoca l'accesso a un documento, la modifica ha effetto alla successiva sincronizzazione dell'utente con il servizio Document Security aprendo il documento protetto tramite criterio online.

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

NOTA

Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

Per revocare un documento protetto da policy, esegui le seguenti operazioni:

  1. Includi file di progetto.
  2. Creare un oggetto API client Document Security.
  3. Recuperare un documento PDF protetto da policy.
  4. Revocare il documento protetto da 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, assicurati di includere i file proxy.

Creare un oggetto API client di sicurezza dei documenti

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

Recuperare un documento PDF protetto da policy

Per revocarlo, è necessario recuperare un documento PDF protetto da policy. Impossibile revocare un documento già revocato o non protetto da policy.

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

Revoca del documento protetto da policy

Per revocare un documento protetto da policy, specificare l'identificativo della licenza del documento protetto da policy. Inoltre, è possibile specificare l'URL di un documento che l'utente può visualizzare quando tenta di aprire il documento revocato. In altre parole, supponiamo che un documento obsoleto venga revocato. Quando un utente tenta di aprire il documento revocato, vedrà un documento aggiornato invece del documento revocato.

NOTA

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

Consulta anche

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Applicazione dei criteri ai documenti PDF

Ripristino dell'accesso ai documenti revisionati

Revoca l’accesso ai documenti utilizzando l’API Java

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

  1. Includi file di progetto

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

  2. Creare un oggetto API client di sicurezza dei documenti

    • 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 da policy

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

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

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

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

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

      • Valore stringa che specifica il valore dell'identificatore di licenza del documento protetto tramite criterio (specificare il valore restituito del metodo DocumentManager dell'oggetto getLicenseId).
      • Membro di dati statico dell'interfaccia License che specifica il motivo della revoca del documento. Ad esempio, puoi specificare License.DOCUMENT_REVISED.
      • Valore java.net.URL che specifica la posizione 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 che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:

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

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

Revoca l’accesso a un documento PDF protetto da policy utilizzando l’API per la sicurezza dei documenti (servizio Web):

  1. Includi file di progetto

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

    NOTA

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

  2. Creare un oggetto API client di sicurezza dei documenti

    • 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.)

    • Crea un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo DocumentSecurityServiceClient.Endpoint.Binding . Imposta il valore restituito su 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à:

      • Assegna il nome utente del modulo di AEM al campo DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
      • Assegna il valore della password corrispondente al campo DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
      • Assegna il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
    • Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

  3. Recuperare un documento PDF protetto da policy

    • Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare un documento PDF protetto da policy che viene revocato.
    • Creare un oggetto System.IO.FileStream richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF protetto dai criteri 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 dell'array di byte ottenendo la proprietà Length dell'oggetto System.IO.FileStream.
    • Compilare l’array di byte con i dati del flusso richiamando il metodo Read dell’oggetto System.IO.FileStream e passando l’array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l'oggetto BLOB assegnando il relativo campo MTOM con il contenuto dell'array di byte.
  4. Revoca del documento protetto da policy

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

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

      • Valore stringa che specifica il valore dell'identificatore di licenza del documento protetto tramite criterio (specificare il valore restituito del metodo DocumentSecurityServiceService dell'oggetto getLicenseId).
      • Membro di dati statico dell' enum Reason che specifica il motivo della revoca del documento. Ad esempio, puoi specificare Reason.DOCUMENT_REVISED.
      • Valore string che specifica la posizione dell'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 che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:

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

Consulta anche

Rimozione di criteri dai documenti di Word

Richiamo di AEM Forms tramite MTOM

Richiamo di AEM Forms tramite SwaRef

Ripristino dell'accesso ai documenti revisionati

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

NOTA

Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

Per ripristinare l’accesso a un documento PDF revocato, eseguire le operazioni seguenti:

  1. Includi file di progetto.
  2. Creare un oggetto API client Document Security.
  3. Recuperare l'identificatore di licenza del documento PDF revocato.
  4. Ripristina 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, assicurati di includere i file proxy.

Creare un oggetto API client di sicurezza dei documenti

Prima di poter eseguire un'operazione del servizio Document Security, è necessario creare un oggetto client del servizio Document Security. Se utilizzi l’API Java, crea un oggetto DocumentSecurityClient. Se si utilizza l'API del servizio Web Document Security, creare un oggetto DocumentSecurityServiceService.

Recupera l'identificatore di licenza del documento PDF revocato

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

Ripristino dell’accesso al documento PDF revocato

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

Consulta anche

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Applicazione dei criteri ai documenti PDF

Revoca dell’accesso ai documenti

Ripristina l'accesso ai documenti revocati utilizzando l'API Java

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

  1. Includi file di progetto.

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

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

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

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:

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

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

Ripristino dell'accesso a un documento revocato tramite l'API Document Security (servizio Web):

  1. Includi file di progetto.

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

    NOTA

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

  2. Creare un oggetto API client Document Security.

    • Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

    • Creare un oggetto DocumentSecurityServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. 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.)

    • Crea un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo DocumentSecurityServiceClient.Endpoint.Binding . Imposta il valore restituito su 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à:

      • Assegna il nome utente del modulo di AEM al campo DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
      • Assegna il valore della password corrispondente al campo DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
      • Assegna il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
    • Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

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

    • Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare un documento PDF revocato al quale viene ripristinato l'accesso.
    • Creare un oggetto System.IO.FileStream richiamando il relativo costruttore e passando un valore di stringa che rappresenta 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 dell'array di byte ottenendo la proprietà Length dell'oggetto System.IO.FileStream.
    • Compilare l’array di byte con i dati del flusso richiamando il metodo Read dell’oggetto System.IO.FileStream e passando l’array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l'oggetto BLOB assegnando il relativo campo MTOM con il contenuto dell'array di byte.
  4. Ripristina 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 di licenza.
    • Ripristinare l'accesso al documento PDF revocato richiamando il metodo unrevokeLicense dell'oggetto DocumentSecurityServiceClient e passando un valore di stringa che specifica il valore dell'identificatore di licenza del documento PDF revocato (passare il valore restituito del metodo DocumentSecurityServiceClient dell'oggetto getLicenseId).

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:

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

Consulta anche

Richiamo di AEM Forms tramite MTOM

Richiamo di AEM Forms tramite SwaRef

Ispezione dei documenti PDF protetti da policy

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

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

NOTA

Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

Per esaminare un documento PDF protetto da policy, eseguire le operazioni seguenti:

  1. Includi file di progetto.
  2. Creare un oggetto API client Document Security.
  3. Recuperare un documento protetto da policy da esaminare.
  4. Ottenere informazioni sul documento protetto tramite 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, assicurati di includere i file proxy.

Creare un oggetto API client di sicurezza dei documenti

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

Recuperare un documento protetto da policy per ispezionare

Per esaminare un documento protetto da policy, recuperarlo. Se si tenta di controllare un documento non protetto con un criterio o revocato, viene generata un'eccezione.

Inspect il documento

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

Ottenere informazioni sul documento protetto tramite policy

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

Se si protegge un documento con un criterio che appartiene ai Criteri personali e quindi si chiama RMInspectResult.getPolicysetName o RMInspectResult.getPolicysetId, viene 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 libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Documenti PDF protetti da policy Inspect utilizzando l'API Java

Inspect è un documento PDF protetto da policy utilizzando l’API del servizio Document Security (Java):

  1. Includi file di progetto.

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

  2. Creare un oggetto API client 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 da policy da esaminare.

    • Creare un oggetto java.io.FileInputStream che rappresenta il documento PDF protetto da 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 RightsManagementClient dell'oggetto getDocumentManager.
    • Inspect è il documento protetto da policy richiamando il metodo LicenseManager dell'oggetto inspectDocument. Passa l'oggetto com.adobe.idp.Document che contiene il documento PDF protetto da policy. Questo metodo restituisce un oggetto RMInspectResult contenente informazioni sul documento protetto tramite criterio.
  5. Ottenere informazioni sul documento protetto tramite criterio.

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

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:

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

Documenti PDF protetti da policy Inspect utilizzando l'API del servizio Web

Inspect è un documento PDF protetto da policy utilizzando l'API del servizio Document Security (servizio Web):

  1. Includi file di progetto.

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

    NOTA

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

  2. Creare un oggetto API client Document Security.

    • Creare un oggetto RightsManagementServiceClient utilizzando il relativo costruttore predefinito.

    • Creare un oggetto RightsManagementServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. 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.)

    • Crea un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo RightsManagementServiceClient.Endpoint.Binding . Imposta il valore restituito su 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à:

      • Assegna il nome utente del modulo di AEM al campo RightsManagementServiceClient.ClientCredentials.UserName.UserName.
      • Assegna il valore della password corrispondente al campo RightsManagementServiceClient.ClientCredentials.UserName.Password.
      • Assegna il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
    • Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

  3. Recuperare un documento protetto da policy da esaminare.

    • Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare un documento PDF da esaminare.
    • Creare un oggetto System.IO.FileStream richiamando il relativo costruttore. Passa 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 dell'array di byte ottenendo la proprietà Length dell'oggetto System.IO.FileStream.
    • Compilare l’array di byte con i dati del flusso richiamando il metodo Read dell’oggetto System.IO.FileStream. Passa la matrice byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l'oggetto BLOB assegnando il relativo campo MTOM con il contenuto dell'array di byte.
  4. Inspect il documento.

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

  5. Ottenere informazioni sul documento protetto tramite criterio.

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

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:

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

Consulta anche

Richiamo di AEM Forms tramite MTOM

Richiamo di AEM Forms tramite SwaRef

Creazione di filigrane

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

NOTA

Solo gli utenti con privilegi amministrativi di Document Security possono creare filigrane. In altre parole, è necessario specificare tale utente quando si definiscono le impostazioni di connessione necessarie per creare un oggetto client del servizio Document Security.

NOTA

Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

Per creare una filigrana, effettua le seguenti operazioni:

  1. Includi file di progetto.
  2. Creare un oggetto API client Document Security.
  3. Impostare gli attributi delle filigrane.
  4. Registrare la filigrana con 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, assicurati di includere i file proxy.

Creare un oggetto API client di sicurezza dei documenti

Prima di poter eseguire un'operazione del servizio Document Security, è necessario creare un oggetto client del servizio Document Security. Se utilizzi l’API Java, crea un oggetto RightsManagementClient. Se si utilizza l'API del servizio Web Document Security, creare un oggetto RightsManagementServiceService.

Impostare gli attributi delle filigrane

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

  • Testo personalizzato
  • DateIncluded
  • IDutenteIncluso
  • NomeUtenteIncluso

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

Nome chiave

Descrizione

Valore

WaterBackCmd:IS_USERNAME_ENABLED

Specifica se il nome utente dell'utente che apre il documento fa parte della filigrana.

True o False

WaterBackCmd:IS_USERID_ENABLED

Specifica se l'identificazione dell'utente che apre il documento fa parte della filigrana.

True o False

WaterBackCmd:IS_CURRENTDATE_ENABLED

Specifica se la data corrente fa parte della filigrana.

True o False

WaterBackCmd:IS_CUSTOMTEXT_ENABLED

Se questo valore è true, è necessario specificare il valore del testo personalizzato utilizzando WaterBackCmd:SRCTEXT.

True o False

WaterBackCmd:OPACITY

Specifica l'opacità della filigrana. Il valore predefinito è 0,5 se non è specificato.

Un valore compreso tra 0,0 e 1,0.

WaterBackCmd:ROTATION

Specifica la rotazione della filigrana. Il valore predefinito è 0 gradi.

Un valore compreso tra 0 e 359.

WaterBackCmd:SCALE

Se si specifica questo valore, WaterBackCmd:IS_SIZE_ENABLED deve essere presente e il valore deve essere true. Se questo attributo non viene specificato, il comportamento predefinito è adattato alla pagina.

Un valore maggiore di 0.0 e inferiore o uguale a 1.0.

WaterBackCmd:HORIZ_ALIGN

Specifica l’allineamento orizzontale della filigrana. Il valore predefinito è center.

a sinistra, al centro o a destra

WaterBackCmd:VERT_ALIGN

Specifica l’allineamento verticale della filigrana. Il valore predefinito è center.

superiore, centrale o inferiore

WaterBackCmd:IS_USE_BACKGROUND

Specifica se la filigrana è di sfondo. Il valore predefinito è false.

True o False

WaterBackCmd:IS_SIZE_ENABLED

True se è specificata una scala personalizzata. Se questo valore è true, è necessario specificare anche SCALE . Se questo valore è false, il valore predefinito è fit to page.

True o False

WaterBackCmd:SRCTEXT

Specifica il testo personalizzato per una filigrana. Se questo valore è presente, anche WaterBackCmd:IS_CUSTOMTEXT_ENABLED deve essere presente e impostato su true.

True o False

Tutte le filigrane devono avere uno dei seguenti attributi definiti:

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

Tutti gli altri attributi sono facoltativi.

Registra la filigrana

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

Consulta anche

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Applicazione dei criteri ai documenti PDF

Creare watermark utilizzando l'API Java

Crea una filigrana utilizzando l’API Document Security (Java):

  1. Includi file di progetto.

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

  2. Creare un oggetto API client Document Security.

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

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

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

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:

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

Creare watermark utilizzando l'API del servizio Web

Crea una filigrana utilizzando l’API Document Security (servizio Web):

  1. Creare un oggetto API client Document Security.

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

    NOTA

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

  2. Creare un oggetto API client Document Security.

    • Creare un oggetto RightsManagementServiceClient utilizzando il relativo costruttore predefinito.

    • Creare un oggetto RightsManagementServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. 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.)

    • Crea un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo RightsManagementServiceClient.Endpoint.Binding . Imposta il valore restituito su 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à:

      • Assegna il nome utente del modulo di AEM al campo RightsManagementServiceClient.ClientCredentials.UserName.UserName.
      • Assegna il valore della password corrispondente al campo RightsManagementServiceClient.ClientCredentials.UserName.Password.
      • Assegna il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
    • Assegna 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 WatermarkSpec dell'oggetto name.
    • Imposta l’attributo id della filigrana assegnando un valore stringa al membro dati WatermarkSpec dell’oggetto id.
    • Per ogni proprietà watermark 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 ciascun oggetto MyMapOf_xsd_string_To_xsd_anyType_Item, richiamare il metodo MyArrayOf_xsd_anyType dell'oggetto Add. Passa l'oggetto MyMapOf_xsd_string_To_xsd_anyType_Item .
    • Assegna l'oggetto MyArrayOf_xsd_anyType al membro dati WatermarkSpec dell'oggetto values.
  4. Registra 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 che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:

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

Consulta anche

Richiamo di AEM Forms tramite MTOM

Richiamo di AEM Forms tramite SwaRef

Modifica delle filigrane

Puoi modificare una filigrana esistente utilizzando l’API Java per la sicurezza dei documenti o l’API del servizio Web. Per apportare modifiche a una filigrana esistente, recuperarla, modificarne gli attributi e quindi aggiornarla sul server. Ad esempio, si supponga di recuperare una filigrana e di modificarne l’attributo di opacità. Prima che la modifica abbia effetto, è necessario aggiornare la filigrana.

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

NOTA

Solo gli utenti con privilegi amministrativi di Document Security possono modificare i watermark. In altre parole, è necessario specificare tale utente quando si definiscono le impostazioni di connessione necessarie per creare un oggetto client del servizio Document Security.

NOTA

Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

Per modificare una filigrana, effettua le seguenti operazioni:

  1. Includi file di progetto.
  2. Creare un oggetto API client Document Security.
  3. Recupera 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, assicurati di includere i file proxy.

Creare un oggetto API client di sicurezza dei documenti

Prima di poter eseguire un'operazione del servizio Document Security, è necessario creare un oggetto client del servizio Document Security. Se utilizzi l’API Java, crea un oggetto DocumentSecurityClient. Se si utilizza l'API del servizio Web Document Security, creare un oggetto DocumentSecurityServiceService.

Recupera la filigrana da modificare

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

Impostare gli attributi delle filigrane

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

NOTA

Quando utilizzi l’API Java per modificare una filigrana, non devi specificare tutti gli attributi. Impostare l'attributo della filigrana che si desidera modificare.

NOTA

Per informazioni sui nomi degli attributi della filigrana, consulta Creazione di filigrane.

Aggiorna la filigrana

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

Consulta anche

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Creazione di filigrane

Modificare i watermark utilizzando l'API Java

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

  1. Includi file di progetto.

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

  2. Creare un oggetto API client Document Security.

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

    Creare un oggetto WatermarkManager richiamando il metodo DocumentSecurityClient dell'oggetto getWatermarkManager 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 la filigrana è completamente trasparente.

    NOTA

    In questo esempio viene modificato solo l'attributo opacity.

  5. Aggiorna la filigrana.

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

Esempi di codice

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

Modificare i watermark utilizzando l'API del servizio Web

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

  1. Includi file di progetto.

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

    NOTA

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

  2. Creare un oggetto API client Document Security.

    • Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

    • Creare un oggetto 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.)

    • Crea un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo DocumentSecurityServiceClient.Endpoint.Binding . Imposta il valore restituito su 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à:

      • Assegna il nome utente del modulo di AEM al campo DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
      • Assegna il valore della password corrispondente al campo DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
      • Assegna il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
    • Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

  3. Recupera la filigrana da modificare.

    Recupera 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à di 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 ciascun oggetto MyMapOf_xsd_string_To_xsd_anyType_Item, richiamare il metodo MyArrayOf_xsd_anyType dell'oggetto Add. Passa l'oggetto MyMapOf_xsd_string_To_xsd_anyType_Item .
    • Assegna l'oggetto MyArrayOf_xsd_anyType al membro dati WatermarkSpec dell'oggetto values.
  5. Aggiorna la filigrana.

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

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, vedere la seguente Guida rapida:

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

Ricerca di eventi

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

Gli eventi rientrano in una delle seguenti categorie:

  • Gli eventi di amministratore sono azioni correlate a un amministratore, ad esempio la creazione di un nuovo account di amministratore.
  • Gli eventi del documento sono azioni correlate a un documento, ad esempio la chiusura di un documento protetto da policy.
  • Gli eventi dei criteri sono azioni correlate a un criterio, ad esempio la creazione di un nuovo criterio.
  • Gli eventi di servizio sono azioni relative 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 del servizio Web. Cercando gli eventi, è possibile eseguire attività quali la creazione di un file di registro di determinati eventi.

NOTA

Per ulteriori informazioni sul servizio Rights Management, consulta Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

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

  1. Includi file di progetto.
  2. Crea un oggetto API client 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, assicurati di includere i file proxy.

Creare un oggetto API client Rights Management

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

Specifica gli eventi da cercare

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

Cerca l’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 libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Cercare eventi utilizzando l'API Java

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

  1. Includi file di progetto

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

  2. Creare un oggetto API client Rights Management

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

  3. Specifica gli eventi da cercare

    • Creare un oggetto EventManager richiamando il metodo DocumentSecurityClient dell'oggetto getEventManager. Questo metodo restituisce un oggetto EventManager.
    • Creare un oggetto EventSearchFilter richiamando il relativo costruttore.
    • Specificare l'evento per il quale eseguire la ricerca richiamando il metodo setEventCode dell'oggetto EventSearchFilter e passando un membro di 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, passa EventManager.POLICY_CREATE_EVENT.
    NOTA

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

  4. Cerca l’evento

    Ricercare 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 oggetti Event.

Esempi di codice

Per esempi di codice che utilizzano il servizio di Rights Management, consulta i seguenti Quick Starts:

  • "Avvio rapido (SOAP): Ricerca di eventi utilizzando l’API Java"

Cercare eventi utilizzando l'API del servizio Web

Cerca eventi utilizzando l’API di Rights Management (servizio Web):

  1. Includi file di progetto

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

    NOTA

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

  2. Creare un oggetto API client Rights Management

    • Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

    • Creare un oggetto DocumentSecurityServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. 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.)

    • Crea un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo DocumentSecurityServiceClient.Endpoint.Binding . Imposta il valore restituito su 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à:

      • Assegna il nome utente del modulo di AEM al campo DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
      • Assegna il valore della password corrispondente al campo DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
      • Assegna il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
    • Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

  3. Specifica gli eventi da cercare

    • Creare un oggetto EventSpec utilizzando il relativo costruttore.
    • Specifica l'inizio del periodo di tempo durante il quale si è verificato l'evento impostando il membro dati firstTime.date dell'oggetto EventSpec con l'istanza DataTime che rappresenta l'inizio dell'intervallo di date in cui si è verificato l'evento.
    • Assegna il valore true al membro dati EventSpec dell'oggetto firstTime.dateSpecified.
    • Specifica la fine del periodo di tempo durante il quale si è verificato l’evento impostando il membro dati lastTime.date dell’oggetto DataTime con l’istanza EventSpec che rappresenta la fine dell’intervallo di date in cui si è verificato l’evento.
    • Assegna il valore true al membro dati EventSpec dell'oggetto lastTime.dateSpecified.
    • 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à:

    Tipo evento

    Valore

    ALL_EVENTS

    999

    USER_CHANGE_PASSWORD_EVENT

    1000

    USER_REGISTER_EVENT

    1001

    USER_PREREGISTER_EVENT

    1002

    USER_ACTIVATE_EVENT

    1003

    USER_DEACTIVATE_EVENT

    1004

    USER_AUTHENTICATE_EVENT

    1005

    USER_AUTHENTICATE_DENY_EVENT

    1006

    USER_ACCOUNT_LOCK_EVENT

    1007

    USER_DELETE_EVENT

    1008

    USER_UPDATE_PROFILE_EVENT

    1009

    DOCUMENT_VIEW_EVENT

    2000

    DOCUMENT_PRINT_LOW_EVENT

    2001

    DOCUMENT_PRINT_HIGH_EVENT

    2002

    DOCUMENT_SIGN_EVENT

    2003

    DOCUMENT_ADD_ANNOTATION_EVENT

    2004

    DOCUMENT_FORM_FILL_EVENT

    2005

    DOCUMENT_CLOSE_EVENT

    2006

    DOCUMENT_MODIFY_EVENT

    2007

    DOCUMENT_CHANGE_SECURITY_HANDLER_EVENT

    2008

    DOCUMENT_SWITCH_POLICY_EVENT

    2009

    DOCUMENT_REVOKE_EVENT

    2010

    $1

    2011

    DOCUMENT_SECURE_EVENT

    2012

    DOCUMENT_UNKNOWN_CLIENT_EVENT

    2013

    DOCUMENT_CHANGE_REVOKE_URL_EVENT

    2014

    POLICY_CHANGE_EVENT

    3000

    POLICY_ENABLE_EVENT

    3001

    POLICY_DISABLE_EVENT

    3002

    POLICY_CREATE_EVENT

    3003

    POLICY_DELETE_EVENT

    3004

    POLICY_CHANGE_OWNER_EVENT

    3005

    SERVER_CLIENT_SYNC_EVENT

    4000

    SERVER_SYNC_DIR_INFO_EVENT

    4001

    SERVER_SYNC_DIR_COMPLETE_EVENT

    4002

    SERVER_VERSION_MISMATCH_EVENT

    4003

    SERVER_CONFIG_CHANGE_EVENT

    4004

    SERVER_ENABLE_OFFLINE_ACCESS_EVENT

    4005

    ADMIN_ADD_EVENT

    5000

    ADMIN_DELETE_EVENT

    5001

    ADMIN_EDIT_EVENT

    5002

    ADMIN_ACTIVATE_EVENT

    5003

    ADMIN_DEACTIVATE_EVENT

    5004

    ERROR_DIRECTORY_SERVICE_EVENT

    6000

    CREATED_POLICYSET_EVENT

    7000

    DELETED_POLICYSET_EVENT

    7001

    MODIFIED_POLICYSET_EVENT

    7002

  4. Cerca l’evento

    Ricercare l’evento richiamando il metodo searchForEvents dell’oggetto DocumentSecurityServiceClient e passando l’oggetto EventSpec che rappresenta l’evento da cercare e il numero massimo di risultati. Questo metodo restituisce un insieme MyArrayOf_xsd_anyType in cui ogni elemento è un'istanza AuditSpec. Utilizzando un'istanza AuditSpec, puoi 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 che utilizzano il servizio di Rights Management, consulta i seguenti Quick Starts:

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

Consulta anche

Richiamo di AEM Forms tramite MTOM

Richiamo di AEM Forms tramite SwaRef

Applicazione dei criteri ai documenti di Word

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

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

NOTA

Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

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

  1. Includi file di progetto.
  2. Creare un oggetto API client Document Security.
  3. Recuperare un documento Word a cui viene applicato un criterio.
  4. Applicare un criterio esistente al documento Word.
  5. Salvare il documento Word protetto da 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, assicurati di includere i file proxy.

Creare un oggetto API client Document Security

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

Recupera un documento di Word

È necessario recuperare un documento di Word per applicare un criterio. Dopo aver applicato un criterio al documento Word, gli utenti vengono limitati quando utilizzano il documento. Ad esempio, se il criterio non consente l'apertura del documento in modalità non in linea, per aprire il documento gli utenti devono essere in linea.

Applicare un criterio esistente al documento 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 verifica un'eccezione.

Salva il documento Word

Dopo aver applicato un criterio a un documento di Word, è possibile salvare il documento Word protetto da policy come file DOC.

Consulta anche

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Revoca dell’accesso ai documenti

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

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

  1. Includi file di progetto.

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

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

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

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

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

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

      Il metodo protectDocument restituisce un oggetto RMSecureDocumentResult contenente il documento Word protetto da policy.

  5. Salvare il documento Word.

    • Richiamare il metodo getProtectedDoc dell'oggetto RMSecureDocumentResult per ottenere il documento Word protetto da policy. Questo metodo restituisce un oggetto com.adobe.idp.Document.
    • Crea un oggetto java.io.File e assicurati 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 che utilizzano il servizio Document Security, vedere la seguente Guida rapida:

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

Applicare un criterio a un documento Word utilizzando l'API del servizio Web

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

  1. Includi file di progetto.

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

    NOTA

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

  2. Creare un oggetto API client Document Security.

    • Creare un oggetto DocumentSecurityServiceClient utilizzando il relativo costruttore predefinito.

    • Creare un oggetto DocumentSecurityServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. 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.)

    • Crea un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo DocumentSecurityServiceClient.Endpoint.Binding . Imposta il valore restituito su 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à:

      • Assegna il nome utente del modulo di AEM al campo DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
      • Assegna il valore della password corrispondente al campo DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
      • Assegna il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
    • Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

  3. Recuperare un documento Word.

    • Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare un documento Word a cui viene applicato un criterio.
    • Creare un oggetto System.IO.FileStream richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento 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 dell'array di byte ottenendo la proprietà Length dell'oggetto System.IO.FileStream.
    • Compilare l’array di byte con i dati del flusso richiamando il metodo Read dell’oggetto System.IO.FileStream. Passa la matrice dei byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l'oggetto BLOB assegnando il relativo campo MTOM con il contenuto dell'array di byte.
  4. Applicare un criterio esistente al documento Word.

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

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

    Il metodo protectDocument restituisce un oggetto BLOB contenente il documento Word protetto da policy.

  5. Salvare il documento Word.

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

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, vedere la seguente Guida rapida:

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

Rimozione di criteri dai documenti di Word

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

NOTA

Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

Per rimuovere un criterio da un documento Word protetto da policy, eseguire le operazioni seguenti:

  1. Includi file di progetto
  2. Creare un oggetto API client Document Security.
  3. Recuperare un documento Word protetto da policy.
  4. Rimuovere il criterio dal documento Word.
  5. Salvare 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, assicurati di includere i file proxy.

Creare un oggetto API client di sicurezza dei documenti

Prima di eseguire un'operazione del servizio Document Security, creare un oggetto client del servizio Document Security.

Recuperare un documento Word protetto da policy

Per rimuovere un criterio, è necessario recuperare un documento Word protetto da policy. Se si tenta di rimuovere un criterio da un documento di Word non protetto da un criterio, verrà generata un'eccezione.

Rimuovi il criterio dal documento Word

È possibile rimuovere un criterio da un documento Word protetto da criteri purché 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 rimuove un criterio da un documento Word, è possibile salvare il documento Word non protetto come file DOC.

Consulta anche

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Applicazione dei criteri ai documenti di Word

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

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

  1. Includi file di progetto

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

  2. Creare un oggetto API client di sicurezza dei documenti

    • 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 da policy

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

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

    • Crea un oggetto java.io.File e assicurati 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 che utilizzano il servizio Document Security, vedere la seguente Guida rapida:

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

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

Rimuovere un criterio da un documento Word protetto da policy utilizzando l'API Document Security (servizio Web):

  1. Includi file di progetto

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

    NOTA

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

  2. Creare un oggetto API client di sicurezza dei documenti

    • 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.)

    • Crea un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo RightsManagementServiceClient.Endpoint.Binding . Imposta il valore restituito su 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à:

      • Assegna il nome utente del modulo di AEM al campo RightsManagementServiceClient.ClientCredentials.UserName.UserName.
      • Assegna il valore della password corrispondente al campo RightsManagementServiceClient.ClientCredentials.UserName.Password.
      • Assegna il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
    • Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

  3. Recuperare un documento Word protetto da policy

    • Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare il documento Word protetto dai criteri da cui viene rimosso il criterio.
    • Creare un oggetto System.IO.FileStream richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento 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 dell'array di byte ottenendo la proprietà Length dell'oggetto System.IO.FileStream.
    • Compilare l’array di byte con i dati del flusso richiamando il metodo Read dell’oggetto System.IO.FileStream e passando l’array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l'oggetto BLOB assegnando il relativo campo MTOM con il contenuto dell'array di byte.
  4. Rimuovi il criterio dal documento Word

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

  5. Salvare il documento Word non protetto

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

Esempi di codice

Per esempi di codice che utilizzano il servizio Document Security, vedere la seguente Guida rapida:

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

Consulta anche

Richiamo di AEM Forms tramite MTOM

In questa pagina