AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.
Informazioni sul servizio Document Security
Il servizio Document Security consente agli utenti di applicare dinamicamente le impostazioni di riservatezza ai documenti Adobe PDF e di mantenere il controllo sui documenti, indipendentemente dalla loro diffusione.
Il servizio Document Security impedisce la diffusione delle informazioni oltre la portata dell’utente, consentendo agli utenti di mantenere il controllo sul modo in cui i destinatari utilizzano il documento PDF protetto dai criteri. Un utente può specificare chi può aprire un documento, limitare le modalità di utilizzo e monitorare il documento dopo la sua distribuzione. Un utente può anche controllare dinamicamente l'accesso a un documento protetto da policy e può anche revocare dinamicamente l'accesso al documento.
Il servizio Document Security protegge anche altri tipi di file come i file Microsoft Word (file DOC). È possibile utilizzare l'API client di sicurezza dei documenti per lavorare con questi tipi di file. Sono supportate le seguenti versioni:
Per chiarezza, le due sezioni seguenti illustrano come utilizzare i documenti di Word:
È possibile eseguire queste operazioni utilizzando il servizio Document Security:
Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.
Puoi creare criteri in modo programmatico utilizzando l’API Java per la sicurezza dei documenti o l’API del servizio Web. A policy è una raccolta di informazioni che include le impostazioni di protezione dei documenti, gli utenti autorizzati e i diritti di utilizzo. Puoi creare e salvare un numero qualsiasi di criteri, utilizzando le impostazioni di sicurezza appropriate per situazioni e utenti diversi.
I criteri consentono di eseguire le attività seguenti:
Quando crei un criterio utilizzando l’API del servizio Web, fai riferimento a un file XML PDRL (Portable Document Rights Language) esistente che descrive il criterio. Le autorizzazioni dei criteri e l'entità sono definite nel documento PDRL. Il seguente documento XML è un esempio di documento PDRL.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Policy PolicyInstanceVersion="1" PolicyID="5DA3F847-DE76-F9CC-63EA-49A8D59154DE" PolicyCreationTime="2004-08-30T00:02:28.294+00:00" PolicyType="1" PolicySchemaVersion="1.0" PolicyName="SDK Test Policy -4344050357301573237" PolicyDescription="An SDK Test policy" xmlns="https://www.adobe.com/schema/1.0/pdrl">
<PolicyEntry>
<ns1:Permission PermissionName="com.adobe.aps.onlineOpen" Access="ALLOW" xmlns:ns1="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns2:Permission PermissionName="com.adobe.aps.offlineOpen" Access="ALLOW" xmlns:ns2="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns3:Permission PermissionName="com.adobe.aps.pdf.editNotes" Access="ALLOW" xmlns:ns3="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns4:Permission PermissionName="com.adobe.aps.pdf.fillAndSign" Access="ALLOW" xmlns:ns4="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<Principal PrincipalNameType="SYSTEM">
<PrincipalDomain>EDC_SPECIAL</PrincipalDomain>
<PrincipalName>all_internal_users</PrincipalName>
</Principal>
</PolicyEntry>
<PolicyEntry>
<ns5:Permission PermissionName="com.adobe.aps.onlineOpen" Access="ALLOW" xmlns:ns5="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns6:Permission PermissionName="com.adobe.aps.offlineOpen" Access="ALLOW" xmlns:ns6="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns7:Permission PermissionName="com.adobe.aps.pdf.copy" Access="ALLOW" xmlns:ns7="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns8:Permission PermissionName="com.adobe.aps.pdf.printLow" Access="ALLOW" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" xmlns:ns8="https://www.adobe.com/schema/1.0/pdrl" />
<ns9:Permission PermissionName="com.adobe.aps.policySwitch" Access="ALLOW" xmlns:ns9="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns10:Permission PermissionName="com.adobe.aps.revoke" Access="ALLOW" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" xmlns:ns10="https://www.adobe.com/schema/1.0/pdrl" />
<ns11:Permission PermissionName="com.adobe.aps.pdf.edit" Access="ALLOW" xmlns:ns11="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns12:Permission PermissionName="com.adobe.aps.pdf.editNotes" Access="ALLOW" xmlns:ns12="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns13:Permission PermissionName="com.adobe.aps.pdf.fillAndSign" Access="ALLOW" xmlns:ns13="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns14:Permission PermissionName="com.adobe.aps.pdf.printHigh" Access="ALLOW" xmlns:ns14="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<Principal PrincipalNameType="SYSTEM">
<PrincipalDomain>EDC_SPECIAL</PrincipalDomain>
<PrincipalName>publisher</PrincipalName>
</Principal>
</PolicyEntry>
<OfflineLeasePeriod>
<Duration>P31D</Duration>
</OfflineLeasePeriod>
<AuditSettings isTracked="true" />
<PolicyValidityPeriod isAbsoluteTime="false">
<ValidityPeriodRelative>
<NotBeforeRelative>PT0S</NotBeforeRelative>
<NotAfterRelative>P20D</NotAfterRelative>
</ValidityPeriodRelative>
</PolicyValidityPeriod>
</Policy>
Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.
Per creare un criterio, effettua le seguenti operazioni:
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
Per informazioni sulla posizione di questi file JAR, vedi Inclusione dei file libreria Java di AEM Forms.
Creare un oggetto API client di sicurezza dei documenti
Prima di eseguire un'operazione del servizio Document Security, creare un oggetto client del servizio Document Security.
Impostare gli attributi del criterio
Per creare un criterio, impostare gli attributi del criterio. Un attributo obbligatorio è il nome del criterio. I nomi dei criteri devono essere univoci per ciascun set di criteri. Un set di criteri è semplicemente una raccolta di criteri. Possono essere presenti due criteri con lo stesso nome se i criteri appartengono a set di criteri separati. Tuttavia, due criteri all'interno di un singolo set di criteri non possono avere lo stesso nome.
Un altro attributo utile da impostare è il periodo di validità. Un periodo di validità è il periodo di tempo durante il quale un documento protetto da policy è accessibile ai destinatari autorizzati. Se non si imposta questo attributo, il criterio è sempre valido.
Un periodo di validità può essere impostato su una delle seguenti opzioni:
È possibile specificare solo una data di inizio, che fa sì che il criterio sia valido dopo la data di inizio. Se specifichi solo una data di fine, il criterio è valido fino alla data di fine. Tuttavia, viene generata un’eccezione se non sono definite sia una data di inizio che una data di fine.
Quando si impostano gli attributi che appartengono a un criterio, è anche possibile impostare le impostazioni di crittografia. Queste impostazioni di crittografia hanno effetto quando il criterio viene applicato a un documento. È possibile specificare i seguenti valori di crittografia:
Quando si specifica la variabile NoEncryption
non è possibile impostare PlaintextMetadata
opzione per false
. Se tenti di farlo, viene generata un'eccezione.
Per informazioni su altri attributi che è possibile impostare, consulta la sezione Policy
descrizione dell’interfaccia in Riferimento API di AEM Forms.
Creare una voce di criterio
Una voce di criterio associa entità principali, che sono gruppi e utenti, e autorizzazioni a un criterio. Un criterio deve avere almeno una voce di criterio. Si supponga, ad esempio, di eseguire le operazioni seguenti:
Queste azioni consentono ai destinatari di visualizzare il documento solo online e non di copiarlo. Il documento rimane protetto fino a quando la protezione non viene rimossa.
Registra il criterio
Prima di poter essere utilizzato, è necessario registrare un nuovo criterio. Dopo aver registrato un criterio, è possibile utilizzarlo per proteggere i documenti.
Crea un criterio utilizzando l’API Document Security (Java):
Includi file di progetto.
Includi file JAR client, come adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto API client Document Security.
ServiceClientFactory
oggetto contenente le proprietà di connessione.DocumentSecurityClient
utilizzando il relativo costruttore e passando ServiceClientFactory
oggetto.Imposta gli attributi del criterio.
Policy
richiamando l'oggetto InfomodelObjectFactory
statico dell’oggetto createPolicy
metodo . Questo metodo restituisce un Policy
oggetto.Policy
dell’oggetto setName
e passare un valore stringa che specifica il nome del criterio.Policy
dell’oggetto setDescription
e passare un valore stringa che specifica la descrizione del criterio.Policy
dell’oggetto setPolicySetName
e passare un valore stringa che specifica il nome del set di criteri. (puoi specificare null
per questo valore di parametro che determina l'aggiunta del criterio al Criteri personali set di criteri).InfomodelObjectFactory
statico dell’oggetto createValidityPeriod
metodo . Questo metodo restituisce un ValidityPeriod
oggetto.ValidityPeriod
dell’oggetto setRelativeExpirationDays
e passare un valore intero che specifica il numero di giorni.Policy
dell’oggetto setValidityPeriod
e passare ValidityPeriod
oggetto.Crea una voce di criterio.
InfomodelObjectFactory
statico dell’oggetto createPolicyEntry
metodo . Questo metodo restituisce un PolicyEntry
oggetto.InfomodelObjectFactory
statico dell’oggetto createPermission
metodo . Passa un membro di dati statici appartenente alla Permission
che rappresenta l'autorizzazione. Questo metodo restituisce un Permission
oggetto. Ad esempio, per aggiungere l’autorizzazione che consente agli utenti di copiare dati da un documento PDF protetto da policy, passare Permission.COPY
. (Ripeti questo passaggio per ogni autorizzazione da aggiungere).PolicyEntry
dell’oggetto addPermission
e passare Permission
oggetto. (Ripeti questo passaggio per ogni Permission
oggetto creato).InfomodelObjectFactory
statico dell’oggetto createSpecialPrincipal
metodo . Passa un membro dati appartenente alla InfomodelObjectFactory
oggetto che rappresenta l'entità principale. Questo metodo restituisce un Principal
oggetto. Ad esempio, per aggiungere come principale l’editore del documento, passare InfomodelObjectFactory.PUBLISHER_PRINCIPAL
.PolicyEntry
dell’oggetto setPrincipal
e passare Principal
oggetto.Policy
dell’oggetto addPolicyEntry
e passare PolicyEntry
oggetto.Registra il criterio.
Crea un PolicyManager
richiamando l'oggetto DocumentSecurityClient
dell’oggetto getPolicyManager
metodo .
Registra il criterio richiamando il PolicyManager
dell’oggetto registerPolicy
e passando i seguenti valori:
Policy
oggetto che rappresenta il criterio da registrare.Valore stringa che rappresenta il set di criteri a cui appartiene il criterio.
Se nelle impostazioni di connessione si utilizza un account amministratore AEM forms per creare DocumentSecurityClient
, quindi specificare il nome del set di criteri quando si richiama il registerPolicy
metodo . Se passi un null
per il set di criteri, il criterio viene creato negli amministratori Criteri personali set di criteri.
Se utilizzi un utente Document Security nelle impostazioni di connessione, puoi richiamare l' 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 Criteri personali. Se non si desidera aggiungere il nuovo criterio a questo set di criteri, specificare un nome del set di criteri quando si richiama il registerPolicy
metodo .
Quando crei un criterio, fai riferimento a un set di criteri esistente. Se si specifica un set di criteri che non esiste, viene generata un'eccezione.
Per esempi di codice che utilizzano il servizio Document Security, consulta quanto segue:
Crea un criterio utilizzando l’API Document Security (servizio Web):
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms.
Creare un oggetto API client Document Security.
Crea un DocumentSecurityServiceClient
utilizzando il relativo costruttore predefinito.
Crea un DocumentSecurityServiceClient.Endpoint.Address
utilizzando System.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Non è necessario utilizzare il lc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
Crea un System.ServiceModel.BasicHttpBinding
ottenendo il valore del RightsManagementServiceClient.Endpoint.Binding
campo . Imposta il valore restituito su BasicHttpBinding
.
Imposta la System.ServiceModel.BasicHttpBinding
dell’oggetto MessageEncoding
campo a WSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM.
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Imposta gli attributi del criterio.
PolicySpec
utilizzando il relativo costruttore.PolicySpec
dell’oggetto name
membro dati.PolicySpec
dell’oggetto description
membro dati.PolicySpec
dell’oggetto policySetName
membro dati. È necessario specificare un nome di set di criteri esistente. (puoi specificare null
per questo valore di parametro che determina l'aggiunta del criterio a Criteri personali.)PolicySpec
dell’oggetto offlineLeasePeriod
membro dati.PolicySpec
dell’oggetto policyXml
membro dati con un valore stringa che rappresenta i dati XML PDRL. Per eseguire questa operazione, creare un file .NET StreamReader
utilizzando il relativo costruttore. Passa la posizione di un file XML PDRL che rappresenta il criterio al StreamReader
costruttore. Quindi, richiama il StreamReader
dell’oggetto ReadLine
e assegna il valore restituito a una variabile stringa. Itera attraverso il StreamReader
fino al ReadLine
restituisce null. Assegna la variabile della stringa alla variabile PolicySpec
dell’oggetto policyXml
membro dati.Crea una voce di criterio.
Non è necessario creare una voce di criterio durante la creazione di un criterio utilizzando l'API del servizio Web Document Security. La voce dei criteri è definita nel documento PDRL.
Registra il criterio.
Registra il criterio richiamando il DocumentSecurityServiceClient
dell’oggetto registerPolicy
e passando i seguenti valori:
PolicySpec
oggetto che rappresenta il criterio da registrare.null
che determina l'aggiunta del criterio al MyPolices set di criteri.Se nelle impostazioni di connessione si utilizza un account amministratore AEM forms per creare DocumentSecurityClient
specificare il nome del set di criteri quando si richiama l' registerPolicy
metodo .
Se si utilizza un utente Document SecurityDocument Security all'interno delle impostazioni di connessione, è possibile richiamare l' 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 Criteri personali. Se non si desidera aggiungere il nuovo criterio a questo set di criteri, specificare un nome del set di criteri quando si richiama il registerPolicy
metodo .
Quando crei un criterio e specifichi un set di criteri, assicurati di specificare un set di criteri esistente. Se si specifica un set di criteri che non esiste, viene generata un'eccezione.
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
Puoi modificare un criterio esistente utilizzando l’API Java per la sicurezza dei documenti o l’API del servizio Web. Per apportare modifiche a un criterio esistente, recuperarlo, modificarlo e quindi aggiornare il criterio sul server. Ad esempio, si supponga di recuperare un criterio esistente e di estenderne il periodo di validità. Prima che la modifica abbia effetto, è necessario aggiornare il criterio.
È possibile modificare un criterio quando i requisiti aziendali cambiano e il criterio non riflette più questi requisiti. Invece di creare un nuovo criterio, puoi semplicemente aggiornare un criterio esistente.
Per modificare gli attributi dei criteri utilizzando un servizio Web (ad esempio, utilizzando le classi proxy Java create con JAX-WS), è necessario assicurarsi che il criterio sia registrato con il servizio Document Security. È quindi possibile fare riferimento al criterio esistente utilizzando 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 .
Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.
Per modificare un criterio esistente, esegui i seguenti passaggi:
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
Creare un oggetto API client di sicurezza dei documenti
Prima di poter eseguire un'operazione Document Security Service a livello di programmazione, è necessario creare un oggetto client del servizio Document Security. Se utilizzi l’API Java, crea un RightsManagementClient
oggetto. Se utilizzi l’API del servizio Web Document Security, crea un RightsManagementServiceService
oggetto.
Recupera un criterio esistente
È necessario recuperare un criterio esistente per modificarlo. Per recuperare un criterio, specificare il nome e il set di criteri a cui appartiene il criterio. Se specifichi una null
per il nome del set di criteri, il criterio viene recuperato dalla Criteri personali set di criteri.
Impostare gli attributi del criterio
Per modificare un criterio, è necessario modificare il valore degli attributi del criterio. L'unico attributo di criterio che non è possibile modificare è l'attributo name. Ad esempio, per modificare il periodo di leasing offline del criterio, puoi modificare il valore dell’attributo del periodo di leasing offline del criterio.
Quando modifichi il periodo di lease offline di un criterio utilizzando un servizio Web, la offlineLeasePeriod
sul campo PolicySpec
l'interfaccia viene ignorata. Per aggiornare il periodo di lease offline, modifica il OfflineLeasePeriod
nel documento XML PDRL. Quindi fai riferimento al documento XML PDRL aggiornato utilizzando il PolicySpec
dell’interfaccia policyXML
membro dati.
Per informazioni su altri attributi che è possibile impostare, consulta la sezione Policy
descrizione dell’interfaccia in Riferimento API di AEM Forms.
Aggiornare il criterio
Prima di apportare modifiche a un criterio, è necessario aggiornare il criterio con il servizio Document Security. Le modifiche ai criteri che proteggono i documenti vengono aggiornate al successivo aggiornamento del documento protetto dai criteri con il servizio Document Security.
Modificare un criterio esistente utilizzando l'API Document Security (Java):
Includi file di progetto.
Includi file JAR client, come adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto API client Document Security.
ServiceClientFactory
oggetto contenente le proprietà di connessione.RightsManagementClient
utilizzando il relativo costruttore e passando ServiceClientFactory
oggetto.Recupera un criterio esistente.
Crea un PolicyManager
richiamando l'oggetto RightsManagementClient
dell’oggetto getPolicyManager
metodo .
Crea un Policy
oggetto che rappresenta il criterio da aggiornare richiamando il PolicyManager
dell’oggetto getPolicy
e passando i seguenti valori"
null
che si traduce in MyPolicies
set di criteri in uso.Imposta gli attributi del criterio.
Modifica gli attributi del criterio per soddisfare i requisiti aziendali. Ad esempio, per modificare il periodo di leasing offline del criterio, invoca il Policy
dell’oggetto setOfflineLeasePeriod
metodo .
Aggiorna il criterio.
Aggiornare il criterio richiamando PolicyManager
dell’oggetto updatePolicy
metodo . Passa la Policy
oggetto che rappresenta il criterio da aggiornare.
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere Avvio rapido (modalità SOAP): Modifica di un criterio tramite la sezione API Java .
Modificare un criterio esistente utilizzando l'API Document Security (servizio Web):
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms.
Creare un oggetto API client Document Security.
Crea un RightsManagementServiceClient
utilizzando il relativo costruttore predefinito.
Crea un RightsManagementServiceClient.Endpoint.Address
utilizzando System.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Non è necessario utilizzare il lc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
Crea un System.ServiceModel.BasicHttpBinding
ottenendo il valore del RightsManagementServiceClient.Endpoint.Binding
campo . Imposta il valore restituito su BasicHttpBinding
.
Imposta la System.ServiceModel.BasicHttpBinding
dell’oggetto MessageEncoding
campo a WSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM.
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Recupera un criterio esistente.
Crea un PolicySpec
oggetto che rappresenta il criterio da modificare richiamando il RightsManagementServiceClient
dell’oggetto getPolicy
e passando i seguenti valori:
null
che si traduce in MyPolicies
set di criteri in uso.Imposta gli attributi del criterio.
Modifica gli attributi del criterio per soddisfare i requisiti aziendali.
Aggiorna il criterio.
Aggiorna il criterio richiamando il RightsManagementServiceClient
dell’oggetto updatePolicyFromSDK
e passare PolicySpec
oggetto che rappresenta il criterio da aggiornare.
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
Puoi eliminare un criterio esistente utilizzando l’API Java per la sicurezza dei documenti o l’API del servizio Web. Una volta eliminato, un criterio non può più essere utilizzato per proteggere i documenti. Tuttavia, i documenti protetti da policy esistenti che utilizzano il criterio sono ancora protetti. È possibile eliminare un criterio quando uno più recente diventa disponibile.
Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.
Per eliminare un criterio esistente, eseguire le operazioni seguenti:
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
Creare un oggetto API client di sicurezza dei documenti
Prima di poter eseguire un'operazione del servizio Document Security, è necessario creare un oggetto client del servizio Document Security. Se utilizzi l’API Java, crea un 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 criterio impostato a cui appartiene il criterio. L’utente le cui impostazioni vengono utilizzate per richiamare AEM Forms deve disporre dell’autorizzazione per eliminare il criterio; in caso contrario si verifica un'eccezione. Allo stesso modo, se tenti di eliminare un criterio che non esiste, si verifica un'eccezione.
Elimina un criterio utilizzando l’API Document Security (Java):
Includi file di progetto.
Includi file JAR client, come adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto API client Document Security.
ServiceClientFactory
oggetto contenente le proprietà di connessione.RightsManagementClient
utilizzando il relativo costruttore e passando ServiceClientFactory
oggetto.Elimina il criterio.
Crea un PolicyManager
richiamando l'oggetto RightsManagementClient
dell’oggetto getPolicyManager
metodo .
Elimina il criterio richiamando il PolicyManager
dell’oggetto deletePolicy
e passando i seguenti valori:
null
che si traduce in MyPolicies
set di criteri in uso.Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
Eliminare un criterio utilizzando l'API Document Security (servizio Web):
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms.
Creare un oggetto API client Document Security.
Crea un RightsManagementServiceClient
utilizzando il relativo costruttore predefinito.
Crea un RightsManagementServiceClient.Endpoint.Address
utilizzando System.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Non è necessario utilizzare il lc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
Crea un System.ServiceModel.BasicHttpBinding
ottenendo il valore del RightsManagementServiceClient.Endpoint.Binding
campo . Imposta il valore restituito su BasicHttpBinding
.
Imposta la System.ServiceModel.BasicHttpBinding
dell’oggetto MessageEncoding
campo a WSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM.
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Elimina il criterio.
Elimina un criterio richiamando il RightsManagementServiceClient
dell’oggetto deletePolicy
e passando i seguenti valori:
null
che si traduce in MyPolicies
set di criteri in uso.Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
È possibile applicare un criterio a un documento PDF per proteggere il documento. Applicando un criterio a un documento PDF, è possibile limitare l’accesso al documento. Non è possibile applicare un criterio a un documento se il documento è già protetto con un criterio.
Quando il documento è aperto, è inoltre possibile limitare l’accesso alle funzioni di Acrobat e Adobe Reader, inclusa la possibilità di stampare e copiare testo, apportare modifiche e aggiungere firme e commenti a un documento. Inoltre, è possibile revocare un documento PDF protetto da policy quando si desidera che gli utenti non accedano più al documento.
È possibile monitorare l'utilizzo di un documento protetto da policy dopo averlo distribuito. In altre parole, puoi vedere come viene utilizzato il documento e chi lo sta utilizzando. Ad esempio, puoi scoprire quando qualcuno ha aperto il documento.
Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.
Per applicare un criterio a un documento PDF, eseguire le operazioni seguenti:
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
Creare un oggetto API client Document Security
Prima di eseguire un'operazione del servizio Document Security, creare un oggetto client del servizio Document Security. Se utilizzi l’API Java, crea un 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 un criterio. Dopo aver applicato un criterio al documento PDF, gli utenti vengono limitati quando utilizzano il documento. Ad esempio, se il criterio non consente l'apertura del documento in modalità non in linea, per aprire il documento gli utenti devono essere in linea.
Applicare un criterio esistente al documento PDF
Per applicare un criterio a un documento PDF, fare riferimento a un criterio esistente e specificare il set di criteri a cui appartiene il criterio. L'utente che sta impostando le proprietà di connessione deve avere accesso al criterio specificato. In caso contrario, si verifica un'eccezione.
Salvare il documento PDF
Dopo aver applicato un criterio a un documento PDF, è possibile salvare il documento PDF protetto da criteri come file PDF.
Consulta anche
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Revoca dell’accesso ai documenti
Applicare un criterio a un documento PDF utilizzando l’API Document Security (Java):
Includi file di progetto.
Includi file JAR client, come adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto API client Document Security.
ServiceClientFactory
oggetto contenente le proprietà di connessione.RightsManagementClient
utilizzando il relativo costruttore e passando ServiceClientFactory
oggetto.Recupera un documento PDF.
java.io.FileInputStream
oggetto che rappresenta il documento PDF utilizzando il relativo costruttore. Passa un valore stringa che specifica la posizione del documento PDF.com.adobe.idp.Document
utilizzando il relativo costruttore e passando java.io.FileInputStream
oggetto.Applicare un criterio esistente al documento PDF.
Crea un DocumentManager
richiamando l'oggetto RightsManagementClient
dell’oggetto getDocumentManager
metodo .
Applicare un criterio al documento PDF richiamando il DocumentManager
dell’oggetto protectDocument
e passando i seguenti valori:
com.adobe.idp.Document
oggetto contenente il documento PDF a cui viene applicato il criterio.null
che restituisce MyPolicies
set di criteri in uso.null
Se questo parametro è nullo, il valore del parametro precedente deve essere null
).com.adobe.livecycle.rightsmanagement.Locale
che rappresenta le impostazioni internazionali utilizzate per selezionare il modello di MS Office. Questo valore del parametro è facoltativo e non viene utilizzato per i documenti PDF. Per proteggere un documento PDF, specificare null
.La protectDocument
restituisce un RMSecureDocumentResult
oggetto contenente il documento PDF protetto da policy.
Salvare il documento PDF.
RMSecureDocumentResult
dell’oggetto getProtectedDoc
per ottenere il documento PDF protetto da policy. Questo metodo restituisce un com.adobe.idp.Document
oggetto.java.io.File
e assicurati che l’estensione del file sia PDF.com.adobe.idp.Document
dell’oggetto copyToFile
per copiare il contenuto del Document
al file (assicurati di utilizzare Document
oggetto restituito da getProtectedDoc
metodo).Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
Consulta anche
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Applicare un criterio a un documento PDF utilizzando l'API Document Security (servizio Web):
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms.
Creare un oggetto API client Document Security.
Crea un RightsManagementServiceClient
utilizzando il relativo costruttore predefinito.
Crea un RightsManagementServiceClient.Endpoint.Address
utilizzando System.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio Forms (ad esempio, http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Non è necessario utilizzare il lc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
Crea un System.ServiceModel.BasicHttpBinding
ottenendo il valore del RightsManagementServiceClient.Endpoint.Binding
campo . Imposta il valore restituito su BasicHttpBinding
.
Imposta la System.ServiceModel.BasicHttpBinding
dell’oggetto MessageEncoding
campo a WSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM.
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Recupera un documento PDF.
BLOB
utilizzando il relativo costruttore. La BLOB
viene utilizzato per memorizzare un documento PDF a cui viene applicato un criterio.System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF e la modalità di apertura del file.System.IO.FileStream
oggetto. Determina la dimensione dell'array di byte ottenendo il System.IO.FileStream
dell’oggetto Length
proprietà.System.IO.FileStream
dell’oggetto Read
metodo . Passa la matrice dei byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
oggetto assegnando il relativo MTOM
con il contenuto dell'array di byte.Applicare un criterio esistente al documento PDF.
Applicare un criterio al documento PDF richiamando il RightsManagementServiceClient
dell’oggetto protectDocument
e passando i seguenti valori:
BLOB
oggetto contenente il documento PDF a cui viene applicato il criterio.null
che restituisce MyPolicies
set di criteri in uso.null
).null
).RMLocale
valore che specifica il valore delle impostazioni internazionali (ad esempio, RMLocale.en
).application/pdf
).La protectDocument
restituisce un BLOB
oggetto contenente il documento PDF protetto da policy.
Salvare il documento PDF.
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF protetto tramite criterio.BLOB
oggetto restituito da protectDocument
metodo . Compilare l’array di byte ottenendo il valore del BLOB
dell’oggetto MTOM
membro dati.System.IO.BinaryWriter
richiamando il relativo costruttore e passando System.IO.FileStream
oggetto.System.IO.BinaryWriter
dell’oggetto Write
e passare l'array di byte.Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
È possibile rimuovere un criterio da un documento protetto da criteri per rimuovere la protezione dal documento. In altre parole, se non si desidera più che il documento sia protetto da una politica. Se si desidera aggiornare un documento protetto da policy con un criterio più recente, invece di rimuovere il criterio e aggiungere il criterio aggiornato, è più efficiente cambiare il criterio.
Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.
Per rimuovere un criterio da un documento PDF protetto da policy, eseguire le operazioni seguenti:
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
Creare un oggetto API client di sicurezza dei documenti
Prima di eseguire un'operazione del servizio Document Security, creare un oggetto client del servizio Document Security.
Recuperare un documento PDF protetto da policy
È possibile recuperare un documento PDF protetto da policy per rimuovere un criterio. Se si tenta di rimuovere un criterio da un documento PDF non protetto da un criterio, verrà generata un'eccezione.
Rimuovi il criterio dal documento PDF
È possibile rimuovere un criterio da un documento PDF protetto da criteri, purché nelle impostazioni di connessione sia specificato un amministratore. In caso contrario, il criterio utilizzato per proteggere un documento deve contenere SWITCH_POLICY
per rimuovere un criterio da un documento di PDF. Inoltre, anche l’utente specificato nelle impostazioni di connessione di AEM Forms deve disporre di tale autorizzazione. In caso contrario, viene generata un'eccezione.
Salvare il documento PDF non protetto
Dopo la rimozione di un criterio da un documento PDF, è possibile salvare il documento PDF non protetto come file PDF.
Consulta anche
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Applicazione dei criteri ai documenti PDF
È possibile rimuovere un criterio da un documento PDF protetto da policy utilizzando l’API Document Security (Java):
Includi file di progetto.
Includi file JAR client, come adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto API client Document Security.
ServiceClientFactory
oggetto contenente le proprietà di connessione.DocumentSecurityClient
utilizzando il relativo costruttore e passando ServiceClientFactory
oggetto.Recupera un documento PDF protetto da policy.
java.io.FileInputStream
oggetto che rappresenta il documento PDF protetto da policy utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento PDF.com.adobe.idp.Document
utilizzando il relativo costruttore e passando java.io.FileInputStream
oggetto.Rimuovi il criterio dal documento PDF.
DocumentManager
richiamando l'oggetto DocumentSecurityClient
dell’oggetto getDocumentManager
metodo .DocumentManager
dell’oggetto removeSecurity
e passare com.adobe.idp.Document
oggetto contenente il documento PDF protetto da policy. Questo metodo restituisce un com.adobe.idp.Document
oggetto contenente un documento PDF non protetto.Salvare il documento PDF non protetto.
java.io.File
e assicurati che l’estensione del file sia PDF.Document
dell’oggetto copyToFile
per copiare il contenuto del Document
al file (assicurati di utilizzare Document
oggetto restituito da removeSecurity
metodo).Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
Rimuovere un criterio da un documento PDF protetto da policy utilizzando l'API Document Security (servizio Web):
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms.
Creare un oggetto API client Document Security.
Crea un DocumentSecurityServiceClient
utilizzando il relativo costruttore predefinito.
Crea un DocumentSecurityServiceClient.Endpoint.Address
utilizzando System.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Non è necessario utilizzare il lc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
Crea un System.ServiceModel.BasicHttpBinding
ottenendo il valore del DocumentSecurityServiceClient.Endpoint.Binding
campo . Imposta il valore restituito su BasicHttpBinding
.
Imposta la System.ServiceModel.BasicHttpBinding
dell’oggetto MessageEncoding
campo a WSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM.
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Recupera un documento PDF protetto da policy.
BLOB
utilizzando il relativo costruttore. La BLOB
viene utilizzato per memorizzare il documento PDF protetto dai criteri da cui viene rimosso il criterio.System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF e la modalità di apertura del file.System.IO.FileStream
oggetto. È possibile determinare le dimensioni dell'array di byte ottenendo il System.IO.FileStream
dell’oggetto Length
proprietà.System.IO.FileStream
dell’oggetto Read
e passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
oggetto assegnando il relativo MTOM
con il contenuto dell'array di byte.Rimuovi il criterio dal documento PDF.
Rimuovi il criterio dal documento PDF richiamando il DocumentSecurityServiceClient
dell’oggetto removePolicySecurity
e passare BLOB
oggetto contenente il documento PDF protetto da policy. Questo metodo restituisce un BLOB
oggetto contenente un documento PDF non protetto.
Salvare il documento PDF non protetto.
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF non protetto.BLOB
oggetto restituito da removePolicySecurity
metodo . Compilare l’array di byte ottenendo il valore del BLOB
dell’oggetto MTOM
campo .System.IO.BinaryWriter
richiamando il relativo costruttore e passando System.IO.FileStream
oggetto.Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
È possibile revocare l’accesso a un documento PDF protetto da policy in modo che tutte le copie del documento risultino inaccessibili agli utenti. Quando un utente tenta di aprire un documento PDF revocato, viene reindirizzato a un URL specifico in cui è possibile visualizzare un documento rivisto. L’URL a cui l’utente viene reindirizzato deve essere specificato a livello di programmazione. Quando si revoca l'accesso a un documento, la modifica ha effetto alla successiva sincronizzazione dell'utente con il servizio Document Security aprendo il documento protetto tramite criterio online.
La possibilità di revocare l’accesso a un documento offre ulteriore protezione. Ad esempio, si supponga che sia disponibile una versione più recente di un documento e che non si desideri più che qualcuno visualizzi la versione obsoleta. In questa situazione, l'accesso al documento precedente può essere revocato e nessuno può visualizzare il documento a meno che l'accesso non venga ripristinato.
Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.
Per revocare un documento protetto da policy, esegui le seguenti operazioni:
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
Creare un oggetto API client di sicurezza dei documenti
Prima di poter eseguire un'operazione del servizio Document Security, è necessario creare un oggetto client del servizio Document Security.
Recuperare un documento PDF protetto da policy
Per revocarlo, è necessario recuperare un documento PDF protetto da policy. Impossibile revocare un documento già revocato o non protetto da policy.
Se si conosce il valore dell'identificatore di licenza del documento protetto tramite criterio, non è necessario recuperare il documento PDF protetto tramite criterio. Tuttavia, nella maggior parte dei casi, per ottenere il valore dell’identificatore di licenza è necessario recuperare il documento PDF.
Revoca del documento protetto da policy
Per revocare un documento protetto da policy, specificare l'identificativo della licenza del documento protetto da policy. Inoltre, è possibile specificare l'URL di un documento che l'utente può visualizzare quando tenta di aprire il documento revocato. In altre parole, supponiamo che un documento obsoleto venga revocato. Quando un utente tenta di aprire il documento revocato, vedrà un documento aggiornato invece del documento revocato.
Se si tenta di revocare un documento già revocato, viene generata un'eccezione.
Consulta anche
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Applicazione dei criteri ai documenti PDF
Ripristino dell'accesso ai documenti revisionati
Revoca l’accesso a un documento PDF protetto da policy utilizzando l’API Document Security (Java):
Includi file di progetto
Includi file JAR client, come adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto API client di sicurezza dei documenti
ServiceClientFactory
oggetto contenente le proprietà di connessione.DocumentSecurityClient
utilizzando il relativo costruttore e passando ServiceClientFactory
oggetto.Recuperare un documento PDF protetto da policy
java.io.FileInputStream
oggetto che rappresenta il documento PDF protetto da policy utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento PDF.com.adobe.idp.Document
utilizzando il relativo costruttore e passando java.io.FileInputStream
oggetto.Revoca del documento protetto da policy
Crea un DocumentManager
richiamando l'oggetto DocumentSecurityClient
dell’oggetto getDocumentManager
metodo .
Recupera il valore dell'identificatore di licenza del documento protetto tramite criterio richiamando il DocumentManager
dell’oggetto getLicenseId
metodo . Passa la com.adobe.idp.Document
oggetto che rappresenta il documento protetto da policy. Questo metodo restituisce un valore stringa che rappresenta il valore dell'identificatore di licenza.
Crea un LicenseManager
richiamando l'oggetto DocumentSecurityClient
dell’oggetto getLicenseManager
metodo .
Revocare il documento protetto dai criteri richiamando il LicenseManager
dell’oggetto revokeLicense
e passando i seguenti valori:
DocumentManager
dell’oggetto getLicenseId
metodo).License
interfaccia che specifica il motivo della revoca del documento. Ad esempio, puoi specificare License.DOCUMENT_REVISED
.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 passare null
.Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
Revoca l’accesso a un documento PDF protetto da policy utilizzando l’API Document Security (servizio Web):
Includi file di progetto
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms.
Creare un oggetto API client di sicurezza dei documenti
Crea un DocumentSecurityServiceClient
utilizzando il relativo costruttore predefinito.
Crea un DocumentSecurityServiceClient.Endpoint.Address
utilizzando System.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Non è necessario utilizzare il lc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
Crea un System.ServiceModel.BasicHttpBinding
ottenendo il valore del DocumentSecurityServiceClient.Endpoint.Binding
campo . Imposta il valore restituito su BasicHttpBinding
.
Imposta la System.ServiceModel.BasicHttpBinding
dell’oggetto MessageEncoding
campo a WSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM.
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Recuperare un documento PDF protetto da policy
BLOB
utilizzando il relativo costruttore. La BLOB
viene utilizzato per memorizzare un documento PDF protetto da policy revocato.System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF protetto da policy da revocare e la modalità di apertura del file.System.IO.FileStream
oggetto. È possibile determinare le dimensioni dell'array di byte ottenendo il System.IO.FileStream
dell’oggetto Length
proprietà.System.IO.FileStream
dell’oggetto Read
e passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
oggetto assegnando il relativo MTOM
con il contenuto dell'array di byte.Revoca del documento protetto da policy
Recupera il valore dell'identificatore di licenza del documento protetto tramite criterio richiamando il DocumentSecurityServiceClient
dell’oggetto getLicenseID
e passare BLOB
oggetto che rappresenta il documento protetto da policy. Questo metodo restituisce un valore stringa che rappresenta l'identificatore di licenza.
Revocare il documento protetto dai criteri richiamando il DocumentSecurityServiceClient
dell’oggetto revokeLicense
e passando i seguenti valori:
DocumentSecurityServiceService
dell’oggetto getLicenseId
metodo).Reason
enum che specifica il motivo della revoca del documento. Ad esempio, puoi specificare Reason.DOCUMENT_REVISED
.string
valore che specifica la posizione dell'URL in cui si trova un documento revisionato. Se non desideri reindirizzare un utente a un altro URL, puoi passare null
.Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
Consulta anche
Rimozione di criteri dai documenti di Word
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
È possibile ripristinare l’accesso a un documento PDF revocato, in modo che tutte le copie del documento revocato siano accessibili agli utenti. Quando un utente apre un documento ripristinato revocato, può visualizzare il documento.
Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.
Per ripristinare l’accesso a un documento PDF revocato, eseguire le operazioni seguenti:
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
Creare un oggetto API client di sicurezza dei documenti
Prima di poter eseguire un'operazione del servizio Document Security, è necessario creare un oggetto client del servizio Document Security. Se utilizzi l’API Java, crea un DocumentSecurityClient
oggetto. Se utilizzi l’API del servizio Web Document Security, crea un DocumentSecurityServiceService
oggetto.
Recupera l’identificatore di licenza del documento PDF revocato
Per ripristinare un documento PDF revocato, è necessario recuperare l’identificatore di licenza del documento PDF revocato. Dopo aver ottenuto il valore dell'identificatore di licenza, è possibile ripristinare un documento revocato. Se si tenta di ripristinare un documento non revocato, verrà generata un'eccezione.
Ripristino dell’accesso al documento PDF revocato
Per ripristinare l’accesso a un documento PDF revocato, è necessario specificare l’identificatore di licenza del documento revocato. Se si tenta di ripristinare l’accesso a un documento PDF non revocato, verrà generata un’eccezione.
Consulta anche
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Applicazione dei criteri ai documenti PDF
Revoca dell’accesso ai documenti
Ripristina l’accesso a un documento revocato utilizzando l’API Document Security (Java):
Includi file di progetto.
Includi file JAR client, come adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto API client Document Security.
ServiceClientFactory
oggetto contenente le proprietà di connessione.DocumentSecurityClient
utilizzando il relativo costruttore e passando ServiceClientFactory
oggetto.Recupera l’identificatore di licenza del documento PDF revocato.
java.io.FileInputStream
oggetto che rappresenta il documento PDF revocato utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento PDF.com.adobe.idp.Document
utilizzando il relativo costruttore e passando java.io.FileInputStream
oggetto.DocumentManager
richiamando l'oggetto DocumentSecurityClient
dell’oggetto getDocumentManager
metodo .DocumentManager
dell’oggetto getLicenseId
e passare com.adobe.idp.Document
oggetto che rappresenta il documento revocato. Questo metodo restituisce un valore stringa che rappresenta l'identificatore di licenza.Ripristina l’accesso al documento PDF revocato.
LicenseManager
richiamando l'oggetto DocumentSecurityClient
dell’oggetto getLicenseManager
metodo .LicenseManager
dell’oggetto unrevokeLicense
e passare il valore dell'identificativo della licenza del documento revocato.Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
Ripristino dell'accesso a un documento revocato tramite l'API Document Security (servizio Web):
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms.
Creare un oggetto API client Document Security.
Crea un DocumentSecurityServiceClient
utilizzando il relativo costruttore predefinito.
Crea un DocumentSecurityServiceClient.Endpoint.Address
utilizzando System.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Non è necessario utilizzare il lc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
Crea un System.ServiceModel.BasicHttpBinding
ottenendo il valore del DocumentSecurityServiceClient.Endpoint.Binding
campo . Imposta il valore restituito su BasicHttpBinding
.
Imposta la System.ServiceModel.BasicHttpBinding
dell’oggetto MessageEncoding
campo a WSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM.
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Recupera l’identificatore di licenza del documento PDF revocato.
BLOB
utilizzando il relativo costruttore. La BLOB
viene utilizzato per memorizzare un documento PDF revocato al quale viene ripristinato l'accesso.System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF revocato e la modalità di apertura del file.System.IO.FileStream
oggetto. È possibile determinare le dimensioni dell'array di byte ottenendo il System.IO.FileStream
dell’oggetto Length
proprietà.System.IO.FileStream
dell’oggetto Read
e passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
oggetto assegnando il relativo MTOM
con il contenuto dell'array di byte.Ripristina l’accesso al documento PDF revocato.
DocumentSecurityServiceClient
dell’oggetto getLicenseID
e passare BLOB
oggetto che rappresenta il documento revocato. Questo metodo restituisce un valore stringa che rappresenta l'identificatore di licenza.DocumentSecurityServiceClient
dell’oggetto unrevokeLicense
e passare un valore stringa che specifica il valore dell'identificatore di licenza del documento PDF revocato (passare il valore restituito del DocumentSecurityServiceClient
dell’oggetto getLicenseId
metodo).Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
È possibile utilizzare l’API del servizio Document Security (Java e il servizio Web) per ispezionare i documenti PDF protetti da policy. L'ispezione dei documenti PDF protetti da policy restituisce informazioni sul documento PDF protetto da policy. Ad esempio, è possibile determinare il criterio utilizzato per proteggere il documento e la data in cui il documento è stato protetto.
Non è possibile eseguire questa operazione se la versione di LiveCycle in uso è 8.x o una versione precedente. In AEM Forms viene aggiunto il supporto per l’ispezione di documenti protetti da policy. Se si tenta di esaminare un documento protetto da policy utilizzando il LiveCycle 8.x (o versione precedente), viene generata un'eccezione.
Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.
Per esaminare un documento PDF protetto da policy, eseguire le operazioni seguenti:
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
Creare un oggetto API client di sicurezza dei documenti
Prima di eseguire un'operazione del servizio Document Security, creare un oggetto client del servizio Document Security. Se utilizzi l’API Java, crea un RightsManagementClient
oggetto. Se utilizzi l’API del servizio Web Document Security, crea un RightsManagementServiceService
oggetto.
Recuperare un documento protetto da policy per ispezionare
Per esaminare un documento protetto da policy, recuperarlo. Se si tenta di controllare un documento non protetto con un criterio o revocato, viene generata un'eccezione.
Inspect il documento
Dopo aver recuperato un documento protetto da policy, è possibile esaminarlo.
Ottenere informazioni sul documento protetto tramite policy
Dopo aver esaminato un documento PDF protetto da policy, è possibile ottenere informazioni su di esso. Ad esempio, è possibile determinare il criterio utilizzato per proteggere il documento.
Se proteggi un documento con un criterio che appartiene a Criteri personali, chiama RMInspectResult.getPolicysetName
o RMInspectResult.getPolicysetId
, viene restituito null.
Se il documento è protetto utilizzando un criterio contenuto in un set di criteri (diverso da Criteri personali), allora RMInspectResult.getPolicysetName
e RMInspectResult.getPolicysetId
restituisce stringhe valide.
Consulta anche
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Inspect è un documento PDF protetto da policy utilizzando l’API del servizio Document Security (Java):
Includi file di progetto.
Includi file JAR client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java. Per informazioni sulla posizione di questi file, vedi Inclusione dei file libreria Java di AEM Forms.
Creare un oggetto API client Document Security.
ServiceClientFactory
oggetto contenente le proprietà di connessione. (Vedi Impostazione delle proprietà di connessione.)RightsManagementClient
utilizzando il relativo costruttore e passando ServiceClientFactory
oggetto.Recuperare un documento protetto da policy da esaminare.
java.io.FileInputStream
oggetto che rappresenta il documento PDF protetto da policy utilizzando il relativo costruttore. Passa un valore stringa che specifica la posizione del documento PDF.com.adobe.idp.Document
utilizzando il relativo costruttore e passando java.io.FileInputStream
oggetto.Inspect il documento.
DocumentManager
richiamando l'oggetto RightsManagementClient
dell’oggetto getDocumentManager
metodo .LicenseManager
dell’oggetto inspectDocument
metodo . Passa la com.adobe.idp.Document
oggetto contenente il documento PDF protetto da policy. Questo metodo restituisce un RMInspectResult
oggetto contenente informazioni sul documento protetto tramite criterio.Ottenere informazioni sul documento protetto tramite criterio.
Per ottenere informazioni sul documento protetto tramite criterio, invocare il metodo appropriato di appartenenza RMInspectResult
oggetto. Ad esempio, per recuperare il nome del criterio, richiama il RMInspectResult
dell’oggetto getPolicyName
metodo .
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
Inspect è un documento PDF protetto da policy utilizzando l’API del servizio Document Security (servizio Web):
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms.
Creare un oggetto API client Document Security.
Crea un RightsManagementServiceClient
utilizzando il relativo costruttore predefinito.
Crea un RightsManagementServiceClient.Endpoint.Address
utilizzando System.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Non è necessario utilizzare il lc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
Crea un System.ServiceModel.BasicHttpBinding
ottenendo il valore del RightsManagementServiceClient.Endpoint.Binding
campo . Imposta il valore restituito su BasicHttpBinding
.
Imposta la System.ServiceModel.BasicHttpBinding
dell’oggetto MessageEncoding
campo a WSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM.
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Recuperare un documento protetto da policy da esaminare.
BLOB
utilizzando il relativo costruttore. La BLOB
viene utilizzato per memorizzare un documento PDF da esaminare.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.System.IO.FileStream
oggetto. È possibile determinare le dimensioni dell'array di byte ottenendo il System.IO.FileStream
dell’oggetto Length
proprietà.System.IO.FileStream
dell’oggetto Read
metodo . Passa la matrice byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
oggetto assegnando il relativo MTOM
con il contenuto dell'array di byte.Inspect il documento.
Inspect è il documento protetto da policy richiamando il RightsManagementServiceClient
dell’oggetto inspectDocument
metodo . Passa la BLOB
oggetto contenente il documento PDF protetto da policy. Questo metodo restituisce un RMInspectResult
oggetto contenente informazioni sul documento protetto tramite criterio.
Ottenere informazioni sul documento protetto tramite criterio.
Per ottenere informazioni sul documento protetto tramite criterio, ottenere il valore del campo appropriato che appartiene al RMInspectResult
oggetto. Ad esempio, per recuperare il nome del criterio, ottieni il valore del RMInspectResult
dell’oggetto policyName
campo .
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
Le filigrane consentono di garantire la sicurezza di un documento identificando in modo univoco il documento e controllando la violazione del copyright. Ad esempio, è possibile creare e posizionare una filigrana che indichi Riservato in tutte le pagine di un documento. Una volta creata una filigrana, puoi includerla come parte di un criterio. In altre parole, puoi impostare l’attributo della filigrana del criterio con la filigrana appena creata. Dopo che un criterio contenente una filigrana viene applicato a un documento, la filigrana viene visualizzata nel documento protetto tramite criterio.
Solo gli utenti con privilegi amministrativi di Document Security possono creare filigrane. In altre parole, è necessario specificare tale utente quando si definiscono le impostazioni di connessione necessarie per creare un oggetto client del servizio Document Security.
Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.
Per creare una filigrana, effettua le seguenti operazioni:
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
Creare un oggetto API client di sicurezza dei documenti
Prima di poter eseguire un'operazione del servizio Document Security, è necessario creare un oggetto client del servizio Document Security. Se utilizzi l’API Java, crea un RightsManagementClient
oggetto. Se utilizzi l’API del servizio Web Document Security, crea un RightsManagementServiceService
oggetto.
Impostare gli attributi delle filigrane
Per creare una nuova filigrana, è necessario impostare gli attributi della filigrana. L'attributo name deve sempre essere definito. Oltre all'attributo name, è necessario impostare almeno uno dei seguenti attributi:
Nella tabella seguente sono elencate le coppie chiave-valore richieste per la creazione di una filigrana utilizzando i servizi Web.
Nome chiave |
Descrizione |
Valore |
---|---|---|
|
Specifica se il nome utente dell'utente che apre il documento fa parte della filigrana. |
True o False |
|
Specifica se l'identificazione dell'utente che apre il documento fa parte della filigrana. |
True o False |
|
Specifica se la data corrente fa parte della filigrana. |
True o False |
|
Se questo valore è true, è necessario specificare il valore del testo personalizzato utilizzando |
True o False |
|
Specifica l'opacità della filigrana. Il valore predefinito è 0,5 se non è specificato. |
Un valore compreso tra 0,0 e 1,0. |
|
Specifica la rotazione della filigrana. Il valore predefinito è 0 gradi. |
Un valore compreso tra 0 e 359. |
|
Se questo valore viene specificato, allora |
Un valore maggiore di 0,0 e minore o uguale a 1,0. |
|
Specifica l’allineamento orizzontale della filigrana. Il valore predefinito è center. |
a sinistra, al centro o a destra |
|
Specifica l’allineamento verticale della filigrana. Il valore predefinito è center. |
superiore, centrale o inferiore |
|
Specifica se la filigrana è di sfondo. Il valore predefinito è false. |
True o False |
|
True se è specificata una scala personalizzata. Se questo valore è true, è necessario specificare anche SCALE . Se questo valore è false, il valore predefinito è fit to page. |
True o False |
|
Specifica il testo personalizzato per una filigrana. Se questo valore è presente, allora |
True o False |
Tutte le filigrane devono avere uno dei seguenti attributi definiti:
WaterBackCmd:IS_USERNAME_ENABLED
WaterBackCmd:IS_USERID_ENABLED
WaterBackCmd:IS_CURRENTDATE_ENABLED
WaterBackCmd:IS_CUSTOMTEXT_ENABLED
Tutti gli altri attributi sono facoltativi.
Registra la filigrana
Prima di poter essere utilizzato, è necessario registrare una nuova filigrana con il servizio Document Security. Dopo aver registrato una filigrana, puoi utilizzarla all’interno dei criteri.
Consulta anche
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Applicazione dei criteri ai documenti PDF
Crea una filigrana utilizzando l’API Document Security (Java):
Includi file di progetto.
Includi file JAR client, ad esempio adobe-rightsmanagement-client.jar
, nel percorso classe del progetto Java.
Creare un oggetto API client Document Security.
ServiceClientFactory
oggetto contenente le proprietà di connessione.RightsManagementClient
utilizzando il relativo costruttore e passando ServiceClientFactory
oggetto.Impostare gli attributi della filigrana
Watermark
richiamando l'oggetto InfomodelObjectFactory
statico dell’oggetto createWatermark
metodo . Questo metodo restituisce un Watermark
oggetto.Watermark
dell’oggetto setName
e passare un valore stringa che specifica il nome del criterio.Watermark
dell’oggetto setBackground
metodo e passaggio true
. Impostando questo attributo, la filigrana viene visualizzata sullo sfondo del documento.Watermark
dell’oggetto setCustomText
e passare un valore stringa che rappresenta il testo della filigrana.Watermark
dell’oggetto setOpacity
e passare un valore intero che specifica il livello di opacità. Il valore 100 indica che la filigrana è completamente opaca e il valore 0 indica che la filigrana è completamente trasparente.Registra la filigrana.
WatermarkManager
richiamando l'oggetto RightsManagementClient
dell’oggetto getWatermarkManager
metodo . Questo metodo restituisce un WatermarkManager
oggetto.WatermarkManager
dell’oggetto registerWatermark
e passare Watermark
oggetto che rappresenta la filigrana da registrare. Questo metodo restituisce un valore di stringa che rappresenta il valore di identificazione della filigrana.Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
Crea una filigrana utilizzando l’API Document Security (servizio Web):
Creare un oggetto API client Document Security.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms.
Creare un oggetto API client Document Security.
Crea un RightsManagementServiceClient
utilizzando il relativo costruttore predefinito.
Crea un RightsManagementServiceClient.Endpoint.Address
utilizzando System.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Non è necessario utilizzare il lc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
Crea un System.ServiceModel.BasicHttpBinding
ottenendo il valore del RightsManagementServiceClient.Endpoint.Binding
campo . Imposta il valore restituito su BasicHttpBinding
.
Imposta la System.ServiceModel.BasicHttpBinding
dell’oggetto MessageEncoding
campo a WSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM.
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Impostare gli attributi della filigrana.
WatermarkSpec
richiamando l'oggetto WatermarkSpec
costruttore.WatermarkSpec
dell’oggetto name
membro dati.id
assegnando un valore stringa a WatermarkSpec
dell’oggetto id
membro dati.MyMapOf_xsd_string_To_xsd_anyType_Item
oggetto.MyMapOf_xsd_string_To_xsd_anyType_Item
dell’oggetto key
membro dati (ad esempio, WaterBackCmd:OPACITY)
.MyMapOf_xsd_string_To_xsd_anyType_Item
dell’oggetto value
membro dati (ad esempio, .25
).MyArrayOf_xsd_anyType
oggetto. Per ogni MyMapOf_xsd_string_To_xsd_anyType_Item
oggetto, richiamare MyArrayOf_xsd_anyType
dell’oggetto Add
metodo . Passa la MyMapOf_xsd_string_To_xsd_anyType_Item
oggetto.MyArrayOf_xsd_anyType
dell'oggetto WatermarkSpec
dell’oggetto values
membro dati.Registra la filigrana.
Registra la filigrana richiamando il RightsManagementServiceClient
dell’oggetto registerWatermark
e passare WatermarkSpec
oggetto che rappresenta la filigrana da registrare.
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
Puoi modificare una filigrana esistente utilizzando l’API Java per la sicurezza dei documenti o l’API del servizio Web. Per apportare modifiche a una filigrana esistente, recuperarla, modificarne gli attributi e quindi aggiornarla sul server. Ad esempio, si supponga di recuperare una filigrana e di modificarne l’attributo di opacità. Prima che la modifica abbia effetto, è necessario aggiornare la filigrana.
Quando si modifica una filigrana, la modifica ha effetto sui documenti futuri a cui viene applicata la filigrana. In altre parole, i documenti PDF esistenti che contengono la filigrana non sono interessati.
Solo gli utenti con privilegi amministrativi di Document Security possono modificare i watermark. In altre parole, è necessario specificare tale utente quando si definiscono le impostazioni di connessione necessarie per creare un oggetto client del servizio Document Security.
Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.
Per modificare una filigrana, effettua le seguenti operazioni:
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
Creare un oggetto API client di sicurezza dei documenti
Prima di poter eseguire un'operazione del servizio Document Security, è necessario creare un oggetto client del servizio Document Security. Se utilizzi l’API Java, crea un 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 recuperare una filigrana esistente. È possibile recuperare una filigrana specificandone il nome o specificandone il valore di identificazione.
Impostare gli attributi delle filigrane
Per modificare una filigrana esistente, modificare il valore di uno o più attributi di filigrana. Quando aggiorni in modo programmatico una filigrana utilizzando un servizio Web, è necessario impostare tutti gli attributi originariamente impostati, anche se il valore non cambia. Ad esempio, si supponga di aver impostato i seguenti attributi di filigrana: WaterBackCmd:IS_USERID_ENABLED
, WaterBackCmd:IS_CUSTOMTEXT_ENABLED
, WaterBackCmd:OPACITY
e WaterBackCmd:SRCTEXT
. Anche se l'unico attributo che si desidera modificare è WaterBackCmd:OPACITY
, è necessario impostare gli altri valori affinché siano corretti.
Quando utilizzi l’API Java per modificare una filigrana, non devi specificare tutti gli attributi. Impostare l'attributo della filigrana che si desidera modificare.
Per informazioni sui nomi degli attributi della filigrana, vedi Creazione di filigrane.
Aggiorna la filigrana
Dopo aver modificato gli attributi di una filigrana, è necessario aggiornare la filigrana.
Consulta anche
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Modificare una filigrana utilizzando l’API Document Security (Java):
Includi file di progetto.
Includi file JAR client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto API client Document Security.
ServiceClientFactory
oggetto contenente le proprietà di connessione.DocumentSecurityClient
utilizzando il relativo costruttore e passando ServiceClientFactory
oggetto.Recupera la filigrana da modificare.
Crea un WatermarkManager
richiamando l'oggetto DocumentSecurityClient
dell’oggetto getWatermarkManager
e passare un valore stringa che specifica il nome della filigrana. Questo metodo restituisce un Watermark
oggetto che rappresenta la filigrana da modificare.
Impostare gli attributi della filigrana.
Imposta l’attributo di opacità della filigrana richiamando il Watermark
dell’oggetto setOpacity
e passare un valore intero che specifica il livello di opacità. Il valore 100 indica che la filigrana è completamente opaca e il valore 0 indica che la filigrana è completamente trasparente.
In questo esempio viene modificato solo l'attributo opacity.
Aggiorna la filigrana.
WatermarkManager
dell’oggetto updateWatermark
e passare il Watermark
oggetto il cui attributo è stato modificato.Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere Avvio rapido (modalità SOAP): Modifica di una filigrana utilizzando la sezione Java API .
Modificare una filigrana utilizzando l'API Document Security (servizio Web):
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms.
Creare un oggetto API client Document Security.
Crea un DocumentSecurityServiceClient
utilizzando il relativo costruttore predefinito.
Crea un RightsManagementServiceClient.Endpoint.Address
utilizzando System.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/DocumentSecurityService?WSDL
.) Non è necessario utilizzare il lc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
Crea un System.ServiceModel.BasicHttpBinding
ottenendo il valore del DocumentSecurityServiceClient.Endpoint.Binding
campo . Imposta il valore restituito su BasicHttpBinding
.
Imposta la System.ServiceModel.BasicHttpBinding
dell’oggetto MessageEncoding
campo a WSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM.
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Recupera la filigrana da modificare.
Recupera la filigrana da modificare richiamando il DocumentSecurityServiceClient
dell’oggetto getWatermarkByName
metodo . Passa un valore stringa che specifica il nome della filigrana. Questo metodo restituisce un WatermarkSpec
oggetto che rappresenta la filigrana da modificare.
Impostare gli attributi della filigrana.
MyMapOf_xsd_string_To_xsd_anyType_Item
oggetto.MyMapOf_xsd_string_To_xsd_anyType_Item
dell’oggetto key
membro dati (ad esempio, WaterBackCmd:OPACITY)
.MyMapOf_xsd_string_To_xsd_anyType_Item
dell’oggetto value
membro dati (ad esempio, .50
).MyArrayOf_xsd_anyType
oggetto. Per ogni MyMapOf_xsd_string_To_xsd_anyType_Item
oggetto, richiamare MyArrayOf_xsd_anyType
dell’oggetto Add
metodo . Passa la MyMapOf_xsd_string_To_xsd_anyType_Item
oggetto.MyArrayOf_xsd_anyType
dell'oggetto WatermarkSpec
dell’oggetto values
membro dati.Aggiorna la filigrana.
Aggiorna la filigrana richiamando il DocumentSecurityServiceClient
dell’oggetto updateWatermark
e passare WatermarkSpec
oggetto che rappresenta la filigrana da modificare.
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere la seguente Guida rapida:
Il servizio di Rights Management tiene traccia delle azioni specifiche che si verificano, ad esempio l'applicazione di un criterio a un documento, l'apertura di un documento protetto da policy e la revoca dell'accesso ai documenti. Il controllo degli eventi deve essere abilitato per il servizio di Rights Management, altrimenti gli eventi non vengono tracciati.
Gli eventi rientrano in una delle seguenti categorie:
Puoi cercare eventi specifici utilizzando l’API Java di Rights Management o l’API del servizio Web. Cercando gli eventi, è possibile eseguire attività quali la creazione di un file di registro di determinati eventi.
Per ulteriori informazioni sul servizio di Rights Management, vedi Riferimento servizi per AEM Forms.
Per cercare un evento di Rights Management, esegui le seguenti operazioni:
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
Creare un oggetto API client Rights Management
Prima di poter eseguire un'operazione di servizio di Rights Management a livello di programmazione, è necessario creare un oggetto client di servizio di Rights Management. Se utilizzi l’API Java, crea un DocumentSecurityClient
oggetto. Se utilizzi l’API del servizio Web di Rights Management, crea un DocumentSecurityServiceService
oggetto.
Specifica gli eventi da cercare
È necessario specificare l’evento da cercare. Ad esempio, è possibile cercare l'evento di creazione del criterio, che si verifica quando viene creato un nuovo criterio.
Cerca l’evento
Dopo aver specificato l’evento da cercare, puoi utilizzare l’API Java di Rights Management o l’API del servizio Web di Rights Management per cercare l’evento.
Consulta anche
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Cerca eventi utilizzando l’API di Rights Management (Java):
Includi file di progetto
Includi file JAR client, come adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto API client Rights Management
Crea un DocumentSecurityClient
utilizzando il relativo costruttore e passando un ServiceClientFactory
oggetto contenente le proprietà di connessione.
Specifica gli eventi da cercare
EventManager
richiamando l'oggetto DocumentSecurityClient
dell’oggetto getEventManager
metodo . Questo metodo restituisce un EventManager
oggetto.EventSearchFilter
richiamando il relativo costruttore.EventSearchFilter
dell’oggetto setEventCode
e passare un membro di dati statici appartenente al gruppo EventManager
Classe che rappresenta l'evento di cui eseguire la ricerca. Ad esempio, per cercare l'evento di creazione del criterio, passare EventManager.POLICY_CREATE_EVENT
.Puoi definire criteri di ricerca aggiuntivi richiamando EventSearchFilter
metodi oggetto. Ad esempio, richiama il setUserName
per specificare un utente associato all'evento.
Cerca l’evento
Cerca l’evento richiamando il EventManager
dell’oggetto searchForEvents
e passare EventSearchFilter
oggetto che definisce i criteri di ricerca degli eventi. Questo metodo restituisce un array di Event
oggetti.
Esempi di codice
Per esempi di codice che utilizzano il servizio di Rights Management, consulta i seguenti Quick Starts:
Cerca eventi utilizzando l’API di Rights Management (servizio Web):
Includi file di progetto
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms.
Creare un oggetto API client Rights Management
Crea un DocumentSecurityServiceClient
utilizzando il relativo costruttore predefinito.
Crea un DocumentSecurityServiceClient.Endpoint.Address
utilizzando System.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Non è necessario utilizzare il lc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
Crea un System.ServiceModel.BasicHttpBinding
ottenendo il valore del DocumentSecurityServiceClient.Endpoint.Binding
campo . Imposta il valore restituito su BasicHttpBinding
.
Imposta la System.ServiceModel.BasicHttpBinding
dell’oggetto MessageEncoding
campo a WSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM.
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Specifica gli eventi da cercare
EventSpec
utilizzando il relativo costruttore.EventSpec
dell’oggetto firstTime.date
membro con DataTime
istanza che rappresenta l’inizio dell’intervallo di date in cui si è verificato l’evento.true
al EventSpec
dell’oggetto firstTime.dateSpecified
membro dati.EventSpec
dell’oggetto lastTime.date
membro con DataTime
istanza che rappresenta la fine dell’intervallo di date in cui si è verificato l’evento.true
al EventSpec
dell’oggetto lastTime.dateSpecified
membro dati.EventSpec
dell’oggetto eventCode
membro dati. Nella tabella seguente sono elencati i valori numerici che è possibile assegnare a questa proprietà:Tipo evento |
Valore |
---|---|
|
999 |
|
1000 |
|
1001 |
|
1002 |
|
1003 |
|
1004 |
|
1005 |
|
1006 |
|
1007 |
|
1008 |
|
1009 |
|
2000 |
|
2001 |
|
2002 |
|
2003 |
|
2004 |
|
2005 |
|
2006 |
|
2007 |
|
2008 |
|
2009 |
|
2010 |
|
2011 |
|
2012 |
|
2013 |
|
2014 |
|
3000 |
|
3001 |
|
3002 |
|
3003 |
|
3004 |
|
3005 |
|
4000 |
|
4001 |
|
4002 |
|
4003 |
|
4004 |
|
4005 |
|
5000 |
|
5001 |
|
5002 |
|
5003 |
|
5004 |
|
6000 |
|
7000 |
|
7001 |
|
7002 |
Cerca l’evento
Cerca l’evento richiamando il DocumentSecurityServiceClient
dell’oggetto searchForEvents
e passare EventSpec
oggetto che rappresenta l'evento per il quale eseguire la ricerca e il numero massimo di risultati. Questo metodo restituisce un MyArrayOf_xsd_anyType
raccolta in cui ogni elemento è un AuditSpec
istanza. Utilizzo di un AuditSpec
ad esempio, puoi ottenere informazioni sull’evento, ad esempio l’ora in cui si è verificato. La AuditSpec
l'istanza contiene timestamp
membro dati che specifica queste informazioni.
Esempi di codice
Per esempi di codice che utilizzano il servizio di Rights Management, consulta i seguenti Quick Starts:
Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
Oltre ai documenti PDF, il servizio Rights Management supporta formati di documenti aggiuntivi, ad esempio un documento Microsoft Word (file DOC) e altri formati di file Microsoft Office. Ad esempio, è possibile applicare un criterio a un documento Word per proteggerlo. Applicando un criterio a un documento Word, si limita l'accesso al documento. Non è possibile applicare un criterio a un documento se il documento è già protetto con un criterio.
È possibile monitorare l'utilizzo di un documento Word protetto da policy dopo averlo distribuito. In altre parole, puoi vedere come viene utilizzato il documento e chi lo sta utilizzando. Ad esempio, puoi scoprire quando qualcuno ha aperto il documento.
Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.
Per applicare un criterio a un documento Word, eseguire le operazioni seguenti:
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
Creare un oggetto API client Document Security
Prima di poter eseguire un'operazione del servizio Document Security, è necessario creare un oggetto client del servizio Document Security.
Recupera un documento di Word
È necessario recuperare un documento di Word per applicare un criterio. Dopo aver applicato un criterio al documento Word, gli utenti vengono limitati quando utilizzano il documento. Ad esempio, se il criterio non consente l'apertura del documento in modalità non in linea, per aprire il documento gli utenti devono essere in linea.
Applicare un criterio esistente al documento Word
Per applicare un criterio a un documento di Word, è necessario fare riferimento a un criterio esistente e specificare il set di criteri a cui appartiene il criterio. L'utente che sta impostando le proprietà di connessione deve avere accesso al criterio specificato. In caso contrario, si verifica un'eccezione.
Salva il documento Word
Dopo aver applicato un criterio a un documento Word, è possibile salvare il documento Word protetto da policy come file DOC.
Consulta anche
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Revoca dell’accesso ai documenti
Applicare un criterio a un documento Word utilizzando l'API Document Security (Java):
Includi file di progetto.
Includi file JAR client, come adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto API client Document Security.
ServiceClientFactory
oggetto contenente le proprietà di connessione.DocumentSecurityClient
utilizzando il relativo costruttore e passando ServiceClientFactory
oggetto.Recuperare un documento Word.
java.io.FileInputStream
oggetto che rappresenta il documento di Word utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento di Word.com.adobe.idp.Document
utilizzando il relativo costruttore e passando java.io.FileInputStream
oggetto.Applicare un criterio esistente al documento Word.
Crea un DocumentManager
richiamando l'oggetto DocumentSecurityClient
dell’oggetto getDocumentManager
metodo .
Applicare un criterio al documento Word richiamando il DocumentManager
dell’oggetto protectDocument
e passando i seguenti valori:
com.adobe.idp.Document
oggetto che contiene il documento Word a cui viene applicato il criterio.null
che restituisce MyPolicies
set di criteri in uso.null
(se questo parametro è null
, il valore del parametro precedente deve essere null
).com.adobe.livecycle.rightsmanagement.Locale
che rappresenta le impostazioni internazionali utilizzate per selezionare il modello di MS Office. Questo valore del parametro è facoltativo e puoi specificare null
.La protectDocument
restituisce un RMSecureDocumentResult
oggetto contenente il documento Word protetto da policy.
Salvare il documento Word.
RMSecureDocumentResult
dell’oggetto getProtectedDoc
per ottenere il documento Word protetto da policy. Questo metodo restituisce un com.adobe.idp.Document
oggetto.java.io.File
e assicurati che l'estensione del file sia DOC.com.adobe.idp.Document
dell’oggetto copyToFile
per copiare il contenuto del Document
al file (assicurati di utilizzare Document
oggetto restituito da getProtectedDoc
metodo).Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere la seguente Guida rapida:
Applicare un criterio a un documento Word utilizzando l'API Document Security (servizio Web):
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/DocumentSecurityService?WSDL&lc_version=9.0.1
.
Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms.
Creare un oggetto API client Document Security.
Crea un DocumentSecurityServiceClient
utilizzando il relativo costruttore predefinito.
Crea un DocumentSecurityServiceClient.Endpoint.Address
utilizzando System.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/DocumentSecurityService?WSDL
.) Non è necessario utilizzare il lc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
Crea un System.ServiceModel.BasicHttpBinding
ottenendo il valore del DocumentSecurityServiceClient.Endpoint.Binding
campo . Imposta il valore restituito su BasicHttpBinding
.
Imposta la System.ServiceModel.BasicHttpBinding
dell’oggetto MessageEncoding
campo a WSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM.
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Recuperare un documento Word.
BLOB
utilizzando il relativo costruttore. La BLOB
viene utilizzato per memorizzare un documento di Word a cui viene applicato un criterio.System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento di Word e la modalità di apertura del file.System.IO.FileStream
oggetto. Determina la dimensione dell'array di byte ottenendo il System.IO.FileStream
dell’oggetto Length
proprietà.System.IO.FileStream
dell’oggetto Read
metodo . Passa la matrice dei byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
oggetto assegnando il relativo MTOM
con il contenuto dell'array di byte.Applicare un criterio esistente al documento Word.
Applicare un criterio al documento Word richiamando il DocumentSecurityServiceClient
dell’oggetto protectDocument
e passando i seguenti valori:
BLOB
oggetto che contiene il documento Word a cui viene applicato il criterio.null
che restituisce MyPolicies
set di criteri in uso.null
).null
).RMLocale
valore che specifica il valore delle impostazioni internazionali (ad esempio, RMLocale.en
).application/doc
).La protectDocument
restituisce un BLOB
oggetto contenente il documento Word protetto da policy.
Salvare il documento Word.
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento Word protetto da policy.BLOB
oggetto restituito da protectDocument
metodo . Compilare l’array di byte ottenendo il valore del BLOB
dell’oggetto MTOM
membro dati.System.IO.BinaryWriter
richiamando il relativo costruttore e passando System.IO.FileStream
oggetto.System.IO.BinaryWriter
dell’oggetto Write
e passare l'array di byte.Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere la seguente Guida rapida:
È possibile rimuovere un criterio da un documento Word protetto da criteri per rimuovere la protezione dal documento. In altre parole, se non si desidera più che il documento sia protetto da una politica. Se si desidera aggiornare un documento Word protetto da policy con un criterio più recente, invece di rimuovere il criterio e aggiungere il criterio aggiornato, è più efficiente cambiare il criterio.
Per ulteriori informazioni sul servizio Document Security, vedere Riferimento servizi per AEM Forms.
Per rimuovere un criterio da un documento Word protetto da policy, eseguire le operazioni seguenti:
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
Creare un oggetto API client di sicurezza dei documenti
Prima di eseguire un'operazione del servizio Document Security, creare un oggetto client del servizio Document Security.
Recuperare un documento Word protetto da policy
Per rimuovere un criterio, è necessario recuperare un documento Word protetto da policy. Se si tenta di rimuovere un criterio da un documento di Word non protetto da un criterio, verrà generata un'eccezione.
Rimuovi il criterio dal documento Word
È possibile rimuovere un criterio da un documento Word protetto da criteri purché nelle impostazioni di connessione sia specificato un amministratore. In caso contrario, il criterio utilizzato per proteggere un documento deve contenere SWITCH_POLICY
per rimuovere un criterio da un documento di Word. Inoltre, anche l’utente specificato nelle impostazioni di connessione di AEM Forms deve disporre di tale autorizzazione. In caso contrario, viene generata un'eccezione.
Salvare il documento Word non protetto
Dopo che il servizio Document Security rimuove un criterio da un documento Word, è possibile salvare il documento Word non protetto come file DOC.
Consulta anche
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Applicazione dei criteri ai documenti di Word
Rimuovere un criterio da un documento Word protetto da policy utilizzando l'API Document Security (Java):
Includi file di progetto
Includi file JAR client, come adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto API client di sicurezza dei documenti
ServiceClientFactory
oggetto contenente le proprietà di connessione.RightsManagementClient
utilizzando il relativo costruttore e passando ServiceClientFactory
oggetto.Recuperare un documento Word protetto da policy
java.io.FileInputStream
oggetto che rappresenta il documento Word protetto da policy utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento Word.com.adobe.idp.Document
utilizzando il relativo costruttore e passando java.io.FileInputStream
oggetto.Rimuovi il criterio dal documento Word
DocumentManager
richiamando l'oggetto RightsManagementClient
dell’oggetto getDocumentManager
metodo .DocumentManager
dell’oggetto removeSecurity
e passare com.adobe.idp.Document
oggetto contenente il documento Word protetto da policy. Questo metodo restituisce un com.adobe.idp.Document
oggetto contenente un documento Word non protetto.Salvare il documento Word non protetto
java.io.File
e assicurati che l'estensione del file sia DOC.Document
dell’oggetto copyToFile
per copiare il contenuto del Document
al file (assicurati di utilizzare Document
oggetto restituito da removeSecurity
metodo).Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere la seguente Guida rapida:
Rimuovere un criterio da un documento Word protetto da policy utilizzando l'API Document Security (servizio Web):
Includi file di progetto
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms.
Creare un oggetto API client di sicurezza dei documenti
Crea un RightsManagementServiceClient
utilizzando il relativo costruttore predefinito.
Crea un RightsManagementServiceClient.Endpoint.Address
utilizzando System.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Non è necessario utilizzare il lc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
Crea un System.ServiceModel.BasicHttpBinding
ottenendo il valore del RightsManagementServiceClient.Endpoint.Binding
campo . Imposta il valore restituito su BasicHttpBinding
.
Imposta la System.ServiceModel.BasicHttpBinding
dell’oggetto MessageEncoding
campo a WSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM.
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Recuperare un documento Word protetto da policy
BLOB
utilizzando il relativo costruttore. La BLOB
l'oggetto viene utilizzato per memorizzare il documento Word protetto dai criteri da cui viene rimosso il criterio.System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento di Word e la modalità di apertura del file.System.IO.FileStream
oggetto. È possibile determinare le dimensioni dell'array di byte ottenendo il System.IO.FileStream
dell’oggetto Length
proprietà.System.IO.FileStream
dell’oggetto Read
e passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
oggetto assegnando il relativo MTOM
con il contenuto dell'array di byte.Rimuovi il criterio dal documento Word
Rimuovere il criterio dal documento Word richiamando il RightsManagementServiceClient
dell’oggetto removePolicySecurity
e passare BLOB
oggetto contenente il documento Word protetto da policy. Questo metodo restituisce un BLOB
oggetto contenente un documento Word non protetto.
Salvare il documento Word non protetto
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento Word non protetto.BLOB
oggetto restituito da removePolicySecurity
metodo . Compilare l’array di byte ottenendo il valore del BLOB
dell’oggetto MTOM
campo .System.IO.BinaryWriter
richiamando il relativo costruttore e passando System.IO.FileStream
oggetto.Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere la seguente Guida rapida:
Consulta anche
Richiamo di AEM Forms tramite MTOM