Protezione di documenti con criteri protecting-documents-with-policies
Gli esempi e gli esempi contenuti in questo documento sono solo per l’ambiente AEM Forms su JEE.
Informazioni sul servizio Document Security
Il servizio Document Security consente agli utenti di applicare dinamicamente le impostazioni di riservatezza ai documenti di Adobe PDF e di mantenere il controllo su di essi, indipendentemente dalla loro diffusione.
Il servizio Document Security impedisce la diffusione di informazioni al di fuori della portata dell’utente, consentendo agli utenti di mantenere il controllo sul modo in cui i destinatari utilizzano il documento PDF protetto tramite policy. Un utente può specificare chi può aprire un documento, limitare le modalità di utilizzo e monitorare il documento dopo la distribuzione. Un utente può inoltre controllare in modo dinamico l’accesso a un documento protetto tramite policy e può persino revocare in modo dinamico l’accesso al documento.
Il servizio Document Security protegge anche altri tipi di file, come i file Word di Microsoft (file DOC). Per utilizzare questi tipi di file è possibile utilizzare l’API client di Document Security. Sono supportate le seguenti versioni:
- File di Microsoft Office 2003 (file DOC, XLS, PPT)
- File di Microsoft Office 2007 (file DOCX, XLSX, PPTX)
- File PTC Pro/E
Per maggiore chiarezza, nelle due sezioni seguenti viene illustrato come utilizzare i documenti di Word:
Puoi eseguire queste attività utilizzando il servizio Document Security:
- Creare criteri. Per informazioni, consulta Creazione di criteri.
- Modificare i criteri. Per informazioni, consulta Modifica dei criteri.
- Elimina criteri. Per informazioni, consulta Eliminazione dei criteri.
- Applicare policy ai documenti PDF. Per informazioni, consulta Applicazione delle policy ai documenti di PDF.
- Rimuovere i criteri dai documenti di PDF. Per informazioni, consulta Rimozione di criteri dai documenti di PDF.
- Documenti protetti tramite policy di Inspect. Per informazioni, consulta Verifica dei documenti di PDF protetti tramite policy.
- Revoca dell'accesso ai documenti di PDF. Per informazioni, consulta Revoca dell'accesso ai documenti.
- Ripristinare l'accesso ai documenti revocati. Per informazioni, consulta Ripristino dell’accesso ai documenti revocati.
- Creare filigrane. Per informazioni, consulta Creazione di filigrane.
- Cerca gli eventi. Per informazioni, consulta Ricerca di eventi.
Creazione di criteri creating-policies
Puoi creare policy a livello di programmazione utilizzando l’API Java di Document Security o l’API di servizio web. A policy è una raccolta di informazioni che includono impostazioni di protezione dei documenti, utenti autorizzati e diritti di utilizzo. È possibile creare e salvare un numero qualsiasi di criteri, utilizzando le impostazioni di protezione appropriate per situazioni e utenti diversi.
I criteri consentono di eseguire le seguenti attività:
- Specificare gli utenti autorizzati ad aprire il documento. I destinatari possono appartenere o essere esterni alla tua organizzazione.
- Specificare come i destinatari possono utilizzare il documento. Puoi limitare l’accesso a diverse funzioni di Acrobat e Adobe Reader. Queste funzionalità includono la possibilità di stampare e copiare testo, aggiungere firme e aggiungere commenti a un documento.
- Modificare le impostazioni di accesso e protezione in qualsiasi momento, anche dopo la distribuzione del documento protetto tramite policy.
- Monitorare l'utilizzo del documento dopo averlo distribuito. È possibile vedere come viene utilizzato il documento e chi lo sta utilizzando. Ad esempio, è possibile verificare quando un utente ha aperto il documento.
Creazione di una policy tramite servizi web creating-a-policy-using-web-services
Quando si crea una policy utilizzando l’API del servizio Web, fare riferimento a un file XML Portable Document Rights Language (PDRL) esistente che descrive la policy. Le autorizzazioni dei criteri e l'entità principale sono definite nel documento PDRL. Il seguente documento XML è un esempio di documento PDRL.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Policy PolicyInstanceVersion="1" PolicyID="5DA3F847-DE76-F9CC-63EA-49A8D59154DE" PolicyCreationTime="2004-08-30T00:02:28.294+00:00" PolicyType="1" PolicySchemaVersion="1.0" PolicyName="SDK Test Policy -4344050357301573237" PolicyDescription="An SDK Test policy" xmlns="https://www.adobe.com/schema/1.0/pdrl">
<PolicyEntry>
<ns1:Permission PermissionName="com.adobe.aps.onlineOpen" Access="ALLOW" xmlns:ns1="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns2:Permission PermissionName="com.adobe.aps.offlineOpen" Access="ALLOW" xmlns:ns2="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns3:Permission PermissionName="com.adobe.aps.pdf.editNotes" Access="ALLOW" xmlns:ns3="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns4:Permission PermissionName="com.adobe.aps.pdf.fillAndSign" Access="ALLOW" xmlns:ns4="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<Principal PrincipalNameType="SYSTEM">
<PrincipalDomain>EDC_SPECIAL</PrincipalDomain>
<PrincipalName>all_internal_users</PrincipalName>
</Principal>
</PolicyEntry>
<PolicyEntry>
<ns5:Permission PermissionName="com.adobe.aps.onlineOpen" Access="ALLOW" xmlns:ns5="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns6:Permission PermissionName="com.adobe.aps.offlineOpen" Access="ALLOW" xmlns:ns6="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns7:Permission PermissionName="com.adobe.aps.pdf.copy" Access="ALLOW" xmlns:ns7="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns8:Permission PermissionName="com.adobe.aps.pdf.printLow" Access="ALLOW" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" xmlns:ns8="https://www.adobe.com/schema/1.0/pdrl" />
<ns9:Permission PermissionName="com.adobe.aps.policySwitch" Access="ALLOW" xmlns:ns9="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns10:Permission PermissionName="com.adobe.aps.revoke" Access="ALLOW" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" xmlns:ns10="https://www.adobe.com/schema/1.0/pdrl" />
<ns11:Permission PermissionName="com.adobe.aps.pdf.edit" Access="ALLOW" xmlns:ns11="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns12:Permission PermissionName="com.adobe.aps.pdf.editNotes" Access="ALLOW" xmlns:ns12="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns13:Permission PermissionName="com.adobe.aps.pdf.fillAndSign" Access="ALLOW" xmlns:ns13="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns14:Permission PermissionName="com.adobe.aps.pdf.printHigh" Access="ALLOW" xmlns:ns14="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<Principal PrincipalNameType="SYSTEM">
<PrincipalDomain>EDC_SPECIAL</PrincipalDomain>
<PrincipalName>publisher</PrincipalName>
</Principal>
</PolicyEntry>
<OfflineLeasePeriod>
<Duration>P31D</Duration>
</OfflineLeasePeriod>
<AuditSettings isTracked="true" />
<PolicyValidityPeriod isAbsoluteTime="false">
<ValidityPeriodRelative>
<NotBeforeRelative>PT0S</NotBeforeRelative>
<NotAfterRelative>P20D</NotAfterRelative>
</ValidityPeriodRelative>
</PolicyValidityPeriod>
</Policy>
Riepilogo dei passaggi summary-of-steps
Per creare un criterio, effettuare le seguenti operazioni:
- Includi file di progetto.
- Crea un oggetto API client di Document Security.
- Impostare gli attributi del criterio.
- Crea una voce criterio.
- Registra il criterio.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
- adobe-rightsmanagement-client.jar
- namespace.jar (se AEM Forms è distribuito su JBoss)
- jaxb-api.jar (se AEM Forms è distribuito su JBoss)
- jaxb-impl.jar (se AEM Forms è distribuito su JBoss)
- jaxb-libs.jar (se AEM Forms è distribuito su JBoss)
- jaxb-xjc.jar (se AEM Forms è distribuito su JBoss)
- relaxDatatype.jar (se AEM Forms è distribuito su JBoss)
- xsdlib.jar (se AEM Forms è distribuito su JBoss)
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-utilities.jar
- jbossall-client.jar (utilizza un file JAR diverso se AEM Forms non è distribuito su JBoss)
Per informazioni sulla posizione di questi file JAR, vedi Inclusione dei file della libreria Java di AEM Forms.
Creare un oggetto API client di Document Security
Prima di poter eseguire un’operazione del servizio Document Security a livello di programmazione, crea un oggetto client del servizio Document Security.
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 ogni set di criteri. Un set di criteri è semplicemente una raccolta di criteri. Se i criteri appartengono a set di criteri separati, è possibile che siano presenti due criteri con lo stesso nome. Tuttavia, due criteri all'interno di un singolo set di criteri non possono avere lo stesso nome.
Un altro attributo utile da impostare è il periodo di validità. Un periodo di validità è il periodo di tempo durante il quale un documento protetto tramite policy è accessibile ai destinatari autorizzati. Se non si imposta questo attributo, il criterio è sempre valido.
Un periodo di validità può essere impostato su una delle seguenti opzioni:
- Un numero di giorni impostato per l'accesso al documento dal momento in cui il documento viene pubblicato
- Data di fine dopo la quale il documento non è accessibile
- Un intervallo di date specifico per il quale il documento è accessibile
- Sempre valido
È possibile specificare solo una data di inizio, che determina la validità del criterio dopo la data di inizio. Se specifichi solo una data di fine, il criterio è valido fino alla data di fine. Tuttavia, viene generata un’eccezione se non sono definite sia una data di inizio che una data di fine.
Quando si impostano gli attributi che appartengono a un criterio, è inoltre possibile impostare le impostazioni di crittografia. Queste impostazioni di crittografia hanno effetto quando la policy viene applicata a un documento. È possibile specificare i seguenti valori di crittografia:
- AES256: rappresenta l’algoritmo di crittografia AES con una chiave a 256 bit.
- AES128: rappresenta l’algoritmo di crittografia AES con una chiave a 128 bit.
- Nessuna crittografia: Non rappresenta alcuna crittografia.
Quando si specifica NoEncryption
, non è possibile impostare PlaintextMetadata
opzione per false
. Se tenti di farlo, viene generata un’eccezione.
Policy
descrizione dell’interfaccia in Riferimento API di AEM Forms.Creare una voce criterio
Una voce criterio consente di associare entità, ovvero gruppi e utenti, e autorizzazioni a un criterio. Un criterio deve avere almeno una voce di criterio. Si supponga, ad esempio, di eseguire i task riportati di seguito.
- Creare e registrare una voce di criterio che consente a un gruppo di visualizzare un documento solo mentre è online e impedisce ai destinatari di copiarlo.
- Allega la voce del criterio al criterio.
- Proteggi un documento con la policy utilizzando Acrobat.
Di conseguenza, i destinatari possono solo visualizzare il documento online e non possono copiarlo. Il documento rimane protetto finché non viene rimossa la protezione.
Registra la policy
È necessario registrare un nuovo criterio prima di poterlo utilizzare. Dopo aver registrato una policy, è possibile utilizzarla per proteggere i documenti.
Creare un criterio utilizzando l’API Java create-a-policy-using-the-java-api
Crea una policy utilizzando Document Security API (Java):
-
Includi file di progetto.
Includi i file JAR dei client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
-
Crea un oggetto API client di Document Security.
- Creare un
ServiceClientFactory
oggetto che contiene proprietà di connessione. - Creare un
DocumentSecurityClient
mediante il costruttore e passando ilServiceClientFactory
oggetto.
- Creare un
-
Impostare gli attributi del criterio.
- Creare un
Policy
oggetto richiamando ilInfomodelObjectFactory
statico dell'oggettocreatePolicy
metodo. Questo metodo restituisce unPolicy
oggetto. - Impostare l'attributo name del criterio richiamando
Policy
dell'oggettosetName
e passando un valore stringa che specifica il nome del criterio. - Impostare la descrizione del criterio richiamando
Policy
dell'oggettosetDescription
e passando un valore stringa che specifica la descrizione del criterio. - Specificare il set di criteri a cui appartiene il nuovo criterio richiamando
Policy
dell'oggettosetPolicySetName
e passando un valore stringa che specifica il nome del set di criteri. (È possibile specificarenull
per questo valore di parametro che determina l’aggiunta del criterio a I Miei Criteri set di criteri.) - Creare il periodo di validità del criterio richiamando
InfomodelObjectFactory
statico dell'oggettocreateValidityPeriod
metodo. Questo metodo restituisce unValidityPeriod
oggetto. - Impostare il numero di giorni per i quali un documento protetto tramite policy è accessibile richiamando
ValidityPeriod
dell'oggettosetRelativeExpirationDays
e viene passato un valore intero che specifica il numero di giorni. - Impostare il periodo di validità del criterio richiamando
Policy
dell'oggettosetValidityPeriod
e passando ilValidityPeriod
oggetto.
- Creare un
-
Crea una voce criterio.
- Creare una voce di criterio richiamando
InfomodelObjectFactory
statico dell'oggettocreatePolicyEntry
metodo. Questo metodo restituisce unPolicyEntry
oggetto. - Specificare le autorizzazioni del criterio richiamando
InfomodelObjectFactory
statico dell'oggettocreatePermission
metodo. Trasmettere un membro dati statico che appartiene alPermission
interfaccia che rappresenta l’autorizzazione. Questo metodo restituisce unPermission
oggetto. Ad esempio, per aggiungere l’autorizzazione che consente agli utenti di copiare i dati da un documento PDF protetto tramite policy, passaPermission.COPY
. (Ripeti questo passaggio per ogni autorizzazione da aggiungere). - Aggiungere l’autorizzazione alla voce del criterio richiamando
PolicyEntry
dell'oggettoaddPermission
e passando ilPermission
oggetto. (Ripeti questo passaggio per ogniPermission
oggetto creato). - Creare l’entità criterio richiamando
InfomodelObjectFactory
statico dell'oggettocreateSpecialPrincipal
metodo. Trasmettere un membro dati che appartiene alInfomodelObjectFactory
oggetto che rappresenta l'entità principale. Questo metodo restituisce unPrincipal
oggetto. Ad esempio, per aggiungere l'editore del documento come entità principale, passareInfomodelObjectFactory.PUBLISHER_PRINCIPAL
. - Aggiungere l'entità alla voce del criterio richiamando
PolicyEntry
dell'oggettosetPrincipal
e passando ilPrincipal
oggetto. - Aggiungere la voce del criterio richiamando
Policy
dell'oggettoaddPolicyEntry
e passando ilPolicyEntry
oggetto.
- Creare una voce di criterio richiamando
-
Registra il criterio.
-
Creare un
PolicyManager
oggetto richiamando ilDocumentSecurityClient
dell'oggettogetPolicyManager
metodo. -
Registra il criterio richiamando
PolicyManager
dell'oggettoregisterPolicy
e fornendo i seguenti valori:- Il
Policy
oggetto che rappresenta il criterio da registrare.
- Il
-
Valore stringa che rappresenta il set di criteri a cui appartiene il criterio.
Se si utilizza un account amministratore di AEM forms nelle impostazioni di connessione per creare
DocumentSecurityClient
, quindi specificare il nome del set di criteri quando si richiamaregisterPolicy
metodo. Se si supera unnull
per il set di criteri, il criterio viene creato negli amministratori I Miei Criteri set di criteri.Se utilizzi un utente di Document Security nelle impostazioni di connessione, puoi richiamare l’utente sovraccaricato
registerPolicy
metodo 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 I Miei Criteri. Se non si desidera aggiungere il nuovo criterio a questo set di criteri, specificare un nome per il set di criteri quando si richiamaregisterPolicy
metodo.note note NOTE Quando crei un criterio, fai riferimento a un set di criteri esistente. Se si specifica un set di criteri che non esiste, viene generata un'eccezione. -
Per esempi di codice con il servizio Document Security, consulta:
- "Guida rapida (modalità SOAP): creazione di un criterio tramite l’API Java"
Creare un criterio utilizzando l’API del servizio web create-a-policy-using-the-web-service-api
Crea una policy utilizzando Document Security API (servizio web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms. -
Crea un oggetto API client di Document Security.
-
Creare un
DocumentSecurityServiceClient
utilizzando il costruttore predefinito. -
Creare un
DocumentSecurityServiceClient.Endpoint.Address
oggetto utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il file WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Non è necessario utilizzare illc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Creare un
System.ServiceModel.BasicHttpBinding
dell'oggetto ottenendo il valore delRightsManagementServiceClient.Endpoint.Binding
campo. Invia il valore restituito aBasicHttpBinding
. -
Imposta il
System.ServiceModel.BasicHttpBinding
dell'oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegna al campo il nome utente dei moduli AEM
RightsManagementServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore password corrispondente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Assegna al campo il nome utente dei moduli AEM
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Impostare gli attributi del criterio.
- Creare un
PolicySpec
mediante il costruttore. - Impostare il nome del criterio assegnando un valore stringa al
PolicySpec
dell'oggettoname
membro dati. - Impostare la descrizione del criterio assegnando un valore stringa al
PolicySpec
dell'oggettodescription
membro dati. - Specificare il set di criteri a cui appartiene il criterio assegnando un valore stringa al
PolicySpec
dell'oggettopolicySetName
membro dati. Specificare un nome di set di criteri esistente. (È possibile specificarenull
per questo valore di parametro che determina l’aggiunta del criterio a I Miei Criteri.) - Impostare il periodo di lease non in linea del criterio assegnando un valore intero al
PolicySpec
dell'oggettoofflineLeasePeriod
membro dati. - Imposta il
PolicySpec
dell'oggettopolicyXml
membro dati con un valore stringa che rappresenta i dati XML PDRL. Per eseguire questa operazione, creare una .NETStreamReader
mediante il costruttore. Passa la posizione di un file XML PDRL che rappresenta il criterio aStreamReader
costruttore. Quindi, richiamaStreamReader
dell'oggettoReadLine
e assegna il valore restituito a una variabile stringa. Effettua iterazione attraversoStreamReader
oggetto fino alReadLine
il metodo restituisce null. Assegna la variabile stringa aPolicySpec
dell'oggettopolicyXml
membro dati.
- Creare un
-
Crea una voce criterio.
Non è necessario creare una voce policy durante la creazione di una policy utilizzando l’API del servizio web di Document Security. La voce del criterio è definita nel documento PDRL.
-
Registra il criterio.
Registra il criterio richiamando
DocumentSecurityServiceClient
dell'oggettoregisterPolicy
e fornendo i seguenti valori:- Il
PolicySpec
oggetto che rappresenta il criterio da registrare. - Valore stringa che rappresenta il set di criteri a cui appartiene il criterio. È possibile specificare un
null
valore che determina l’aggiunta del criterio al MyPolicy set di criteri.
Se si utilizza un account amministratore di AEM forms nelle impostazioni di connessione per creare
DocumentSecurityClient
oggetto, specificare il nome del set di criteri quando si richiamaregisterPolicy
metodo.Se utilizzi un utente di Document Security nelle impostazioni di connessione, puoi richiamare l’utente sovraccaricato
registerPolicy
metodo 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 I Miei Criteri. Se non si desidera aggiungere il nuovo criterio a questo set di criteri, specificare un nome per il set di criteri quando si richiamaregisterPolicy
metodo.note note NOTE Quando crei un criterio e specifichi un set di criteri, accertati di specificare un set di criteri esistente. Se si specifica un set di criteri che non esiste, viene generata un'eccezione. - Il
Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:
- "Guida rapida (MTOM): creazione di un criterio utilizzando l’API del servizio web"
- "Guida rapida (SwaRef): creazione di un criterio utilizzando l’API del servizio web"
Modifica dei criteri modifying-policies
Puoi modificare una policy esistente utilizzando l’API Java di Document Security o l’API di servizio web. Per modificare un criterio esistente, recuperarlo, modificarlo e quindi aggiornare il criterio sul server. Si supponga, ad esempio, di recuperare un criterio esistente e di estenderne il periodo di validità. Prima che la modifica entri in vigore, devi aggiornare il criterio.
È possibile modificare un criterio quando cambiano i requisiti aziendali e il criterio non riflette più questi requisiti. Invece di creare un criterio, puoi semplicemente aggiornare un criterio esistente.
Per modificare gli attributi dei criteri utilizzando un servizio web (ad esempio, utilizzando le classi proxy Java create con JAX-WS), è necessario assicurarsi che i criteri siano registrati nel servizio Document Security. È quindi possibile fare riferimento al criterio esistente utilizzando PolicySpec.getPolicyXml
e modificare gli attributi dei criteri utilizzando i metodi applicabili. Ad esempio, puoi modificare il periodo di lease offline richiamando il PolicySpec.setOfflineLeasePeriod
metodo.
Riepilogo dei passaggi summary_of_steps-1
Per modificare un criterio esistente, effettuare le seguenti operazioni:
- Includi file di progetto.
- Crea un oggetto API client di Document Security.
- Recupera un criterio esistente.
- Modificare gli attributi dei criteri.
- Aggiorna il criterio.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.
Creare un oggetto API client di Document Security
Prima di poter eseguire un’operazione Document Security Service a livello di programmazione, è necessario creare un oggetto client del servizio Document Security. Se utilizzi l’API Java, crea un’ RightsManagementClient
oggetto. Se utilizzi l’API del servizio web Document Security, crea un’ RightsManagementServiceService
oggetto.
Recuperare un criterio esistente
Recuperare un criterio esistente per modificarlo. Per recuperare un criterio, specificare il nome del criterio e il set di criteri a cui appartiene il criterio. Se si specifica un null
per il nome del set di criteri, il criterio viene recuperato dal I Miei Criteri set di criteri.
Impostare gli attributi del criterio
Per modificare un criterio, è necessario modificare il valore degli attributi del criterio. L’unico attributo del criterio che non può essere modificato è l’attributo name. Ad esempio, per modificare il periodo di lease offline del criterio, è possibile modificare il valore dell'attributo del periodo di lease offline del criterio.
Quando si modifica il periodo di lease offline di un criterio utilizzando un servizio web, il offlineLeasePeriod
campo sul PolicySpec
viene ignorata. Per aggiornare il periodo di lease offline, modifica OfflineLeasePeriod
nel documento PDRL XML. Quindi, fare riferimento al documento XML PDRL aggiornato utilizzando PolicySpec
dell'interfaccia policyXML
membro dati.
Policy
descrizione dell’interfaccia in Riferimento API di AEM Forms.Aggiornare il criterio
Prima di poter applicare le modifiche apportate a una policy, è necessario aggiornarla con il servizio Document Security. Le modifiche alle policy che proteggono i documenti vengono aggiornate alla successiva sincronizzazione del documento protetto con il servizio Document Security.
Modificare i criteri esistenti utilizzando l’API Java modify-existing-policies-using-the-java-api
Modifica una policy esistente utilizzando Document Security API (Java):
-
Includi file di progetto.
Includi i file JAR dei client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
-
Crea un oggetto API client di Document Security.
- Creare un
ServiceClientFactory
oggetto che contiene proprietà di connessione. - Creare un
RightsManagementClient
mediante il costruttore e passando ilServiceClientFactory
oggetto.
- Creare un
-
Recupera un criterio esistente.
-
Creare un
PolicyManager
oggetto richiamando ilRightsManagementClient
dell'oggettogetPolicyManager
metodo. -
Creare un
Policy
oggetto che rappresenta il criterio da aggiornare richiamandoPolicyManager
dell'oggettogetPolicy
e fornendo i seguenti valori"- Valore stringa che rappresenta il nome del set di criteri a cui appartiene il criterio. È possibile specificare
null
che comporta laMyPolicies
set di criteri in uso. - Valore stringa che rappresenta il nome del criterio.
- Valore stringa che rappresenta il nome del set di criteri a cui appartiene il criterio. È possibile specificare
-
-
Impostare gli attributi del criterio.
Modifica gli attributi della policy per soddisfare i requisiti aziendali. Ad esempio, per modificare il periodo di lease offline del criterio, richiama
Policy
dell'oggettosetOfflineLeasePeriod
metodo. -
Aggiorna il criterio.
Aggiorna il criterio richiamando
PolicyManager
dell'oggettoupdatePolicy
metodo. Passa ilPolicy
oggetto che rappresenta il criterio da aggiornare.
Esempi di codice
Per esempi di codice con il servizio Document Security, consulta la sezione Guida rapida (modalità SOAP): modificare una policy utilizzando l’API Java.
Modificare i criteri esistenti utilizzando l’API del servizio web modify-existing-policies-using-the-web-service-api
Modifica una policy esistente utilizzando Document Security API (servizio web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms. -
Crea un oggetto API client di Document Security.
-
Creare un
RightsManagementServiceClient
utilizzando il costruttore predefinito. -
Creare un
RightsManagementServiceClient.Endpoint.Address
oggetto utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il file WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Non è necessario utilizzare illc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Creare un
System.ServiceModel.BasicHttpBinding
dell'oggetto ottenendo il valore delRightsManagementServiceClient.Endpoint.Binding
campo. Invia il valore restituito aBasicHttpBinding
. -
Imposta il
System.ServiceModel.BasicHttpBinding
dell'oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegna al campo il nome utente dei moduli AEM
RightsManagementServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore password corrispondente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Assegna al campo il nome utente dei moduli AEM
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recupera un criterio esistente.
Creare un
PolicySpec
oggetto che rappresenta il criterio da modificare richiamandoRightsManagementServiceClient
dell'oggettogetPolicy
e fornendo i seguenti valori:- Valore stringa che specifica il nome del set di criteri a cui appartiene il criterio. È possibile specificare
null
che comporta laMyPolicies
set di criteri in uso. - Valore stringa che specifica il nome del criterio.
- Valore stringa che specifica il nome del set di criteri a cui appartiene il criterio. È possibile specificare
-
Impostare gli attributi del criterio.
Modifica gli attributi della policy per soddisfare i requisiti aziendali.
-
Aggiorna il criterio.
Aggiorna il criterio richiamando
RightsManagementServiceClient
dell'oggettoupdatePolicyFromSDK
e passando ilPolicySpec
oggetto che rappresenta il criterio da aggiornare.
Esempi di codice
Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:
- "Guida rapida (MTOM): modifica di un criterio tramite l’API del servizio web"
- "Guida rapida (SwaRef): modifica di un criterio tramite l’API del servizio web"
Eliminazione dei criteri deleting-policies
Puoi eliminare una policy esistente utilizzando l’API Java di Document Security o l’API di servizio web. Una volta eliminata, una policy non può più essere utilizzata per proteggere i documenti. Tuttavia, i documenti protetti tramite policy esistenti che utilizzano la policy sono ancora protetti. È possibile eliminare un criterio quando ne diventa disponibile uno più recente.
Riepilogo dei passaggi summary_of_steps-2
Per eliminare un criterio esistente, effettuare le seguenti operazioni:
- Includi file di progetto
- Crea un oggetto API client di Document Security.
- Elimina il criterio.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.
Creare un oggetto API client di Document Security
Prima di poter eseguire un’operazione del servizio Document Security a livello di programmazione, è necessario creare un oggetto client del servizio Document Security. Se utilizzi l’API Java, crea un’ RightsManagementClient
oggetto. Se utilizzi l’API del servizio web Document Security, crea un’ RightsManagementServiceService
oggetto.
Elimina il criterio
Per eliminare un criterio, specificare il criterio da eliminare e il set di criteri a cui appartiene il criterio. L’utente le cui impostazioni vengono utilizzate per richiamare AEM Forms deve disporre dell’autorizzazione per eliminare il criterio; in caso contrario, si verifica un’eccezione. Analogamente, se si tenta di eliminare un criterio inesistente, si verifica un'eccezione.
Eliminare i criteri utilizzando l’API Java delete-policies-using-the-java-api
Elimina una policy utilizzando Document Security API (Java):
-
Includi file di progetto.
Includi i file JAR dei client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
-
Crea un oggetto API client di Document Security.
- Creare un
ServiceClientFactory
oggetto che contiene proprietà di connessione. - Creare un
RightsManagementClient
mediante il costruttore e passando ilServiceClientFactory
oggetto.
- Creare un
-
Elimina il criterio.
-
Creare un
PolicyManager
oggetto richiamando ilRightsManagementClient
dell'oggettogetPolicyManager
metodo. -
Elimina il criterio richiamando
PolicyManager
dell'oggettodeletePolicy
e fornendo i seguenti valori:- Valore stringa che specifica il nome del set di criteri a cui appartiene il criterio. È possibile specificare
null
che comporta laMyPolicies
set di criteri in uso. - Valore stringa che specifica il nome del criterio da eliminare.
- Valore stringa che specifica il nome del set di criteri a cui appartiene il criterio. È possibile specificare
-
Esempi di codice
Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:
- "Guida rapida (modalità SOAP): eliminazione di un criterio tramite l’API Java"
Eliminare i criteri utilizzando l’API del servizio web delete-policies-using-the-web-service-api
Elimina una policy utilizzando l’API di Document Security (servizio web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms. -
Crea un oggetto API client di Document Security.
-
Creare un
RightsManagementServiceClient
utilizzando il costruttore predefinito. -
Creare un
RightsManagementServiceClient.Endpoint.Address
oggetto utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il file WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Non è necessario utilizzare illc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Creare un
System.ServiceModel.BasicHttpBinding
dell'oggetto ottenendo il valore delRightsManagementServiceClient.Endpoint.Binding
campo. Invia il valore restituito aBasicHttpBinding
. -
Imposta il
System.ServiceModel.BasicHttpBinding
dell'oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegna al campo il nome utente dei moduli AEM
RightsManagementServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore password corrispondente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Assegna al campo il nome utente dei moduli AEM
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Elimina il criterio.
Eliminare un criterio richiamando
RightsManagementServiceClient
dell'oggettodeletePolicy
e fornendo i seguenti valori:- Valore stringa che specifica il nome del set di criteri a cui appartiene il criterio. È possibile specificare
null
che comporta laMyPolicies
set di criteri in uso. - Valore stringa che specifica il nome del criterio da eliminare.
- Valore stringa che specifica il nome del set di criteri a cui appartiene il criterio. È possibile specificare
Esempi di codice
Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:
- "Guida rapida (MTOM): eliminazione di un criterio tramite l’API del servizio web"
- "Guida rapida (SwaRef): eliminazione di un criterio tramite l’API del servizio web"
Applicazione delle policy ai documenti di PDF applying-policies-to-pdf-documents
È possibile applicare una policy a un documento PDF per proteggere il documento. Applicando una policy a un documento PDF, si limita l’accesso al documento. Non è possibile applicare una policy a un documento se il documento è già protetto con una policy.
Quando il documento è aperto, è inoltre possibile limitare l'accesso alle funzioni di Acrobat e Adobe Reader, inclusa la possibilità di stampare e copiare testo, apportare modifiche e aggiungere firme e commenti a un documento. Inoltre, è possibile revocare un documento PDF protetto tramite policy quando non si desidera più che gli utenti accedano al documento.
È possibile monitorare l’utilizzo di un documento protetto tramite policy dopo averlo distribuito. In altre parole, è possibile vedere come viene utilizzato il documento e chi lo sta utilizzando. Ad esempio, è possibile scoprire quando qualcuno ha aperto il documento.
Riepilogo dei passaggi summary_of_steps-3
Per applicare una policy a un documento PDF, effettuare le seguenti operazioni:
- Includi file di progetto.
- Crea un oggetto API client di Document Security.
- Recuperare un documento PDF a cui è applicato un criterio.
- Applica una policy esistente al documento PDF.
- Salva il documento PDF protetto tramite policy.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.
Creare un oggetto API client di Document Security
Prima di poter eseguire un’operazione del servizio Document Security a livello di programmazione, crea un oggetto client del servizio Document Security. Se utilizzi l’API Java, crea un’ DocumentSecurityClient
oggetto. Se utilizzi l’API del servizio web Document Security, crea un’ DocumentSecurityServiceService
oggetto.
Recuperare un documento PDF
È possibile recuperare un documento PDF per applicare una policy. Dopo aver applicato una policy al documento PDF, gli utenti vengono limitati quando utilizzano il documento. Se, ad esempio, la policy non consente l'apertura del documento in modalità non in linea, gli utenti devono essere in linea per aprire il documento.
Applicare una policy esistente al documento PDF
Per applicare una policy a un documento PDF, fai riferimento a una policy esistente e specifica a quale set di policy appartiene la policy. L'utente che sta impostando le proprietà di connessione deve avere accesso al criterio specificato. In caso contrario, si verificherà un'eccezione.
Salva il documento PDF
Dopo che il servizio Document Security ha applicato una policy a un documento PDF PDF, puoi salvarlo come file PDF.
Consulta anche
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Revoca dell'accesso ai documenti
Applicare una policy a un documento PDF utilizzando l’API Java apply-a-policy-to-a-pdf-document-using-the-java-api
Applica una policy a un documento PDF utilizzando Document Security API (Java):
-
Includi file di progetto.
Includi i file JAR dei client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
-
Crea un oggetto API client di Document Security.
- Creare un
ServiceClientFactory
oggetto che contiene proprietà di connessione. - Creare un
RightsManagementClient
mediante il costruttore e passando ilServiceClientFactory
oggetto.
- Creare un
-
Recuperare un documento PDF.
- Creare un
java.io.FileInputStream
oggetto che rappresenta il documento PDF utilizzando il relativo costruttore. Passa un valore stringa che specifica la posizione del documento PDF. - Creare un
com.adobe.idp.Document
mediante il costruttore e passando iljava.io.FileInputStream
oggetto.
- Creare un
-
Applica una policy esistente al documento PDF.
-
Creare un
DocumentManager
oggetto richiamando ilRightsManagementClient
dell'oggettogetDocumentManager
metodo. -
Applicare una policy al documento PDF richiamando
DocumentManager
dell'oggettoprotectDocument
e fornendo i seguenti valori:- Il
com.adobe.idp.Document
oggetto che contiene il documento PDF a cui viene applicato il criterio. - Valore stringa che specifica il nome del documento.
- Valore stringa che specifica il nome del set di criteri a cui appartiene il criterio. È possibile specificare un
null
valore che risulta inMyPolicies
set di criteri in uso. - Valore stringa che specifica il nome del criterio.
- Valore string che rappresenta il nome del dominio del gestore utenti dell'utente che è l'autore del documento. Il valore di questo parametro è facoltativo e può essere null (se il parametro è null, il valore del parametro successivo deve essere null).
- Valore stringa che rappresenta il nome canonico dell'utente responsabile dell'utente che è l'autore del documento. Il valore di questo parametro è facoltativo e può essere
null
(se questo parametro è null, il valore del parametro precedente deve esserenull
). - A
com.adobe.livecycle.rightsmanagement.Locale
che rappresenta la lingua utilizzata per selezionare il modello di MS Office. Questo valore di parametro è facoltativo e non viene utilizzato per i documenti PDF. Per proteggere un documento PDF, specificanull
.
Il
protectDocument
il metodo restituisce unRMSecureDocumentResult
oggetto contenente il documento PDF protetto tramite policy. - Il
-
-
Salvare il documento PDF.
- Richiama
RMSecureDocumentResult
dell'oggettogetProtectedDoc
metodo per ottenere il documento PDF protetto tramite policy. Questo metodo restituisce uncom.adobe.idp.Document
oggetto. - Creare un
java.io.File
e accertati che l’estensione del file sia PDF. - Richiama
com.adobe.idp.Document
dell'oggettocopyToFile
metodo per copiare il contenuto delDocument
al file (assicurati di utilizzare ilDocument
oggetto restituito dagetProtectedDoc
metodo).
- Richiama
Esempi di codice
Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:
- "Guida rapida (modalità EJB): applicazione di una policy a un documento PDF tramite l’API Java"
- "Guida rapida (modalità SOAP): applicazione di una policy a un documento PDF tramite l’API Java"
Consulta anche
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Applicare una policy a un documento PDF utilizzando l’API del servizio web apply-a-policy-to-a-pdf-document-using-the-web-service-api
Applicare una policy a un documento PDF utilizzando Document Security API (servizio web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms. -
Crea un oggetto API client di Document Security.
-
Creare un
RightsManagementServiceClient
utilizzando il costruttore predefinito. -
Creare un
RightsManagementServiceClient.Endpoint.Address
oggetto utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il file WSDL al servizio Forms (ad esempio,http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Non è necessario utilizzare illc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Creare un
System.ServiceModel.BasicHttpBinding
dell'oggetto ottenendo il valore delRightsManagementServiceClient.Endpoint.Binding
campo. Invia il valore restituito aBasicHttpBinding
. -
Imposta il
System.ServiceModel.BasicHttpBinding
dell'oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegna al campo il nome utente dei moduli AEM
RightsManagementServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore password corrispondente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Assegna al campo il nome utente dei moduli AEM
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recuperare un documento PDF.
- Creare un
BLOB
mediante il costruttore. IlBLOB
L'oggetto viene utilizzato per memorizzare un documento PDF a cui viene applicato un criterio. - Creare un
System.IO.FileStream
dell'oggetto richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF e la modalità di apertura del file. - Creare una matrice di byte che memorizza il contenuto della
System.IO.FileStream
oggetto. Determinare la dimensione dell'array di byte ottenendoSystem.IO.FileStream
dell'oggettoLength
proprietà. - Compilare la matrice di byte con i dati di flusso richiamando
System.IO.FileStream
dell'oggettoRead
metodo. Passare la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare il
BLOB
oggetto assegnando il relativoMTOM
con il contenuto della matrice di byte.
- Creare un
-
Applica una policy esistente al documento PDF.
Applicare una policy al documento PDF richiamando
RightsManagementServiceClient
dell'oggettoprotectDocument
e fornendo i seguenti valori:- Il
BLOB
oggetto che contiene il documento PDF a cui viene applicato il criterio. - Valore stringa che specifica il nome del documento.
- Valore stringa che specifica il nome del set di criteri a cui appartiene il criterio. È possibile specificare un
null
valore che risulta inMyPolicies
set di criteri in uso. - Valore stringa che specifica il nome del criterio.
- Valore string che rappresenta il nome del dominio del gestore utenti dell'utente che è l'autore del documento. Il valore di questo parametro è facoltativo e può essere null (se il parametro è null, il valore del parametro successivo deve essere
null
). - Valore stringa che rappresenta il nome canonico dell'utente responsabile dell'utente che è l'autore del documento. Il valore di questo parametro è facoltativo e può essere null (se il parametro è null, il valore del parametro precedente deve essere
null
). - A
RMLocale
valore che specifica il valore locale (ad esempio,RMLocale.en
). - Parametro di output stringa utilizzato per memorizzare il valore dell'identificatore dei criteri.
- Parametro di output stringa utilizzato per memorizzare il valore dell'identificatore protetto tramite policy.
- Un parametro di output stringa utilizzato per memorizzare il tipo mime (ad esempio,
application/pdf
).
Il
protectDocument
il metodo restituisce unBLOB
oggetto contenente il documento PDF protetto tramite policy. - Il
-
Salvare il documento PDF.
- Creare un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF protetto tramite policy. - Creare una matrice di byte che memorizza il contenuto dei dati
BLOB
oggetto restituito daprotectDocument
metodo. Popolare la matrice di byte ottenendo il valore dellaBLOB
dell'oggettoMTOM
membro dati. - Creare un
System.IO.BinaryWriter
oggetto richiamando il relativo costruttore e passando ilSystem.IO.FileStream
oggetto. - Scrivere il contenuto della matrice di byte in un file PDF richiamando
System.IO.BinaryWriter
dell'oggettoWrite
e passando la matrice di byte.
- Creare un
Esempi di codice
Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:
- "Guida rapida (MTOM): applicazione di una policy a un documento PDF tramite l’API del servizio web"
- "Guida rapida (SwaRef): applicazione di una policy a un documento PDF tramite l’API del servizio web"
Rimozione di criteri dai documenti di PDF removing-policies-from-pdf-documents
È possibile rimuovere una policy da un documento protetto tramite policy per rimuovere la protezione dal documento. In altre parole, se non desideri più che il documento sia protetto da una policy. Se si desidera aggiornare un documento protetto tramite policy con una policy più recente, invece di rimuovere la policy e aggiungere la policy aggiornata, è più efficiente cambiare la policy.
Riepilogo dei passaggi summary_of_steps-4
Per rimuovere una policy da un documento PDF protetto tramite policy, attenersi alla seguente procedura:
- Includi file di progetto
- Crea un oggetto API client di Document Security.
- Recuperare un documento PDF protetto tramite policy.
- Rimuovi il criterio dal documento PDF.
- Salvare il documento PDF non protetto.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.
Creare un oggetto API client di Document Security
Prima di poter eseguire un’operazione del servizio Document Security a livello di programmazione, crea un oggetto client del servizio Document Security.
Recuperare un documento PDF protetto tramite policy
Per rimuovere una policy, è possibile recuperare un documento PDF protetto tramite policy. Se tenti di rimuovere una policy da un documento PDF non protetto da una policy, viene generata un’eccezione.
Rimuovi il criterio dal documento PDF
È possibile rimuovere una policy da un documento PDF protetto tramite policy a condizione che nelle impostazioni di connessione sia specificato un amministratore. In caso contrario, il criterio utilizzato per proteggere un documento deve contenere SWITCH_POLICY
autorizzazione a rimuovere una policy 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.
Salva il documento PDF non protetto
Dopo che il servizio Document Security ha rimosso una policy da un documento PDF, puoi salvare il documento PDF non protetto come file PDF.
Consulta anche
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Applicazione delle policy ai documenti di PDF
Rimuovere una policy da un documento PDF utilizzando l’API Java remove-a-policy-from-a-pdf-document-using-the-java-api
Rimuovi una policy da un documento PDF protetto tramite policy utilizzando Document Security API (Java):
-
Includi file di progetto.
Includi i file JAR dei client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
-
Crea un oggetto API client di Document Security.
- Creare un
ServiceClientFactory
oggetto che contiene proprietà di connessione. - Creare un
DocumentSecurityClient
mediante il costruttore e passando ilServiceClientFactory
oggetto.
- Creare un
-
Recuperare un documento PDF protetto tramite policy.
- Creare un
java.io.FileInputStream
oggetto che rappresenta il documento PDF protetto tramite policy utilizzando il relativo costruttore e passando un valore stringa che specifica la posizione del documento PDF. - Creare un
com.adobe.idp.Document
mediante il costruttore e passando iljava.io.FileInputStream
oggetto.
- Creare un
-
Rimuovi il criterio dal documento PDF.
- Creare un
DocumentManager
oggetto richiamando ilDocumentSecurityClient
dell'oggettogetDocumentManager
metodo. - Rimuovere una policy dal documento PDF richiamando
DocumentManager
dell'oggettoremoveSecurity
e passando ilcom.adobe.idp.Document
oggetto contenente il documento PDF protetto tramite policy. Questo metodo restituisce uncom.adobe.idp.Document
oggetto contenente un documento PDF non protetto.
- Creare un
-
Salvare il documento PDF non protetto.
- Creare un
java.io.File
e accertati che l’estensione del file sia PDF. - Richiama
Document
dell'oggettocopyToFile
metodo per copiare il contenuto delDocument
al file (assicurati di utilizzare ilDocument
oggetto restituito daremoveSecurity
metodo).
- Creare un
Esempi di codice
Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:
- "Guida rapida (modalità SOAP): rimozione di una policy da un documento PDF tramite l’API Java"
Rimuovere un criterio utilizzando l’API del servizio web remove-a-policy-using-the-web-service-api
Rimuovi una policy da un documento PDF protetto tramite policy utilizzando Document Security API (servizio web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms. -
Crea un oggetto API client di Document Security.
-
Creare un
DocumentSecurityServiceClient
utilizzando il costruttore predefinito. -
Creare un
DocumentSecurityServiceClient.Endpoint.Address
oggetto utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il file WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Non è necessario utilizzare illc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Creare un
System.ServiceModel.BasicHttpBinding
dell'oggetto ottenendo il valore delDocumentSecurityServiceClient.Endpoint.Binding
campo. Invia il valore restituito aBasicHttpBinding
. -
Imposta il
System.ServiceModel.BasicHttpBinding
dell'oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegna al campo il nome utente dei moduli AEM
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore password corrispondente al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Assegna al campo il nome utente dei moduli AEM
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recuperare un documento PDF protetto tramite policy.
- Creare un
BLOB
mediante il costruttore. IlBLOB
L'oggetto viene utilizzato per memorizzare il documento PDF protetto tramite policy da cui viene rimossa la policy. - Creare un
System.IO.FileStream
dell'oggetto richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF e la modalità di apertura del file. - Creare una matrice di byte che memorizza il contenuto della
System.IO.FileStream
oggetto. È possibile determinare le dimensioni della matrice di byte ottenendoSystem.IO.FileStream
dell'oggettoLength
proprietà. - Compilare la matrice di byte con i dati di flusso richiamando
System.IO.FileStream
dell'oggettoRead
e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare il
BLOB
oggetto assegnando il relativoMTOM
con il contenuto della matrice di byte.
- Creare un
-
Rimuovi il criterio dal documento PDF.
Rimuovere la policy dal documento PDF richiamando
DocumentSecurityServiceClient
dell'oggettoremovePolicySecurity
e passando ilBLOB
oggetto contenente il documento PDF protetto tramite policy. Questo metodo restituisce unBLOB
oggetto contenente un documento PDF non protetto. -
Salvare il documento PDF non protetto.
- Creare un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento di PDF non protetto. - Creare una matrice di byte che memorizza il contenuto dei dati
BLOB
oggetto restituito daremovePolicySecurity
metodo. Popolare la matrice di byte ottenendo il valore dellaBLOB
dell'oggettoMTOM
campo. - Creare un
System.IO.BinaryWriter
oggetto richiamando il relativo costruttore e passando ilSystem.IO.FileStream
oggetto.
- Creare un
Esempi di codice
Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:
- "Guida rapida (MTOM): rimozione di una policy da un documento PDF tramite l’API del servizio web"
- "Guida rapida (SwaRef): rimozione di una policy da un documento PDF tramite l’API del servizio web"
Consulta anche
Richiamare AEM Forms tramite MTOM
Richiamare AEM Forms con SwaRef
Revoca dell'accesso ai documenti revoking-access-to-documents
È possibile revocare l’accesso a un documento di PDF protetto tramite policy in modo che tutte le copie del documento siano inaccessibili agli utenti. Quando un utente cerca di aprire un documento PDF revocato, viene reindirizzato a un URL specificato in cui è possibile visualizzare un documento revisionato. L'URL a cui l'utente viene reindirizzato deve essere specificato a livello di programmazione. Quando revochi l’accesso a un documento, la modifica entra in vigore alla successiva sincronizzazione dell’utente con il servizio Document Security, quando il documento protetto tramite policy viene aperto online.
La possibilità di revocare l'accesso a un documento offre una protezione aggiuntiva. Si supponga, ad esempio, che sia disponibile una versione più recente di un documento e che non si desideri più visualizzare la versione obsoleta. In questo caso, è possibile revocare l'accesso al documento precedente e non è possibile visualizzare il documento a meno che non venga ripristinato l'accesso.
Riepilogo dei passaggi summary_of_steps-5
Per revocare un documento protetto tramite policy, effettuare le seguenti operazioni:
- Includi file di progetto.
- Crea un oggetto API client di Document Security.
- Recuperare un documento PDF protetto tramite policy.
- Revoca del documento protetto tramite policy.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.
Creare un oggetto API client di Document Security
Prima di poter eseguire un’operazione del servizio Document Security a livello di programmazione, è necessario creare un oggetto client del servizio Document Security.
Recuperare un documento PDF protetto tramite policy
Recupera un documento PDF protetto tramite policy per revocarlo. Non è possibile revocare un documento già revocato o non protetto tramite policy.
Se si conosce il valore dell'identificatore di licenza del documento protetto tramite policy, non è necessario recuperare il documento PDF protetto tramite policy. Tuttavia, nella maggior parte dei casi è necessario recuperare il documento PDF per ottenere il valore dell'identificatore della licenza.
Revoca del documento protetto tramite policy
Per revocare un documento protetto tramite policy, specifica l’identificatore di licenza del documento protetto tramite policy. È inoltre possibile specificare l'URL di un documento che l'utente può visualizzare quando tenta di aprire il documento revocato. In altre parole, si supponga che un documento non aggiornato venga revocato. Quando un utente cerca di aprire il documento revocato, visualizza un documento aggiornato invece del documento revocato.
Consulta anche
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Applicazione delle policy ai documenti di PDF
Ripristino dell’accesso ai documenti revocati
Revocare l’accesso ai documenti utilizzando l’API Java revoke-access-to-documents-using-the-java-api
Revoca dell’accesso a un documento PDF protetto tramite policy utilizzando Document Security API (Java):
-
Includi file di progetto
Includi i file JAR dei client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
-
Creare un oggetto API client di Document Security
- Creare un
ServiceClientFactory
oggetto che contiene proprietà di connessione. - Creare un
DocumentSecurityClient
mediante il costruttore e passando ilServiceClientFactory
oggetto.
- Creare un
-
Recuperare un documento PDF protetto tramite policy
- Creare un
java.io.FileInputStream
oggetto che rappresenta il documento PDF protetto tramite policy utilizzando il relativo costruttore e passando un valore stringa che specifica la posizione del documento PDF. - Creare un
com.adobe.idp.Document
mediante il costruttore e passando iljava.io.FileInputStream
oggetto.
- Creare un
-
Revoca del documento protetto tramite policy
-
Creare un
DocumentManager
oggetto richiamando ilDocumentSecurityClient
dell'oggettogetDocumentManager
metodo. -
Recuperare il valore dell'identificatore di licenza del documento protetto tramite policy richiamando
DocumentManager
dell'oggettogetLicenseId
metodo. Passa ilcom.adobe.idp.Document
oggetto che rappresenta il documento protetto tramite policy. Questo metodo restituisce un valore stringa che rappresenta il valore dell'identificatore di licenza. -
Creare un
LicenseManager
oggetto richiamando ilDocumentSecurityClient
dell'oggettogetLicenseManager
metodo. -
Revoca del documento protetto tramite policy richiamando
LicenseManager
dell'oggettorevokeLicense
e fornendo i seguenti valori:- Valore stringa che specifica il valore dell'identificatore di licenza del documento protetto tramite policy (specificare il valore restituito del
DocumentManager
dell'oggettogetLicenseId
metodo). - Un membro dati statico del
License
interfaccia che specifica il motivo della revoca del documento. Ad esempio, puoi specificareLicense.DOCUMENT_REVISED
. - A
java.net.URL
valore che specifica la posizione in cui si trova un documento revisionato. Se non desideri reindirizzare un utente a un altro URL, puoi passarenull
.
- Valore stringa che specifica il valore dell'identificatore di licenza del documento protetto tramite policy (specificare il valore restituito del
-
Esempi di codice
Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:
- "Guida rapida (modalità SOAP): revoca di un documento tramite API Java"
Revoca dell’accesso ai documenti tramite l’API del servizio web revoke-access-to-documents-using-the-web-service-api
Revoca dell’accesso a un documento PDF protetto tramite policy utilizzando Document Security API (servizio web):
-
Includi file di progetto
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms. -
Creare un oggetto API client di Document Security
-
Creare un
DocumentSecurityServiceClient
utilizzando il costruttore predefinito. -
Creare un
DocumentSecurityServiceClient.Endpoint.Address
oggetto utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il file WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Non è necessario utilizzare illc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Creare un
System.ServiceModel.BasicHttpBinding
dell'oggetto ottenendo il valore delDocumentSecurityServiceClient.Endpoint.Binding
campo. Invia il valore restituito aBasicHttpBinding
. -
Imposta il
System.ServiceModel.BasicHttpBinding
dell'oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegna al campo il nome utente dei moduli AEM
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore password corrispondente al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Assegna al campo il nome utente dei moduli AEM
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recuperare un documento PDF protetto tramite policy
- Creare un
BLOB
mediante il costruttore. IlBLOB
L'oggetto viene utilizzato per memorizzare un documento PDF protetto tramite policy revocato. - Creare un
System.IO.FileStream
oggetto richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF protetto tramite policy da revocare e la modalità di apertura del file. - Creare una matrice di byte che memorizza il contenuto della
System.IO.FileStream
oggetto. È possibile determinare le dimensioni della matrice di byte ottenendoSystem.IO.FileStream
dell'oggettoLength
proprietà. - Compilare la matrice di byte con i dati di flusso richiamando
System.IO.FileStream
dell'oggettoRead
e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare il
BLOB
oggetto assegnando il relativoMTOM
con il contenuto della matrice di byte.
- Creare un
-
Revoca del documento protetto tramite policy
-
Recuperare il valore dell'identificatore di licenza del documento protetto tramite policy richiamando
DocumentSecurityServiceClient
dell'oggettogetLicenseID
e passando ilBLOB
oggetto che rappresenta il documento protetto tramite policy. Questo metodo restituisce un valore stringa che rappresenta l'identificatore della licenza. -
Revoca del documento protetto tramite policy richiamando
DocumentSecurityServiceClient
dell'oggettorevokeLicense
e fornendo i seguenti valori:- Valore stringa che specifica il valore dell'identificatore di licenza del documento protetto tramite policy (specificare il valore restituito del
DocumentSecurityServiceService
dell'oggettogetLicenseId
metodo). - Un membro dati statico del
Reason
enum che specifica il motivo della revoca del documento. Ad esempio, puoi specificareReason.DOCUMENT_REVISED
. - A
string
valore che specifica la posizione URL in cui si trova un documento revisionato. Se non desideri reindirizzare un utente a un altro URL, puoi passarenull
.
- Valore stringa che specifica il valore dell'identificatore di licenza del documento protetto tramite policy (specificare il valore restituito del
-
Esempi di codice
Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:
- "Guida rapida (MTOM): revoca di un documento tramite l’API del servizio web"
- "Guida rapida (SwaRef): revoca di un documento tramite l’API del servizio web"
Consulta anche
Rimozione di criteri da documenti di Word
Richiamare AEM Forms tramite MTOM
Richiamare AEM Forms con SwaRef
Ripristino dell’accesso ai documenti revocati reinstating-access-to-revoked-documents
È possibile ripristinare l'accesso a un documento di PDF revocato, in modo che tutte le copie del documento revocato siano accessibili agli utenti. Quando un utente apre un documento ripristinato che è stato revocato, può visualizzare il documento.
Riepilogo dei passaggi summary_of_steps-6
Per ripristinare l'accesso a un documento di PDF revocato, effettuare le seguenti operazioni:
- Includi file di progetto.
- Crea un oggetto API client di Document Security.
- Recuperare l'identificatore di licenza del documento PDF revocato.
- Ripristinare l'accesso al documento PDF revocato.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.
Creare un oggetto API client di Document Security
Prima di poter eseguire un’operazione del servizio Document Security a livello di programmazione, è necessario creare un oggetto client del servizio Document Security. Se utilizzi l’API Java, crea un’ DocumentSecurityClient
oggetto. Se utilizzi l’API del servizio web Document Security, crea un’ DocumentSecurityServiceService
oggetto.
Recuperare l'identificatore di licenza del documento di PDF revocato
Recuperare l'identificatore di licenza del documento PDF revocato per ripristinare un documento PDF revocato. Dopo aver ottenuto il valore dell'identificatore di licenza, è possibile ripristinare un documento revocato. Se si tenta di ripristinare un documento non revocato, verrà generata un'eccezione.
Ripristina l'accesso al documento di PDF revocato
Per ripristinare l'accesso a un documento PDF revocato, è necessario specificare l'identificatore della licenza del documento revocato. Se si tenta di ripristinare l'accesso a un documento di PDF non revocato, verrà generata un'eccezione.
Consulta anche
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Applicazione delle policy ai documenti di PDF
Revoca dell'accesso ai documenti
Ripristinare l’accesso ai documenti revocati utilizzando l’API Java reinstate-access-to-revoked-documents-using-the-java-api
Ripristinare l’accesso a un documento revocato utilizzando Document Security API (Java):
-
Includi file di progetto.
Includi i file JAR dei client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
-
Crea un oggetto API client di Document Security.
- Creare un
ServiceClientFactory
oggetto che contiene proprietà di connessione. - Creare un
DocumentSecurityClient
mediante il costruttore e passando ilServiceClientFactory
oggetto.
- Creare un
-
Recuperare l'identificatore di licenza del documento PDF revocato.
- Creare un
java.io.FileInputStream
oggetto che rappresenta il documento PDF revocato tramite il costruttore e passando un valore stringa che specifica la posizione del documento PDF. - Creare un
com.adobe.idp.Document
mediante il costruttore e passando iljava.io.FileInputStream
oggetto. - Creare un
DocumentManager
oggetto richiamando ilDocumentSecurityClient
dell'oggettogetDocumentManager
metodo. - Recuperare il valore dell'identificatore di licenza del documento revocato richiamando
DocumentManager
dell'oggettogetLicenseId
e passando ilcom.adobe.idp.Document
oggetto che rappresenta il documento revocato. Questo metodo restituisce un valore stringa che rappresenta l'identificatore della licenza.
- Creare un
-
Ripristinare l'accesso al documento PDF revocato.
- Creare un
LicenseManager
oggetto richiamando ilDocumentSecurityClient
dell'oggettogetLicenseManager
metodo. - Ripristinare l'accesso al documento PDF revocato richiamando
LicenseManager
dell'oggettounrevokeLicense
e passando il valore dell'identificatore di licenza del documento revocato.
- Creare un
Esempi di codice
Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:
- "Guida rapida (modalità SOAP): ripristino dell’accesso a un documento revocato tramite l’API del servizio web"
Ripristinare l’accesso ai documenti revocati tramite l’API del servizio web reinstate-access-to-revoked-documents-using-the-web-service-api
Ripristinare l’accesso a un documento revocato utilizzando Document Security API (servizio web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms. -
Crea un oggetto API client di Document Security.
-
Creare un
DocumentSecurityServiceClient
utilizzando il costruttore predefinito. -
Creare un
DocumentSecurityServiceClient.Endpoint.Address
oggetto utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il file WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Non è necessario utilizzare illc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Creare un
System.ServiceModel.BasicHttpBinding
dell'oggetto ottenendo il valore delDocumentSecurityServiceClient.Endpoint.Binding
campo. Invia il valore restituito aBasicHttpBinding
. -
Imposta il
System.ServiceModel.BasicHttpBinding
dell'oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegna al campo il nome utente dei moduli AEM
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore password corrispondente al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Assegna al campo il nome utente dei moduli AEM
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recuperare l'identificatore di licenza del documento PDF revocato.
- Creare un
BLOB
mediante il costruttore. IlBLOB
L'oggetto viene utilizzato per memorizzare un documento PDF revocato a cui viene ripristinato l'accesso. - Creare un
System.IO.FileStream
oggetto richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF revocato e la modalità di apertura del file. - Creare una matrice di byte che memorizza il contenuto della
System.IO.FileStream
oggetto. È possibile determinare le dimensioni della matrice di byte ottenendoSystem.IO.FileStream
dell'oggettoLength
proprietà. - Compilare la matrice di byte con i dati di flusso richiamando
System.IO.FileStream
dell'oggettoRead
e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare il
BLOB
oggetto assegnando il relativoMTOM
con il contenuto della matrice di byte.
- Creare un
-
Ripristinare l'accesso al documento PDF revocato.
- Recuperare il valore dell'identificatore di licenza del documento revocato richiamando
DocumentSecurityServiceClient
dell'oggettogetLicenseID
e passando ilBLOB
oggetto che rappresenta il documento revocato. Questo metodo restituisce un valore stringa che rappresenta l'identificatore della licenza. - Ripristinare l'accesso al documento PDF revocato richiamando
DocumentSecurityServiceClient
dell'oggettounrevokeLicense
e passando un valore stringa che specifica il valore dell'identificatore di licenza del documento PDF revocato (passare il valore restituito delDocumentSecurityServiceClient
dell'oggettogetLicenseId
metodo).
- Recuperare il valore dell'identificatore di licenza del documento revocato richiamando
Esempi di codice
Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:
- "Guida rapida (MTOM): ripristino dell’accesso a un documento revocato tramite l’API del servizio web"
- "Guida rapida (SwaRef): ripristino dell’accesso a un documento revocato tramite l’API del servizio web"
Consulta anche
Richiamare AEM Forms tramite MTOM
Richiamare AEM Forms con SwaRef
Verifica dei documenti di PDF protetti tramite policy inspecting-policy-protected-pdf-documents
Puoi usare l’API Document Security Service (Java e servizio web) per esaminare i documenti PDF protetti tramite policy. L’ispezione dei documenti di PDF protetti tramite policy restituisce informazioni sul documento di PDF protetto tramite policy. È possibile, ad esempio, determinare la policy utilizzata per proteggere il documento e la data in cui è stato protetto.
Non è possibile eseguire questa attività se la versione del LiveCycle in uso è 8.x o precedente. In AEM Forms è stato aggiunto il supporto per l’ispezione di documenti protetti tramite policy. Se si tenta di esaminare un documento protetto tramite policy utilizzando LiveCycle 8.x (o versioni precedenti), viene generata un'eccezione.
Riepilogo dei passaggi summary_of_steps-7
Per esaminare un documento PDF protetto tramite policy, effettua le seguenti operazioni:
- Includi file di progetto.
- Crea un oggetto API client di Document Security.
- Recuperare un documento protetto tramite policy da esaminare.
- Ottenere informazioni sul documento protetto tramite policy.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.
Creare un oggetto API client di Document Security
Prima di poter eseguire un’operazione del servizio Document Security a livello di programmazione, crea un oggetto client del servizio Document Security. Se utilizzi l’API Java, crea un’ RightsManagementClient
oggetto. Se utilizzi l’API del servizio web Document Security, crea un’ RightsManagementServiceService
oggetto.
Recuperare un documento protetto tramite policy da esaminare
Per esaminare un documento protetto tramite policy, recuperalo. Se si tenta di ispezionare un documento non protetto con una policy o revocato, viene generata un'eccezione.
Inspect il documento
Dopo aver recuperato un documento protetto tramite policy, è possibile esaminarlo.
Ottenere informazioni sul documento protetto tramite policy
Dopo aver esaminato un documento PDF protetto tramite policy, puoi ottenere informazioni al riguardo. È ad esempio possibile determinare il criterio utilizzato per proteggere il documento.
Se proteggi un documento con una policy che appartiene a I miei criteri e poi richiami 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
restituisce stringhe valide.
Consulta anche
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Documenti di Inspect Policy Protected PDF tramite l’API Java inspect-policy-protected-pdf-documents-using-the-java-api
Inspect è un documento PDF protetto tramite policy utilizzando Document Security Service API (Java):
-
Includi file di progetto.
Includi i file JAR dei client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java. Per informazioni sulla posizione di questi file, vedere Inclusione dei file della libreria Java di AEM Forms.
-
Crea un oggetto API client di Document Security.
- Creare un
ServiceClientFactory
oggetto che contiene proprietà di connessione. (vedere Impostazione delle proprietà di connessione.) - Creare un
RightsManagementClient
mediante il costruttore e passando ilServiceClientFactory
oggetto.
- Creare un
-
Recuperare un documento protetto tramite policy da esaminare.
- Creare un
java.io.FileInputStream
oggetto che rappresenta il documento PDF protetto tramite policy utilizzando il relativo costruttore. Passa un valore stringa che specifica la posizione del documento PDF. - Creare un
com.adobe.idp.Document
mediante il costruttore e passando iljava.io.FileInputStream
oggetto.
- Creare un
-
Inspect il documento.
- Creare un
DocumentManager
oggetto richiamando ilRightsManagementClient
dell'oggettogetDocumentManager
metodo. - Inspect il documento protetto tramite policy richiamando
LicenseManager
dell'oggettoinspectDocument
metodo. Passa ilcom.adobe.idp.Document
oggetto contenente il documento PDF protetto tramite policy. Questo metodo restituisce unRMInspectResult
oggetto contenente informazioni sul documento protetto tramite policy.
- Creare un
-
Ottenere informazioni sul documento protetto tramite policy.
Per ottenere informazioni sul documento protetto tramite policy, richiama il metodo appropriato a cui appartiene
RMInspectResult
oggetto. Ad esempio, per recuperare il nome del criterio, richiamaRMInspectResult
dell'oggettogetPolicyName
metodo.
Esempi di codice
Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:
- "Guida rapida (modalità SOAP): ispezione dei documenti PDF protetti tramite policy tramite l’API Java"
Documenti di Inspect Policy Protected PDF che utilizzano l’API del servizio web inspect-policy-protected-pdf-documents-using-the-web-service-api
Inspect è un documento PDF protetto tramite policy utilizzando l’API Document Security Service (servizio web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms. -
Crea un oggetto API client di Document Security.
-
Creare un
RightsManagementServiceClient
utilizzando il costruttore predefinito. -
Creare un
RightsManagementServiceClient.Endpoint.Address
oggetto utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il file WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Non è necessario utilizzare illc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Creare un
System.ServiceModel.BasicHttpBinding
dell'oggetto ottenendo il valore delRightsManagementServiceClient.Endpoint.Binding
campo. Invia il valore restituito aBasicHttpBinding
. -
Imposta il
System.ServiceModel.BasicHttpBinding
dell'oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegna al campo il nome utente dei moduli AEM
RightsManagementServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore password corrispondente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Assegna al campo il nome utente dei moduli AEM
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recuperare un documento protetto tramite policy da esaminare.
- Creare un
BLOB
mediante il costruttore. IlBLOB
L'oggetto viene utilizzato per memorizzare un documento PDF da verificare. - Creare un
System.IO.FileStream
richiamando il relativo costruttore. Passa un valore stringa che rappresenta la posizione del file del documento PDF e la modalità di apertura del file in. - Creare una matrice di byte che memorizza il contenuto della
System.IO.FileStream
oggetto. È possibile determinare le dimensioni della matrice di byte ottenendoSystem.IO.FileStream
dell'oggettoLength
proprietà. - Compilare la matrice di byte con i dati di flusso richiamando
System.IO.FileStream
dell'oggettoRead
metodo. Passare la matrice di byte, la posizione iniziale e la lunghezza del flusso per la lettura. - Popolare il
BLOB
oggetto assegnando il relativoMTOM
con il contenuto della matrice di byte.
- Creare un
-
Inspect il documento.
Inspect il documento protetto tramite policy richiamando
RightsManagementServiceClient
dell'oggettoinspectDocument
metodo. Passa ilBLOB
oggetto contenente il documento PDF protetto tramite policy. Questo metodo restituisce unRMInspectResult
oggetto contenente informazioni sul documento protetto tramite policy. -
Ottenere informazioni sul documento protetto tramite policy.
Per ottenere informazioni sul documento protetto tramite policy, ottieni il valore del campo appropriato che appartiene al
RMInspectResult
oggetto. Ad esempio, per recuperare il nome del criterio, ottieni il valore delRMInspectResult
dell'oggettopolicyName
campo.
Esempi di codice
Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:
- "Guida rapida (MTOM): controllo dei documenti PDF protetti tramite policy tramite l’API del servizio web"
- "Guida rapida (SwaRef): controllo dei documenti PDF protetti tramite policy tramite l’API del servizio web"
Consulta anche
Richiamare AEM Forms tramite MTOM
Richiamare AEM Forms con SwaRef
Creazione di filigrane creating-watermarks
Le filigrane contribuiscono a garantire la sicurezza di un documento identificandolo in modo univoco e controllando la violazione del copyright. Ad esempio, è possibile creare e inserire una filigrana che indichi Riservato su tutte le pagine di un documento. Dopo aver creato una filigrana, puoi includerla come parte di una policy. In altre parole, è possibile impostare l’attributo della filigrana del criterio con la filigrana appena creata. Dopo aver applicato a un documento una policy contenente una filigrana, questa viene visualizzata nel documento protetto tramite policy.
Riepilogo dei passaggi summary_of_steps-8
Per creare una filigrana, effettuare le seguenti operazioni:
- Includi file di progetto.
- Crea un oggetto API client di Document Security.
- Impostare gli attributi delle filigrane.
- Registra la filigrana presso il servizio Document Security.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.
Creare un oggetto API client di Document Security
Prima di poter eseguire un’operazione del servizio Document Security a livello di programmazione, è necessario creare un oggetto client del servizio Document Security. Se utilizzi l’API Java, crea un’ RightsManagementClient
oggetto. Se utilizzi l’API del servizio web Document Security, crea un’ RightsManagementServiceService
oggetto.
Impostare gli attributi delle filigrane
Per creare una filigrana, è necessario impostare gli attributi della filigrana. L’attributo name deve sempre essere definito. Oltre all'attributo name, è necessario impostare almeno uno dei seguenti attributi:
- Testo personalizzato
- DateIncluded
- UserIdIncluded
- UserNameIncluded
Nella tabella seguente sono elencate le coppie chiave-valore necessarie per la creazione di una filigrana tramite i servizi Web.
WaterBackCmd:IS_USERNAME_ENABLED
WaterBackCmd:IS_USERID_ENABLED
WaterBackCmd:IS_CURRENTDATE_ENABLED
WaterBackCmd:IS_CUSTOMTEXT_ENABLED
WaterBackCmd:SRCTEXT
.WaterBackCmd:OPACITY
WaterBackCmd:ROTATION
WaterBackCmd:SCALE
WaterBackCmd:IS_SIZE_ENABLED
deve essere presente e il valore deve essere true. Se questo attributo non è specificato, il comportamento predefinito è Adatta alla pagina.WaterBackCmd:HORIZ_ALIGN
WaterBackCmd:VERT_ALIGN
WaterBackCmd:IS_USE_BACKGROUND
WaterBackCmd:IS_SIZE_ENABLED
WaterBackCmd:SRCTEXT
WaterBackCmd:IS_CUSTOMTEXT_ENABLED
deve essere presente e impostato su true.Per tutte le filigrane deve essere definito uno dei seguenti attributi:
WaterBackCmd:IS_USERNAME_ENABLED
WaterBackCmd:IS_USERID_ENABLED
WaterBackCmd:IS_CURRENTDATE_ENABLED
WaterBackCmd:IS_CUSTOMTEXT_ENABLED
Tutti gli altri attributi sono facoltativi.
Registrare la filigrana
Prima di poter essere utilizzata, una nuova filigrana deve essere registrata presso il servizio Document Security. Dopo aver registrato una filigrana, puoi utilizzarla all’interno dei criteri.
Consulta anche
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Applicazione delle policy ai documenti di PDF
Creare filigrane utilizzando l’API Java create-watermarks-using-the-java-api
Crea una filigrana utilizzando Document Security API (Java):
-
Includi file di progetto.
Includi file JAR client, ad esempio
adobe-rightsmanagement-client.jar
, nel percorso della classe del progetto Java. -
Crea un oggetto API client di Document Security.
- Creare un
ServiceClientFactory
oggetto che contiene proprietà di connessione. - Creare un
RightsManagementClient
mediante il costruttore e passando ilServiceClientFactory
oggetto.
- Creare un
-
Imposta attributi filigrana
- Creare un
Watermark
oggetto richiamando ilInfomodelObjectFactory
statico dell'oggettocreateWatermark
metodo. Questo metodo restituisce unWatermark
oggetto. - Impostare l'attributo del nome della filigrana richiamando
Watermark
dell'oggettosetName
e passando un valore stringa che specifica il nome del criterio. - Impostare l'attributo di sfondo della filigrana richiamando
Watermark
dell'oggettosetBackground
metodo e passaggiotrue
. Impostando questo attributo, la filigrana viene visualizzata sullo sfondo del documento. - Impostare l'attributo di testo personalizzato della filigrana richiamando
Watermark
dell'oggettosetCustomText
e passando un valore stringa che rappresenta il testo della filigrana. - Impostare l'attributo di opacità della filigrana richiamando
Watermark
dell'oggettosetOpacity
e viene passato un valore intero che specifica il livello di opacità. Il valore 100 indica che la filigrana è completamente opaca e il valore 0 indica che è completamente trasparente.
- Creare un
-
Registrare la filigrana.
- Creare un
WatermarkManager
oggetto richiamando ilRightsManagementClient
dell'oggettogetWatermarkManager
metodo. Questo metodo restituisce unWatermarkManager
oggetto. - Registrare la filigrana richiamando
WatermarkManager
dell'oggettoregisterWatermark
e passando ilWatermark
oggetto che rappresenta la filigrana da registrare. Questo metodo restituisce un valore stringa che rappresenta il valore di identificazione della filigrana.
- Creare un
Esempi di codice
Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:
- "Guida rapida (modalità SOAP): creazione di una filigrana tramite l’API Java"
Creare filigrane utilizzando l’API del servizio web create-watermarks-using-the-web-service-api
Crea una filigrana utilizzando Document Security API (servizio web):
-
Crea un oggetto API client di Document Security.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms. -
Crea un oggetto API client di Document Security.
-
Creare un
RightsManagementServiceClient
utilizzando il costruttore predefinito. -
Creare un
RightsManagementServiceClient.Endpoint.Address
oggetto utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il file WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Non è necessario utilizzare illc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Creare un
System.ServiceModel.BasicHttpBinding
dell'oggetto ottenendo il valore delRightsManagementServiceClient.Endpoint.Binding
campo. Invia il valore restituito aBasicHttpBinding
. -
Imposta il
System.ServiceModel.BasicHttpBinding
dell'oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegna al campo il nome utente dei moduli AEM
RightsManagementServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore password corrispondente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Assegna al campo il nome utente dei moduli AEM
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Impostare gli attributi della filigrana.
- Creare un
WatermarkSpec
oggetto richiamando ilWatermarkSpec
costruttore. - Impostare il nome della filigrana assegnando un valore stringa al
WatermarkSpec
dell'oggettoname
membro dati. - Impostare la filigrana
id
mediante l'assegnazione di un valore stringa alWatermarkSpec
dell'oggettoid
membro dati. - Per ogni proprietà filigrana da impostare, crea un
MyMapOf_xsd_string_To_xsd_anyType_Item
oggetto. - Imposta il valore chiave assegnando un valore alla
MyMapOf_xsd_string_To_xsd_anyType_Item
dell'oggettokey
membro dati (ad esempio,WaterBackCmd:OPACITY)
. - Imposta il valore assegnando un valore a
MyMapOf_xsd_string_To_xsd_anyType_Item
dell'oggettovalue
membro dati (ad esempio,.25
). - Creare un
MyArrayOf_xsd_anyType
oggetto. Per ogniMyMapOf_xsd_string_To_xsd_anyType_Item
oggetto, richiamareMyArrayOf_xsd_anyType
dell'oggettoAdd
metodo. Passa ilMyMapOf_xsd_string_To_xsd_anyType_Item
oggetto. - Assegna la
MyArrayOf_xsd_anyType
oggetto alWatermarkSpec
dell'oggettovalues
membro dati.
- Creare un
-
Registrare la filigrana.
Registrare la filigrana richiamando
RightsManagementServiceClient
dell'oggettoregisterWatermark
e passando ilWatermarkSpec
oggetto che rappresenta la filigrana da registrare.
Esempi di codice
Per esempi di codice con il servizio Document Security, consulta la sezione Quick Starts (Avvio rapido) seguente:
- "Guida rapida (MTOM): creazione di una filigrana tramite l’API del servizio web"
- "Guida rapida (SwaRef): creazione di una filigrana tramite l’API del servizio web"
Consulta anche
Richiamare AEM Forms tramite MTOM
Richiamare AEM Forms con SwaRef
Modifica delle filigrane modifying-watermarks
Puoi modificare una filigrana esistente utilizzando l’API Java di Document Security o l’API di servizio web. Per modificare una filigrana esistente, recuperarla, modificarne gli attributi e quindi aggiornarla sul server. Si supponga, ad esempio, di recuperare una filigrana e di modificarne l'attributo di opacità. Prima di applicare la modifica, è necessario aggiornare la filigrana.
Quando si modifica una filigrana, la modifica ha effetto sui documenti futuri a cui è applicata la filigrana. In altre parole, i documenti PDF esistenti che contengono la filigrana non vengono interessati.
Riepilogo dei passaggi summary_of_steps-9
Per modificare una filigrana, effettuare le seguenti operazioni:
- Includi file di progetto.
- Crea un oggetto API client di Document Security.
- Recuperate la filigrana da modificare.
- Impostare gli attributi delle filigrane.
- Aggiorna la filigrana.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.
Creare un oggetto API client di Document Security
Prima di poter eseguire un’operazione del servizio Document Security a livello di programmazione, è necessario creare un oggetto client del servizio Document Security. Se utilizzi l’API Java, crea un’ DocumentSecurityClient
oggetto. Se utilizzi l’API del servizio web Document Security, crea un’ DocumentSecurityServiceService
oggetto.
Recupera la filigrana da modificare
Per modificare una filigrana, è necessario recuperarne una esistente. È possibile recuperare una filigrana specificandone il nome o specificandone il valore di identificatore.
Impostare gli attributi delle filigrane
Per modificare una filigrana esistente, modificare il valore di uno o più attributi della filigrana. Quando si aggiorna una filigrana a livello di programmazione utilizzando un servizio Web, è necessario impostare tutti gli attributi impostati in origine, anche se il valore non cambia. Ad esempio, si supponga di impostare i seguenti attributi di filigrana: WaterBackCmd:IS_USERID_ENABLED
, WaterBackCmd:IS_CUSTOMTEXT_ENABLED
, WaterBackCmd:OPACITY
, e WaterBackCmd:SRCTEXT
. Anche se l’unico attributo che desideri modificare è WaterBackCmd:OPACITY
, è necessario impostare correttamente gli altri valori.
Aggiorna filigrana
Dopo aver modificato gli attributi di una filigrana, è necessario aggiornarla.
Consulta anche
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Modificare le filigrane utilizzando l’API Java modify-watermarks-using-the-java-api
Modifica una filigrana utilizzando Document Security API (Java):
-
Includi file di progetto.
Includi i file JAR dei client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
-
Crea un oggetto API client di Document Security.
- Creare un
ServiceClientFactory
oggetto che contiene proprietà di connessione. - Creare un
DocumentSecurityClient
mediante il costruttore e passando ilServiceClientFactory
oggetto.
- Creare un
-
Recuperate la filigrana da modificare.
Creare un
WatermarkManager
oggetto richiamando ilDocumentSecurityClient
dell'oggettogetWatermarkManager
e passa un valore stringa che specifica il nome della filigrana. Questo metodo restituisce unWatermark
oggetto che rappresenta la filigrana da modificare. -
Impostare gli attributi della filigrana.
Impostare l'attributo di opacità della filigrana richiamando
Watermark
dell'oggettosetOpacity
e viene passato un valore intero che specifica il livello di opacità. Il valore 100 indica che la filigrana è completamente opaca e il valore 0 indica che è completamente trasparente.note note NOTE In questo esempio viene modificato solo l'attributo di opacità. -
Aggiorna la filigrana.
- Aggiornare la filigrana richiamando
WatermarkManager
dell'oggettoupdateWatermark
e trasmettere ilWatermark
oggetto il cui attributo è stato modificato.
- Aggiornare la filigrana richiamando
Esempi di codice
Per esempi di codice con il servizio Document Security, consulta la sezione Guida rapida (modalità SOAP): modifica di una filigrana tramite API Java.
Modificare le filigrane utilizzando l’API del servizio web modify-watermarks-using-the-web-service-api
Modifica una filigrana utilizzando Document Security API (servizio web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms. -
Crea un oggetto API client di Document Security.
-
Creare un
DocumentSecurityServiceClient
utilizzando il costruttore predefinito. -
Creare un
RightsManagementServiceClient.Endpoint.Address
oggetto utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il file WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/DocumentSecurityService?WSDL
.) Non è necessario utilizzare illc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Creare un
System.ServiceModel.BasicHttpBinding
dell'oggetto ottenendo il valore delDocumentSecurityServiceClient.Endpoint.Binding
campo. Invia il valore restituito aBasicHttpBinding
. -
Imposta il
System.ServiceModel.BasicHttpBinding
dell'oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegna al campo il nome utente dei moduli AEM
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore password corrispondente al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Assegna al campo il nome utente dei moduli AEM
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recuperate la filigrana da modificare.
Recuperare la filigrana da modificare richiamando
DocumentSecurityServiceClient
dell'oggettogetWatermarkByName
metodo. Passa un valore stringa che specifica il nome della filigrana. Questo metodo restituisce unWatermarkSpec
oggetto che rappresenta la filigrana da modificare. -
Impostare gli attributi della filigrana.
- Per ogni proprietà filigrana da aggiornare, crea un
MyMapOf_xsd_string_To_xsd_anyType_Item
oggetto. - Imposta il valore chiave assegnando un valore alla
MyMapOf_xsd_string_To_xsd_anyType_Item
dell'oggettokey
membro dati (ad esempio,WaterBackCmd:OPACITY)
. - Imposta il valore assegnando un valore a
MyMapOf_xsd_string_To_xsd_anyType_Item
dell'oggettovalue
membro dati (ad esempio,.50
). - Creare un
MyArrayOf_xsd_anyType
oggetto. Per ogniMyMapOf_xsd_string_To_xsd_anyType_Item
oggetto, richiamareMyArrayOf_xsd_anyType
dell'oggettoAdd
metodo. Passa ilMyMapOf_xsd_string_To_xsd_anyType_Item
oggetto. - Assegna la
MyArrayOf_xsd_anyType
oggetto alWatermarkSpec
dell'oggettovalues
membro dati.
- Per ogni proprietà filigrana da aggiornare, crea un
-
Aggiorna la filigrana.
Aggiornare la filigrana richiamando
DocumentSecurityServiceClient
dell'oggettoupdateWatermark
e passando ilWatermarkSpec
oggetto che rappresenta la filigrana da modificare.
Esempi di codice
Per esempi di codice con il servizio Document Security, consulta la Guida introduttiva seguente:
- "Guida rapida (MTOM): modifica di una filigrana tramite l’API del servizio web"
Ricerca di eventi searching-for-events
Il servizio di Rights Management tiene traccia di azioni specifiche nel momento in cui si verificano, ad esempio l’applicazione di una policy a un documento, l’apertura di un documento protetto tramite policy e la revoca dell’accesso ai documenti. Il controllo degli eventi deve essere abilitato per il servizio di Rights Management oppure non è possibile tenere traccia degli eventi.
Gli eventi rientrano in una delle seguenti categorie:
- Gli eventi di amministratore sono azioni correlate a un amministratore, ad esempio la creazione di un account amministratore.
- Gli eventi documento sono azioni correlate a un documento, ad esempio la chiusura di un documento protetto tramite policy.
- Gli eventi dei criteri sono azioni correlate a un criterio, ad esempio la creazione di un criterio.
- Gli eventi di servizio sono azioni correlate al servizio di Rights Management, ad esempio la sincronizzazione con la directory utente.
Puoi cercare eventi specifici utilizzando l’API Java di Rights Management o l’API di servizio web. La ricerca di eventi consente di eseguire attività quali la creazione di un file di registro di determinati eventi.
Riepilogo dei passaggi summary_of_steps-10
Per cercare un evento di Rights Management, effettuare le seguenti operazioni:
- Includi file di progetto.
- Crea un oggetto API client di Rights Management.
- Specifica l’evento per il quale eseguire la ricerca.
- Cerca l’evento.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.
Creazione di un oggetto API client di Rights Management
Prima di poter eseguire un'operazione del servizio di Rights Management a livello di programmazione, è necessario creare un oggetto client del servizio di Rights Management. Se utilizzi l’API Java, crea un’ DocumentSecurityClient
oggetto. Se utilizzi l’API del servizio Web Rights Management, crea un’ DocumentSecurityServiceService
oggetto.
Specificare gli eventi da cercare
Specifica l’evento da cercare. Ad esempio, è possibile cercare l’evento di creazione del criterio, che si verifica quando viene creato un nuovo criterio.
Cerca 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 della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Cercare gli eventi utilizzando l’API Java search-for-events-using-the-java-api
Cerca gli eventi utilizzando l’API di Rights Management (Java):
-
Includi file di progetto
Includi i file JAR dei client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
-
Creazione di un oggetto API client di Rights Management
Creare un
DocumentSecurityClient
oggetto utilizzando il relativo costruttore e passando unServiceClientFactory
oggetto che contiene proprietà di connessione. -
Specificare gli eventi da cercare
- Creare un
EventManager
oggetto richiamando ilDocumentSecurityClient
dell'oggettogetEventManager
metodo. Questo metodo restituisce unEventManager
oggetto. - Creare un
EventSearchFilter
richiamando il relativo costruttore. - Specifica l’evento per il quale eseguire la ricerca richiamando
EventSearchFilter
dell'oggettosetEventCode
e il passaggio di un membro dati statico che appartiene alEventManager
classe che rappresenta l’evento per il quale eseguire la ricerca. Ad esempio, per cercare l’evento di creazione del criterio, passaEventManager.POLICY_CREATE_EVENT
.
note note NOTE È possibile definire criteri di ricerca aggiuntivi richiamando EventSearchFilter
metodi a oggetti. Ad esempio, richiama ilsetUserName
per specificare un utente associato all'evento. - Creare un
-
Cerca l’evento
Cercare l'evento richiamando
EventManager
dell'oggettosearchForEvents
e passando ilEventSearchFilter
oggetto che definisce i criteri di ricerca dell'evento. Questo metodo restituisce un array diEvent
oggetti.
Esempi di codice
Per esempi di codice relativi all'utilizzo del servizio di Rights Management, vedere la Guida introduttiva seguente:
- "Quick Start (SOAP): ricerca di eventi tramite l’API Java"
Cercare gli eventi utilizzando l’API del servizio web search-for-events-using-the-web-service-api
Cerca gli eventi utilizzando l’API di Rights Management (servizio web):
-
Includi file di progetto
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms. -
Creazione di un oggetto API client di Rights Management
-
Creare un
DocumentSecurityServiceClient
utilizzando il costruttore predefinito. -
Creare un
DocumentSecurityServiceClient.Endpoint.Address
oggetto utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il file WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Non è necessario utilizzare illc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Creare un
System.ServiceModel.BasicHttpBinding
dell'oggetto ottenendo il valore delDocumentSecurityServiceClient.Endpoint.Binding
campo. Invia il valore restituito aBasicHttpBinding
. -
Imposta il
System.ServiceModel.BasicHttpBinding
dell'oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegna al campo il nome utente dei moduli AEM
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore password corrispondente al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Assegna al campo il nome utente dei moduli AEM
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Specificare gli eventi da cercare
- Creare un
EventSpec
mediante il costruttore. - Specificare l'inizio del periodo di tempo durante il quale si è verificato l'evento impostando
EventSpec
dell'oggettofirstTime.date
membro dati conDataTime
istanza che rappresenta l’inizio dell’intervallo di date in cui si è verificato l’evento. - Assegna il valore
true
alEventSpec
dell'oggettofirstTime.dateSpecified
membro dati. - Specificare la fine del periodo di tempo durante il quale si è verificato l'evento impostando
EventSpec
dell'oggettolastTime.date
membro dati conDataTime
istanza che rappresenta la fine dell’intervallo di date in cui si è verificato l’evento. - Assegna il valore
true
alEventSpec
dell'oggettolastTime.dateSpecified
membro dati. - Imposta l’evento da cercare assegnando un valore stringa alla
EventSpec
dell'oggettoeventCode
membro dati. Nella tabella seguente sono elencati i valori numerici che è possibile assegnare a questa proprietà:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 18-row-2 19-row-2 20-row-2 21-row-2 22-row-2 23-row-2 24-row-2 25-row-2 26-row-2 27-row-2 28-row-2 29-row-2 30-row-2 31-row-2 32-row-2 33-row-2 34-row-2 35-row-2 36-row-2 37-row-2 38-row-2 39-row-2 40-row-2 41-row-2 42-row-2 43-row-2 44-row-2 45-row-2 46-row-2 47-row-2 Tipo di evento Valore ALL_EVENTS
999 USER_CHANGE_PASSWORD_EVENT
1000 USER_REGISTER_EVENT
1001 USER_PREREGISTER_EVENT
1002 USER_ACTIVATE_EVENT
1003 USER_DEACTIVATE_EVENT
1004 USER_AUTHENTICATE_EVENT
1005 USER_AUTHENTICATE_DENY_EVENT
1006 USER_ACCOUNT_LOCK_EVENT
1007 USER_DELETE_EVENT
1008 USER_UPDATE_PROFILE_EVENT
1009 DOCUMENT_VIEW_EVENT
2000 DOCUMENT_PRINT_LOW_EVENT
2001 DOCUMENT_PRINT_HIGH_EVENT
2002 DOCUMENT_SIGN_EVENT
2003 DOCUMENT_ADD_ANNOTATION_EVENT
2004 DOCUMENT_FORM_FILL_EVENT
2005 DOCUMENT_CLOSE_EVENT
2006 DOCUMENT_MODIFY_EVENT
2007 DOCUMENT_CHANGE_SECURITY_HANDLER_EVENT
2008 DOCUMENT_SWITCH_POLICY_EVENT
2009 DOCUMENT_REVOKE_EVENT
2010 $1
2011 DOCUMENT_SECURE_EVENT
2012 DOCUMENT_UNKNOWN_CLIENT_EVENT
2013 DOCUMENT_CHANGE_REVOKE_URL_EVENT
2014 POLICY_CHANGE_EVENT
3000 POLICY_ENABLE_EVENT
3001 POLICY_DISABLE_EVENT
3002 POLICY_CREATE_EVENT
3003 POLICY_DELETE_EVENT
3004 POLICY_CHANGE_OWNER_EVENT
3005 SERVER_CLIENT_SYNC_EVENT
4000 SERVER_SYNC_DIR_INFO_EVENT
4001 SERVER_SYNC_DIR_COMPLETE_EVENT
4002 SERVER_VERSION_MISMATCH_EVENT
4003 SERVER_CONFIG_CHANGE_EVENT
4004 SERVER_ENABLE_OFFLINE_ACCESS_EVENT
4005 ADMIN_ADD_EVENT
5000 ADMIN_DELETE_EVENT
5001 ADMIN_EDIT_EVENT
5002 ADMIN_ACTIVATE_EVENT
5003 ADMIN_DEACTIVATE_EVENT
5004 ERROR_DIRECTORY_SERVICE_EVENT
6000 CREATED_POLICYSET_EVENT
7000 DELETED_POLICYSET_EVENT
7001 MODIFIED_POLICYSET_EVENT
7002 - Creare un
-
Cerca l’evento
Cercare l'evento richiamando
DocumentSecurityServiceClient
dell'oggettosearchForEvents
e passando ilEventSpec
oggetto che rappresenta l’evento per il quale eseguire la ricerca e il numero massimo di risultati. Questo metodo restituisce unMyArrayOf_xsd_anyType
raccolta in cui ogni elemento è unAuditSpec
dell'istanza. Utilizzo di unAuditSpec
dell'evento, ad esempio l'ora in cui si è verificato. IlAuditSpec
l’istanza contiene untimestamp
membro dati che specifica queste informazioni.
Esempi di codice
Per esempi di codice relativi all'utilizzo del servizio di Rights Management, vedere la Guida introduttiva seguente:
- "Guida rapida (MTOM): ricerca di eventi tramite l’API del servizio web"
- "Quick Start (SwaRef): ricerca di eventi tramite l’API del servizio web"
Consulta anche
Richiamare AEM Forms tramite MTOM
Richiamare AEM Forms con SwaRef
Applicazione di criteri ai documenti di Word applying-policies-to-word-documents
Oltre ai documenti PDF, il servizio Rights Management supporta formati di documento aggiuntivi, ad esempio un documento di Microsoft Word (file DOC) e altri formati di file di Microsoft Office. È ad esempio possibile applicare una policy a un documento di Word per proteggerlo. Applicando una policy a un documento di Word, si limita l'accesso al documento. Non è possibile applicare una policy a un documento se il documento è già protetto con una policy.
È possibile monitorare l'utilizzo di un documento Word protetto tramite policy dopo averlo distribuito. In altre parole, è possibile vedere come viene utilizzato il documento e chi lo sta utilizzando. Ad esempio, è possibile scoprire quando qualcuno ha aperto il documento.
Riepilogo dei passaggi summary_of_steps-11
Per applicare una policy a un documento di Word, effettuare le seguenti operazioni:
- Includi file di progetto.
- Crea un oggetto API client di Document Security.
- Recuperare un documento di Word a cui è applicato un criterio.
- Applicare una policy esistente al documento di Word.
- Salvare il documento Word protetto tramite policy.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.
Creare un oggetto API client di Document Security
Prima di poter eseguire un’operazione del servizio Document Security a livello di programmazione, è necessario creare un oggetto client del servizio Document Security.
Recuperare un documento di Word
Recuperare un documento di Word per applicare una policy. Dopo aver applicato una policy al documento di Word, gli utenti saranno soggetti a restrizioni quando utilizzano il documento. Se, ad esempio, la policy non consente l'apertura del documento in modalità non in linea, gli utenti devono essere in linea per aprire il documento.
Applicare una policy esistente al documento di Word
Per applicare un criterio a un documento di Word, è necessario fare riferimento a un criterio esistente e specificare il set di criteri a cui appartiene il criterio. L'utente che sta impostando le proprietà di connessione deve avere accesso al criterio specificato. In caso contrario, si verificherà un'eccezione.
Salvare il documento di Word
Dopo che il servizio Document Security ha applicato una policy a un documento di Word, è possibile salvarlo come file DOC.
Consulta anche
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Revoca dell'accesso ai documenti
Applicare una policy a un documento Word utilizzando l’API Java apply-a-policy-to-a-word-document-using-the-java-api
Applicare una policy a un documento di Word utilizzando l’API Document Security (Java):
-
Includi file di progetto.
Includi i file JAR dei client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
-
Crea un oggetto API client di Document Security.
- Creare un
ServiceClientFactory
oggetto che contiene proprietà di connessione. - Creare un
DocumentSecurityClient
mediante il costruttore e passando ilServiceClientFactory
oggetto.
- Creare un
-
Recuperare un documento di Word.
- Creare un
java.io.FileInputStream
oggetto che rappresenta il documento di Word utilizzando il relativo costruttore e passando un valore stringa che specifica la posizione del documento di Word. - Creare un
com.adobe.idp.Document
mediante il costruttore e passando iljava.io.FileInputStream
oggetto.
- Creare un
-
Applicare una policy esistente al documento di Word.
-
Creare un
DocumentManager
oggetto richiamando ilDocumentSecurityClient
dell'oggettogetDocumentManager
metodo. -
Applicare una policy al documento di Word richiamando
DocumentManager
dell'oggettoprotectDocument
e fornendo i seguenti valori:- Il
com.adobe.idp.Document
oggetto che contiene il documento di Word a cui viene applicato il criterio. - Valore stringa che specifica il nome del documento.
- Valore stringa che specifica il nome del set di criteri a cui appartiene il criterio. È possibile specificare un
null
valore che risulta inMyPolicies
set di criteri in uso. - Valore stringa che specifica il nome del criterio.
- Valore string che rappresenta il nome del dominio del gestore utenti dell'utente che è l'autore del documento. Il valore di questo parametro è facoltativo e può essere null (se il parametro è null, il valore del parametro successivo deve essere null).
- Valore stringa che rappresenta il nome canonico dell'utente responsabile dell'utente che è l'autore del documento. Il valore di questo parametro è facoltativo e può essere
null
(se questo parametro ènull
, il valore del parametro precedente deve esserenull
). - A
com.adobe.livecycle.rightsmanagement.Locale
che rappresenta la lingua utilizzata per selezionare il modello di MS Office. Il valore di questo parametro è facoltativo ed è possibile specificarenull
.
Il
protectDocument
il metodo restituisce unRMSecureDocumentResult
oggetto che contiene il documento Word protetto tramite policy. - Il
-
-
Salvare il documento di Word.
- Richiama
RMSecureDocumentResult
dell'oggettogetProtectedDoc
per ottenere il documento Word protetto tramite policy. Questo metodo restituisce uncom.adobe.idp.Document
oggetto. - Creare un
java.io.File
e assicurarsi che l'estensione del file sia DOC. - Richiama
com.adobe.idp.Document
dell'oggettocopyToFile
metodo per copiare il contenuto delDocument
al file (assicurati di utilizzare ilDocument
oggetto restituito dagetProtectedDoc
metodo).
- Richiama
Esempi di codice
Per esempi di codice con il servizio Document Security, consulta la Guida introduttiva seguente:
- "Guida rapida (modalità SOAP): applicazione di una policy a un documento Word tramite l’API Java"
Applicare una policy a un documento Word utilizzando l’API del servizio web apply-a-policy-to-a-word-document-using-the-web-service-api
Applicare una policy a un documento di Word utilizzando Document Security API (servizio web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/DocumentSecurityService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms. -
Crea un oggetto API client di Document Security.
-
Creare un
DocumentSecurityServiceClient
utilizzando il costruttore predefinito. -
Creare un
DocumentSecurityServiceClient.Endpoint.Address
oggetto utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il file WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/DocumentSecurityService?WSDL
.) Non è necessario utilizzare illc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Creare un
System.ServiceModel.BasicHttpBinding
dell'oggetto ottenendo il valore delDocumentSecurityServiceClient.Endpoint.Binding
campo. Invia il valore restituito aBasicHttpBinding
. -
Imposta il
System.ServiceModel.BasicHttpBinding
dell'oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegna al campo il nome utente dei moduli AEM
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore password corrispondente al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Assegna al campo il nome utente dei moduli AEM
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recuperare un documento di Word.
- Creare un
BLOB
mediante il costruttore. IlBLOB
L'oggetto viene utilizzato per memorizzare un documento di Word a cui viene applicato un criterio. - Creare un
System.IO.FileStream
oggetto richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento di Word e la modalità di apertura del file. - Creare una matrice di byte che memorizza il contenuto della
System.IO.FileStream
oggetto. Determinare la dimensione dell'array di byte ottenendoSystem.IO.FileStream
dell'oggettoLength
proprietà. - Compilare la matrice di byte con i dati di flusso richiamando
System.IO.FileStream
dell'oggettoRead
metodo. Passare la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare il
BLOB
oggetto assegnando il relativoMTOM
con il contenuto della matrice di byte.
- Creare un
-
Applicare una policy esistente al documento di Word.
Applicare una policy al documento di Word richiamando
DocumentSecurityServiceClient
dell'oggettoprotectDocument
e fornendo i seguenti valori:- Il
BLOB
oggetto che contiene il documento di Word a cui viene applicato il criterio. - Valore stringa che specifica il nome del documento.
- Valore stringa che specifica il nome del set di criteri a cui appartiene il criterio. È possibile specificare un
null
valore che risulta inMyPolicies
set di criteri in uso. - Valore stringa che specifica il nome del criterio.
- Valore string che rappresenta il nome del dominio del gestore utenti dell'utente che è l'autore del documento. Il valore di questo parametro è facoltativo e può essere null (se il parametro è null, il valore del parametro successivo deve essere
null
). - Valore stringa che rappresenta il nome canonico dell'utente responsabile dell'utente che è l'autore del documento. Il valore di questo parametro è facoltativo e può essere null (se il parametro è null, il valore del parametro precedente deve essere
null
). - A
RMLocale
valore che specifica il valore locale (ad esempio,RMLocale.en
). - Parametro di output stringa utilizzato per memorizzare il valore dell'identificatore dei criteri.
- Parametro di output stringa utilizzato per memorizzare il valore dell'identificatore protetto tramite policy.
- Un parametro di output stringa utilizzato per memorizzare il tipo mime (ad esempio,
application/doc
).
Il
protectDocument
il metodo restituisce unBLOB
oggetto che contiene il documento Word protetto tramite policy. - Il
-
Salvare il documento di Word.
- Creare un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento Word protetto tramite policy. - Creare una matrice di byte che memorizza il contenuto dei dati
BLOB
oggetto restituito daprotectDocument
metodo. Popolare la matrice di byte ottenendo il valore dellaBLOB
dell'oggettoMTOM
membro dati. - Creare un
System.IO.BinaryWriter
oggetto richiamando il relativo costruttore e passando ilSystem.IO.FileStream
oggetto. - Scrivere il contenuto della matrice di byte in un file di Word richiamando
System.IO.BinaryWriter
dell'oggettoWrite
e passando la matrice di byte.
- Creare un
Esempi di codice
Per esempi di codice con il servizio Document Security, consulta la Guida introduttiva seguente:
- "Guida rapida (MTOM): applicazione di una policy a un documento Word tramite l’API del servizio web"
Rimozione di criteri da documenti di Word removing-policies-from-word-documents
È possibile rimuovere una policy da un documento Word protetto tramite policy per rimuovere la protezione dal documento. In altre parole, se non desideri più che il documento sia protetto da una policy. Se si desidera aggiornare un documento Word protetto tramite policy con una policy più recente, invece di rimuovere la policy e aggiungere la policy aggiornata, è più efficiente cambiare la policy.
Riepilogo dei passaggi summary_of_steps-12
Per rimuovere una policy da un documento Word protetto tramite policy, effettuare le seguenti operazioni:
- Includi file di progetto
- Crea un oggetto API client di Document Security.
- Recuperare un documento Word protetto tramite policy.
- Rimuovere la policy dal documento di Word.
- Salva i documenti Word non protetti
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.
Creare un oggetto API client di Document Security
Prima di poter eseguire un’operazione del servizio Document Security a livello di programmazione, crea un oggetto client del servizio Document Security.
Recuperare un documento Word protetto tramite policy
Recuperare un documento Word protetto tramite policy per rimuovere una policy. Se si tenta di rimuovere una policy da un documento di Word non protetto da una policy, verrà generata un'eccezione.
Rimuovere la policy dal documento di Word
È possibile rimuovere una policy da un documento Word protetto tramite policy a condizione che nelle impostazioni di connessione sia specificato un amministratore. In caso contrario, il criterio utilizzato per proteggere un documento deve contenere SWITCH_POLICY
autorizzazione per rimuovere una policy da un documento di Word. Inoltre, anche l’utente specificato nelle impostazioni di connessione di AEM Forms deve disporre di tale autorizzazione. In caso contrario, viene generata un'eccezione.
Salvare il documento Word non protetto
Dopo che il servizio Document Security ha rimosso una policy da un documento Word, puoi salvare il documento Word non protetto come file DOC.
Consulta anche
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Applicazione di criteri ai documenti di Word
Rimuovere una policy da un documento Word utilizzando l’API Java remove-a-policy-from-a-word-document-using-the-java-api
Rimuovi una policy da un documento Word protetto tramite policy utilizzando Document Security API (Java):
-
Includi file di progetto
Includi i file JAR dei client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
-
Creare un oggetto API client di Document Security
- Creare un
ServiceClientFactory
oggetto che contiene proprietà di connessione. - Creare un
RightsManagementClient
mediante il costruttore e passando ilServiceClientFactory
oggetto.
- Creare un
-
Recuperare un documento Word protetto tramite policy
- Creare un
java.io.FileInputStream
oggetto che rappresenta il documento Word protetto tramite policy utilizzando il relativo costruttore e passando un valore stringa che specifica la posizione del documento Word. - Creare un
com.adobe.idp.Document
mediante il costruttore e passando iljava.io.FileInputStream
oggetto.
- Creare un
-
Rimuovere la policy dal documento di Word
- Creare un
DocumentManager
oggetto richiamando ilRightsManagementClient
dell'oggettogetDocumentManager
metodo. - Rimuovere una policy dal documento di Word richiamando
DocumentManager
dell'oggettoremoveSecurity
e passando ilcom.adobe.idp.Document
oggetto che contiene il documento Word protetto tramite policy. Questo metodo restituisce uncom.adobe.idp.Document
oggetto contenente un documento di Word non protetto.
- Creare un
-
Salvare il documento Word non protetto
- Creare un
java.io.File
e assicurarsi che l'estensione del file sia DOC. - Richiama
Document
dell'oggettocopyToFile
metodo per copiare il contenuto delDocument
al file (assicurati di utilizzare ilDocument
oggetto restituito daremoveSecurity
metodo).
- Creare un
Esempi di codice
Per esempi di codice con il servizio Document Security, consulta la Guida introduttiva seguente:
- "Guida rapida (modalità SOAP): rimozione di una policy da un documento Word tramite l’API Java"
Rimuovere una policy da un documento di Word utilizzando l’API del servizio web remove-a-policy-from-a-word-document-using-the-web-service-api
Rimuovi una policy da un documento Word protetto tramite policy utilizzando Document Security API (servizio web):
-
Includi file di progetto
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms. -
Creare un oggetto API client di Document Security
-
Creare un
RightsManagementServiceClient
utilizzando il costruttore predefinito. -
Creare un
RightsManagementServiceClient.Endpoint.Address
oggetto utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il file WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Non è necessario utilizzare illc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Creare un
System.ServiceModel.BasicHttpBinding
dell'oggetto ottenendo il valore delRightsManagementServiceClient.Endpoint.Binding
campo. Invia il valore restituito aBasicHttpBinding
. -
Imposta il
System.ServiceModel.BasicHttpBinding
dell'oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegna al campo il nome utente dei moduli AEM
RightsManagementServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore password corrispondente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Assegna al campo il nome utente dei moduli AEM
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recuperare un documento Word protetto tramite policy
- Creare un
BLOB
mediante il costruttore. IlBLOB
viene utilizzato per memorizzare il documento Word protetto tramite policy da cui viene rimossa la policy. - Creare un
System.IO.FileStream
oggetto richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento di Word e la modalità di apertura del file. - Creare una matrice di byte che memorizza il contenuto della
System.IO.FileStream
oggetto. È possibile determinare le dimensioni della matrice di byte ottenendoSystem.IO.FileStream
dell'oggettoLength
proprietà. - Compilare la matrice di byte con i dati di flusso richiamando
System.IO.FileStream
dell'oggettoRead
e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare il
BLOB
oggetto assegnando il relativoMTOM
con il contenuto della matrice di byte.
- Creare un
-
Rimuovere la policy dal documento di Word
Rimuovere la policy dal documento di Word richiamando
RightsManagementServiceClient
dell'oggettoremovePolicySecurity
e passando ilBLOB
oggetto che contiene il documento Word protetto tramite policy. Questo metodo restituisce unBLOB
oggetto contenente un documento di Word non protetto. -
Salvare il documento Word non protetto
- Creare un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento di Word non protetto. - Creare una matrice di byte che memorizza il contenuto dei dati
BLOB
oggetto restituito daremovePolicySecurity
metodo. Popolare la matrice di byte ottenendo il valore dellaBLOB
dell'oggettoMTOM
campo. - Creare un
System.IO.BinaryWriter
oggetto richiamando il relativo costruttore e passando ilSystem.IO.FileStream
oggetto.
- Creare un
Esempi di codice
Per esempi di codice con il servizio Document Security, consulta la Guida introduttiva seguente:
- "Guida rapida (MTOM): rimozione di una policy da un documento Word tramite l’API del servizio web"
Consulta anche
Richiamare AEM Forms tramite MTOM