Protezione dei documenti con i criteri protecting-documents-with-policies
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:
- File di Microsoft Office 2003 (file DOC, XLS, PPT)
- File Microsoft Office 2007 (DOCX, XLSX, file PPTX)
- File Pro/E PTC
Per chiarezza, le due sezioni seguenti illustrano come utilizzare i documenti di Word:
È possibile eseguire queste operazioni utilizzando il servizio Document Security:
- Creare criteri. Per informazioni, consulta Creazione di criteri.
- Modificare i criteri. Per informazioni, consulta Modifica dei criteri.
- Elimina criteri. Per informazioni, consulta Eliminazione dei criteri.
- Applicare criteri ai documenti PDF. Per informazioni, consulta Applicazione dei criteri ai documenti PDF.
- Rimuovere i criteri dai documenti PDF. Per informazioni, consulta Rimozione di criteri dai documenti di PDF.
- Documenti protetti da policy Inspect. Per informazioni, consulta Ispezione dei documenti PDF protetti.
- Revoca l’accesso ai documenti PDF. Per informazioni, consulta Revoca dell’accesso ai documenti.
- Ripristino dell'accesso ai documenti revocati. Per informazioni, consulta Ripristino dell'accesso ai documenti revisionati.
- Creare filigrane. Per informazioni, consulta Creazione di filigrane.
- Cerca eventi. Per informazioni, consulta Ricerca di eventi.
Creazione di criteri creating-policies
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:
- Specificare gli utenti che possono aprire il documento. I destinatari possono appartenere o essere esterni alla tua organizzazione.
- Specifica come i destinatari possono utilizzare il documento. Puoi limitare l’accesso a diverse funzioni di Acrobat e Adobe Reader. Queste funzioni includono la possibilità di stampare e copiare testo, aggiungere firme e aggiungere commenti a un documento.
- Modificare le impostazioni di accesso e protezione in qualsiasi momento, anche dopo la distribuzione del documento protetto tramite criterio.
- Monitora l'utilizzo del documento dopo la distribuzione. È possibile vedere come viene utilizzato il documento e chi lo utilizza. Ad esempio, è possibile verificare quando un utente ha aperto il documento.
Creazione di un criterio tramite i servizi web creating-a-policy-using-web-services
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>
Riepilogo dei passaggi summary-of-steps
Per creare un criterio, effettua le seguenti operazioni:
- Includi file di progetto.
- Creare un oggetto API client Document Security.
- Imposta gli attributi del criterio.
- Crea una voce di criterio.
- Registra il criterio.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
- adobe-rightsmanagement-client.jar
- namespace.jar (se AEM Forms è implementato su JBoss)
- jaxb-api.jar (se AEM Forms è implementato su JBoss)
- jaxb-impl.jar (se AEM Forms è implementato su JBoss)
- jaxb-libs.jar (se AEM Forms è implementato su JBoss)
- jaxb-xjc.jar (se AEM Forms è implementato su JBoss)
- relaxngDatype.jar (se AEM Forms è implementato su JBoss)
- xsdlib.jar (se AEM Forms è implementato su JBoss)
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-utilities.jar
- jbossall-client.jar (usa un file JAR diverso se AEM Forms non è distribuito su JBoss)
Per informazioni sulla posizione di questi file JAR, 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:
- Un numero impostato di giorni in cui il documento è accessibile dal momento in cui viene pubblicato
- Data di fine dopo la quale il documento non è accessibile
- Un intervallo di date specifico per il quale il documento è accessibile
- Sempre valido
È possibile specificare solo una data di inizio, che fa sì che il criterio sia valido dopo la data di inizio. Se specifichi solo una data di fine, il criterio è valido fino alla data di fine. Tuttavia, viene generata un’eccezione se non sono definite sia una data di inizio che una data di fine.
Quando si impostano gli attributi che appartengono a un criterio, è anche possibile impostare le impostazioni di crittografia. Queste impostazioni di crittografia hanno effetto quando il criterio viene applicato a un documento. È possibile specificare i seguenti valori di crittografia:
- AES256: Rappresenta l’algoritmo di crittografia AES con una chiave a 256 bit.
- AES128: Rappresenta l’algoritmo di crittografia AES con una chiave a 128 bit.
- NoEncryption: Non rappresenta la cifratura.
Quando si specifica la variabile NoEncryption non è possibile impostare PlaintextMetadata opzione per false. Se tenti di farlo, viene generata un'eccezione.
Policy descrizione dell’interfaccia in Riferimento API di AEM Forms.Creare una voce di criterio
Una voce di criterio associa entità principali, che sono gruppi e utenti, e autorizzazioni a un criterio. Un criterio deve avere almeno una voce di criterio. Si supponga, ad esempio, di eseguire le operazioni seguenti:
- Crea e registra una voce di criterio che consente a un gruppo di visualizzare un documento solo mentre è in linea e non consente ai destinatari di copiarlo.
- Allega l'immissione dei criteri al criterio.
- Proteggi un documento con il criterio utilizzando Acrobat.
Queste azioni consentono ai destinatari di visualizzare il documento solo online e non di copiarlo. Il documento rimane protetto fino a quando la protezione non viene rimossa.
Registra il criterio
Prima di poter essere utilizzato, è necessario registrare un nuovo criterio. Dopo aver registrato un criterio, è possibile utilizzarlo per proteggere i documenti.
Creare un criterio utilizzando l’API Java create-a-policy-using-the-java-api
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.
- Crea un
ServiceClientFactoryoggetto contenente le proprietà di connessione. - Crea un
DocumentSecurityClientutilizzando il relativo costruttore e passandoServiceClientFactoryoggetto.
- Crea un
-
Imposta gli attributi del criterio.
- Crea un
Policyrichiamando l'oggettoInfomodelObjectFactorystatico dell’oggettocreatePolicymetodo . Questo metodo restituisce unPolicyoggetto. - Imposta l’attributo del nome del criterio richiamando il
Policydell’oggettosetNamee passare un valore stringa che specifica il nome del criterio. - Imposta la descrizione del criterio richiamando il
Policydell’oggettosetDescriptione passare un valore stringa che specifica la descrizione del criterio. - Imposta il criterio a cui appartiene il nuovo criterio richiamando il
Policydell’oggettosetPolicySetNamee passare un valore stringa che specifica il nome del set di criteri. (puoi specificarenullper questo valore di parametro che determina l'aggiunta del criterio al Criteri personali set di criteri). - Crea il periodo di validità del criterio richiamando il
InfomodelObjectFactorystatico dell’oggettocreateValidityPeriodmetodo . Questo metodo restituisce unValidityPeriodoggetto. - Imposta il numero di giorni per i quali un documento protetto da policy è accessibile richiamando il
ValidityPerioddell’oggettosetRelativeExpirationDayse passare un valore intero che specifica il numero di giorni. - Imposta il periodo di validità del criterio richiamando il
Policydell’oggettosetValidityPeriode passareValidityPeriodoggetto.
- Crea un
-
Crea una voce di criterio.
- Crea una voce di criterio richiamando il
InfomodelObjectFactorystatico dell’oggettocreatePolicyEntrymetodo . Questo metodo restituisce unPolicyEntryoggetto. - Specifica le autorizzazioni del criterio richiamando il
InfomodelObjectFactorystatico dell’oggettocreatePermissionmetodo . Passa un membro di dati statici appartenente allaPermissionche rappresenta l'autorizzazione. Questo metodo restituisce unPermissionoggetto. Ad esempio, per aggiungere l’autorizzazione che consente agli utenti di copiare dati da un documento PDF protetto da policy, passarePermission.COPY. (Ripeti questo passaggio per ogni autorizzazione da aggiungere). - Aggiungi l'autorizzazione alla voce del criterio richiamando il
PolicyEntrydell’oggettoaddPermissione passarePermissionoggetto. (Ripeti questo passaggio per ogniPermissionoggetto creato). - Crea l'entità del criterio richiamando il
InfomodelObjectFactorystatico dell’oggettocreateSpecialPrincipalmetodo . Passa un membro dati appartenente allaInfomodelObjectFactoryoggetto che rappresenta l'entità principale. Questo metodo restituisce unPrincipaloggetto. Ad esempio, per aggiungere come principale l’editore del documento, passareInfomodelObjectFactory.PUBLISHER_PRINCIPAL. - Aggiungi l'entità alla voce del criterio richiamando il
PolicyEntrydell’oggettosetPrincipale passarePrincipaloggetto. - Aggiungi la voce del criterio al criterio richiamando il
Policydell’oggettoaddPolicyEntrye passarePolicyEntryoggetto.
- Crea una voce di criterio richiamando il
-
Registra il criterio.
-
Crea un
PolicyManagerrichiamando l'oggettoDocumentSecurityClientdell’oggettogetPolicyManagermetodo . -
Registra il criterio richiamando il
PolicyManagerdell’oggettoregisterPolicye passando i seguenti valori:- La
Policyoggetto che rappresenta il criterio da registrare.
- La
-
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 ilregisterPolicymetodo . Se passi unnullper 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'
registerPolicymetodo 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 ilregisterPolicymetodo .note note NOTE Quando crei un criterio, fai riferimento a un set di criteri esistente. Se si specifica un set di criteri che non esiste, viene generata un'eccezione. -
Per esempi di codice che utilizzano il servizio Document Security, consulta quanto segue:
- "Avvio rapido (modalità SOAP): Creazione di un criterio tramite l’API Java"
Creare un criterio utilizzando l’API del servizio Web create-a-policy-using-the-web-service-api
Crea 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.note note NOTE Sostituisci localhostcon l’indirizzo IP del server che ospita AEM Forms. -
Creare un oggetto API client Document Security.
-
Crea un
DocumentSecurityServiceClientutilizzando il relativo costruttore predefinito. -
Crea un
DocumentSecurityServiceClient.Endpoint.AddressutilizzandoSystem.ServiceModel.EndpointAddresscostruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/RightsManagementService?WSDL.) Non è necessario utilizzare illc_versionattributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Crea un
System.ServiceModel.BasicHttpBindingottenendo il valore delRightsManagementServiceClient.Endpoint.Bindingcampo . Imposta il valore restituito suBasicHttpBinding. -
Imposta la
System.ServiceModel.BasicHttpBindingdell’oggettoMessageEncodingcampo aWSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente del modulo di AEM al campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName. - Assegna il valore della password corrispondente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password. - Assegna il valore costante
HttpClientCredentialType.Basical campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Assegnare il nome utente del modulo di AEM al campo
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnlyal campoBasicHttpBindingSecurity.Security.Mode.
-
-
Imposta gli attributi del criterio.
- Crea un
PolicySpecutilizzando il relativo costruttore. - Imposta il nome del criterio assegnando un valore stringa al
PolicySpecdell’oggettonamemembro dati. - Imposta la descrizione del criterio assegnando un valore stringa al
PolicySpecdell’oggettodescriptionmembro dati. - Imposta il criterio a cui appartiene il criterio assegnando un valore stringa al criterio
PolicySpecdell’oggettopolicySetNamemembro dati. È necessario specificare un nome di set di criteri esistente. (puoi specificarenullper questo valore di parametro che determina l'aggiunta del criterio a Criteri personali.) - Imposta il periodo di leasing offline del criterio assegnando un valore intero al
PolicySpecdell’oggettoofflineLeasePeriodmembro dati. - Imposta la
PolicySpecdell’oggettopolicyXmlmembro dati con un valore stringa che rappresenta i dati XML PDRL. Per eseguire questa operazione, creare un file .NETStreamReaderutilizzando il relativo costruttore. Passa la posizione di un file XML PDRL che rappresenta il criterio alStreamReadercostruttore. Quindi, richiama ilStreamReaderdell’oggettoReadLinee assegna il valore restituito a una variabile stringa. Itera attraverso ilStreamReaderfino alReadLinerestituisce null. Assegna la variabile della stringa alla variabilePolicySpecdell’oggettopolicyXmlmembro dati.
- Crea un
-
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
DocumentSecurityServiceClientdell’oggettoregisterPolicye passando i seguenti valori:- La
PolicySpecoggetto che rappresenta il criterio da registrare. - Valore stringa che rappresenta il set di criteri a cui appartiene il criterio. Puoi specificare un
nullche determina l'aggiunta del criterio al MyPolices set di criteri.
Se nelle impostazioni di connessione si utilizza un account amministratore AEM forms per creare
DocumentSecurityClientspecificare il nome del set di criteri quando si richiama l'registerPolicymetodo .Se si utilizza un utente Document SecurityDocument Security all'interno delle impostazioni di connessione, è possibile richiamare l'
registerPolicymetodo 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 ilregisterPolicymetodo .note note NOTE 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. - La
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
- "Avvio rapido (MTOM): Creazione di un criterio tramite l’API del servizio Web"
- "Avvio rapido (SwaRef): Creazione di un criterio tramite l’API del servizio Web"
Modifica dei criteri modifying-policies
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 .
Riepilogo dei passaggi summary_of_steps-1
Per modificare un criterio esistente, esegui i seguenti passaggi:
- Includi file di progetto.
- Creare un oggetto API client Document Security.
- Recupera un criterio esistente.
- Modificare gli attributi dei criteri.
- Aggiorna il criterio.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, 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.
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 i criteri esistenti utilizzando l’API Java modify-existing-policies-using-the-java-api
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.
- Crea un
ServiceClientFactoryoggetto contenente le proprietà di connessione. - Crea un
RightsManagementClientutilizzando il relativo costruttore e passandoServiceClientFactoryoggetto.
- Crea un
-
Recupera un criterio esistente.
-
Crea un
PolicyManagerrichiamando l'oggettoRightsManagementClientdell’oggettogetPolicyManagermetodo . -
Crea un
Policyoggetto che rappresenta il criterio da aggiornare richiamando ilPolicyManagerdell’oggettogetPolicye passando i seguenti valori"- Valore stringa che rappresenta il nome del set di criteri a cui appartiene il criterio. Puoi specificare
nullche si traduce inMyPoliciesset di criteri in uso. - Valore stringa che rappresenta il nome del criterio.
- Valore stringa che rappresenta il nome del set di criteri a cui appartiene il criterio. Puoi specificare
-
-
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
Policydell’oggettosetOfflineLeasePeriodmetodo . -
Aggiorna il criterio.
Aggiornare il criterio richiamando
PolicyManagerdell’oggettoupdatePolicymetodo . Passa laPolicyoggetto che rappresenta il criterio da aggiornare.
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere Avvio rapido (modalità SOAP): Modifica di un criterio tramite la sezione API Java .
Modificare i criteri esistenti utilizzando l'API del servizio Web modify-existing-policies-using-the-web-service-api
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.note note NOTE Sostituisci localhostcon l’indirizzo IP del server che ospita AEM Forms. -
Creare un oggetto API client Document Security.
-
Crea un
RightsManagementServiceClientutilizzando il relativo costruttore predefinito. -
Crea un
RightsManagementServiceClient.Endpoint.AddressutilizzandoSystem.ServiceModel.EndpointAddresscostruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/RightsManagementService?WSDL.) Non è necessario utilizzare illc_versionattributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Crea un
System.ServiceModel.BasicHttpBindingottenendo il valore delRightsManagementServiceClient.Endpoint.Bindingcampo . Imposta il valore restituito suBasicHttpBinding. -
Imposta la
System.ServiceModel.BasicHttpBindingdell’oggettoMessageEncodingcampo aWSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente del modulo di AEM al campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName. - Assegna il valore della password corrispondente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password. - Assegna il valore costante
HttpClientCredentialType.Basical campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Assegnare il nome utente del modulo di AEM al campo
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnlyal campoBasicHttpBindingSecurity.Security.Mode.
-
-
Recupera un criterio esistente.
Crea un
PolicySpecoggetto che rappresenta il criterio da modificare richiamando ilRightsManagementServiceClientdell’oggettogetPolicye passando i seguenti valori:- Valore stringa che specifica il nome del set di criteri a cui appartiene il criterio. Puoi specificare
nullche si traduce inMyPoliciesset di criteri in uso. - Valore stringa che specifica il nome del criterio.
- Valore stringa che specifica il nome del set di criteri a cui appartiene il criterio. Puoi specificare
-
Imposta gli attributi del criterio.
Modifica gli attributi del criterio per soddisfare i requisiti aziendali.
-
Aggiorna il criterio.
Aggiorna il criterio richiamando il
RightsManagementServiceClientdell’oggettoupdatePolicyFromSDKe passarePolicySpecoggetto che rappresenta il criterio da aggiornare.
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
- "Avvio rapido (MTOM): Modifica di un criterio tramite l’API del servizio Web"
- "Avvio rapido (SwaRef): Modifica di un criterio tramite l’API del servizio Web"
Eliminazione dei criteri deleting-policies
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.
Riepilogo dei passaggi summary_of_steps-2
Per eliminare un criterio esistente, eseguire le operazioni seguenti:
- Includi file di progetto
- Creare un oggetto API client Document Security.
- Elimina il criterio.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, 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.
Eliminare i criteri tramite l’API Java delete-policies-using-the-java-api
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.
- Crea un
ServiceClientFactoryoggetto contenente le proprietà di connessione. - Crea un
RightsManagementClientutilizzando il relativo costruttore e passandoServiceClientFactoryoggetto.
- Crea un
-
Elimina il criterio.
-
Crea un
PolicyManagerrichiamando l'oggettoRightsManagementClientdell’oggettogetPolicyManagermetodo . -
Elimina il criterio richiamando il
PolicyManagerdell’oggettodeletePolicye passando i seguenti valori:- Valore stringa che specifica il nome del set di criteri a cui appartiene il criterio. Puoi specificare
nullche si traduce inMyPoliciesset di criteri in uso. - Valore stringa che specifica il nome del criterio da eliminare.
- Valore stringa che specifica il nome del set di criteri a cui appartiene il criterio. Puoi specificare
-
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
- "Avvio rapido (modalità SOAP): Eliminazione di un criterio tramite l’API Java"
Eliminare i criteri utilizzando l’API del servizio Web delete-policies-using-the-web-service-api
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.note note NOTE Sostituisci localhostcon l’indirizzo IP del server che ospita AEM Forms. -
Creare un oggetto API client Document Security.
-
Crea un
RightsManagementServiceClientutilizzando il relativo costruttore predefinito. -
Crea un
RightsManagementServiceClient.Endpoint.AddressutilizzandoSystem.ServiceModel.EndpointAddresscostruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/RightsManagementService?WSDL.) Non è necessario utilizzare illc_versionattributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Crea un
System.ServiceModel.BasicHttpBindingottenendo il valore delRightsManagementServiceClient.Endpoint.Bindingcampo . Imposta il valore restituito suBasicHttpBinding. -
Imposta la
System.ServiceModel.BasicHttpBindingdell’oggettoMessageEncodingcampo aWSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente del modulo di AEM al campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName. - Assegna il valore della password corrispondente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password. - Assegna il valore costante
HttpClientCredentialType.Basical campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Assegnare il nome utente del modulo di AEM al campo
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnlyal campoBasicHttpBindingSecurity.Security.Mode.
-
-
Elimina il criterio.
Elimina un criterio richiamando il
RightsManagementServiceClientdell’oggettodeletePolicye passando i seguenti valori:- Valore stringa che specifica il nome del set di criteri a cui appartiene il criterio. Puoi specificare
nullche si traduce inMyPoliciesset di criteri in uso. - Valore stringa che specifica il nome del criterio da eliminare.
- Valore stringa che specifica il nome del set di criteri a cui appartiene il criterio. Puoi specificare
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
- "Avvio rapido (MTOM): Eliminazione di un criterio tramite l'API del servizio Web"
- "Avvio rapido (SwaRef): Eliminazione di un criterio tramite l'API del servizio Web"
Applicazione dei criteri ai documenti PDF applying-policies-to-pdf-documents
È 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.
Riepilogo dei passaggi summary_of_steps-3
Per applicare un criterio a un documento PDF, eseguire le operazioni seguenti:
- Includi file di progetto.
- Creare un oggetto API client Document Security.
- Recupera un documento PDF a cui viene applicato un criterio.
- Applicare un criterio esistente al documento PDF.
- Salvare il documento PDF protetto da policy.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
Creare un oggetto API client Document Security
Prima di 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 Java apply-a-policy-to-a-pdf-document-using-the-java-api
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.
- Crea un
ServiceClientFactoryoggetto contenente le proprietà di connessione. - Crea un
RightsManagementClientutilizzando il relativo costruttore e passandoServiceClientFactoryoggetto.
- Crea un
-
Recupera un documento PDF.
- Crea un
java.io.FileInputStreamoggetto che rappresenta il documento PDF utilizzando il relativo costruttore. Passa un valore stringa che specifica la posizione del documento PDF. - Crea un
com.adobe.idp.Documentutilizzando il relativo costruttore e passandojava.io.FileInputStreamoggetto.
- Crea un
-
Applicare un criterio esistente al documento PDF.
-
Crea un
DocumentManagerrichiamando l'oggettoRightsManagementClientdell’oggettogetDocumentManagermetodo . -
Applicare un criterio al documento PDF richiamando il
DocumentManagerdell’oggettoprotectDocumente passando i seguenti valori:- La
com.adobe.idp.Documentoggetto contenente il documento PDF a cui viene applicato il criterio. - Valore stringa che specifica il nome del documento.
- Valore stringa che specifica il nome dell'insieme di criteri a cui appartiene il criterio. Puoi specificare un
nullche restituisceMyPoliciesset di criteri in uso. - Valore stringa che specifica il nome del criterio.
- Valore stringa che rappresenta il nome del dominio User Manager dell'utente che è l'editore del documento. Questo valore del parametro è facoltativo e può essere nullo (se questo parametro è nullo, il valore del parametro successivo deve essere nullo).
- Valore stringa che rappresenta il nome canonico dell'utente di user manager che è l'editore del documento. Questo valore del parametro è facoltativo e può essere
nullSe questo parametro è nullo, il valore del parametro precedente deve esserenull). - A
com.adobe.livecycle.rightsmanagement.Localeche 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, specificarenull.
La
protectDocumentrestituisce unRMSecureDocumentResultoggetto contenente il documento PDF protetto da policy. - La
-
-
Salvare il documento PDF.
- Richiama il
RMSecureDocumentResultdell’oggettogetProtectedDocper ottenere il documento PDF protetto da policy. Questo metodo restituisce uncom.adobe.idp.Documentoggetto. - Crea un
java.io.Filee assicurati che l’estensione del file sia PDF. - Richiama il
com.adobe.idp.Documentdell’oggettocopyToFileper copiare il contenuto delDocumental file (assicurati di utilizzareDocumentoggetto restituito dagetProtectedDocmetodo).
- Richiama il
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
- "Avvio rapido (modalità EJB): Applicazione di un criterio a un documento PDF tramite l’API Java"
- "Avvio rapido (modalità SOAP): Applicazione di un criterio a un documento PDF tramite l’API Java"
Consulta anche
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Applicazione di un criterio a un documento PDF tramite l’API del servizio Web apply-a-policy-to-a-pdf-document-using-the-web-service-api
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.note note NOTE Sostituisci localhostcon l’indirizzo IP del server che ospita AEM Forms. -
Creare un oggetto API client Document Security.
-
Crea un
RightsManagementServiceClientutilizzando il relativo costruttore predefinito. -
Crea un
RightsManagementServiceClient.Endpoint.AddressutilizzandoSystem.ServiceModel.EndpointAddresscostruttore. Passa un valore stringa che specifica il WSDL al servizio Forms (ad esempio,http://localhost:8080/soap/services/RightsManagementService?WSDL.) Non è necessario utilizzare illc_versionattributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Crea un
System.ServiceModel.BasicHttpBindingottenendo il valore delRightsManagementServiceClient.Endpoint.Bindingcampo . Imposta il valore restituito suBasicHttpBinding. -
Imposta la
System.ServiceModel.BasicHttpBindingdell’oggettoMessageEncodingcampo aWSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente del modulo di AEM al campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName. - Assegna il valore della password corrispondente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password. - Assegna il valore costante
HttpClientCredentialType.Basical campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Assegnare il nome utente del modulo di AEM al campo
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnlyal campoBasicHttpBindingSecurity.Security.Mode.
-
-
Recupera un documento PDF.
- Crea un
BLOButilizzando il relativo costruttore. LaBLOBviene utilizzato per memorizzare un documento PDF a cui viene applicato un criterio. - Crea un
System.IO.FileStreamrichiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF e la modalità di apertura del file. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStreamoggetto. Determina la dimensione dell'array di byte ottenendo ilSystem.IO.FileStreamdell’oggettoLengthproprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStreamdell’oggettoReadmetodo . Passa la matrice dei byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOBoggetto assegnando il relativoMTOMcon il contenuto dell'array di byte.
- Crea un
-
Applicare un criterio esistente al documento PDF.
Applicare un criterio al documento PDF richiamando il
RightsManagementServiceClientdell’oggettoprotectDocumente passando i seguenti valori:- La
BLOBoggetto contenente il documento PDF a cui viene applicato il criterio. - Valore stringa che specifica il nome del documento.
- Valore stringa che specifica il nome dell'insieme di criteri a cui appartiene il criterio. Puoi specificare un
nullche restituisceMyPoliciesset di criteri in uso. - Valore stringa che specifica il nome del criterio.
- Valore stringa che rappresenta il nome del dominio User Manager dell'utente che è l'editore del documento. Questo valore del parametro è facoltativo e può essere nullo (se questo parametro è nullo, il valore del parametro successivo deve essere
null). - Valore stringa che rappresenta il nome canonico dell'utente di user manager che è l'editore del documento. Questo valore del parametro è facoltativo e può essere nullo (se questo parametro è nullo, il valore del parametro precedente deve essere
null). - A
RMLocalevalore che specifica il valore delle impostazioni internazionali (ad esempio,RMLocale.en). - Parametro di output della stringa utilizzato per memorizzare il valore dell'identificatore del criterio.
- Parametro di output della stringa utilizzato per memorizzare il valore dell'identificatore protetto da policy.
- Un parametro di output della stringa utilizzato per memorizzare il tipo di mime (ad esempio,
application/pdf).
La
protectDocumentrestituisce unBLOBoggetto contenente il documento PDF protetto da policy. - La
-
Salvare il documento PDF.
- Crea un
System.IO.FileStreamrichiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF protetto tramite criterio. - Creare un array di byte che memorizza il contenuto dei dati del
BLOBoggetto restituito daprotectDocumentmetodo . Compilare l’array di byte ottenendo il valore delBLOBdell’oggettoMTOMmembro dati. - Crea un
System.IO.BinaryWriterrichiamando il relativo costruttore e passandoSystem.IO.FileStreamoggetto. - Scrivi il contenuto dell’array di byte in un file PDF richiamando il
System.IO.BinaryWriterdell’oggettoWritee passare l'array di byte.
- Crea un
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
- "Avvio rapido (MTOM): Applicazione di un criterio a un documento PDF tramite l’API del servizio Web"
- "Avvio rapido (SwaRef): Applicazione di un criterio a un documento PDF tramite l’API del servizio Web"
Rimozione di criteri dai documenti di PDF removing-policies-from-pdf-documents
È 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.
Riepilogo dei passaggi summary_of_steps-4
Per rimuovere un criterio da un documento PDF protetto da policy, eseguire le operazioni seguenti:
- Includi file di progetto
- Creare un oggetto API client Document Security.
- Recupera un documento PDF protetto da policy.
- Rimuovi il criterio dal documento PDF.
- Salvare il documento PDF non protetto.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, 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
Rimuovere un criterio da un documento PDF utilizzando l’API Java remove-a-policy-from-a-pdf-document-using-the-java-api
È 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.
- Crea un
ServiceClientFactoryoggetto contenente le proprietà di connessione. - Crea un
DocumentSecurityClientutilizzando il relativo costruttore e passandoServiceClientFactoryoggetto.
- Crea un
-
Recupera un documento PDF protetto da policy.
- Crea un
java.io.FileInputStreamoggetto 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. - Crea un
com.adobe.idp.Documentutilizzando il relativo costruttore e passandojava.io.FileInputStreamoggetto.
- Crea un
-
Rimuovi il criterio dal documento PDF.
- Crea un
DocumentManagerrichiamando l'oggettoDocumentSecurityClientdell’oggettogetDocumentManagermetodo . - Rimuovere un criterio dal documento PDF richiamando il
DocumentManagerdell’oggettoremoveSecuritye passarecom.adobe.idp.Documentoggetto contenente il documento PDF protetto da policy. Questo metodo restituisce uncom.adobe.idp.Documentoggetto contenente un documento PDF non protetto.
- Crea un
-
Salvare il documento PDF non protetto.
- Crea un
java.io.Filee assicurati che l’estensione del file sia PDF. - Richiama il
Documentdell’oggettocopyToFileper copiare il contenuto delDocumental file (assicurati di utilizzareDocumentoggetto restituito daremoveSecuritymetodo).
- Crea un
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
- "Avvio rapido (modalità SOAP): Rimozione di un criterio da un documento PDF tramite l’API Java"
Rimuovere un criterio utilizzando l’API del servizio Web remove-a-policy-using-the-web-service-api
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.note note NOTE Sostituisci localhostcon l’indirizzo IP del server che ospita AEM Forms. -
Creare un oggetto API client Document Security.
-
Crea un
DocumentSecurityServiceClientutilizzando il relativo costruttore predefinito. -
Crea un
DocumentSecurityServiceClient.Endpoint.AddressutilizzandoSystem.ServiceModel.EndpointAddresscostruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/RightsManagementService?WSDL.) Non è necessario utilizzare illc_versionattributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Crea un
System.ServiceModel.BasicHttpBindingottenendo il valore delDocumentSecurityServiceClient.Endpoint.Bindingcampo . Imposta il valore restituito suBasicHttpBinding. -
Imposta la
System.ServiceModel.BasicHttpBindingdell’oggettoMessageEncodingcampo aWSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente del modulo di AEM al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName. - Assegna il valore della password corrispondente al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password. - Assegna il valore costante
HttpClientCredentialType.Basical campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Assegnare il nome utente del modulo di AEM al campo
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnlyal campoBasicHttpBindingSecurity.Security.Mode.
-
-
Recupera un documento PDF protetto da policy.
- Crea un
BLOButilizzando il relativo costruttore. LaBLOBviene utilizzato per memorizzare il documento PDF protetto dai criteri da cui viene rimosso il criterio. - Crea un
System.IO.FileStreamrichiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF e la modalità di apertura del file. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStreamoggetto. È possibile determinare le dimensioni dell'array di byte ottenendo ilSystem.IO.FileStreamdell’oggettoLengthproprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStreamdell’oggettoReade passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOBoggetto assegnando il relativoMTOMcon il contenuto dell'array di byte.
- Crea un
-
Rimuovi il criterio dal documento PDF.
Rimuovi il criterio dal documento PDF richiamando il
DocumentSecurityServiceClientdell’oggettoremovePolicySecuritye passareBLOBoggetto contenente il documento PDF protetto da policy. Questo metodo restituisce unBLOBoggetto contenente un documento PDF non protetto. -
Salvare il documento PDF non protetto.
- Crea un
System.IO.FileStreamrichiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF non protetto. - Creare un array di byte che memorizza il contenuto dei dati del
BLOBoggetto restituito daremovePolicySecuritymetodo . Compilare l’array di byte ottenendo il valore delBLOBdell’oggettoMTOMcampo . - Crea un
System.IO.BinaryWriterrichiamando il relativo costruttore e passandoSystem.IO.FileStreamoggetto.
- Crea un
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
- "Avvio rapido (MTOM): Rimozione di un criterio da un documento PDF tramite l’API del servizio Web"
- "Avvio rapido (SwaRef): Rimozione di un criterio da un documento PDF tramite l’API del servizio Web"
Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
Revoca dell’accesso ai documenti revoking-access-to-documents
È 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.
Riepilogo dei passaggi summary_of_steps-5
Per revocare un documento protetto da policy, esegui le seguenti operazioni:
- Includi file di progetto.
- Creare un oggetto API client Document Security.
- Recupera un documento PDF protetto da policy.
- Revocare il documento protetto da policy.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
Creare un oggetto API client di sicurezza dei documenti
Prima di poter eseguire un'operazione del servizio Document Security, è necessario creare un oggetto client del servizio Document Security.
Recuperare un documento PDF protetto da policy
Per revocarlo, è necessario recuperare un documento PDF protetto da policy. Impossibile revocare un documento già revocato o non protetto da policy.
Se si conosce il valore dell'identificatore di licenza del documento protetto tramite criterio, non è necessario recuperare il documento PDF protetto tramite criterio. Tuttavia, nella maggior parte dei casi, per ottenere il valore dell’identificatore di licenza è necessario recuperare il documento PDF.
Revoca del documento protetto da policy
Per revocare un documento protetto da policy, specificare l'identificativo della licenza del documento protetto da policy. Inoltre, è possibile specificare l'URL di un documento che l'utente può visualizzare quando tenta di aprire il documento revocato. In altre parole, supponiamo che un documento obsoleto venga revocato. Quando un utente tenta di aprire il documento revocato, vedrà un documento aggiornato invece del documento revocato.
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 dell’accesso ai documenti tramite l’API Java revoke-access-to-documents-using-the-java-api
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
- Crea un
ServiceClientFactoryoggetto contenente le proprietà di connessione. - Crea un
DocumentSecurityClientutilizzando il relativo costruttore e passandoServiceClientFactoryoggetto.
- Crea un
-
Recuperare un documento PDF protetto da policy
- Crea un
java.io.FileInputStreamoggetto 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. - Crea un
com.adobe.idp.Documentutilizzando il relativo costruttore e passandojava.io.FileInputStreamoggetto.
- Crea un
-
Revoca del documento protetto da policy
-
Crea un
DocumentManagerrichiamando l'oggettoDocumentSecurityClientdell’oggettogetDocumentManagermetodo . -
Recupera il valore dell'identificatore di licenza del documento protetto tramite criterio richiamando il
DocumentManagerdell’oggettogetLicenseIdmetodo . Passa lacom.adobe.idp.Documentoggetto che rappresenta il documento protetto da policy. Questo metodo restituisce un valore stringa che rappresenta il valore dell'identificatore di licenza. -
Crea un
LicenseManagerrichiamando l'oggettoDocumentSecurityClientdell’oggettogetLicenseManagermetodo . -
Revocare il documento protetto dai criteri richiamando il
LicenseManagerdell’oggettorevokeLicensee passando i seguenti valori:- Valore stringa che specifica il valore dell'identificatore di licenza del documento protetto tramite criterio (specificare il valore restituito del
DocumentManagerdell’oggettogetLicenseIdmetodo). - Un membro di dati statici del
Licenseinterfaccia che specifica il motivo della revoca del documento. Ad esempio, puoi specificareLicense.DOCUMENT_REVISED. - A
java.net.URLvalore che specifica la posizione in cui si trova un documento revisionato. Se non desideri reindirizzare un utente a un altro URL, puoi passarenull.
- Valore stringa che specifica il valore dell'identificatore di licenza del documento protetto tramite criterio (specificare il valore restituito del
-
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
- "Avvio rapido (modalità SOAP): Revoca di un documento tramite l’API Java"
Revoca dell’accesso ai documenti tramite l’API del servizio Web revoke-access-to-documents-using-the-web-service-api
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.note note NOTE Sostituisci localhostcon l’indirizzo IP del server che ospita AEM Forms. -
Creare un oggetto API client di sicurezza dei documenti
-
Crea un
DocumentSecurityServiceClientutilizzando il relativo costruttore predefinito. -
Crea un
DocumentSecurityServiceClient.Endpoint.AddressutilizzandoSystem.ServiceModel.EndpointAddresscostruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/RightsManagementService?WSDL.) Non è necessario utilizzare illc_versionattributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Crea un
System.ServiceModel.BasicHttpBindingottenendo il valore delDocumentSecurityServiceClient.Endpoint.Bindingcampo . Imposta il valore restituito suBasicHttpBinding. -
Imposta la
System.ServiceModel.BasicHttpBindingdell’oggettoMessageEncodingcampo aWSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente del modulo di AEM al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName. - Assegna il valore della password corrispondente al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password. - Assegna il valore costante
HttpClientCredentialType.Basical campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Assegnare il nome utente del modulo di AEM al campo
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnlyal campoBasicHttpBindingSecurity.Security.Mode.
-
-
Recuperare un documento PDF protetto da policy
- Crea un
BLOButilizzando il relativo costruttore. LaBLOBviene utilizzato per memorizzare un documento PDF protetto da policy revocato. - Crea un
System.IO.FileStreamrichiamando 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. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStreamoggetto. È possibile determinare le dimensioni dell'array di byte ottenendo ilSystem.IO.FileStreamdell’oggettoLengthproprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStreamdell’oggettoReade passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOBoggetto assegnando il relativoMTOMcon il contenuto dell'array di byte.
- Crea un
-
Revoca del documento protetto da policy
-
Recupera il valore dell'identificatore di licenza del documento protetto tramite criterio richiamando il
DocumentSecurityServiceClientdell’oggettogetLicenseIDe passareBLOBoggetto 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
DocumentSecurityServiceClientdell’oggettorevokeLicensee passando i seguenti valori:- Valore stringa che specifica il valore dell'identificatore di licenza del documento protetto tramite criterio (specificare il valore restituito del
DocumentSecurityServiceServicedell’oggettogetLicenseIdmetodo). - Un membro di dati statici del
Reasonenum che specifica il motivo della revoca del documento. Ad esempio, puoi specificareReason.DOCUMENT_REVISED. - A
stringvalore che specifica la posizione dell'URL in cui si trova un documento revisionato. Se non desideri reindirizzare un utente a un altro URL, puoi passarenull.
- Valore stringa che specifica il valore dell'identificatore di licenza del documento protetto tramite criterio (specificare il valore restituito del
-
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
- "Avvio rapido (MTOM): Revoca di un documento tramite l’API del servizio Web"
- "Avvio rapido (SwaRef): Revoca di un documento tramite l’API del servizio Web"
Consulta anche
Rimozione di criteri dai documenti di Word
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
Ripristino dell'accesso ai documenti revisionati reinstating-access-to-revoked-documents
È possibile ripristinare l’accesso a un documento PDF revocato, in modo che tutte le copie del documento revocato siano accessibili agli utenti. Quando un utente apre un documento ripristinato revocato, può visualizzare il documento.
Riepilogo dei passaggi summary_of_steps-6
Per ripristinare l’accesso a un documento PDF revocato, eseguire le operazioni seguenti:
- Includi file di progetto.
- Creare un oggetto API client Document Security.
- Recupera l’identificatore di licenza del documento PDF revocato.
- Ripristina l’accesso al documento PDF revocato.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
Creare un oggetto API client di sicurezza dei documenti
Prima di poter eseguire un'operazione del servizio Document Security, è necessario creare un oggetto client del servizio Document Security. Se utilizzi l’API Java, crea un 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
Ripristino dell’accesso ai documenti revocati tramite l’API Java reinstate-access-to-revoked-documents-using-the-java-api
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.
- Crea un
ServiceClientFactoryoggetto contenente le proprietà di connessione. - Crea un
DocumentSecurityClientutilizzando il relativo costruttore e passandoServiceClientFactoryoggetto.
- Crea un
-
Recupera l’identificatore di licenza del documento PDF revocato.
- Crea un
java.io.FileInputStreamoggetto che rappresenta il documento PDF revocato utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento PDF. - Crea un
com.adobe.idp.Documentutilizzando il relativo costruttore e passandojava.io.FileInputStreamoggetto. - Crea un
DocumentManagerrichiamando l'oggettoDocumentSecurityClientdell’oggettogetDocumentManagermetodo . - Recupera il valore dell'identificatore di licenza del documento revocato richiamando il
DocumentManagerdell’oggettogetLicenseIde passarecom.adobe.idp.Documentoggetto che rappresenta il documento revocato. Questo metodo restituisce un valore stringa che rappresenta l'identificatore di licenza.
- Crea un
-
Ripristina l’accesso al documento PDF revocato.
- Crea un
LicenseManagerrichiamando l'oggettoDocumentSecurityClientdell’oggettogetLicenseManagermetodo . - Ripristina l'accesso al documento PDF revocato richiamando il
LicenseManagerdell’oggettounrevokeLicensee passare il valore dell'identificativo della licenza del documento revocato.
- Crea un
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
- "Avvio rapido (modalità SOAP): Ripristino dell’accesso a un documento revocato tramite l’API del servizio Web"
Ripristino dell’accesso ai documenti revocati tramite l’API del servizio Web reinstate-access-to-revoked-documents-using-the-web-service-api
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.note note NOTE Sostituisci localhostcon l’indirizzo IP del server che ospita AEM Forms. -
Creare un oggetto API client Document Security.
-
Crea un
DocumentSecurityServiceClientutilizzando il relativo costruttore predefinito. -
Crea un
DocumentSecurityServiceClient.Endpoint.AddressutilizzandoSystem.ServiceModel.EndpointAddresscostruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/RightsManagementService?WSDL.) Non è necessario utilizzare illc_versionattributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Crea un
System.ServiceModel.BasicHttpBindingottenendo il valore delDocumentSecurityServiceClient.Endpoint.Bindingcampo . Imposta il valore restituito suBasicHttpBinding. -
Imposta la
System.ServiceModel.BasicHttpBindingdell’oggettoMessageEncodingcampo aWSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente del modulo di AEM al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName. - Assegna il valore della password corrispondente al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password. - Assegna il valore costante
HttpClientCredentialType.Basical campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Assegnare il nome utente del modulo di AEM al campo
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnlyal campoBasicHttpBindingSecurity.Security.Mode.
-
-
Recupera l’identificatore di licenza del documento PDF revocato.
- Crea un
BLOButilizzando il relativo costruttore. LaBLOBviene utilizzato per memorizzare un documento PDF revocato al quale viene ripristinato l'accesso. - Crea un
System.IO.FileStreamrichiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF revocato e la modalità di apertura del file. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStreamoggetto. È possibile determinare le dimensioni dell'array di byte ottenendo ilSystem.IO.FileStreamdell’oggettoLengthproprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStreamdell’oggettoReade passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOBoggetto assegnando il relativoMTOMcon il contenuto dell'array di byte.
- Crea un
-
Ripristina l’accesso al documento PDF revocato.
- Recupera il valore dell'identificatore di licenza del documento revocato richiamando il
DocumentSecurityServiceClientdell’oggettogetLicenseIDe passareBLOBoggetto che rappresenta il documento revocato. Questo metodo restituisce un valore stringa che rappresenta l'identificatore di licenza. - Ripristina l'accesso al documento PDF revocato richiamando il
DocumentSecurityServiceClientdell’oggettounrevokeLicensee passare un valore stringa che specifica il valore dell'identificatore di licenza del documento PDF revocato (passare il valore restituito delDocumentSecurityServiceClientdell’oggettogetLicenseIdmetodo).
- Recupera il valore dell'identificatore di licenza del documento revocato richiamando il
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
- "Avvio rapido (MTOM): Ripristino dell’accesso a un documento revocato tramite l’API del servizio Web"
- "Avvio rapido (SwaRef): Ripristino dell’accesso a un documento revocato tramite l’API del servizio Web"
Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
Ispezione dei documenti PDF protetti inspecting-policy-protected-pdf-documents
È 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.
Riepilogo dei passaggi summary_of_steps-7
Per esaminare un documento PDF protetto da policy, eseguire le operazioni seguenti:
- Includi file di progetto.
- Creare un oggetto API client Document Security.
- Recuperare un documento protetto da policy da esaminare.
- Ottenere informazioni sul documento protetto tramite criterio.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
Creare un oggetto API client di sicurezza dei documenti
Prima di eseguire un'operazione del servizio Document Security, creare un oggetto client del servizio Document Security. Se utilizzi l’API Java, crea un 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
Documenti PDF protetti da policy Inspect tramite l’API Java inspect-policy-protected-pdf-documents-using-the-java-api
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.
- Crea un
ServiceClientFactoryoggetto contenente le proprietà di connessione. (Vedi Impostazione delle proprietà di connessione.) - Crea un
RightsManagementClientutilizzando il relativo costruttore e passandoServiceClientFactoryoggetto.
- Crea un
-
Recuperare un documento protetto da policy da esaminare.
- Crea un
java.io.FileInputStreamoggetto che rappresenta il documento PDF protetto da policy utilizzando il relativo costruttore. Passa un valore stringa che specifica la posizione del documento PDF. - Crea un
com.adobe.idp.Documentutilizzando il relativo costruttore e passandojava.io.FileInputStreamoggetto.
- Crea un
-
Inspect il documento.
- Crea un
DocumentManagerrichiamando l'oggettoRightsManagementClientdell’oggettogetDocumentManagermetodo . - Inspect è il documento protetto da policy richiamando il
LicenseManagerdell’oggettoinspectDocumentmetodo . Passa lacom.adobe.idp.Documentoggetto contenente il documento PDF protetto da policy. Questo metodo restituisce unRMInspectResultoggetto contenente informazioni sul documento protetto tramite criterio.
- Crea un
-
Ottenere informazioni sul documento protetto tramite criterio.
Per ottenere informazioni sul documento protetto tramite criterio, invocare il metodo appropriato di appartenenza
RMInspectResultoggetto. Ad esempio, per recuperare il nome del criterio, richiama ilRMInspectResultdell’oggettogetPolicyNamemetodo .
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
- "Avvio rapido (modalità SOAP): Ispezione dei documenti PDF protetti da policy tramite l’API Java"
Documenti Inspect Policy Protected PDF che utilizzano l'API del servizio Web inspect-policy-protected-pdf-documents-using-the-web-service-api
Inspect è un documento PDF protetto 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.note note NOTE Sostituisci localhostcon l’indirizzo IP del server che ospita AEM Forms. -
Creare un oggetto API client Document Security.
-
Crea un
RightsManagementServiceClientutilizzando il relativo costruttore predefinito. -
Crea un
RightsManagementServiceClient.Endpoint.AddressutilizzandoSystem.ServiceModel.EndpointAddresscostruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/RightsManagementService?WSDL.) Non è necessario utilizzare illc_versionattributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Crea un
System.ServiceModel.BasicHttpBindingottenendo il valore delRightsManagementServiceClient.Endpoint.Bindingcampo . Imposta il valore restituito suBasicHttpBinding. -
Imposta la
System.ServiceModel.BasicHttpBindingdell’oggettoMessageEncodingcampo aWSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente del modulo di AEM al campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName. - Assegna il valore della password corrispondente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password. - Assegna il valore costante
HttpClientCredentialType.Basical campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Assegnare il nome utente del modulo di AEM al campo
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnlyal campoBasicHttpBindingSecurity.Security.Mode.
-
-
Recuperare un documento protetto da policy da esaminare.
- Crea un
BLOButilizzando il relativo costruttore. LaBLOBviene utilizzato per memorizzare un documento PDF da esaminare. - Crea un
System.IO.FileStreamrichiamando il relativo costruttore. Passa un valore stringa che rappresenta la posizione del file del documento PDF e la modalità di apertura del file. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStreamoggetto. È possibile determinare le dimensioni dell'array di byte ottenendo ilSystem.IO.FileStreamdell’oggettoLengthproprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStreamdell’oggettoReadmetodo . Passa la matrice byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOBoggetto assegnando il relativoMTOMcon il contenuto dell'array di byte.
- Crea un
-
Inspect il documento.
Inspect è il documento protetto da policy richiamando il
RightsManagementServiceClientdell’oggettoinspectDocumentmetodo . Passa laBLOBoggetto contenente il documento PDF protetto da policy. Questo metodo restituisce unRMInspectResultoggetto 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
RMInspectResultoggetto. Ad esempio, per recuperare il nome del criterio, ottieni il valore delRMInspectResultdell’oggettopolicyNamecampo .
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
- "Avvio rapido (MTOM): Ispezione dei documenti PDF protetti da policy utilizzando l'API del servizio Web"
- "Avvio rapido (SwaRef): Ispezione dei documenti PDF protetti da policy utilizzando l'API del servizio Web"
Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
Creazione di filigrane creating-watermarks
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.
Riepilogo dei passaggi summary_of_steps-8
Per creare una filigrana, effettua le seguenti operazioni:
- Includi file di progetto.
- Creare un oggetto API client Document Security.
- Impostare gli attributi delle filigrane.
- Registrare la filigrana con il servizio Document Security.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
Creare un oggetto API client di sicurezza dei documenti
Prima di poter eseguire un'operazione del servizio Document Security, è necessario creare un oggetto client del servizio Document Security. Se utilizzi l’API Java, crea un 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:
- Testo personalizzato
- DateIncluded
- IDutenteIncluso
- NomeUtenteIncluso
Nella tabella seguente sono elencate le coppie chiave-valore richieste per la creazione di una filigrana utilizzando i servizi Web.
WaterBackCmd:IS_USERNAME_ENABLEDWaterBackCmd:IS_USERID_ENABLEDWaterBackCmd:IS_CURRENTDATE_ENABLEDWaterBackCmd:IS_CUSTOMTEXT_ENABLEDWaterBackCmd:SRCTEXT.WaterBackCmd:OPACITYWaterBackCmd:ROTATIONWaterBackCmd:SCALEWaterBackCmd:IS_SIZE_ENABLED deve essere presente e il valore deve essere true. Se questo attributo non viene specificato, il comportamento predefinito è adattato alla pagina.WaterBackCmd:HORIZ_ALIGNWaterBackCmd:VERT_ALIGNWaterBackCmd:IS_USE_BACKGROUNDWaterBackCmd:IS_SIZE_ENABLEDWaterBackCmd:SRCTEXTWaterBackCmd:IS_CUSTOMTEXT_ENABLED deve anche essere presente e impostato su true.Tutte le filigrane devono avere uno dei seguenti attributi definiti:
WaterBackCmd:IS_USERNAME_ENABLEDWaterBackCmd:IS_USERID_ENABLEDWaterBackCmd:IS_CURRENTDATE_ENABLEDWaterBackCmd:IS_CUSTOMTEXT_ENABLED
Tutti gli altri attributi sono facoltativi.
Registra la filigrana
Prima di poter essere utilizzato, è necessario registrare una nuova filigrana con il servizio Document Security. Dopo aver registrato una filigrana, puoi utilizzarla all’interno dei criteri.
Consulta anche
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Applicazione dei criteri ai documenti PDF
Creare watermark utilizzando l’API Java create-watermarks-using-the-java-api
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.
- Crea un
ServiceClientFactoryoggetto contenente le proprietà di connessione. - Crea un
RightsManagementClientutilizzando il relativo costruttore e passandoServiceClientFactoryoggetto.
- Crea un
-
Impostare gli attributi della filigrana
- Crea un
Watermarkrichiamando l'oggettoInfomodelObjectFactorystatico dell’oggettocreateWatermarkmetodo . Questo metodo restituisce unWatermarkoggetto. - Imposta l’attributo del nome della filigrana richiamando il
Watermarkdell’oggettosetNamee passare un valore stringa che specifica il nome del criterio. - Imposta l’attributo di sfondo della filigrana richiamando il
Watermarkdell’oggettosetBackgroundmetodo e passaggiotrue. Impostando questo attributo, la filigrana viene visualizzata sullo sfondo del documento. - Imposta l’attributo di testo personalizzato della filigrana richiamando il
Watermarkdell’oggettosetCustomTexte passare un valore stringa che rappresenta il testo della filigrana. - Imposta l’attributo di opacità della filigrana richiamando il
Watermarkdell’oggettosetOpacitye 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.
- Crea un
-
Registra la filigrana.
- Crea un
WatermarkManagerrichiamando l'oggettoRightsManagementClientdell’oggettogetWatermarkManagermetodo . Questo metodo restituisce unWatermarkManageroggetto. - Registra la filigrana richiamando il
WatermarkManagerdell’oggettoregisterWatermarke passareWatermarkoggetto che rappresenta la filigrana da registrare. Questo metodo restituisce un valore di stringa che rappresenta il valore di identificazione della filigrana.
- Crea un
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
- "Avvio rapido (modalità SOAP): Creazione di una filigrana utilizzando l’API Java"
Creare watermark utilizzando l’API del servizio Web create-watermarks-using-the-web-service-api
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.note note NOTE Sostituisci localhostcon l’indirizzo IP del server che ospita AEM Forms. -
Creare un oggetto API client Document Security.
-
Crea un
RightsManagementServiceClientutilizzando il relativo costruttore predefinito. -
Crea un
RightsManagementServiceClient.Endpoint.AddressutilizzandoSystem.ServiceModel.EndpointAddresscostruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/RightsManagementService?WSDL.) Non è necessario utilizzare illc_versionattributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Crea un
System.ServiceModel.BasicHttpBindingottenendo il valore delRightsManagementServiceClient.Endpoint.Bindingcampo . Imposta il valore restituito suBasicHttpBinding. -
Imposta la
System.ServiceModel.BasicHttpBindingdell’oggettoMessageEncodingcampo aWSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente del modulo di AEM al campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName. - Assegna il valore della password corrispondente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password. - Assegna il valore costante
HttpClientCredentialType.Basical campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Assegnare il nome utente del modulo di AEM al campo
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnlyal campoBasicHttpBindingSecurity.Security.Mode.
-
-
Impostare gli attributi della filigrana.
- Crea un
WatermarkSpecrichiamando l'oggettoWatermarkSpeccostruttore. - Imposta il nome della filigrana assegnando un valore stringa alla variabile
WatermarkSpecdell’oggettonamemembro dati. - Imposta la filigrana
idassegnando un valore stringa aWatermarkSpecdell’oggettoidmembro dati. - Per ogni proprietà di filigrana da impostare, creare una
MyMapOf_xsd_string_To_xsd_anyType_Itemoggetto. - Imposta il valore chiave assegnando un valore al
MyMapOf_xsd_string_To_xsd_anyType_Itemdell’oggettokeymembro dati (ad esempio,WaterBackCmd:OPACITY). - Imposta il valore assegnando un valore al
MyMapOf_xsd_string_To_xsd_anyType_Itemdell’oggettovaluemembro dati (ad esempio,.25). - Crea un
MyArrayOf_xsd_anyTypeoggetto. Per ogniMyMapOf_xsd_string_To_xsd_anyType_Itemoggetto, richiamareMyArrayOf_xsd_anyTypedell’oggettoAddmetodo . Passa laMyMapOf_xsd_string_To_xsd_anyType_Itemoggetto. - Assegna
MyArrayOf_xsd_anyTypedell'oggettoWatermarkSpecdell’oggettovaluesmembro dati.
- Crea un
-
Registra la filigrana.
Registra la filigrana richiamando il
RightsManagementServiceClientdell’oggettoregisterWatermarke passareWatermarkSpecoggetto che rappresenta la filigrana da registrare.
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere i seguenti Quick Starts:
- "Avvio rapido (MTOM): Creazione di una filigrana utilizzando l’API del servizio Web"
- "Avvio rapido (SwaRef): Creazione di una filigrana utilizzando l’API del servizio Web"
Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
Modifica delle filigrane modifying-watermarks
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.
Riepilogo dei passaggi summary_of_steps-9
Per modificare una filigrana, effettua le seguenti operazioni:
- Includi file di progetto.
- Creare un oggetto API client Document Security.
- Recupera la filigrana da modificare.
- Impostare gli attributi delle filigrane.
- Aggiorna la filigrana.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, 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:OPACITYe WaterBackCmd:SRCTEXT. Anche se l'unico attributo che si desidera modificare è WaterBackCmd:OPACITY, è necessario impostare gli altri valori affinché siano corretti.
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 i watermark tramite l'API Java modify-watermarks-using-the-java-api
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.
- Crea un
ServiceClientFactoryoggetto contenente le proprietà di connessione. - Crea un
DocumentSecurityClientutilizzando il relativo costruttore e passandoServiceClientFactoryoggetto.
- Crea un
-
Recupera la filigrana da modificare.
Crea un
WatermarkManagerrichiamando l'oggettoDocumentSecurityClientdell’oggettogetWatermarkManagere passare un valore stringa che specifica il nome della filigrana. Questo metodo restituisce unWatermarkoggetto che rappresenta la filigrana da modificare. -
Impostare gli attributi della filigrana.
Imposta l’attributo di opacità della filigrana richiamando il
Watermarkdell’oggettosetOpacitye 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.note note NOTE In questo esempio viene modificato solo l'attributo opacity. -
Aggiorna la filigrana.
- Aggiorna la filigrana richiamando il
WatermarkManagerdell’oggettoupdateWatermarke passare ilWatermarkoggetto il cui attributo è stato modificato.
- Aggiorna la filigrana richiamando il
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere Avvio rapido (modalità SOAP): Modifica di una filigrana utilizzando la sezione Java API .
Modificare i watermark utilizzando l'API del servizio Web modify-watermarks-using-the-web-service-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.note note NOTE Sostituisci localhostcon l’indirizzo IP del server che ospita AEM Forms. -
Creare un oggetto API client Document Security.
-
Crea un
DocumentSecurityServiceClientutilizzando il relativo costruttore predefinito. -
Crea un
RightsManagementServiceClient.Endpoint.AddressutilizzandoSystem.ServiceModel.EndpointAddresscostruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/DocumentSecurityService?WSDL.) Non è necessario utilizzare illc_versionattributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Crea un
System.ServiceModel.BasicHttpBindingottenendo il valore delDocumentSecurityServiceClient.Endpoint.Bindingcampo . Imposta il valore restituito suBasicHttpBinding. -
Imposta la
System.ServiceModel.BasicHttpBindingdell’oggettoMessageEncodingcampo aWSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente del modulo di AEM al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName. - Assegna il valore della password corrispondente al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password. - Assegna il valore costante
HttpClientCredentialType.Basical campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Assegnare il nome utente del modulo di AEM al campo
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnlyal campoBasicHttpBindingSecurity.Security.Mode.
-
-
Recupera la filigrana da modificare.
Recupera la filigrana da modificare richiamando il
DocumentSecurityServiceClientdell’oggettogetWatermarkByNamemetodo . Passa un valore stringa che specifica il nome della filigrana. Questo metodo restituisce unWatermarkSpecoggetto che rappresenta la filigrana da modificare. -
Impostare gli attributi della filigrana.
- Per ogni proprietà di filigrana da aggiornare, crea una
MyMapOf_xsd_string_To_xsd_anyType_Itemoggetto. - Imposta il valore chiave assegnando un valore al
MyMapOf_xsd_string_To_xsd_anyType_Itemdell’oggettokeymembro dati (ad esempio,WaterBackCmd:OPACITY). - Imposta il valore assegnando un valore al
MyMapOf_xsd_string_To_xsd_anyType_Itemdell’oggettovaluemembro dati (ad esempio,.50). - Crea un
MyArrayOf_xsd_anyTypeoggetto. Per ogniMyMapOf_xsd_string_To_xsd_anyType_Itemoggetto, richiamareMyArrayOf_xsd_anyTypedell’oggettoAddmetodo . Passa laMyMapOf_xsd_string_To_xsd_anyType_Itemoggetto. - Assegna
MyArrayOf_xsd_anyTypedell'oggettoWatermarkSpecdell’oggettovaluesmembro dati.
- Per ogni proprietà di filigrana da aggiornare, crea una
-
Aggiorna la filigrana.
Aggiorna la filigrana richiamando il
DocumentSecurityServiceClientdell’oggettoupdateWatermarke passareWatermarkSpecoggetto che rappresenta la filigrana da modificare.
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere la seguente Guida rapida:
- "Avvio rapido (MTOM): Modifica di una filigrana utilizzando l’API del servizio Web"
Ricerca di eventi searching-for-events
Il servizio di Rights Management tiene traccia delle azioni specifiche che si verificano, ad esempio l'applicazione di un criterio a un documento, l'apertura di un documento protetto da policy e la revoca dell'accesso ai documenti. Il controllo degli eventi deve essere abilitato per il servizio di Rights Management, altrimenti gli eventi non vengono tracciati.
Gli eventi rientrano in una delle seguenti categorie:
- Gli eventi di amministratore sono azioni correlate a un amministratore, ad esempio la creazione di un nuovo account di amministratore.
- Gli eventi del documento sono azioni correlate a un documento, ad esempio la chiusura di un documento protetto da policy.
- Gli eventi dei criteri sono azioni correlate a un criterio, ad esempio la creazione di un nuovo criterio.
- Gli eventi di servizio sono azioni relative al servizio di Rights Management, ad esempio la sincronizzazione con la directory utente.
Puoi cercare eventi specifici utilizzando l’API Java di Rights Management o l’API del servizio Web. Cercando gli eventi, è possibile eseguire attività quali la creazione di un file di registro di determinati eventi.
Riepilogo dei passaggi summary_of_steps-10
Per cercare un evento di Rights Management, esegui le seguenti operazioni:
- Includi file di progetto.
- Crea un oggetto API client Rights Management.
- Specifica l’evento per il quale eseguire la ricerca.
- Cerca l’evento.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, 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
Cercare eventi utilizzando l’API Java search-for-events-using-the-java-api
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
DocumentSecurityClientutilizzando il relativo costruttore e passando unServiceClientFactoryoggetto contenente le proprietà di connessione. -
Specifica gli eventi da cercare
- Crea un
EventManagerrichiamando l'oggettoDocumentSecurityClientdell’oggettogetEventManagermetodo . Questo metodo restituisce unEventManageroggetto. - Crea un
EventSearchFilterrichiamando il relativo costruttore. - Specifica l’evento per il quale eseguire la ricerca richiamando il
EventSearchFilterdell’oggettosetEventCodee passare un membro di dati statici appartenente al gruppoEventManagerClasse che rappresenta l'evento di cui eseguire la ricerca. Ad esempio, per cercare l'evento di creazione del criterio, passareEventManager.POLICY_CREATE_EVENT.
note note NOTE Puoi definire criteri di ricerca aggiuntivi richiamando EventSearchFiltermetodi oggetto. Ad esempio, richiama ilsetUserNameper specificare un utente associato all'evento. - Crea un
-
Cerca l’evento
Cerca l’evento richiamando il
EventManagerdell’oggettosearchForEventse passareEventSearchFilteroggetto che definisce i criteri di ricerca degli eventi. Questo metodo restituisce un array diEventoggetti.
Esempi di codice
Per esempi di codice che utilizzano il servizio di Rights Management, consulta i seguenti Quick Starts:
- "Avvio rapido (SOAP): Ricerca di eventi utilizzando l’API Java"
Cercare eventi utilizzando l’API del servizio Web search-for-events-using-the-web-service-api
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.note note NOTE Sostituisci localhostcon l’indirizzo IP del server che ospita AEM Forms. -
Creare un oggetto API client Rights Management
-
Crea un
DocumentSecurityServiceClientutilizzando il relativo costruttore predefinito. -
Crea un
DocumentSecurityServiceClient.Endpoint.AddressutilizzandoSystem.ServiceModel.EndpointAddresscostruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/RightsManagementService?WSDL.) Non è necessario utilizzare illc_versionattributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Crea un
System.ServiceModel.BasicHttpBindingottenendo il valore delDocumentSecurityServiceClient.Endpoint.Bindingcampo . Imposta il valore restituito suBasicHttpBinding. -
Imposta la
System.ServiceModel.BasicHttpBindingdell’oggettoMessageEncodingcampo aWSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente del modulo di AEM al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName. - Assegna il valore della password corrispondente al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password. - Assegna il valore costante
HttpClientCredentialType.Basical campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Assegnare il nome utente del modulo di AEM al campo
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnlyal campoBasicHttpBindingSecurity.Security.Mode.
-
-
Specifica gli eventi da cercare
- Crea un
EventSpecutilizzando il relativo costruttore. - Specifica l'inizio del periodo di tempo durante il quale si è verificato l'evento impostando il
EventSpecdell’oggettofirstTime.datemembro conDataTimeistanza che rappresenta l’inizio dell’intervallo di date in cui si è verificato l’evento. - Assegna il valore
truealEventSpecdell’oggettofirstTime.dateSpecifiedmembro dati. - Specifica la fine del periodo di tempo durante il quale si è verificato l’evento impostando il
EventSpecdell’oggettolastTime.datemembro conDataTimeistanza che rappresenta la fine dell’intervallo di date in cui si è verificato l’evento. - Assegna il valore
truealEventSpecdell’oggettolastTime.dateSpecifiedmembro dati. - Imposta l'evento da cercare assegnando un valore stringa al
EventSpecdell’oggettoeventCodemembro dati. Nella tabella seguente sono elencati i valori numerici che è possibile assegnare a questa proprietà:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 18-row-2 19-row-2 20-row-2 21-row-2 22-row-2 23-row-2 24-row-2 25-row-2 26-row-2 27-row-2 28-row-2 29-row-2 30-row-2 31-row-2 32-row-2 33-row-2 34-row-2 35-row-2 36-row-2 37-row-2 38-row-2 39-row-2 40-row-2 41-row-2 42-row-2 43-row-2 44-row-2 45-row-2 46-row-2 47-row-2 Tipo evento Valore ALL_EVENTS999 USER_CHANGE_PASSWORD_EVENT1000 USER_REGISTER_EVENT1001 USER_PREREGISTER_EVENT1002 USER_ACTIVATE_EVENT1003 USER_DEACTIVATE_EVENT1004 USER_AUTHENTICATE_EVENT1005 USER_AUTHENTICATE_DENY_EVENT1006 USER_ACCOUNT_LOCK_EVENT1007 USER_DELETE_EVENT1008 USER_UPDATE_PROFILE_EVENT1009 DOCUMENT_VIEW_EVENT2000 DOCUMENT_PRINT_LOW_EVENT2001 DOCUMENT_PRINT_HIGH_EVENT2002 DOCUMENT_SIGN_EVENT2003 DOCUMENT_ADD_ANNOTATION_EVENT2004 DOCUMENT_FORM_FILL_EVENT2005 DOCUMENT_CLOSE_EVENT2006 DOCUMENT_MODIFY_EVENT2007 DOCUMENT_CHANGE_SECURITY_HANDLER_EVENT2008 DOCUMENT_SWITCH_POLICY_EVENT2009 DOCUMENT_REVOKE_EVENT2010 $12011 DOCUMENT_SECURE_EVENT2012 DOCUMENT_UNKNOWN_CLIENT_EVENT2013 DOCUMENT_CHANGE_REVOKE_URL_EVENT2014 POLICY_CHANGE_EVENT3000 POLICY_ENABLE_EVENT3001 POLICY_DISABLE_EVENT3002 POLICY_CREATE_EVENT3003 POLICY_DELETE_EVENT3004 POLICY_CHANGE_OWNER_EVENT3005 SERVER_CLIENT_SYNC_EVENT4000 SERVER_SYNC_DIR_INFO_EVENT4001 SERVER_SYNC_DIR_COMPLETE_EVENT4002 SERVER_VERSION_MISMATCH_EVENT4003 SERVER_CONFIG_CHANGE_EVENT4004 SERVER_ENABLE_OFFLINE_ACCESS_EVENT4005 ADMIN_ADD_EVENT5000 ADMIN_DELETE_EVENT5001 ADMIN_EDIT_EVENT5002 ADMIN_ACTIVATE_EVENT5003 ADMIN_DEACTIVATE_EVENT5004 ERROR_DIRECTORY_SERVICE_EVENT6000 CREATED_POLICYSET_EVENT7000 DELETED_POLICYSET_EVENT7001 MODIFIED_POLICYSET_EVENT7002 - Crea un
-
Cerca l’evento
Cerca l’evento richiamando il
DocumentSecurityServiceClientdell’oggettosearchForEventse passareEventSpecoggetto che rappresenta l'evento per il quale eseguire la ricerca e il numero massimo di risultati. Questo metodo restituisce unMyArrayOf_xsd_anyTyperaccolta in cui ogni elemento è unAuditSpecistanza. Utilizzo di unAuditSpecad esempio, puoi ottenere informazioni sull’evento, ad esempio l’ora in cui si è verificato. LaAuditSpecl'istanza contienetimestampmembro dati che specifica queste informazioni.
Esempi di codice
Per esempi di codice che utilizzano il servizio di Rights Management, consulta i seguenti Quick Starts:
- "Avvio rapido (MTOM): Ricerca di eventi tramite l’API del servizio Web"
- "Avvio rapido (SwaRef): Ricerca di eventi tramite l’API del servizio Web"
Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
Applicazione dei criteri ai documenti di Word applying-policies-to-word-documents
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.
Riepilogo dei passaggi summary_of_steps-11
Per applicare un criterio a un documento Word, eseguire le operazioni seguenti:
- Includi file di progetto.
- Creare un oggetto API client Document Security.
- Recuperare un documento Word a cui viene applicato un criterio.
- Applicare un criterio esistente al documento Word.
- Salvare il documento Word protetto da policy.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
Creare un oggetto API client Document Security
Prima di poter eseguire un'operazione del servizio Document Security, è necessario creare un oggetto client del servizio Document Security.
Recupera un documento di Word
È necessario recuperare un documento di Word per applicare un criterio. Dopo aver applicato un criterio al documento Word, gli utenti vengono limitati quando utilizzano il documento. Ad esempio, se il criterio non consente l'apertura del documento in modalità non in linea, per aprire il documento gli utenti devono essere in linea.
Applicare un criterio esistente al documento Word
Per applicare un criterio a un documento di Word, è necessario fare riferimento a un criterio esistente e specificare il set di criteri a cui appartiene il criterio. L'utente che sta impostando le proprietà di connessione deve avere accesso al criterio specificato. In caso contrario, si verifica un'eccezione.
Salva il documento Word
Dopo aver applicato un criterio a un documento Word, è possibile salvare il documento Word protetto da policy come file DOC.
Consulta anche
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Revoca dell’accesso ai documenti
Applicare un criterio a un documento Word utilizzando l'API Java apply-a-policy-to-a-word-document-using-the-java-api
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.
- Crea un
ServiceClientFactoryoggetto contenente le proprietà di connessione. - Crea un
DocumentSecurityClientutilizzando il relativo costruttore e passandoServiceClientFactoryoggetto.
- Crea un
-
Recuperare un documento Word.
- Crea un
java.io.FileInputStreamoggetto che rappresenta il documento di Word utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento di Word. - Crea un
com.adobe.idp.Documentutilizzando il relativo costruttore e passandojava.io.FileInputStreamoggetto.
- Crea un
-
Applicare un criterio esistente al documento Word.
-
Crea un
DocumentManagerrichiamando l'oggettoDocumentSecurityClientdell’oggettogetDocumentManagermetodo . -
Applicare un criterio al documento Word richiamando il
DocumentManagerdell’oggettoprotectDocumente passando i seguenti valori:- La
com.adobe.idp.Documentoggetto che contiene il documento Word a cui viene applicato il criterio. - Valore stringa che specifica il nome del documento.
- Valore stringa che specifica il nome dell'insieme di criteri a cui appartiene il criterio. Puoi specificare un
nullche restituisceMyPoliciesset di criteri in uso. - Valore stringa che specifica il nome del criterio.
- Valore stringa che rappresenta il nome del dominio User Manager dell'utente che è l'editore del documento. Questo valore del parametro è facoltativo e può essere nullo (se questo parametro è nullo, il valore del parametro successivo deve essere nullo).
- Valore stringa che rappresenta il nome canonico dell'utente di user manager che è l'editore del documento. Questo valore del parametro è facoltativo e può essere
null(se questo parametro ènull, il valore del parametro precedente deve esserenull). - A
com.adobe.livecycle.rightsmanagement.Localeche rappresenta le impostazioni internazionali utilizzate per selezionare il modello di MS Office. Questo valore del parametro è facoltativo e puoi specificarenull.
La
protectDocumentrestituisce unRMSecureDocumentResultoggetto contenente il documento Word protetto da policy. - La
-
-
Salvare il documento Word.
- Richiama il
RMSecureDocumentResultdell’oggettogetProtectedDocper ottenere il documento Word protetto da policy. Questo metodo restituisce uncom.adobe.idp.Documentoggetto. - Crea un
java.io.Filee assicurati che l'estensione del file sia DOC. - Richiama il
com.adobe.idp.Documentdell’oggettocopyToFileper copiare il contenuto delDocumental file (assicurati di utilizzareDocumentoggetto restituito dagetProtectedDocmetodo).
- Richiama il
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere la seguente Guida rapida:
- "Avvio rapido (modalità SOAP): Applicazione di un criterio a un documento Word utilizzando l'API Java"
Applicare un criterio a un documento Word utilizzando l'API del servizio Web apply-a-policy-to-a-word-document-using-the-web-service-api
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.note note NOTE Sostituisci localhostcon l’indirizzo IP del server che ospita AEM Forms. -
Creare un oggetto API client Document Security.
-
Crea un
DocumentSecurityServiceClientutilizzando il relativo costruttore predefinito. -
Crea un
DocumentSecurityServiceClient.Endpoint.AddressutilizzandoSystem.ServiceModel.EndpointAddresscostruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/DocumentSecurityService?WSDL.) Non è necessario utilizzare illc_versionattributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Crea un
System.ServiceModel.BasicHttpBindingottenendo il valore delDocumentSecurityServiceClient.Endpoint.Bindingcampo . Imposta il valore restituito suBasicHttpBinding. -
Imposta la
System.ServiceModel.BasicHttpBindingdell’oggettoMessageEncodingcampo aWSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente del modulo di AEM al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName. - Assegna il valore della password corrispondente al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password. - Assegna il valore costante
HttpClientCredentialType.Basical campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Assegnare il nome utente del modulo di AEM al campo
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnlyal campoBasicHttpBindingSecurity.Security.Mode.
-
-
Recuperare un documento Word.
- Crea un
BLOButilizzando il relativo costruttore. LaBLOBviene utilizzato per memorizzare un documento di Word a cui viene applicato un criterio. - Crea un
System.IO.FileStreamrichiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento di Word e la modalità di apertura del file. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStreamoggetto. Determina la dimensione dell'array di byte ottenendo ilSystem.IO.FileStreamdell’oggettoLengthproprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStreamdell’oggettoReadmetodo . Passa la matrice dei byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOBoggetto assegnando il relativoMTOMcon il contenuto dell'array di byte.
- Crea un
-
Applicare un criterio esistente al documento Word.
Applicare un criterio al documento Word richiamando il
DocumentSecurityServiceClientdell’oggettoprotectDocumente passando i seguenti valori:- La
BLOBoggetto che contiene il documento Word a cui viene applicato il criterio. - Valore stringa che specifica il nome del documento.
- Valore stringa che specifica il nome dell'insieme di criteri a cui appartiene il criterio. Puoi specificare un
nullche restituisceMyPoliciesset di criteri in uso. - Valore stringa che specifica il nome del criterio.
- Valore stringa che rappresenta il nome del dominio User Manager dell'utente che è l'editore del documento. Questo valore del parametro è facoltativo e può essere nullo (se questo parametro è nullo, il valore del parametro successivo deve essere
null). - Valore stringa che rappresenta il nome canonico dell'utente di user manager che è l'editore del documento. Questo valore del parametro è facoltativo e può essere nullo (se questo parametro è nullo, il valore del parametro precedente deve essere
null). - A
RMLocalevalore che specifica il valore delle impostazioni internazionali (ad esempio,RMLocale.en). - Parametro di output della stringa utilizzato per memorizzare il valore dell'identificatore del criterio.
- Parametro di output della stringa utilizzato per memorizzare il valore dell'identificatore protetto da policy.
- Un parametro di output della stringa utilizzato per memorizzare il tipo di mime (ad esempio,
application/doc).
La
protectDocumentrestituisce unBLOBoggetto contenente il documento Word protetto da policy. - La
-
Salvare il documento Word.
- Crea un
System.IO.FileStreamrichiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento Word protetto da policy. - Creare un array di byte che memorizza il contenuto dei dati del
BLOBoggetto restituito daprotectDocumentmetodo . Compilare l’array di byte ottenendo il valore delBLOBdell’oggettoMTOMmembro dati. - Crea un
System.IO.BinaryWriterrichiamando il relativo costruttore e passandoSystem.IO.FileStreamoggetto. - Scrivi il contenuto dell'array di byte in un file Word richiamando il
System.IO.BinaryWriterdell’oggettoWritee passare l'array di byte.
- Crea un
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere la seguente Guida rapida:
- "Avvio rapido (MTOM): Applicazione di un criterio a un documento Word tramite l'API del servizio Web"
Rimozione di criteri dai documenti di Word removing-policies-from-word-documents
È 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.
Riepilogo dei passaggi summary_of_steps-12
Per rimuovere un criterio da un documento Word protetto da policy, eseguire le operazioni seguenti:
- Includi file di progetto
- Creare un oggetto API client Document Security.
- Recuperare un documento Word protetto da policy.
- Rimuovere il criterio dal documento Word.
- Salvare i documenti Word non protetti
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
Creare un oggetto API client di sicurezza dei documenti
Prima di eseguire un'operazione del servizio Document Security, creare un oggetto client del servizio Document Security.
Recuperare un documento Word protetto da policy
Per rimuovere un criterio, è necessario recuperare un documento Word protetto da policy. Se si tenta di rimuovere un criterio da un documento di Word non protetto da un criterio, verrà generata un'eccezione.
Rimuovi il criterio dal documento Word
È possibile rimuovere un criterio da un documento Word protetto da criteri purché nelle impostazioni di connessione sia specificato un amministratore. In caso contrario, il criterio utilizzato per proteggere un documento deve contenere SWITCH_POLICY per rimuovere un criterio da un documento di Word. Inoltre, anche l’utente specificato nelle impostazioni di connessione di AEM Forms deve disporre di tale autorizzazione. In caso contrario, viene generata un'eccezione.
Salvare il documento Word non protetto
Dopo che il servizio Document Security rimuove un criterio da un documento Word, è possibile salvare il documento Word non protetto come file DOC.
Consulta anche
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Applicazione dei criteri ai documenti di Word
Rimuovere un criterio da un documento Word utilizzando l'API Java remove-a-policy-from-a-word-document-using-the-java-api
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
- Crea un
ServiceClientFactoryoggetto contenente le proprietà di connessione. - Crea un
RightsManagementClientutilizzando il relativo costruttore e passandoServiceClientFactoryoggetto.
- Crea un
-
Recuperare un documento Word protetto da policy
- Crea un
java.io.FileInputStreamoggetto 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. - Crea un
com.adobe.idp.Documentutilizzando il relativo costruttore e passandojava.io.FileInputStreamoggetto.
- Crea un
-
Rimuovi il criterio dal documento Word
- Crea un
DocumentManagerrichiamando l'oggettoRightsManagementClientdell’oggettogetDocumentManagermetodo . - Rimuovere un criterio dal documento Word richiamando il
DocumentManagerdell’oggettoremoveSecuritye passarecom.adobe.idp.Documentoggetto contenente il documento Word protetto da policy. Questo metodo restituisce uncom.adobe.idp.Documentoggetto contenente un documento Word non protetto.
- Crea un
-
Salvare il documento Word non protetto
- Crea un
java.io.Filee assicurati che l'estensione del file sia DOC. - Richiama il
Documentdell’oggettocopyToFileper copiare il contenuto delDocumental file (assicurati di utilizzareDocumentoggetto restituito daremoveSecuritymetodo).
- Crea un
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere la seguente Guida rapida:
- "Avvio rapido (modalità SOAP): Rimozione di un criterio da un documento Word utilizzando l'API Java"
Rimuovere un criterio da un documento Word utilizzando l'API del servizio Web remove-a-policy-from-a-word-document-using-the-web-service-api
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.note note NOTE Sostituisci localhostcon l’indirizzo IP del server che ospita AEM Forms. -
Creare un oggetto API client di sicurezza dei documenti
-
Crea un
RightsManagementServiceClientutilizzando il relativo costruttore predefinito. -
Crea un
RightsManagementServiceClient.Endpoint.AddressutilizzandoSystem.ServiceModel.EndpointAddresscostruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/RightsManagementService?WSDL.) Non è necessario utilizzare illc_versionattributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Crea un
System.ServiceModel.BasicHttpBindingottenendo il valore delRightsManagementServiceClient.Endpoint.Bindingcampo . Imposta il valore restituito suBasicHttpBinding. -
Imposta la
System.ServiceModel.BasicHttpBindingdell’oggettoMessageEncodingcampo aWSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente del modulo di AEM al campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName. - Assegna il valore della password corrispondente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password. - Assegna il valore costante
HttpClientCredentialType.Basical campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Assegnare il nome utente del modulo di AEM al campo
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnlyal campoBasicHttpBindingSecurity.Security.Mode.
-
-
Recuperare un documento Word protetto da policy
- Crea un
BLOButilizzando il relativo costruttore. LaBLOBl'oggetto viene utilizzato per memorizzare il documento Word protetto dai criteri da cui viene rimosso il criterio. - Crea un
System.IO.FileStreamrichiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento di Word e la modalità di apertura del file. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStreamoggetto. È possibile determinare le dimensioni dell'array di byte ottenendo ilSystem.IO.FileStreamdell’oggettoLengthproprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStreamdell’oggettoReade passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOBoggetto assegnando il relativoMTOMcon il contenuto dell'array di byte.
- Crea un
-
Rimuovi il criterio dal documento Word
Rimuovere il criterio dal documento Word richiamando il
RightsManagementServiceClientdell’oggettoremovePolicySecuritye passareBLOBoggetto contenente il documento Word protetto da policy. Questo metodo restituisce unBLOBoggetto contenente un documento Word non protetto. -
Salvare il documento Word non protetto
- Crea un
System.IO.FileStreamrichiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento Word non protetto. - Creare un array di byte che memorizza il contenuto dei dati del
BLOBoggetto restituito daremovePolicySecuritymetodo . Compilare l’array di byte ottenendo il valore delBLOBdell’oggettoMTOMcampo . - Crea un
System.IO.BinaryWriterrichiamando il relativo costruttore e passandoSystem.IO.FileStreamoggetto.
- Crea un
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, vedere la seguente Guida rapida:
- "Avvio rapido (MTOM): Rimozione di un criterio da un documento Word utilizzando l'API del servizio Web"
Consulta anche
Richiamo di AEM Forms tramite MTOM