Documenten beveiligen met beleid protecting-documents-with-policies
de Steekproeven en de voorbeelden in dit document zijn slechts voor AEM Forms op milieu JEE.
Ongeveer de Dienst van de Veiligheid van het Document
Met de Document Security-service kunnen gebruikers op dynamische wijze instellingen voor vertrouwelijkheid toepassen op Adobe PDF-documenten en de controle houden over de documenten, ongeacht de mate waarin deze worden verspreid.
De dienst van de Veiligheid van het Document verhindert informatie zich voorbij het bereik van de gebruiker te verspreiden door de gebruikers toe te laten om controle over te houden hoe de ontvangers het beleid-beschermde document van de PDF gebruiken. Een gebruiker kan opgeven wie een document mag openen, hoe hij het kan gebruiken en het document na de verspreiding ervan controleren. Een gebruiker kan ook dynamisch de toegang tot een document beheren dat met een beleid is beveiligd en kan de toegang tot het document zelfs dynamisch intrekken.
De service Documentbeveiliging beschermt ook andere bestandstypen, zoals Microsoft Word-bestanden (DOC-bestanden). U kunt de client-API voor documentbeveiliging gebruiken om met deze bestandstypen te werken. De volgende versies worden ondersteund:
- Microsoft Office 2003-bestanden (DOC-, XLS-, PPT-bestanden)
- Microsoft Office 2007-bestanden (DOCX-, XLSX-, PPTX-bestanden)
- PTC Pro/E-bestanden
Voor de duidelijkheid bespreken de volgende twee secties hoe te met de documenten van Word te werken:
U kunt deze taken uitvoeren met de documentbeveiligingsservice:
- Beleid maken. Voor informatie, zie Creërend Beleid.
- Beleid wijzigen. Voor informatie, zie Wijzend Beleid.
- Beleid verwijderen. Voor informatie, zie het Schrappen van Beleid.
- Beleid toepassen op PDF-documenten. Voor informatie, zie Toepassend Beleid op de Documenten van de PDF.
- Beleid verwijderen uit PDF-documenten. Voor informatie, zie Verwijderend Beleid uit de Documenten van de PDF.
- Met een beleid beveiligde documenten van Inspect. Voor informatie, zie Inspecterend Beleid Beschermde Documenten van de PDF.
- Toegang tot PDF-documenten intrekken. Voor informatie, zie het Herroepen Toegang tot Documenten.
- Toegang tot ingetrokken documenten opnieuw instellen. Voor informatie, zie Wederopstellend Toegang tot Geherroepen Documenten.
- Watermerken maken. Voor informatie, zie Creërend Watermerken.
- Zoeken naar gebeurtenissen. Voor informatie, zie zoekend naar Gebeurtenissen.
Beleid maken creating-policies
U kunt beleid programmatisch maken met de Java API voor documentbeveiliging of de webservice-API. A beleid is een inzameling van informatie die de montages van de documentveiligheid, erkende gebruikers, en gebruiksrechten omvat. U kunt een willekeurig aantal beleidsregels maken en opslaan met de beveiligingsinstellingen die geschikt zijn voor verschillende situaties en gebruikers.
Het beleid laat u toe om deze taken uit te voeren:
- Geef de personen op die het document kunnen openen. Ontvangers kunnen tot uw organisatie behoren of zich buiten uw organisatie bevinden.
- Geef op hoe ontvangers het document kunnen gebruiken. U kunt de toegang tot verschillende Acrobat- en Adobe Reader-functies beperken. Deze functies omvatten de mogelijkheid om tekst af te drukken en te kopiëren, handtekeningen toe te voegen en opmerkingen toe te voegen aan een document.
- Wijzig de toegangs- en beveiligingsinstellingen op elk gewenst moment, zelfs nadat u het document met beveiliging hebt gedistribueerd.
- Controleer het gebruik van het document nadat u het hebt verspreid. U kunt zien hoe het document wordt gebruikt en wie het gebruikt. U kunt bijvoorbeeld erachter komen wanneer iemand het document heeft geopend.
Beleid maken met behulp van webservices creating-a-policy-using-web-services
Wanneer u een beleid maakt met de webservice-API, verwijst u naar een bestaand XML-bestand (Portable Document Rights Language) waarin het beleid wordt beschreven. Beleidsmachtigingen en de principal worden gedefinieerd in het PDRL-document. Het volgende XML-document is een voorbeeld van een PDRL-document.
<?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>
Overzicht van de stappen summary-of-steps
Voer de volgende stappen uit om een beleid te maken:
- Inclusief projectbestanden.
- Maak een API-object voor Document Security Client.
- Stel de kenmerken van het beleid in.
- Maak een beleidsvermelding.
- Registreer het beleid.
omvat projectdossiers
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.
De volgende JAR-bestanden moeten worden toegevoegd aan het klassepad van uw project:
- adobe-rightsmanagement-client.jar
- namespace.jar (als AEM Forms wordt opgesteld op JBoss)
- jaxb-api.jar (als AEM Forms wordt geïmplementeerd op JBoss)
- jaxb-impl.jar (als AEM Forms wordt geïmplementeerd op JBoss)
- jaxb-libs.jar (als AEM Forms wordt geïmplementeerd op JBoss)
- jaxb-xjc.jar (als AEM Forms wordt geïmplementeerd op JBoss)
- relaxngDatatype.jar (als AEM Forms wordt geïmplementeerd op JBoss)
- xsdlib.jar (als AEM Forms wordt geïmplementeerd op JBoss)
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-utilities.jar
- jbossall-client.jar (gebruik een ander JAR-bestand als AEM Forms niet is geïmplementeerd op JBoss)
Voor informatie over de plaats van deze JAR dossiers, zie Inclusief de bibliotheekdossiers van AEM Forms Java.
creeer een voorwerp van de Cliënt API van de Veiligheid van het Document
Voordat u via programmacode een bewerking met de documentbeveiligingsservice kunt uitvoeren, maakt u een clientobject van de documentbeveiligingsservice.
plaats de attributen van het beleid
Stel beleidskenmerken in om een beleid te maken. Een verplicht kenmerk is de beleidsnaam. Beleidsnamen moeten uniek zijn voor elke beleidsset. Een beleidsset is gewoon een verzameling van beleidsmaatregelen. Er kunnen twee beleid met dezelfde naam zijn als het beleid tot afzonderlijke beleidsreeksen behoort. Twee beleid binnen één beleidsset kan echter niet dezelfde beleidsnaam hebben.
Een ander nuttig kenmerk dat moet worden ingesteld, is de geldigheidsperiode. Een geldigheidsperiode is de periode waarin een document dat onder een beleid valt, toegankelijk is voor geautoriseerde ontvangers. Als u dit kenmerk niet instelt, is het beleid altijd geldig.
U kunt een geldigheidsperiode instellen op een van de volgende opties:
- Een bepaald aantal dagen dat het document toegankelijk is vanaf het moment dat het document wordt gepubliceerd
- Een einddatum waarna het document niet toegankelijk is
- Een specifiek datumbereik waarvoor het document toegankelijk is
- Altijd geldig
U kunt alleen een begindatum opgeven, wat betekent dat het beleid geldig is na de begindatum. Als u slechts een einddatum specificeert, is het beleid geldig tot de einddatum. Er wordt echter een uitzondering gegenereerd als zowel een begindatum als een einddatum niet zijn gedefinieerd.
Wanneer u kenmerken instelt die tot een beleid behoren, kunt u ook versleutelingsinstellingen instellen. Deze versleutelingsinstellingen zijn van invloed wanneer het beleid wordt toegepast op een document. U kunt de volgende versleutelingswaarden opgeven:
- AES256: Vertegenwoordigt het AES encryptiealgoritme met een sleutel met 256 bits.
- AES128: Vertegenwoordigt het AES encryptiealgoritme met een sleutel met 128 bits.
- NoEncryption: vertegenwoordigt geen encryptie.
Wanneer u de optie NoEncryption
opgeeft, kunt u de optie PlaintextMetadata
niet instellen op false
. Wanneer u dit probeert, wordt een uitzondering gegenereerd.
Policy
interfacebeschrijving in de AEM Forms API Verwijzing.creeer een beleidsingang
Een beleidsingang verbindt hoofden, die groepen en gebruikers zijn, en toestemmingen aan een beleid. Een beleid moet ten minste één beleidslijn hebben. Stel bijvoorbeeld dat u de volgende taken uitvoert:
- Maak en registreer een beleidsvermelding waarmee een groep een document alleen online kan bekijken en ontvangers het niet kunnen kopiëren.
- Koppel de beleidsvermelding aan het beleid.
- Beveilig een document met het beleid door Acrobat te gebruiken.
Hierdoor kunnen ontvangers het document alleen online bekijken en niet kopiëren. Het document blijft beveiligd totdat de beveiliging ervan is verwijderd.
registreer het beleid
Een nieuw beleid moet worden geregistreerd alvorens het kan worden gebruikt. Nadat u een beleid hebt geregistreerd, kunt u het gebruiken om documenten te beschermen.
Een beleid maken met de Java API create-a-policy-using-the-java-api
Een beleid maken met de API voor documentbeveiliging (Java):
-
Inclusief projectbestanden.
Neem client-JAR-bestanden, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project.
-
Maak een API-object voor Document Security Client.
- Maak een
ServiceClientFactory
-object dat verbindingseigenschappen bevat. - Maak een
DocumentSecurityClient
-object door de constructor ervan te gebruiken en hetServiceClientFactory
-object door te geven.
- Maak een
-
Stel de kenmerken van het beleid in.
- Maak een
Policy
-object door de statische methodeInfomodelObjectFactory
van het objectcreatePolicy
aan te roepen. Deze methode retourneert eenPolicy
-object. - Stel het kenmerk name van het beleid in door de methode
setName
van het objectPolicy
aan te roepen en een tekenreekswaarde door te geven die de naam van het beleid aangeeft. - Stel de beschrijving van het beleid in door de methode
setDescription
van het objectPolicy
aan te roepen en een tekenreekswaarde door te geven die de beschrijving van het beleid opgeeft. - Geef de beleidsset op waartoe het nieuwe beleid behoort door de methode
setPolicySetName
van het objectPolicy
aan te roepen en een tekenreekswaarde door te geven die de naam van de beleidsset opgeeft. (U kuntnull
voor deze parameterwaarde specificeren die in het beleid dat aan wordt toegevoegd Mijn Beleid beleidsreeks.) - Maak de geldigheidsperiode van het beleid door de statische methode
createValidityPeriod
van het objectInfomodelObjectFactory
aan te roepen. Deze methode retourneert eenValidityPeriod
-object. - Stel het aantal dagen in waarvoor een document dat met een beleid is beveiligd, toegankelijk is door de methode
setRelativeExpirationDays
van het objectValidityPeriod
aan te roepen en een geheel getal door te geven dat het aantal dagen opgeeft. - Stel de geldigheidsperiode van het beleid in door de methode
setValidityPeriod
van het objectPolicy
aan te roepen en het objectValidityPeriod
door te geven.
- Maak een
-
Maak een beleidsvermelding.
- Maak een beleidsitem door de statische methode
createPolicyEntry
van het objectInfomodelObjectFactory
aan te roepen. Deze methode retourneert eenPolicyEntry
-object. - Geef de beleidsmachtigingen op door de statische methode
createPermission
van het objectInfomodelObjectFactory
aan te roepen. Geef een statisch gegevenslid door dat tot dePermission
interface behoort die de toestemming vertegenwoordigt. Deze methode retourneert eenPermission
-object. Als u bijvoorbeeld de machtiging wilt toevoegen waarmee gebruikers gegevens kunnen kopiëren uit een met een beleid beveiligd PDF-document, geeft uPermission.COPY
door. (Herhaal deze stap voor elke machtiging die u wilt toevoegen.) - Voeg de machtiging aan de beleidsvermelding toe door de methode
addPermission
van het objectPolicyEntry
aan te roepen en het objectPermission
door te geven. (Herhaal deze stap voor elkPermission
-object dat u hebt gemaakt). - Maak de beleidshoofd door de statische methode
createSpecialPrincipal
van het objectInfomodelObjectFactory
aan te roepen. Geef een gegevenslid door dat behoort tot hetInfomodelObjectFactory
-object dat de principal vertegenwoordigt. Deze methode retourneert eenPrincipal
-object. Als u bijvoorbeeld de uitgever van het document als hoofd wilt toevoegen, geeft uInfomodelObjectFactory.PUBLISHER_PRINCIPAL
door. - Voeg het hoofd aan de beleidsingang toe door de
setPrincipal
methode van objectenPolicyEntry
aan te roepen en hetPrincipal
voorwerp over te gaan. - Voeg de beleidsvermelding aan het beleid toe door de methode
addPolicyEntry
van het objectPolicy
aan te roepen en het objectPolicyEntry
door te geven.
- Maak een beleidsitem door de statische methode
-
Registreer het beleid.
-
Maak een
PolicyManager
-object door de methodeDocumentSecurityClient
objectgetPolicyManager
aan te roepen. -
Registreer het beleid door de methode
registerPolicy
van het objectPolicyManager
aan te roepen en de volgende waarden door te geven:- Het
Policy
-object dat het te registreren beleid vertegenwoordigt.
- Het
-
Een tekenreekswaarde die staat voor de beleidsset waartoe het beleid behoort.
Als u binnen de verbindingsinstellingen een beheerdersaccount voor AEM formulieren gebruikt om het
DocumentSecurityClient
-object te maken, geeft u de naam van de beleidsset op wanneer u de methoderegisterPolicy
aanroept. Als u eennull
waarde voor de beleidsreeks overgaat, wordt het beleid gecreeerd in de beheerders Mijn Beleid beleidsreeks.Als u een gebruiker van de Veiligheid van het Document binnen verbindingsmontages gebruikt, dan kunt u de overbelaste
registerPolicy
methode aanhalen die slechts het beleid goedkeurt. U hoeft dus geen naam voor de beleidsset op te geven. Nochtans, wordt het beleid toegevoegd aan de beleidsreeks genoemd Mijn Beleid. Als u het nieuwe beleid niet aan deze beleidreeks wilt toevoegen, dan specificeer een naam van de beleidsreeks wanneer u deregisterPolicy
methode aanhaalt.note note NOTE Verwijs bij het maken van een beleid naar een bestaande beleidsset. Als u een beleidsset opgeeft die niet bestaat, wordt een uitzondering gegenereerd. -
Zie het volgende voor codevoorbeelden met de Document Security-service:
- "Snel starten (SOAP modus): beleid maken met de Java API"
Beleid maken met de webservice-API create-a-policy-using-the-web-service-api
Een beleid maken met de API voor documentbeveiliging (webservice):
-
Inclusief projectbestanden.
Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Vervang localhost
door het IP-adres van de server die als host fungeert voor AEM Forms. -
Maak een API-object voor Document Security Client.
-
Maak een
DocumentSecurityServiceClient
-object met de standaardconstructor. -
Maak een
DocumentSecurityServiceClient.Endpoint.Address
-object met deSystem.ServiceModel.EndpointAddress
-constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeldhttp://localhost:8080/soap/services/RightsManagementService?WSDL
.) U hoeft het attribuutlc_version
niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.) -
Maak een
System.ServiceModel.BasicHttpBinding
-object door de waarde van hetRightsManagementServiceClient.Endpoint.Binding
-veld op te halen. De geretourneerde waarde wordt gecast naarBasicHttpBinding
. -
Stel het veld
MessageEncoding
van hetSystem.ServiceModel.BasicHttpBinding
-object in opWSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt. -
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
- Wijs de gebruikersnaam van het AEM aan het veld
RightsManagementServiceClient.ClientCredentials.UserName.UserName
toe. - Wijs de bijbehorende wachtwoordwaarde toe aan het veld
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Wijs de constante waarde
HttpClientCredentialType.Basic
toe aan het veldBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Wijs de gebruikersnaam van het AEM aan het veld
-
Wijs de constante waarde
BasicHttpSecurityMode.TransportCredentialOnly
toe aan het veldBasicHttpBindingSecurity.Security.Mode
.
-
-
Stel de kenmerken van het beleid in.
- Maak een
PolicySpec
-object met behulp van de constructor. - Stel de naam van het beleid in door een tekenreekswaarde toe te wijzen aan het
name
-gegevenslid van hetPolicySpec
-object. - Stel de beschrijving van het beleid in door een tekenreekswaarde toe te wijzen aan het
description
-gegevenslid van hetPolicySpec
-object. - Geef de beleidsset op waartoe het beleid behoort door een tekenreekswaarde toe te wijzen aan het gegevenslid
policySetName
van hetPolicySpec
-object. Geef een bestaande naam voor een beleidsset op. (U kuntnull
voor deze parameterwaarde specificeren die in het beleid dat aan wordt toegevoegd Mijn Beleid.) - Stel de offline leaseperiode van het beleid in door een geheel-getalwaarde toe te wijzen aan het gegevenslid
offlineLeasePeriod
van hetPolicySpec
-object. - Stel het gegevenslid
policyXml
van hetPolicySpec
-object in met een tekenreekswaarde die PDRL XML-gegevens vertegenwoordigt. Om deze taak uit te voeren, creeer een .NETStreamReader
voorwerp door zijn aannemer te gebruiken. Geef de locatie van een PDRL XML-bestand dat het beleid vertegenwoordigt, door aan de constructorStreamReader
. Roep vervolgens de methodeReadLine
van het objectStreamReader
aan en wijs de geretourneerde waarde toe aan een tekenreeksvariabele. Doorlopen van het objectStreamReader
totdat de methodeReadLine
null retourneert. Wijs de tekenreeksvariabele toe aan het gegevenslidpolicyXml
van hetPolicySpec
-object.
- Maak een
-
Maak een beleidsvermelding.
Het is niet nodig om een beleidsitem te maken wanneer u een beleid maakt met de webservice-API voor documentbeveiliging. Het beleidsitem wordt gedefinieerd in het PDF-document.
-
Registreer het beleid.
Registreer het beleid door de methode
registerPolicy
van het objectDocumentSecurityServiceClient
aan te roepen en de volgende waarden door te geven:- Het
PolicySpec
-object dat het te registreren beleid vertegenwoordigt. - Een tekenreekswaarde die staat voor de beleidsset waartoe het beleid behoort. U kunt een
null
waarde specificeren die in het beleid resulteert dat aan wordt toegevoegd MyPolices beleidsreeks.
Als u binnen de verbindingsinstellingen een beheerdersaccount voor AEM formulieren gebruikt om het
DocumentSecurityClient
-object te maken, geeft u de naam van de beleidsset op wanneer u de methoderegisterPolicy
aanroept.Als u een gebruiker van de Veiligheid van het Document SecurityDocument binnen verbindingsmontages gebruikt, dan kunt u de overbelaste methode aanhalen
registerPolicy
die slechts het beleid goedkeurt. U hoeft dus geen naam voor de beleidsset op te geven. Nochtans, wordt het beleid toegevoegd aan de beleidsreeks genoemd Mijn Beleid. Als u het nieuwe beleid niet aan deze beleidreeks wilt toevoegen, dan specificeer een naam van de beleidsreeks wanneer u deregisterPolicy
methode aanhaalt.note note NOTE Wanneer het creëren van een beleid en u specificeert een beleidsreeks, zorg ervoor dat u een bestaande beleidsreeks specificeert. Als u een beleidsset opgeeft die niet bestaat, wordt een uitzondering gegenereerd. - Het
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
- "Quick Start (MTOM): Creating a policy using the web service API"
- "Quick Start (SwaRef): Creating a policy using the web service API"
Beleid wijzigen modifying-policies
U kunt een bestaand beleid wijzigen met de Java API voor documentbeveiliging of de webservice-API. Om een bestaand beleid te veranderen, wint u het terug, wijzigt het, en werkt dan het beleid op de server bij. Stel dat u een bestaand beleid ophaalt en de geldigheidsperiode ervan verlengt. Voordat de wijziging van kracht wordt, moet u het beleid bijwerken.
U kunt een beleid wijzigen wanneer de bedrijfsvereisten veranderen en het beleid niet meer op deze vereisten wijst. In plaats van een beleid te maken, kunt u gewoon een bestaand beleid bijwerken.
Als u beleidskenmerken wilt wijzigen met behulp van een webservice (bijvoorbeeld met Java-proxyklassen die zijn gemaakt met JAX-WS), moet u ervoor zorgen dat het beleid is geregistreerd bij de Document Security-service. Vervolgens kunt u naar het bestaande beleid verwijzen met de methode PolicySpec.getPolicyXml
en de beleidskenmerken wijzigen met de toepasselijke methoden. U kunt bijvoorbeeld de offline leaseperiode wijzigen door de methode PolicySpec.setOfflineLeasePeriod
aan te roepen.
Overzicht van de stappen summary_of_steps-1
Voer de volgende stappen uit om een bestaand beleid te wijzigen:
- Inclusief projectbestanden.
- Maak een API-object voor Document Security Client.
- Een bestaand beleid ophalen.
- Beleidskenmerken wijzigen.
- Werk het beleid bij.
omvat projectdossiers
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.
creeer een voorwerp van de Cliënt API van de Veiligheid van het Document
Voordat u via programmacode een bewerking voor documentbeveiliging kunt uitvoeren, moet u een client-object voor documentbeveiliging maken. Maak een RightsManagementClient
-object als u de Java API gebruikt. Als u de webservice-API voor documentbeveiliging gebruikt, maakt u een RightsManagementServiceService
-object.
wint een bestaand beleid terug
Haal een bestaand beleid op om het te wijzigen. Om een beleid terug te winnen, specificeer de beleidsnaam en het beleid dat wordt geplaatst waartot het beleid behoort. Als u een null
waarde voor de naam van de beleidsreeks specificeert, wordt het beleid teruggewonnen van Mijn 2} beleidsreeks van Beleid.
plaats de attributen van het beleid
Als u een beleid wilt wijzigen, wijzigt u de waarde van beleidskenmerken. Het enige beleidskenmerk dat u niet kunt wijzigen, is het naamkenmerk. Bijvoorbeeld, om de off-line huurperiode van het beleid te veranderen, kunt u de waarde van de off-line de huurperiode van het beleid attributen wijzigen.
Wanneer u de offline leaseperiode van een beleid wijzigt met behulp van een webservice, wordt het veld offlineLeasePeriod
in de interface van PolicySpec
genegeerd. Als u de offline leaseperiode wilt bijwerken, wijzigt u het element OfflineLeasePeriod
in het PDF XML-document. Verwijs vervolgens naar het bijgewerkte PDRL XML-document met het policyXML
-gegevenslid van de interface PolicySpec
.
Policy
interfacebeschrijving in de AEM Forms API Verwijzing.werk het beleid bij
Voordat de wijzigingen die u in een beleid aanbrengt, worden doorgevoerd, moet u het beleid bijwerken met de documentbeveiligingsservice. Wijzigingen in beleid dat documenten beveiligt, worden de volgende keer dat het document met beveiligingsbeleid wordt gesynchroniseerd met de documentbeveiligingsservice bijgewerkt.
Bestaand beleid wijzigen met de Java API modify-existing-policies-using-the-java-api
Wijzig een bestaand beleid met de API voor documentbeveiliging (Java):
-
Inclusief projectbestanden.
Neem client-JAR-bestanden, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project.
-
Maak een API-object voor Document Security Client.
- Maak een
ServiceClientFactory
-object dat verbindingseigenschappen bevat. - Maak een
RightsManagementClient
-object door de constructor ervan te gebruiken en hetServiceClientFactory
-object door te geven.
- Maak een
-
Een bestaand beleid ophalen.
-
Maak een
PolicyManager
-object door de methodeRightsManagementClient
objectgetPolicyManager
aan te roepen. -
Maak een
Policy
-object dat het beleid vertegenwoordigt dat moet worden bijgewerkt door de methode van hetPolicyManager
objectgetPolicy
aan te roepen en de volgende waarden door te geven."- Een tekenreekswaarde die staat voor de naam van de beleidsset waartoe het beleid behoort. U kunt
null
opgeven die als resultaat heeft dat deMyPolicies
-beleidsset wordt gebruikt. - Een tekenreekswaarde die de naam van het beleid vertegenwoordigt.
- Een tekenreekswaarde die staat voor de naam van de beleidsset waartoe het beleid behoort. U kunt
-
-
Stel de kenmerken van het beleid in.
Verander de attributen van het beleid om aan uw bedrijfsvereisten te voldoen. Als u bijvoorbeeld de offline leaseperiode van het beleid wilt wijzigen, roept u de methode
setOfflineLeasePeriod
van het objectPolicy
aan. -
Werk het beleid bij.
Werk het beleid bij door de methode
updatePolicy
van hetPolicyManager
-object aan te roepen. Geef hetPolicy
-object door dat het beleid vertegenwoordigt dat moet worden bijgewerkt.
de voorbeelden van de Code
Zie Snel starten (modus SOAP): Een beleid wijzigen met de Java API-sectie voor codevoorbeelden met de documentbeveiligingsservice.
Bestaand beleid wijzigen met de webservice-API modify-existing-policies-using-the-web-service-api
Wijzig een bestaand beleid met de API voor documentbeveiliging (webservice):
-
Inclusief projectbestanden.
Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Vervang localhost
door het IP-adres van de server die als host fungeert voor AEM Forms. -
Maak een API-object voor Document Security Client.
-
Maak een
RightsManagementServiceClient
-object met de standaardconstructor. -
Maak een
RightsManagementServiceClient.Endpoint.Address
-object met deSystem.ServiceModel.EndpointAddress
-constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeldhttp://localhost:8080/soap/services/RightsManagementService?WSDL
.) U hoeft het attribuutlc_version
niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.) -
Maak een
System.ServiceModel.BasicHttpBinding
-object door de waarde van hetRightsManagementServiceClient.Endpoint.Binding
-veld op te halen. De geretourneerde waarde wordt gecast naarBasicHttpBinding
. -
Stel het veld
MessageEncoding
van hetSystem.ServiceModel.BasicHttpBinding
-object in opWSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt. -
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
- Wijs de gebruikersnaam van het AEM aan het veld
RightsManagementServiceClient.ClientCredentials.UserName.UserName
toe. - Wijs de bijbehorende wachtwoordwaarde toe aan het veld
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Wijs de constante waarde
HttpClientCredentialType.Basic
toe aan het veldBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Wijs de gebruikersnaam van het AEM aan het veld
-
Wijs de constante waarde
BasicHttpSecurityMode.TransportCredentialOnly
toe aan het veldBasicHttpBindingSecurity.Security.Mode
.
-
-
Een bestaand beleid ophalen.
Maak een
PolicySpec
-object dat het beleid vertegenwoordigt dat moet worden gewijzigd door de methodeRightsManagementServiceClient
objectgetPolicy
aan te roepen en de volgende waarden door te geven:- Een tekenreekswaarde die de naam van de beleidsset opgeeft waartoe het beleid behoort. U kunt
null
opgeven die als resultaat heeft dat deMyPolicies
-beleidsset wordt gebruikt. - Een tekenreekswaarde die de naam van het beleid opgeeft.
- Een tekenreekswaarde die de naam van de beleidsset opgeeft waartoe het beleid behoort. U kunt
-
Stel de kenmerken van het beleid in.
Verander de attributen van het beleid om aan uw bedrijfsvereisten te voldoen.
-
Werk het beleid bij.
Werk het beleid bij door de methode
updatePolicyFromSDK
van het objectRightsManagementServiceClient
aan te roepen en het objectPolicySpec
door te geven dat het bij te werken beleid vertegenwoordigt.
de voorbeelden van de Code
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
- "Quick Start (MTOM): Modifying a policy using the web service API"
- "Quick Start (SwaRef): Modifying a policy using the web service API"
Beleid verwijderen deleting-policies
U kunt een bestaand beleid verwijderen met de Java API voor documentbeveiliging of de webservice-API. Nadat een beleid is verwijderd, kan het niet meer worden gebruikt om documenten te beschermen. Bestaande documenten die door het beleid worden beschermd, zijn echter nog steeds beveiligd. U kunt een beleid schrappen wanneer nieuwere beschikbaar wordt.
Overzicht van de stappen summary_of_steps-2
Voer de volgende stappen uit om een bestaand beleid te verwijderen:
- Projectbestanden opnemen
- Maak een API-object voor Document Security Client.
- Verwijder het beleid.
omvat projectdossiers
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.
creeer een voorwerp van de Cliënt API van de Veiligheid van het Document
Voordat u programmatisch een Document Security-servicebewerking kunt uitvoeren, moet u een Document Security-service-clientobject maken. Maak een RightsManagementClient
-object als u de Java API gebruikt. Als u de webservice-API voor documentbeveiliging gebruikt, maakt u een RightsManagementServiceService
-object.
Schrap het beleid
Als u een beleid wilt verwijderen, geeft u het beleid op dat u wilt verwijderen en de beleidsset waartoe het beleid behoort. De gebruiker van wie de montages worden gebruikt om AEM Forms aan te halen moet toestemming hebben om het beleid te schrappen; anders komt een uitzondering voor. En als u probeert een beleid te verwijderen dat niet bestaat, treedt een uitzondering op.
Beleid verwijderen met de Java API delete-policies-using-the-java-api
Een beleid verwijderen met de API voor documentbeveiliging (Java):
-
Inclusief projectbestanden.
Neem client-JAR-bestanden, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project.
-
Maak een API-object voor Document Security Client.
- Maak een
ServiceClientFactory
-object dat verbindingseigenschappen bevat. - Maak een
RightsManagementClient
-object door de constructor ervan te gebruiken en hetServiceClientFactory
-object door te geven.
- Maak een
-
Verwijder het beleid.
-
Maak een
PolicyManager
-object door de methodeRightsManagementClient
objectgetPolicyManager
aan te roepen. -
Verwijder het beleid door de methode
deletePolicy
van het objectPolicyManager
aan te roepen en de volgende waarden door te geven:- Een tekenreekswaarde die de naam van de beleidsset opgeeft waartoe het beleid behoort. U kunt
null
opgeven die als resultaat heeft dat deMyPolicies
-beleidsset wordt gebruikt. - Een tekenreekswaarde die de naam aangeeft van het beleid dat moet worden verwijderd.
- Een tekenreekswaarde die de naam van de beleidsset opgeeft waartoe het beleid behoort. U kunt
-
de voorbeelden van de Code
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
- "Snel starten (SOAP modus): beleid verwijderen met de Java API"
Beleid verwijderen met de webservice-API delete-policies-using-the-web-service-api
Verwijder een beleid met de API voor documentbeveiliging (webservice):
-
Inclusief projectbestanden.
Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Vervang localhost
door het IP-adres van de server die als host fungeert voor AEM Forms. -
Maak een API-object voor Document Security Client.
-
Maak een
RightsManagementServiceClient
-object met de standaardconstructor. -
Maak een
RightsManagementServiceClient.Endpoint.Address
-object met deSystem.ServiceModel.EndpointAddress
-constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeldhttp://localhost:8080/soap/services/RightsManagementService?WSDL
.) U hoeft het attribuutlc_version
niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.) -
Maak een
System.ServiceModel.BasicHttpBinding
-object door de waarde van hetRightsManagementServiceClient.Endpoint.Binding
-veld op te halen. De geretourneerde waarde wordt gecast naarBasicHttpBinding
. -
Stel het veld
MessageEncoding
van hetSystem.ServiceModel.BasicHttpBinding
-object in opWSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt. -
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
- Wijs de gebruikersnaam van het AEM aan het veld
RightsManagementServiceClient.ClientCredentials.UserName.UserName
toe. - Wijs de bijbehorende wachtwoordwaarde toe aan het veld
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Wijs de constante waarde
HttpClientCredentialType.Basic
toe aan het veldBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Wijs de gebruikersnaam van het AEM aan het veld
-
Wijs de constante waarde
BasicHttpSecurityMode.TransportCredentialOnly
toe aan het veldBasicHttpBindingSecurity.Security.Mode
.
-
-
Verwijder het beleid.
Verwijder een beleid door de methode
deletePolicy
van het objectRightsManagementServiceClient
aan te roepen en de volgende waarden door te geven:- Een tekenreekswaarde die de naam van de beleidsset opgeeft waartoe het beleid behoort. U kunt
null
opgeven die als resultaat heeft dat deMyPolicies
-beleidsset wordt gebruikt. - Een tekenreekswaarde die de naam aangeeft van het beleid dat moet worden verwijderd.
- Een tekenreekswaarde die de naam van de beleidsset opgeeft waartoe het beleid behoort. U kunt
de voorbeelden van de Code
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
- "Quick Start (MTOM): Deleting a policy using the web service API"
- "Quick Start (SwaRef): Deleting a policy using the web service API"
Beleid toepassen op PDF-documenten applying-policies-to-pdf-documents
U kunt een beleid op een document van de PDF toepassen om het document te beveiligen. Door een beleid op een document van de PDF toe te passen, beperkt u toegang tot het document. U kunt geen beleid op een document toepassen als het document reeds met een beleid wordt beveiligd.
Terwijl het document is geopend, kunt u ook de toegang tot Acrobat- en Adobe Reader-functies beperken, zoals de mogelijkheid om tekst af te drukken en te kopiëren, wijzigingen aan te brengen en handtekeningen en opmerkingen aan een document toe te voegen. Bovendien kunt u een met een beleid beveiligd PDF-document intrekken wanneer u niet langer wilt dat gebruikers het document openen.
U kunt het gebruik van een document dat met een beleid is beveiligd controleren nadat u het hebt verspreid. Dat wil zeggen dat u kunt zien hoe het document wordt gebruikt en wie het gebruikt. U kunt bijvoorbeeld zien wanneer iemand het document heeft geopend.
Overzicht van de stappen summary_of_steps-3
Voer de volgende stappen uit om een beleid toe te passen op een PDF-document:
- Inclusief projectbestanden.
- Maak een API-object voor Document Security Client.
- Hiermee wordt een PDF-document opgehaald waarop een beleid is toegepast.
- Pas een bestaand beleid op het document van de PDF toe.
- Sla het met beleid beveiligde PDF-document op.
omvat projectdossiers
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.
creeer een Cliënt APIobject van de Veiligheid van het Document
Voordat u via programmacode een bewerking met de documentbeveiligingsservice kunt uitvoeren, maakt u een clientobject van de documentbeveiligingsservice. Maak een DocumentSecurityClient
-object als u de Java API gebruikt. Als u de webservice-API voor documentbeveiliging gebruikt, maakt u een DocumentSecurityServiceService
-object.
wint een document van PDF terug
U kunt een PDF-document ophalen om een beleid toe te passen. Nadat u een beleid op het document van de PDF toepast, worden de gebruikers beperkt wanneer het gebruiken van het document. Als het beleid bijvoorbeeld niet toestaat dat het document offline wordt geopend, moeten gebruikers online zijn om het document te openen.
pas een bestaand beleid op het document van PDF toe
Om een beleid op een document van de PDF toe te passen, verwijs een bestaand beleid en specificeer welk beleid het beleid tot behoort. De gebruiker die de verbindingseigenschappen instelt, moet toegang hebben tot het opgegeven beleid. Als dat niet het geval is, treedt een uitzondering op.
sparen het document van de PDF
Nadat de dienst van de Veiligheid van het Document een beleid op een document van de PDF toepast, kunt u het beleid-beschermde document van de PDF als PDF dossier bewaren.
zie ook
Inclusief AEM Forms Java-bibliotheekbestanden
Een beleid toepassen op een PDF-document met de Java API apply-a-policy-to-a-pdf-document-using-the-java-api
Een beleid toepassen op een PDF-document met behulp van de API voor documentbeveiliging (Java):
-
Inclusief projectbestanden.
Neem client-JAR-bestanden, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project.
-
Maak een API-object voor Document Security Client.
- Maak een
ServiceClientFactory
-object dat verbindingseigenschappen bevat. - Maak een
RightsManagementClient
-object door de constructor ervan te gebruiken en hetServiceClientFactory
-object door te geven.
- Maak een
-
Een PDF-document ophalen.
- Maak een
java.io.FileInputStream
-object dat het PDF-document vertegenwoordigt met behulp van de constructor. Geef een tekenreekswaarde door die de locatie van het PDF-document aangeeft. - Maak een
com.adobe.idp.Document
-object door de constructor ervan te gebruiken en hetjava.io.FileInputStream
-object door te geven.
- Maak een
-
Pas een bestaand beleid op het document van de PDF toe.
-
Maak een
DocumentManager
-object door de methodeRightsManagementClient
objectgetDocumentManager
aan te roepen. -
Pas een beleid toe op het document PDF door de methode
protectDocument
van het objectDocumentManager
aan te roepen en de volgende waarden door te geven:- Het
com.adobe.idp.Document
-object dat het PDF-document bevat waarop het beleid wordt toegepast. - Een tekenreekswaarde die de naam van het document aangeeft.
- Een tekenreekswaarde die de naam opgeeft van de beleidsset waartoe het beleid behoort. U kunt een
null
-waarde opgeven die resulteert in het gebruik van deMyPolicies
-beleidsset. - Een tekenreekswaarde die de beleidsnaam opgeeft.
- Een tekenreekswaarde die de naam vertegenwoordigt van het gebruikersbeheerdomein van de gebruiker die de uitgever van het document is. Deze parameterwaarde is optioneel en kan null zijn (als deze parameter null is, moet de volgende parameterwaarde null zijn).
- Een tekenreekswaarde die de naam vertegenwoordigt van de canonieke naam van de gebruiker van de gebruikersmanager die de uitgever van het document is. Deze parameterwaarde is optioneel en kan
null
zijn (als deze parameter null is, moet de vorige parameterwaardenull
zijn). - A
com.adobe.livecycle.rightsmanagement.Locale
die de landinstelling vertegenwoordigt die wordt gebruikt voor het selecteren van de sjabloon MS Office. Deze parameterwaarde is optioneel en wordt niet gebruikt voor PDF-documenten. Geefnull
op om een PDF-document te beveiligen.
De methode
protectDocument
retourneert eenRMSecureDocumentResult
-object dat het met een beleid beveiligde PDF-document bevat. - Het
-
-
Sla het PDF-document op.
- Roep de methode
getProtectedDoc
van hetRMSecureDocumentResult
-object aan om het met beleid beveiligde PDF-document op te halen. Deze methode retourneert eencom.adobe.idp.Document
-object. - Maak een
java.io.File
-object en controleer of de bestandsextensie PDF is. - Roep de methode
copyToFile
van het objectcom.adobe.idp.Document
aan om de inhoud van het objectDocument
naar het bestand te kopiëren (gebruik het objectDocument
dat door de methodegetProtectedDoc
is geretourneerd).
- Roep de methode
de voorbeelden van de Code
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
- "Snel starten (EJB-modus): beleid toepassen op een PDF-document met behulp van de Java API"
- "Snel starten (SOAP modus): beleid toepassen op een PDF-document met behulp van de Java API"
zie ook
Een beleid toepassen op een PDF-document met de webservice-API apply-a-policy-to-a-pdf-document-using-the-web-service-api
Pas een beleid op een document van de PDF toe door de Veiligheid API van het Document (Webdienst) te gebruiken:
-
Inclusief projectbestanden.
Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Vervang localhost
door het IP-adres van de server die als host fungeert voor AEM Forms. -
Maak een API-object voor Document Security Client.
-
Maak een
RightsManagementServiceClient
-object met de standaardconstructor. -
Maak een
RightsManagementServiceClient.Endpoint.Address
-object met deSystem.ServiceModel.EndpointAddress
-constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de Forms-service (bijvoorbeeldhttp://localhost:8080/soap/services/RightsManagementService?WSDL
.) U hoeft het attribuutlc_version
niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.) -
Maak een
System.ServiceModel.BasicHttpBinding
-object door de waarde van hetRightsManagementServiceClient.Endpoint.Binding
-veld op te halen. De geretourneerde waarde wordt gecast naarBasicHttpBinding
. -
Stel het veld
MessageEncoding
van hetSystem.ServiceModel.BasicHttpBinding
-object in opWSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt. -
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
- Wijs de gebruikersnaam van het AEM aan het veld
RightsManagementServiceClient.ClientCredentials.UserName.UserName
toe. - Wijs de bijbehorende wachtwoordwaarde toe aan het veld
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Wijs de constante waarde
HttpClientCredentialType.Basic
toe aan het veldBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Wijs de gebruikersnaam van het AEM aan het veld
-
Wijs de constante waarde
BasicHttpSecurityMode.TransportCredentialOnly
toe aan het veldBasicHttpBindingSecurity.Security.Mode
.
-
-
Een PDF-document ophalen.
- Maak een
BLOB
-object met behulp van de constructor. HetBLOB
-object wordt gebruikt om een PDF-document op te slaan waarop een beleid wordt toegepast. - Maak een
System.IO.FileStream
-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het PDF-document en de modus waarin het bestand moet worden geopend, vertegenwoordigt. - Maak een bytearray waarin de inhoud van het object
System.IO.FileStream
wordt opgeslagen. Bepaal de grootte van de bytearray door de eigenschapLength
van het objectSystem.IO.FileStream
op te halen. - Vul de bytearray met streamgegevens door de methode
Read
van het objectSystem.IO.FileStream
aan te roepen. Geef de bytearray, de startpositie en de streamlengte door om te lezen. - Vul het
BLOB
-object door hetMTOM
-veld ervan toe te wijzen met de inhoud van de bytearray.
- Maak een
-
Pas een bestaand beleid op het document van de PDF toe.
Pas een beleid toe op het document PDF door de methode
protectDocument
van het objectRightsManagementServiceClient
aan te roepen en de volgende waarden door te geven:- Het
BLOB
-object dat het PDF-document bevat waarop het beleid wordt toegepast. - Een tekenreekswaarde die de naam van het document aangeeft.
- Een tekenreekswaarde die de naam opgeeft van de beleidsset waartoe het beleid behoort. U kunt een
null
-waarde opgeven die resulteert in het gebruik van deMyPolicies
-beleidsset. - Een tekenreekswaarde die de beleidsnaam opgeeft.
- Een tekenreekswaarde die de naam vertegenwoordigt van het gebruikersbeheerdomein van de gebruiker die de uitgever van het document is. Deze parameterwaarde is optioneel en kan null zijn (als deze parameter null is, moet de volgende parameterwaarde
null
zijn). - Een tekenreekswaarde die de naam vertegenwoordigt van de canonieke naam van de gebruiker van de gebruikersmanager die de uitgever van het document is. Deze parameterwaarde is optioneel en kan null zijn (als deze parameter null is, moet de vorige parameterwaarde
null
zijn). - Een
RMLocale
-waarde die de waarde van de landinstelling opgeeft (bijvoorbeeldRMLocale.en
). - Een parameter van de koordoutput die wordt gebruikt om de waarde van beleidsidentificatie op te slaan.
- Een parameter van de koordoutput die wordt gebruikt om de beleid-beschermde herkenningstekenwaarde op te slaan.
- Een parameter van de koordoutput die wordt gebruikt om het mime type (bijvoorbeeld,
application/pdf
) op te slaan.
De methode
protectDocument
retourneert eenBLOB
-object dat het met een beleid beveiligde PDF-document bevat. - Het
-
Sla het PDF-document op.
- Maak een
System.IO.FileStream
-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het met een beleid beveiligde PDF-document vertegenwoordigt. - Maak een bytearray waarin de gegevensinhoud wordt opgeslagen van het object
BLOB
dat door de methodeprotectDocument
is geretourneerd. Vul de bytearray met de waarde van het gegevenslidMTOM
van het objectBLOB
. - Maak een
System.IO.BinaryWriter
-object door de constructor ervan aan te roepen en hetSystem.IO.FileStream
-object door te geven. - Schrijf de inhoud van de bytearray naar een PDF-bestand door de methode
Write
van het objectSystem.IO.BinaryWriter
aan te roepen en de bytearray door te geven.
- Maak een
de voorbeelden van de Code
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
- "Snel starten (MTOM): beleid toepassen op een PDF-document met behulp van de webservice-API"
- "Quick Start (SwaRef): Applying a policy to a PDF document using the web service API "
Beleid verwijderen uit PDF-documenten removing-policies-from-pdf-documents
U kunt een beleid verwijderen uit een document dat met een beleid is beveiligd om de beveiliging van het document te verwijderen. Dat wil zeggen, als u niet langer wilt dat het document wordt beschermd door een beleid. Als u een beleid-beschermd document met een nieuwer beleid wilt bijwerken, dan in plaats van het beleid te verwijderen en het bijgewerkte beleid toe te voegen, is het efficiënter om het beleid te schakelen.
Overzicht van de stappen summary_of_steps-4
Voer de volgende stappen uit om een beleid te verwijderen uit een met beleid beveiligd PDF-document:
- Projectbestanden opnemen
- Maak een API-object voor Document Security Client.
- Hiermee wordt een met beleid beveiligd PDF-document opgehaald.
- Verwijder het beleid uit het document van de PDF.
- Sla het onbeveiligde PDF-document op.
omvat projectdossiers
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.
creeer een voorwerp van de Cliënt API van de Veiligheid van het Document
Voordat u via programmacode een bewerking met de documentbeveiligingsservice kunt uitvoeren, maakt u een clientobject van de documentbeveiligingsservice.
wint een beleid-beschermd document van PDF terug
U kunt een met een beleid beveiligd PDF-document ophalen om een beleid te verwijderen. Als u probeert om een beleid uit een document te verwijderen van de PDF dat niet door een beleid wordt beschermd, zult u een uitzondering veroorzaken.
verwijder het beleid uit het document van PDF
U kunt een beleid uit een beleid-beschermd document van de PDF verwijderen op voorwaarde dat een beheerder in de verbindingsmontages wordt gespecificeerd. Als dat niet het geval is, moet het beleid dat wordt gebruikt om een document te beveiligen de toestemming SWITCH_POLICY
bevatten om een beleid uit een document van de PDF te verwijderen. De gebruiker die is opgegeven in de AEM Forms-verbindingsinstellingen moet ook over deze machtiging beschikken. Anders wordt een uitzondering gegenereerd.
sparen het onbeveiligde document van PDF
Nadat de documentbeveiligingsservice een beleid uit een PDF-document heeft verwijderd, kunt u het onbeveiligde PDF-document opslaan als een PDF-bestand.
zie ook
Inclusief AEM Forms Java-bibliotheekbestanden
Een beleid verwijderen uit een PDF-document met de Java API remove-a-policy-from-a-pdf-document-using-the-java-api
Verwijder een beleid uit een beleid-beschermd document van de PDF door de Veiligheid API van het Document (Java) te gebruiken:
-
Inclusief projectbestanden.
Neem client-JAR-bestanden, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project.
-
Maak een API-object voor Document Security Client.
- Maak een
ServiceClientFactory
-object dat verbindingseigenschappen bevat. - Maak een
DocumentSecurityClient
-object door de constructor ervan te gebruiken en hetServiceClientFactory
-object door te geven.
- Maak een
-
Hiermee wordt een met beleid beveiligd PDF-document opgehaald.
- Maak een
java.io.FileInputStream
-object dat het met een beleid beveiligde PDF-document vertegenwoordigt door de constructor ervan te gebruiken en een tekenreekswaarde door te geven die de locatie van het PDF-document aangeeft. - Maak een
com.adobe.idp.Document
-object door de constructor ervan te gebruiken en hetjava.io.FileInputStream
-object door te geven.
- Maak een
-
Verwijder het beleid uit het document van de PDF.
- Maak een
DocumentManager
-object door de methodeDocumentSecurityClient
objectgetDocumentManager
aan te roepen. - Verwijder een beleid uit het PDF-document door de methode
removeSecurity
van hetDocumentManager
-object aan te roepen en hetcom.adobe.idp.Document
-object door te geven dat het met een beleid beveiligde PDF-document bevat. Deze methode retourneert eencom.adobe.idp.Document
-object dat een onbeveiligd PDF-document bevat.
- Maak een
-
Sla het onbeveiligde PDF-document op.
- Maak een
java.io.File
-object en controleer of de bestandsextensie PDF is. - Roep de methode
copyToFile
van het objectDocument
aan om de inhoud van het objectDocument
naar het bestand te kopiëren (gebruik het objectDocument
dat door de methoderemoveSecurity
is geretourneerd).
- Maak een
de voorbeelden van de Code
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
- "Snel starten (SOAP modus): Een beleid verwijderen uit een PDF-document met de Java API"
Een beleid verwijderen met de webservice-API remove-a-policy-using-the-web-service-api
Verwijder een beleid uit een beleid-beschermd document van de PDF gebruikend de Veiligheid API van het Document (Webdienst):
-
Inclusief projectbestanden.
Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Vervang localhost
door het IP-adres van de server die als host fungeert voor AEM Forms. -
Maak een API-object voor Document Security Client.
-
Maak een
DocumentSecurityServiceClient
-object met de standaardconstructor. -
Maak een
DocumentSecurityServiceClient.Endpoint.Address
-object met deSystem.ServiceModel.EndpointAddress
-constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeldhttp://localhost:8080/soap/services/RightsManagementService?WSDL
.) U hoeft het attribuutlc_version
niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.) -
Maak een
System.ServiceModel.BasicHttpBinding
-object door de waarde van hetDocumentSecurityServiceClient.Endpoint.Binding
-veld op te halen. De geretourneerde waarde wordt gecast naarBasicHttpBinding
. -
Stel het veld
MessageEncoding
van hetSystem.ServiceModel.BasicHttpBinding
-object in opWSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt. -
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
- Wijs de gebruikersnaam van het AEM aan het veld
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
toe. - Wijs de bijbehorende wachtwoordwaarde toe aan het veld
DocumentSecurityServiceClient.ClientCredentials.UserName.Password
. - Wijs de constante waarde
HttpClientCredentialType.Basic
toe aan het veldBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Wijs de gebruikersnaam van het AEM aan het veld
-
Wijs de constante waarde
BasicHttpSecurityMode.TransportCredentialOnly
toe aan het veldBasicHttpBindingSecurity.Security.Mode
.
-
-
Hiermee wordt een met beleid beveiligd PDF-document opgehaald.
- Maak een
BLOB
-object met behulp van de constructor. HetBLOB
-object wordt gebruikt om het met een beleid beveiligde PDF-document op te slaan waaruit het beleid wordt verwijderd. - Maak een
System.IO.FileStream
-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het PDF-document en de modus waarin het bestand moet worden geopend, vertegenwoordigt. - Maak een bytearray waarin de inhoud van het object
System.IO.FileStream
wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschapLength
van het objectSystem.IO.FileStream
op te halen. - Vul de bytearray met streamgegevens door de methode
Read
van het objectSystem.IO.FileStream
aan te roepen en de bytearray, de startpositie en de lengte van de stream door te geven om te lezen. - Vul het
BLOB
-object door hetMTOM
-veld ervan toe te wijzen met de inhoud van de bytearray.
- Maak een
-
Verwijder het beleid uit het document van de PDF.
Verwijder het beleid uit het document PDF door de methode
removePolicySecurity
van het objectDocumentSecurityServiceClient
aan te roepen en het objectBLOB
door te geven dat het document met beveiligde PDF bevat. Deze methode retourneert eenBLOB
-object dat een onbeveiligd PDF-document bevat. -
Sla het onbeveiligde PDF-document op.
- Maak een
System.IO.FileStream
-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het onbeveiligde PDF-document vertegenwoordigt. - Maak een bytearray waarin de gegevensinhoud wordt opgeslagen van het object
BLOB
dat door de methoderemovePolicySecurity
is geretourneerd. Vul de bytearray met de waarde van het veldMTOM
van het objectBLOB
. - Maak een
System.IO.BinaryWriter
-object door de constructor ervan aan te roepen en hetSystem.IO.FileStream
-object door te geven.
- Maak een
de voorbeelden van de Code
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
- "Quick Start (MTOM): Remoting a policy from a PDF document using the web service API "
- "Quick Start (SwaRef): Removing a policy from a PDF document using the web service API"
zie ook
Toegang tot documenten intrekken revoking-access-to-documents
U kunt de toegang tot een met een beleid beveiligd PDF-document intrekken, waardoor alle kopieën van het document niet toegankelijk zijn voor gebruikers. Wanneer een gebruiker een ingetrokken PDF-document probeert te openen, wordt deze doorgestuurd naar een opgegeven URL waar een gereviseerd document kan worden weergegeven. De URL waarnaar de gebruiker is omgeleid, moet via programmacode worden opgegeven. Wanneer u de toegang tot een document intrekt, wordt de wijziging van kracht wanneer de gebruiker opnieuw synchroniseert met de documentbeveiligingsservice door het document dat met een beleid is beveiligd online te openen.
De mogelijkheid om de toegang tot een document in te trekken biedt extra beveiliging. Stel dat er een nieuwere versie van een document beschikbaar is en dat u niet langer wilt dat iemand de verouderde versie bekijkt. In dit geval kan de toegang tot het oudere document worden ingetrokken en kan niemand het document bekijken tenzij de toegang wordt hersteld.
Overzicht van de stappen summary_of_steps-5
Voer de volgende stappen uit om een document dat met een beleid is beveiligd, in te trekken:
- Inclusief projectbestanden.
- Maak een API-object voor Document Security Client.
- Hiermee wordt een met beleid beveiligd PDF-document opgehaald.
- Intrekken van het document dat met een beleid is beveiligd.
omvat projectdossiers
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.
creeer een voorwerp van de Cliënt API van de Veiligheid van het Document
Voordat u programmatisch een Document Security-servicebewerking kunt uitvoeren, moet u een Document Security-service-clientobject maken.
wint een beleid-beschermd document van PDF terug
Haal een document met een door het beleid beschermde PDF op om het in te trekken. U kunt een document dat al is ingetrokken of dat niet door een beleid beveiligd is, niet intrekken.
Als u de waarde van de vergunningsidentificatie van het beleid-beschermde document kent, dan is het niet noodzakelijk om het beleid-beschermde document van de PDF terug te winnen. In de meeste gevallen moet u echter het PDF-document ophalen om de waarde van de licentie-id op te halen.
trekt het beleid-beschermde document in
Als u een document wilt intrekken dat met een beleid is beveiligd, geeft u de licentie-id op van het document dat met een beleid is beveiligd. Daarnaast kunt u de URL opgeven van een document dat de gebruiker kan bekijken wanneer hij of zij probeert het ingetrokken document te openen. Dat wil zeggen dat een verouderd document wordt ingetrokken. Wanneer een gebruiker het ingetrokken document probeert te openen, wordt een bijgewerkt document weergegeven in plaats van het ingetrokken document.
zie ook
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Toegang tot documenten intrekken met de Java API revoke-access-to-documents-using-the-java-api
Toegang tot een met beleid beveiligd PDF-document intrekken met de API voor documentbeveiliging (Java):
-
Projectbestanden opnemen
Neem client-JAR-bestanden, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project.
-
Een API-object voor documentbeveiliging maken
- Maak een
ServiceClientFactory
-object dat verbindingseigenschappen bevat. - Maak een
DocumentSecurityClient
-object door de constructor ervan te gebruiken en hetServiceClientFactory
-object door te geven.
- Maak een
-
Een met beleid beveiligd PDF-document ophalen
- Maak een
java.io.FileInputStream
-object dat het met een beleid beveiligde PDF-document vertegenwoordigt door de constructor ervan te gebruiken en een tekenreekswaarde door te geven die de locatie van het PDF-document aangeeft. - Maak een
com.adobe.idp.Document
-object door de constructor ervan te gebruiken en hetjava.io.FileInputStream
-object door te geven.
- Maak een
-
Intrekken van het document dat met een beleid is beveiligd
-
Maak een
DocumentManager
-object door de methodeDocumentSecurityClient
objectgetDocumentManager
aan te roepen. -
Haal de waarde van de licentie-id van het document dat met een beleid is beveiligd, op door de methode
getLicenseId
van het objectDocumentManager
aan te roepen. Geef hetcom.adobe.idp.Document
-object door dat het document vertegenwoordigt dat met een beleid is beveiligd. Deze methode retourneert een tekenreekswaarde die de waarde van de licentie-id vertegenwoordigt. -
Maak een
LicenseManager
-object door de methodeDocumentSecurityClient
objectgetLicenseManager
aan te roepen. -
Intrekken van het document dat met een beleid is beveiligd door de methode
revokeLicense
van het objectLicenseManager
aan te roepen en de volgende waarden door te geven:- Een tekenreekswaarde die de waarde van de licentie-id van het document met beleidsbeveiliging opgeeft (geef de geretourneerde waarde van de methode
getLicenseId
van het objectDocumentManager
op). - Een statisch gegevenslid van de interface
License
dat de reden opgeeft om het document in te trekken. U kunt bijvoorbeeldLicense.DOCUMENT_REVISED
opgeven. - Een
java.net.URL
-waarde die de locatie opgeeft waar een gereviseerd document zich bevindt. Als u een gebruiker niet naar een andere URL wilt omleiden, kunt unull
doorgeven.
- Een tekenreekswaarde die de waarde van de licentie-id van het document met beleidsbeveiliging opgeeft (geef de geretourneerde waarde van de methode
-
de voorbeelden van de Code
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
- "Snel starten (SOAP modus): een document intrekken met de Java API"
Toegang tot documenten intrekken met de webservice-API revoke-access-to-documents-using-the-web-service-api
De toegang tot een met beleid beveiligd PDF-document intrekken met de API voor documentbeveiliging (webservice):
-
Projectbestanden opnemen
Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Vervang localhost
door het IP-adres van de server die als host fungeert voor AEM Forms. -
Een API-object voor documentbeveiliging maken
-
Maak een
DocumentSecurityServiceClient
-object met de standaardconstructor. -
Maak een
DocumentSecurityServiceClient.Endpoint.Address
-object met deSystem.ServiceModel.EndpointAddress
-constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeldhttp://localhost:8080/soap/services/RightsManagementService?WSDL
.) U hoeft het attribuutlc_version
niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.) -
Maak een
System.ServiceModel.BasicHttpBinding
-object door de waarde van hetDocumentSecurityServiceClient.Endpoint.Binding
-veld op te halen. De geretourneerde waarde wordt gecast naarBasicHttpBinding
. -
Stel het veld
MessageEncoding
van hetSystem.ServiceModel.BasicHttpBinding
-object in opWSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt. -
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
- Wijs de gebruikersnaam van het AEM aan het veld
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
toe. - Wijs de bijbehorende wachtwoordwaarde toe aan het veld
DocumentSecurityServiceClient.ClientCredentials.UserName.Password
. - Wijs de constante waarde
HttpClientCredentialType.Basic
toe aan het veldBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Wijs de gebruikersnaam van het AEM aan het veld
-
Wijs de constante waarde
BasicHttpSecurityMode.TransportCredentialOnly
toe aan het veldBasicHttpBindingSecurity.Security.Mode
.
-
-
Een met beleid beveiligd PDF-document ophalen
- Maak een
BLOB
-object met behulp van de constructor. HetBLOB
-object wordt gebruikt om een met een beleid beveiligd PDF-document op te slaan dat wordt ingetrokken. - Maak een
System.IO.FileStream
-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie vertegenwoordigt van het PDF-document dat met een beleid is beveiligd en de modus waarin het bestand moet worden geopend. - Maak een bytearray waarin de inhoud van het object
System.IO.FileStream
wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschapLength
van het objectSystem.IO.FileStream
op te halen. - Vul de bytearray met streamgegevens door de methode
Read
van het objectSystem.IO.FileStream
aan te roepen en de bytearray, de startpositie en de lengte van de stream door te geven om te lezen. - Vul het
BLOB
-object door hetMTOM
-veld ervan toe te wijzen met de inhoud van de bytearray.
- Maak een
-
Intrekken van het document dat met een beleid is beveiligd
-
Haal de waarde van de licentie-id van het document dat met een beleid is beveiligd, op door de methode
getLicenseID
van het objectDocumentSecurityServiceClient
aan te roepen en het objectBLOB
door te geven dat het document vertegenwoordigt dat met een beleid is beveiligd. Deze methode retourneert een tekenreekswaarde die de licentie-id vertegenwoordigt. -
Intrekken van het document dat met een beleid is beveiligd door de methode
revokeLicense
van het objectDocumentSecurityServiceClient
aan te roepen en de volgende waarden door te geven:- Een tekenreekswaarde die de waarde van de licentie-id van het document met beleidsbeveiliging opgeeft (geef de geretourneerde waarde van de methode
getLicenseId
van het objectDocumentSecurityServiceService
op). - Een statisch gegevenslid van de opsomming
Reason
dat de reden opgeeft om het document in te trekken. U kunt bijvoorbeeldReason.DOCUMENT_REVISED
opgeven. - Een
string
-waarde die de URL-locatie opgeeft waarnaar een gereviseerd document zich bevindt. Als u een gebruiker niet naar een andere URL wilt omleiden, kunt unull
doorgeven.
- Een tekenreekswaarde die de waarde van de licentie-id van het document met beleidsbeveiliging opgeeft (geef de geretourneerde waarde van de methode
-
de voorbeelden van de Code
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
- "Quick Start (MTOM): Revoking a document using the web service API"
- "Quick Start (SwaRef): Revoking a document using the web service API"
zie ook
Toegang tot ingetrokken documenten opnieuw instellen reinstating-access-to-revoked-documents
U kunt de toegang tot een ingetrokken PDF-document opnieuw instellen, zodat alle exemplaren van het ingetrokken document toegankelijk zijn voor gebruikers. Wanneer een gebruiker een hersteld document opent dat werd ingetrokken, kan de gebruiker het document bekijken.
Overzicht van de stappen summary_of_steps-6
Voer de volgende stappen uit om de toegang tot een ingetrokken PDF-document te herstellen:
- Inclusief projectbestanden.
- Maak een API-object voor Document Security Client.
- Haal de licentiecode van het ingetrokken PDF-document op.
- Open het ingetrokken PDF-document opnieuw.
omvat projectdossiers
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.
creeer een voorwerp van de Cliënt API van de Veiligheid van het Document
Voordat u programmatisch een Document Security-servicebewerking kunt uitvoeren, moet u een Document Security-service-clientobject maken. Maak een DocumentSecurityClient
-object als u de Java API gebruikt. Als u de webservice-API voor documentbeveiliging gebruikt, maakt u een DocumentSecurityServiceService
-object.
wint het vergunningsherkenningsteken van het ingetrokken document van PDF terug
Haal de licentie-id van het ingetrokken PDF-document op om een ingetrokken PDF-document opnieuw in te voeren. Nadat u de waarde van de licentie-id hebt gekregen, kunt u een ingetrokken document opnieuw installeren. Als u probeert een document opnieuw in te voegen dat niet is ingetrokken, veroorzaakt u een uitzondering.
herstelt toegang tot het ingetrokken document van PDF
Als u de toegang tot een ingetrokken PDF-document wilt herstellen, moet u de licentie-id van het ingetrokken document opgeven. Als u probeert toegang te herstellen tot een PDF-document dat niet is ingetrokken, veroorzaakt u een uitzondering.
zie ook
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Toegang tot ingetrokken documenten opnieuw instellen met de Java API reinstate-access-to-revoked-documents-using-the-java-api
Toegang tot een ingetrokken document opnieuw instellen met de API voor documentbeveiliging (Java):
-
Inclusief projectbestanden.
Neem client-JAR-bestanden, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project.
-
Maak een API-object voor Document Security Client.
- Maak een
ServiceClientFactory
-object dat verbindingseigenschappen bevat. - Maak een
DocumentSecurityClient
-object door de constructor ervan te gebruiken en hetServiceClientFactory
-object door te geven.
- Maak een
-
Haal de licentiecode van het ingetrokken PDF-document op.
- Maak een
java.io.FileInputStream
-object dat het ingetrokken PDF-document vertegenwoordigt door de constructor ervan te gebruiken en een tekenreekswaarde door te geven die de locatie van het PDF-document aangeeft. - Maak een
com.adobe.idp.Document
-object door de constructor ervan te gebruiken en hetjava.io.FileInputStream
-object door te geven. - Maak een
DocumentManager
-object door de methodeDocumentSecurityClient
objectgetDocumentManager
aan te roepen. - Haal de waarde van de licentie-id van het ingetrokken document op door de methode
getLicenseId
van het objectDocumentManager
aan te roepen en het objectcom.adobe.idp.Document
door te geven dat het ingetrokken document vertegenwoordigt. Deze methode retourneert een tekenreekswaarde die de licentie-id vertegenwoordigt.
- Maak een
-
Open het ingetrokken PDF-document opnieuw.
- Maak een
LicenseManager
-object door de methodeDocumentSecurityClient
objectgetLicenseManager
aan te roepen. - Herstel de toegang tot het ingetrokken PDF-document door de methode
unrevokeLicense
van hetLicenseManager
-object aan te roepen en de waarde van de licentie-id van het ingetrokken document door te geven.
- Maak een
de voorbeelden van de Code
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
- "Snel starten (SOAP modus): Toegang tot een ingetrokken document opnieuw instellen met de webservice-API"
Toegang tot ingetrokken documenten opnieuw instellen met de webservice-API reinstate-access-to-revoked-documents-using-the-web-service-api
Toegang tot een ingetrokken document opnieuw instellen met de API voor documentbeveiliging (webservice):
-
Inclusief projectbestanden.
Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Vervang localhost
door het IP-adres van de server die als host fungeert voor AEM Forms. -
Maak een API-object voor Document Security Client.
-
Maak een
DocumentSecurityServiceClient
-object met de standaardconstructor. -
Maak een
DocumentSecurityServiceClient.Endpoint.Address
-object met deSystem.ServiceModel.EndpointAddress
-constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeldhttp://localhost:8080/soap/services/RightsManagementService?WSDL
.) U hoeft het attribuutlc_version
niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.) -
Maak een
System.ServiceModel.BasicHttpBinding
-object door de waarde van hetDocumentSecurityServiceClient.Endpoint.Binding
-veld op te halen. De geretourneerde waarde wordt gecast naarBasicHttpBinding
. -
Stel het veld
MessageEncoding
van hetSystem.ServiceModel.BasicHttpBinding
-object in opWSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt. -
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
- Wijs de gebruikersnaam van het AEM aan het veld
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
toe. - Wijs de bijbehorende wachtwoordwaarde toe aan het veld
DocumentSecurityServiceClient.ClientCredentials.UserName.Password
. - Wijs de constante waarde
HttpClientCredentialType.Basic
toe aan het veldBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Wijs de gebruikersnaam van het AEM aan het veld
-
Wijs de constante waarde
BasicHttpSecurityMode.TransportCredentialOnly
toe aan het veldBasicHttpBindingSecurity.Security.Mode
.
-
-
Haal de licentiecode van het ingetrokken PDF-document op.
- Maak een
BLOB
-object met behulp van de constructor. HetBLOB
-object wordt gebruikt om een ingetrokken PDF-document op te slaan waartoe toegang wordt hersteld. - Maak een
System.IO.FileStream
-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het ingetrokken PDF-document en de modus waarin het bestand moet worden geopend, vertegenwoordigt. - Maak een bytearray waarin de inhoud van het object
System.IO.FileStream
wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschapLength
van het objectSystem.IO.FileStream
op te halen. - Vul de bytearray met streamgegevens door de methode
Read
van het objectSystem.IO.FileStream
aan te roepen en de bytearray, de startpositie en de lengte van de stream door te geven om te lezen. - Vul het
BLOB
-object door hetMTOM
-veld ervan toe te wijzen met de inhoud van de bytearray.
- Maak een
-
Open het ingetrokken PDF-document opnieuw.
- Haal de waarde van de licentie-id van het ingetrokken document op door de methode
getLicenseID
van het objectDocumentSecurityServiceClient
aan te roepen en het objectBLOB
door te geven dat het ingetrokken document vertegenwoordigt. Deze methode retourneert een tekenreekswaarde die de licentie-id vertegenwoordigt. - Herstel de toegang tot het ingetrokken PDF-document door de methode
unrevokeLicense
van het objectDocumentSecurityServiceClient
aan te roepen en een tekenreekswaarde door te geven die de licentie-id-waarde van het ingetrokken PDF-document opgeeft (geef de geretourneerde waarde van de methodeDocumentSecurityServiceClient
van het objectgetLicenseId
door).
- Haal de waarde van de licentie-id van het ingetrokken document op door de methode
de voorbeelden van de Code
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
- "Snel starten (MTOM): Toegang tot een ingetrokken document opnieuw instellen met de webservice-API"
- "Quick Start (SwaRef): Reinsting access to a revoked document using the web service API"
zie ook
Met beleid beveiligde PDF-documenten controleren inspecting-policy-protected-pdf-documents
U kunt de API voor documentbeveiligingsservice (Java en webservice) gebruiken om met beleid beveiligde PDF-documenten te inspecteren. Wanneer u documenten met door een beleid beveiligde PDF controleert, wordt informatie over het document met door een beleid beveiligde PDF geretourneerd. U kunt bijvoorbeeld bepalen welk beleid is gebruikt om het document te beveiligen en op welke datum het document is beveiligd.
U kunt deze taak niet uitvoeren als uw versie van LiveCycle 8.x of een vroegere versie is. Ondersteuning voor het inspecteren van documenten die met een beleid zijn beveiligd, wordt toegevoegd in AEM Forms. Als u probeert om een beleid-beschermd document te inspecteren gebruikend LiveCycle 8.x (of vroeger), wordt een uitzondering geworpen.
Overzicht van de stappen summary_of_steps-7
Voer de volgende stappen uit om een met beleid beveiligd PDF-document te inspecteren:
- Inclusief projectbestanden.
- Maak een API-object voor Document Security Client.
- Haal een document op dat met een beleid is beveiligd en dat u wilt inspecteren.
- Informatie opvragen over het document dat met een beleid is beveiligd.
omvat projectdossiers
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u de proxybestanden opnemen.
creeer een voorwerp van de Cliënt API van de Veiligheid van het Document
Voordat u via programmacode een bewerking met de documentbeveiligingsservice kunt uitvoeren, maakt u een clientobject van de documentbeveiligingsservice. Maak een RightsManagementClient
-object als u de Java API gebruikt. Als u de webservice-API voor documentbeveiliging gebruikt, maakt u een RightsManagementServiceService
-object.
wint een beleid-beschermd document terug om te inspecteren
Als u een document wilt inspecteren dat met een beleid is beveiligd, haalt u het op. Als u een document probeert te inspecteren dat niet met een beleid wordt beveiligd of wordt ingetrokken, wordt een uitzondering gegenereerd.
Inspect het document
Nadat u een document hebt opgehaald dat met een beleid is beveiligd, kunt u het controleren.
verkrijg informatie over het beleid-beschermde document
Nadat u een beleid-beschermd document van de PDF inspecteert, kunt u informatie over het verkrijgen. U kunt bijvoorbeeld bepalen welk beleid wordt gebruikt om het document te beveiligen.
Als u een document beveiligt met een beleid dat tot Mijn Beleid behoort en vervolgens RMInspectResult.getPolicysetName
of RMInspectResult.getPolicysetId
aanroept, wordt null geretourneerd.
Als het document is beveiligd met een beleid dat zich in een beleidsset bevindt (anders dan Mijn beleid), retourneren RMInspectResult.getPolicysetName
en RMInspectResult.getPolicysetId
geldige tekenreeksen.
zie ook
Inspect Policy Protected PDF Documents using the Java API inspect-policy-protected-pdf-documents-using-the-java-api
Inspect a policy-protected PDF document by using the Document Security Service API (Java):
-
Inclusief projectbestanden.
Neem JAR-bestanden voor clients, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project. Voor informatie over de plaats van deze dossiers, zie Inclusief de bibliotheekdossiers van AEM Forms Java.
-
Maak een API-object voor Document Security Client.
- Maak een
ServiceClientFactory
-object dat verbindingseigenschappen bevat. (Zie Plaatsende verbindingseigenschappen.) - Maak een
RightsManagementClient
-object door de constructor ervan te gebruiken en hetServiceClientFactory
-object door te geven.
- Maak een
-
Haal een document op dat met een beleid is beveiligd en dat u wilt inspecteren.
- Maak een
java.io.FileInputStream
-object dat het met een beleid beveiligde PDF-document vertegenwoordigt met behulp van de constructor ervan. Geef een tekenreekswaarde door die de locatie van het PDF-document aangeeft. - Maak een
com.adobe.idp.Document
-object door de constructor ervan te gebruiken en hetjava.io.FileInputStream
-object door te geven.
- Maak een
-
Inspect het document.
- Maak een
DocumentManager
-object door de methodeRightsManagementClient
objectgetDocumentManager
aan te roepen. - Inspect het document dat met een beleid is beveiligd door de methode
inspectDocument
van het objectLicenseManager
aan te roepen. Geef hetcom.adobe.idp.Document
-object door dat het met een beleid beveiligde PDF-document bevat. Deze methode retourneert eenRMInspectResult
-object dat informatie bevat over het document dat met een beleid is beveiligd.
- Maak een
-
Informatie opvragen over het document dat met een beleid is beveiligd.
Als u informatie wilt verkrijgen over het document dat met een beleid is beveiligd, roept u de juiste methode aan die bij het object
RMInspectResult
hoort. Als u bijvoorbeeld de naam van het beleid wilt ophalen, roept u de methodegetPolicyName
van het objectRMInspectResult
aan.
de voorbeelden van de Code
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
- "Snel starten (SOAP modus): Met beleid beveiligde PDF-documenten inspecteren met de Java API"
Inspect Policy Protected PDF Documents using the web service API inspect-policy-protected-pdf-documents-using-the-web-service-api
Inspect a policy-protected PDF document by the Document Security Service API (webservice):
-
Inclusief projectbestanden.
Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Vervang localhost
door het IP-adres van de server die als host fungeert voor AEM Forms. -
Maak een API-object voor Document Security Client.
-
Maak een
RightsManagementServiceClient
-object met de standaardconstructor. -
Maak een
RightsManagementServiceClient.Endpoint.Address
-object met deSystem.ServiceModel.EndpointAddress
-constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeldhttp://localhost:8080/soap/services/RightsManagementService?WSDL
.) U hoeft het attribuutlc_version
niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.) -
Maak een
System.ServiceModel.BasicHttpBinding
-object door de waarde van hetRightsManagementServiceClient.Endpoint.Binding
-veld op te halen. De geretourneerde waarde wordt gecast naarBasicHttpBinding
. -
Stel het veld
MessageEncoding
van hetSystem.ServiceModel.BasicHttpBinding
-object in opWSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt. -
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
- Wijs de gebruikersnaam van het AEM aan het veld
RightsManagementServiceClient.ClientCredentials.UserName.UserName
toe. - Wijs de bijbehorende wachtwoordwaarde toe aan het veld
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Wijs de constante waarde
HttpClientCredentialType.Basic
toe aan het veldBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Wijs de gebruikersnaam van het AEM aan het veld
-
Wijs de constante waarde
BasicHttpSecurityMode.TransportCredentialOnly
toe aan het veldBasicHttpBindingSecurity.Security.Mode
.
-
-
Haal een document op dat met een beleid is beveiligd en dat u wilt inspecteren.
- Maak een
BLOB
-object met behulp van de constructor. HetBLOB
-object wordt gebruikt om een PDF-document op te slaan dat moet worden gecontroleerd. - Maak een
System.IO.FileStream
-object door de constructor ervan aan te roepen. Geef een tekenreekswaarde door die staat voor de bestandslocatie van het PDF-document en de modus waarin het bestand moet worden geopend. - Maak een bytearray waarin de inhoud van het object
System.IO.FileStream
wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschapLength
van het objectSystem.IO.FileStream
op te halen. - Vul de bytearray met streamgegevens door de methode
Read
van het objectSystem.IO.FileStream
aan te roepen. Geef de bytearray, de startpositie en de streamlengte door om te lezen. - Vul het
BLOB
-object door hetMTOM
-veld ervan toe te wijzen met de inhoud van de bytearray.
- Maak een
-
Inspect het document.
Inspect het document dat met een beleid is beveiligd door de methode
inspectDocument
van het objectRightsManagementServiceClient
aan te roepen. Geef hetBLOB
-object door dat het met een beleid beveiligde PDF-document bevat. Deze methode retourneert eenRMInspectResult
-object dat informatie bevat over het document dat met een beleid is beveiligd. -
Informatie opvragen over het document dat met een beleid is beveiligd.
Als u informatie wilt verkrijgen over het document dat met een beleid is beveiligd, vraagt u de waarde op van het veld dat hoort bij het object
RMInspectResult
. Als u bijvoorbeeld de naam van het beleid wilt ophalen, haalt u de waarde op van het veldpolicyName
van hetRMInspectResult
-object.
de voorbeelden van de Code
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
- "Snel starten (MTOM): met beleid beveiligde PDF-documenten inspecteren met de webservice-API"
- "Quick Start (SwaRef): met een beleid beveiligde PDF-documenten inspecteren met behulp van de webservice-API"
zie ook
Watermerken maken creating-watermarks
Watermerken helpen de veiligheid van een document te waarborgen door het document op unieke wijze te identificeren en de inbreuk op het auteursrecht te controleren. U kunt bijvoorbeeld een watermerk maken en plaatsen dat op alle pagina's van een document de tekst Vertrouwelijk aangeeft. Nadat u een watermerk hebt gemaakt, kunt u dit opnemen in een beleid. U kunt dus het watermerkkenmerk van het beleid instellen met het nieuwe watermerk. Nadat een beleid met een watermerk is toegepast op een document, wordt het watermerk weergegeven in het document dat met een beleid is beveiligd.
Overzicht van de stappen summary_of_steps-8
Voer de volgende stappen uit om een watermerk te maken:
- Inclusief projectbestanden.
- Maak een API-object voor Document Security Client.
- Stel de kenmerken van de watermerken in.
- Registreer het watermerk bij de Document Security Service.
omvat projectdossiers
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.
creeer een voorwerp van de Cliënt API van de Veiligheid van het Document
Voordat u programmatisch een Document Security-servicebewerking kunt uitvoeren, moet u een Document Security-service-clientobject maken. Maak een RightsManagementClient
-object als u de Java API gebruikt. Als u de webservice-API voor documentbeveiliging gebruikt, maakt u een RightsManagementServiceService
-object.
plaats de watermerkattributen
Als u een watermerk wilt maken, moet u de kenmerken van het watermerk instellen. Het kenmerk name moet altijd worden gedefinieerd. Naast het kenmerk name moet u ten minste een van de volgende kenmerken instellen:
- Aangepaste tekst
- DateIncluded
- UserIdIncluded
- UserNameIncluded
De volgende tabel bevat een lijst met sleutel- en waardeparen die zijn vereist voor het maken van een watermerk met behulp van webservices.
WaterBackCmd:IS_USERNAME_ENABLED
WaterBackCmd:IS_USERID_ENABLED
WaterBackCmd:IS_CURRENTDATE_ENABLED
WaterBackCmd:IS_CUSTOMTEXT_ENABLED
WaterBackCmd:SRCTEXT
.WaterBackCmd:OPACITY
WaterBackCmd:ROTATION
WaterBackCmd:SCALE
WaterBackCmd:IS_SIZE_ENABLED
aanwezig zijn en moet de waarde true zijn. Als dit kenmerk niet is opgegeven, wordt het standaardgedrag aan de pagina aangepast.WaterBackCmd:HORIZ_ALIGN
WaterBackCmd:VERT_ALIGN
WaterBackCmd:IS_USE_BACKGROUND
WaterBackCmd:IS_SIZE_ENABLED
WaterBackCmd:SRCTEXT
WaterBackCmd:IS_CUSTOMTEXT_ENABLED
ook aanwezig zijn en op true worden ingesteld.Voor alle watermerken moet een van de volgende kenmerken zijn gedefinieerd:
WaterBackCmd:IS_USERNAME_ENABLED
WaterBackCmd:IS_USERID_ENABLED
WaterBackCmd:IS_CURRENTDATE_ENABLED
WaterBackCmd:IS_CUSTOMTEXT_ENABLED
Alle andere kenmerken zijn optioneel.
Register het watermerk
Een nieuw watermerk moet bij de dienst van de Veiligheid van het Document worden geregistreerd alvorens het kan worden gebruikt. Nadat u een watermerk hebt geregistreerd, kunt u dit gebruiken binnen het beleid.
zie ook
Inclusief AEM Forms Java-bibliotheekbestanden
Watermerken maken met de Java API create-watermarks-using-the-java-api
Een watermerk maken met de API voor documentbeveiliging (Java):
-
Inclusief projectbestanden.
Neem client JAR-bestanden, zoals de
adobe-rightsmanagement-client.jar
, op in het klassenpad van uw Java-project. -
Maak een API-object voor Document Security Client.
- Maak een
ServiceClientFactory
-object dat verbindingseigenschappen bevat. - Maak een
RightsManagementClient
-object door de constructor ervan te gebruiken en hetServiceClientFactory
-object door te geven.
- Maak een
-
De kenmerken van het watermerk instellen
- Maak een
Watermark
-object door de statische methodeInfomodelObjectFactory
van het objectcreateWatermark
aan te roepen. Deze methode retourneert eenWatermark
-object. - Stel het name-kenmerk van het watermerk in door de methode
setName
van het objectWatermark
aan te roepen en een tekenreekswaarde door te geven die de naam van het beleid aangeeft. - Stel het achtergrondkenmerk van het watermerk in door de methode
setBackground
van het objectWatermark
aan te roepen en door te geventrue
. Door dit kenmerk in te stellen, verschijnt het watermerk op de achtergrond van het document. - Stel het aangepaste tekstkenmerk van het watermerk in door de methode
setCustomText
van het objectWatermark
aan te roepen en een tekenreekswaarde door te geven die de tekst van het watermerk vertegenwoordigt. - Stel het kenmerk opacity van het watermerk in door de methode
setOpacity
van het objectWatermark
aan te roepen en een geheel-getalwaarde door te geven die het dekkingsniveau opgeeft. De waarde 100 geeft aan dat het watermerk volledig dekkend is en de waarde 0 geeft aan dat het watermerk volledig transparant is.
- Maak een
-
Registreer het watermerk.
- Maak een
WatermarkManager
-object door de methodeRightsManagementClient
objectgetWatermarkManager
aan te roepen. Deze methode retourneert eenWatermarkManager
-object. - Registreer het watermerk door de methode
registerWatermark
van het objectWatermarkManager
aan te roepen en het objectWatermark
door te geven dat het te registreren watermerk vertegenwoordigt. Deze methode retourneert een tekenreekswaarde die de identificatiewaarde van het watermerk vertegenwoordigt.
- Maak een
de voorbeelden van de Code
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
- "Snel starten (SOAP modus): een watermerk maken met de Java API"
Watermerken maken met de webservice-API create-watermarks-using-the-web-service-api
Een watermerk maken met de API voor documentbeveiliging (webservice):
-
Maak een API-object voor Document Security Client.
Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Vervang localhost
door het IP-adres van de server die als host fungeert voor AEM Forms. -
Maak een API-object voor Document Security Client.
-
Maak een
RightsManagementServiceClient
-object met de standaardconstructor. -
Maak een
RightsManagementServiceClient.Endpoint.Address
-object met deSystem.ServiceModel.EndpointAddress
-constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeldhttp://localhost:8080/soap/services/RightsManagementService?WSDL
.) U hoeft het attribuutlc_version
niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.) -
Maak een
System.ServiceModel.BasicHttpBinding
-object door de waarde van hetRightsManagementServiceClient.Endpoint.Binding
-veld op te halen. De geretourneerde waarde wordt gecast naarBasicHttpBinding
. -
Stel het veld
MessageEncoding
van hetSystem.ServiceModel.BasicHttpBinding
-object in opWSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt. -
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
- Wijs de gebruikersnaam van het AEM aan het veld
RightsManagementServiceClient.ClientCredentials.UserName.UserName
toe. - Wijs de bijbehorende wachtwoordwaarde toe aan het veld
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Wijs de constante waarde
HttpClientCredentialType.Basic
toe aan het veldBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Wijs de gebruikersnaam van het AEM aan het veld
-
Wijs de constante waarde
BasicHttpSecurityMode.TransportCredentialOnly
toe aan het veldBasicHttpBindingSecurity.Security.Mode
.
-
-
Stel de kenmerken van het watermerk in.
- Maak een
WatermarkSpec
-object door deWatermarkSpec
-constructor aan te roepen. - Stel de naam van het watermerk in door een tekenreekswaarde toe te wijzen aan het gegevenslid
name
van hetWatermarkSpec
-object. - Stel het kenmerk
id
van het watermerk in door een tekenreekswaarde toe te wijzen aan het gegevenslid van hetWatermarkSpec
objectid
. - Maak een afzonderlijk
MyMapOf_xsd_string_To_xsd_anyType_Item
-object voor elke watermerkeigenschap die moet worden ingesteld. - Stel de sleutelwaarde in door een waarde toe te wijzen aan het
key
-gegevenslid van hetMyMapOf_xsd_string_To_xsd_anyType_Item
-object (bijvoorbeeldWaterBackCmd:OPACITY)
. - Stel de waarde in door een waarde toe te wijzen aan het
value
data-lid.25
van hetMyMapOf_xsd_string_To_xsd_anyType_Item
-object. - Maak een
MyArrayOf_xsd_anyType
-object. Roep voor elkMyMapOf_xsd_string_To_xsd_anyType_Item
-object de methodeMyArrayOf_xsd_anyType
objectAdd
aan. Geef het objectMyMapOf_xsd_string_To_xsd_anyType_Item
door. - Wijs het
MyArrayOf_xsd_anyType
-object toe aan het gegevenslid van hetWatermarkSpec
objectvalues
.
- Maak een
-
Registreer het watermerk.
Registreer het watermerk door de methode
registerWatermark
van het objectRightsManagementServiceClient
aan te roepen en het objectWatermarkSpec
door te geven dat het te registreren watermerk vertegenwoordigt.
de voorbeelden van de Code
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
- "Quick Start (MTOM): Creating a watermark using the web service API"
- "Quick Start (SwaRef): Creating a watermark using the web service API"
zie ook
Watermerken wijzigen modifying-watermarks
U kunt een bestaand watermerk wijzigen met de Java API voor documentbeveiliging of de webservice-API. Als u een bestaand watermerk wilt wijzigen, haalt u het op, wijzigt u de kenmerken en werkt u het vervolgens bij op de server. Stel dat u een watermerk ophaalt en het kenmerk Dekking wijzigt. Voordat de wijziging van kracht wordt, moet u het watermerk bijwerken.
Wanneer u een watermerk wijzigt, is de wijziging van invloed op toekomstige documenten waarop het watermerk is toegepast. Dat wil zeggen dat bestaande PDF-documenten die het watermerk bevatten, niet worden beïnvloed.
Overzicht van de stappen summary_of_steps-9
Voer de volgende stappen uit om een watermerk te wijzigen:
- Inclusief projectbestanden.
- Maak een API-object voor Document Security Client.
- Haal het watermerk op dat u wilt wijzigen.
- Stel de kenmerken van de watermerken in.
- Werk het watermerk bij.
omvat projectdossiers
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.
creeer een voorwerp van de Cliënt API van de Veiligheid van het Document
Voordat u programmatisch een Document Security-servicebewerking kunt uitvoeren, moet u een Document Security-service-clientobject maken. Maak een DocumentSecurityClient
-object als u de Java API gebruikt. Als u de webservice-API voor documentbeveiliging gebruikt, maakt u een DocumentSecurityServiceService
-object.
wint het watermerk terug om te wijzigen
Als u een watermerk wilt wijzigen, moet u een bestaand watermerk ophalen. U kunt een watermerk terugwinnen door zijn naam te specificeren of door zijn herkenningstekenwaarde te specificeren.
plaats de watermerkattributen
Als u een bestaand watermerk wilt wijzigen, wijzigt u de waarde van een of meer watermerkkenmerken. Wanneer u via programmacode een watermerk bijwerkt met behulp van een webservice, moet u alle kenmerken instellen die oorspronkelijk zijn ingesteld, zelfs als de waarde niet verandert. Stel bijvoorbeeld dat de volgende watermerkkenmerken zijn ingesteld: WaterBackCmd:IS_USERID_ENABLED
, WaterBackCmd:IS_CUSTOMTEXT_ENABLED
, WaterBackCmd:OPACITY
en WaterBackCmd:SRCTEXT
. Hoewel het enige kenmerk dat u wilt wijzigen WaterBackCmd:OPACITY
is, moet u de andere waarden instellen.
werk het watermerk bij
Nadat u de kenmerken van een watermerk hebt gewijzigd, moet u het watermerk bijwerken.
zie ook
Inclusief AEM Forms Java-bibliotheekbestanden
Watermerken wijzigen met de Java API modify-watermarks-using-the-java-api
Een watermerk wijzigen met de API voor documentbeveiliging (Java):
-
Inclusief projectbestanden.
Neem JAR-bestanden voor clients, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project.
-
Maak een API-object voor Document Security Client.
- Maak een
ServiceClientFactory
-object dat verbindingseigenschappen bevat. - Maak een
DocumentSecurityClient
-object door de constructor ervan te gebruiken en hetServiceClientFactory
-object door te geven.
- Maak een
-
Haal het watermerk op dat u wilt wijzigen.
Maak een
WatermarkManager
-object door de methodeDocumentSecurityClient
objectgetWatermarkManager
aan te roepen en geef een tekenreekswaarde door die de naam van het watermerk opgeeft. Deze methode retourneert eenWatermark
-object dat het watermerk vertegenwoordigt dat moet worden gewijzigd. -
Stel de kenmerken van het watermerk in.
Stel het kenmerk opacity van het watermerk in door de methode
setOpacity
van het objectWatermark
aan te roepen en een geheel-getalwaarde door te geven die het dekkingsniveau opgeeft. De waarde 100 geeft aan dat het watermerk volledig dekkend is en de waarde 0 geeft aan dat het watermerk volledig transparant is.note note NOTE In dit voorbeeld wordt alleen het kenmerk opacity gewijzigd. -
Werk het watermerk bij.
- Werk het watermerk bij door de methode
updateWatermark
van het objectWatermarkManager
aan te roepen en geef het objectWatermark
door waarvan het kenmerk is gewijzigd.
- Werk het watermerk bij door de methode
de voorbeelden van de Code
Zie Snel starten (modus SOAP): Een watermerk wijzigen met behulp van de Java API-sectie voor codevoorbeelden met de documentbeveiligingsservice.
Watermerken wijzigen met de webservice-API modify-watermarks-using-the-web-service-api
Wijzig een watermerk met de API voor documentbeveiliging (webservice):
-
Inclusief projectbestanden.
Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Vervang localhost
door het IP-adres van de server die als host fungeert voor AEM Forms. -
Maak een API-object voor Document Security Client.
-
Maak een
DocumentSecurityServiceClient
-object met de standaardconstructor. -
Maak een
RightsManagementServiceClient.Endpoint.Address
-object met deSystem.ServiceModel.EndpointAddress
-constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeldhttp://localhost:8080/soap/services/DocumentSecurityService?WSDL
.) U hoeft het attribuutlc_version
niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.) -
Maak een
System.ServiceModel.BasicHttpBinding
-object door de waarde van hetDocumentSecurityServiceClient.Endpoint.Binding
-veld op te halen. De geretourneerde waarde wordt gecast naarBasicHttpBinding
. -
Stel het veld
MessageEncoding
van hetSystem.ServiceModel.BasicHttpBinding
-object in opWSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt. -
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
- Wijs de gebruikersnaam van het AEM aan het veld
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
toe. - Wijs de bijbehorende wachtwoordwaarde toe aan het veld
DocumentSecurityServiceClient.ClientCredentials.UserName.Password
. - Wijs de constante waarde
HttpClientCredentialType.Basic
toe aan het veldBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Wijs de gebruikersnaam van het AEM aan het veld
-
Wijs de constante waarde
BasicHttpSecurityMode.TransportCredentialOnly
toe aan het veldBasicHttpBindingSecurity.Security.Mode
.
-
-
Haal het watermerk op dat u wilt wijzigen.
Haal het watermerk op dat u wilt wijzigen door de methode
getWatermarkByName
van het objectDocumentSecurityServiceClient
aan te roepen. Geef een tekenreekswaarde door die de naam van het watermerk aangeeft. Deze methode retourneert eenWatermarkSpec
-object dat het watermerk vertegenwoordigt dat moet worden gewijzigd. -
Stel de kenmerken van het watermerk in.
- Maak een afzonderlijk
MyMapOf_xsd_string_To_xsd_anyType_Item
-object voor elke watermerkeigenschap die moet worden bijgewerkt. - Stel de sleutelwaarde in door een waarde toe te wijzen aan het
key
-gegevenslid van hetMyMapOf_xsd_string_To_xsd_anyType_Item
-object (bijvoorbeeldWaterBackCmd:OPACITY)
. - Stel de waarde in door een waarde toe te wijzen aan het
value
data-lid.50
van hetMyMapOf_xsd_string_To_xsd_anyType_Item
-object. - Maak een
MyArrayOf_xsd_anyType
-object. Roep voor elkMyMapOf_xsd_string_To_xsd_anyType_Item
-object de methodeMyArrayOf_xsd_anyType
objectAdd
aan. Geef het objectMyMapOf_xsd_string_To_xsd_anyType_Item
door. - Wijs het
MyArrayOf_xsd_anyType
-object toe aan het gegevenslid van hetWatermarkSpec
objectvalues
.
- Maak een afzonderlijk
-
Werk het watermerk bij.
Werk het watermerk bij door de methode
updateWatermark
van het objectDocumentSecurityServiceClient
aan te roepen en het objectWatermarkSpec
door te geven dat het watermerk vertegenwoordigt dat moet worden gewijzigd.
de voorbeelden van de Code
Zie het volgende snelle begin voor codevoorbeelden met gebruik van de Document Security-service:
- "Quick Start (MTOM): Modifying a watermark using the web service API"
Zoeken naar gebeurtenissen searching-for-events
De dienst van het Rights Management volgt specifieke acties aangezien zij voorkomen, zoals het toepassen van een beleid op een document, het openen van een beleid-beschermd document, en het intrekken van toegang tot documenten. Gebeurteniscontrole moet zijn ingeschakeld voor de service Rights Management of gebeurtenissen worden niet bijgehouden.
Gebeurtenissen behoren tot een van de volgende categorieën:
- Beheergebeurtenissen zijn handelingen die betrekking hebben op een beheerder, zoals het maken van een beheerdersaccount.
- Documentgebeurtenissen zijn handelingen die betrekking hebben op een document, zoals het sluiten van een document dat met een beleid is beveiligd.
- Beleidsgebeurtenissen zijn handelingen die betrekking hebben op een beleid, zoals het maken van een beleid.
- De gebeurtenissen van de dienst zijn acties met betrekking tot de dienst van het Rights Management, zoals het synchroniseren met de gebruikersfolder.
U kunt zoeken naar specifieke gebeurtenissen met behulp van de Rights Management Java API of de webservice-API. Door naar gebeurtenissen te zoeken, kunt u taken uitvoeren, zoals het creëren van een logboekdossier van bepaalde gebeurtenissen.
Overzicht van de stappen summary_of_steps-10
Voer de volgende stappen uit om te zoeken naar een Rights Management-gebeurtenis:
- Inclusief projectbestanden.
- Maak een Rights Management Client API-object.
- Geef de gebeurtenis op waarnaar u wilt zoeken.
- Zoeken naar de gebeurtenis.
omvat projectdossiers
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.
creeer een voorwerp van de Cliënt van het Rights Management API
Alvorens u een de dienstverrichting van het Rights Management programmatically kunt uitvoeren, moet u een voorwerp van de de dienstcliënt van het Rights Management tot stand brengen. Maak een DocumentSecurityClient
-object als u de Java API gebruikt. Als u de API voor webservices van het Rights Management gebruikt, maakt u een DocumentSecurityServiceService
-object.
specificeer de gebeurtenissen om te zoeken
Geef op naar welke gebeurtenis moet worden gezocht. U kunt bijvoorbeeld zoeken naar het beleid om een gebeurtenis te maken, die optreedt wanneer een nieuw beleid wordt gemaakt.
Onderzoek naar de gebeurtenis
Nadat u de gebeurtenis hebt opgegeven waarnaar moet worden gezocht, kunt u de Java API voor Rights Managementen of de API voor webservices van Rights Managementen gebruiken om naar de gebeurtenis te zoeken.
zie ook
Zoeken naar gebeurtenissen met de Java API search-for-events-using-the-java-api
U kunt naar gebeurtenissen zoeken met de API voor Rights Managementen (Java):
-
Projectbestanden opnemen
Neem client-JAR-bestanden, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project.
-
Een Rights Management Client API-object maken
Maak een
DocumentSecurityClient
-object door de constructor ervan te gebruiken en eenServiceClientFactory
-object door te geven dat verbindingseigenschappen bevat. -
Geef de gebeurtenissen op waarnaar u wilt zoeken
- Maak een
EventManager
-object door de methodeDocumentSecurityClient
objectgetEventManager
aan te roepen. Deze methode retourneert eenEventManager
-object. - Maak een
EventSearchFilter
-object door de constructor ervan aan te roepen. - Geef de gebeurtenis op waarnaar moet worden gezocht door de methode
setEventCode
van het objectEventSearchFilter
aan te roepen en een lid van het type static data door te geven dat behoort tot de klasseEventManager
die de gebeurtenis vertegenwoordigt waarnaar moet worden gezocht. Als u bijvoorbeeld wilt zoeken naar de gebeurtenis create voor het beleid, geeft uEventManager.POLICY_CREATE_EVENT
door.
note note NOTE U kunt aanvullende zoekcriteria definiëren door objectmethoden van EventSearchFilter
aan te roepen. Roep bijvoorbeeld de methodesetUserName
aan om een gebruiker op te geven die aan de gebeurtenis is gekoppeld. - Maak een
-
Zoeken naar de gebeurtenis
Zoek naar de gebeurtenis door de methode
searchForEvents
van het objectEventManager
aan te roepen en het objectEventSearchFilter
door te geven dat de zoekcriteria voor de gebeurtenis definieert. Deze methode retourneert een array vanEvent
-objecten.
de voorbeelden van de Code
Voor codevoorbeelden die de dienst van het Rights Management gebruiken, zie Snel begint:
- "Snel starten (SOAP): zoeken naar gebeurtenissen met de Java API"
Zoeken naar gebeurtenissen met de webservice-API search-for-events-using-the-web-service-api
U kunt naar gebeurtenissen zoeken met de Rights Management-API (webservice):
-
Projectbestanden opnemen
Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Vervang localhost
door het IP-adres van de server die als host fungeert voor AEM Forms. -
Een Rights Management Client API-object maken
-
Maak een
DocumentSecurityServiceClient
-object met de standaardconstructor. -
Maak een
DocumentSecurityServiceClient.Endpoint.Address
-object met deSystem.ServiceModel.EndpointAddress
-constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeldhttp://localhost:8080/soap/services/RightsManagementService?WSDL
.) U hoeft het attribuutlc_version
niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.) -
Maak een
System.ServiceModel.BasicHttpBinding
-object door de waarde van hetDocumentSecurityServiceClient.Endpoint.Binding
-veld op te halen. De geretourneerde waarde wordt gecast naarBasicHttpBinding
. -
Stel het veld
MessageEncoding
van hetSystem.ServiceModel.BasicHttpBinding
-object in opWSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt. -
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
- Wijs de gebruikersnaam van het AEM aan het veld
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
toe. - Wijs de bijbehorende wachtwoordwaarde toe aan het veld
DocumentSecurityServiceClient.ClientCredentials.UserName.Password
. - Wijs de constante waarde
HttpClientCredentialType.Basic
toe aan het veldBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Wijs de gebruikersnaam van het AEM aan het veld
-
Wijs de constante waarde
BasicHttpSecurityMode.TransportCredentialOnly
toe aan het veldBasicHttpBindingSecurity.Security.Mode
.
-
-
Geef de gebeurtenissen op waarnaar u wilt zoeken
- Maak een
EventSpec
-object met behulp van de constructor. - Geef het begin op van de periode waarin de gebeurtenis heeft plaatsgevonden door het
firstTime.date
data member van hetEventSpec
object in te stellen op deDataTime
-instantie die het begin van het datumbereik vertegenwoordigt op het moment dat de gebeurtenis plaatsvond. - Wijs de waarde
true
toe aan het gegevenslidEventSpec
objectfirstTime.dateSpecified
. - Geef het einde van de periode waarin de gebeurtenis heeft plaatsgevonden op door het
lastTime.date
data member van hetEventSpec
object in te stellen op deDataTime
-instantie die het einde van het datumbereik vertegenwoordigt toen de gebeurtenis plaatsvond. - Wijs de waarde
true
toe aan het gegevenslidEventSpec
objectlastTime.dateSpecified
. - Stel de gebeurtenis waarnaar moet worden gezocht in door een tekenreekswaarde toe te wijzen aan het gegevenslid
eventCode
van hetEventSpec
-object. In de volgende tabel worden de numerieke waarden weergegeven die u aan deze eigenschap kunt toewijzen:
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 Het type Event Waarde ALL_EVENTS
999 USER_CHANGE_PASSWORD_EVENT
1000 USER_REGISTER_EVENT
1001 USER_PREREGISTER_EVENT
1002 USER_ACTIVATE_EVENT
1003 USER_DEACTIVATE_EVENT
1004 USER_AUTHENTICATE_EVENT
1005 USER_AUTHENTICATE_DENY_EVENT
1006 USER_ACCOUNT_LOCK_EVENT
1007 USER_DELETE_EVENT
1008 USER_UPDATE_PROFILE_EVENT
1009 DOCUMENT_VIEW_EVENT
2000 DOCUMENT_PRINT_LOW_EVENT
2001 DOCUMENT_PRINT_HIGH_EVENT
2002 DOCUMENT_SIGN_EVENT
2003 DOCUMENT_ADD_ANNOTATION_EVENT
2004 DOCUMENT_FORM_FILL_EVENT
2005 DOCUMENT_CLOSE_EVENT
2006 DOCUMENT_MODIFY_EVENT
2007 DOCUMENT_CHANGE_SECURITY_HANDLER_EVENT
2008 DOCUMENT_SWITCH_POLICY_EVENT
2009 DOCUMENT_REVOKE_EVENT
2010 $1
2011 DOCUMENT_SECURE_EVENT
2012 DOCUMENT_UNKNOWN_CLIENT_EVENT
2013 DOCUMENT_CHANGE_REVOKE_URL_EVENT
2014 POLICY_CHANGE_EVENT
3000 POLICY_ENABLE_EVENT
3001 POLICY_DISABLE_EVENT
3002 POLICY_CREATE_EVENT
3003 POLICY_DELETE_EVENT
3004 POLICY_CHANGE_OWNER_EVENT
3005 SERVER_CLIENT_SYNC_EVENT
4000 SERVER_SYNC_DIR_INFO_EVENT
4001 SERVER_SYNC_DIR_COMPLETE_EVENT
4002 SERVER_VERSION_MISMATCH_EVENT
4003 SERVER_CONFIG_CHANGE_EVENT
4004 SERVER_ENABLE_OFFLINE_ACCESS_EVENT
4005 ADMIN_ADD_EVENT
5000 ADMIN_DELETE_EVENT
5001 ADMIN_EDIT_EVENT
5002 ADMIN_ACTIVATE_EVENT
5003 ADMIN_DEACTIVATE_EVENT
5004 ERROR_DIRECTORY_SERVICE_EVENT
6000 CREATED_POLICYSET_EVENT
7000 DELETED_POLICYSET_EVENT
7001 MODIFIED_POLICYSET_EVENT
7002 - Maak een
-
Zoeken naar de gebeurtenis
Zoek naar de gebeurtenis door de methode
searchForEvents
van het objectDocumentSecurityServiceClient
aan te roepen en het objectEventSpec
door te geven dat de gebeurtenis vertegenwoordigt waarnaar moet worden gezocht en het maximale aantal resultaten. Deze methode retourneert eenMyArrayOf_xsd_anyType
-verzameling waarbij elk element eenAuditSpec
-instantie is. Met behulp van eenAuditSpec
-instantie kunt u informatie opvragen over de gebeurtenis, zoals de tijd dat deze heeft plaatsgevonden. De instantieAuditSpec
bevat eentimestamp
-gegevenslid dat deze informatie opgeeft.
de voorbeelden van de Code
Voor codevoorbeelden die de dienst van het Rights Management gebruiken, zie Snel begint:
- "Snel starten (MTOM): zoeken naar gebeurtenissen met behulp van de webservice-API"
- "Quick Start (SwaRef): zoeken naar gebeurtenissen met behulp van de webservice-API"
zie ook
Beleid toepassen op Word-documenten applying-policies-to-word-documents
Naast PDF-documenten biedt de Rights Management-service ondersteuning voor aanvullende documentindelingen, zoals een Microsoft Word-document (DOC-bestand) en andere Microsoft Office-bestandsindelingen. U kunt bijvoorbeeld een beleid toepassen op een Word-document om dit te beveiligen. Door een beleid op een document van Word toe te passen, beperkt u toegang tot het document. U kunt geen beleid op een document toepassen als het document reeds met een beleid wordt beveiligd.
U kunt het gebruik van een beleid-beschermd document van Word controleren nadat u het verspreidt. Dat wil zeggen dat u kunt zien hoe het document wordt gebruikt en wie het gebruikt. U kunt bijvoorbeeld zien wanneer iemand het document heeft geopend.
Overzicht van de stappen summary_of_steps-11
Voer de volgende stappen uit om een beleid toe te passen op een Word-document:
- Inclusief projectbestanden.
- Maak een API-object voor Document Security Client.
- Hiermee wordt een Word-document opgehaald waarop een beleid wordt toegepast.
- Pas een bestaand beleid op het document van Word toe.
- Sla het door het beleid beveiligde Word-document op.
omvat projectdossiers
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.
creeer een Cliënt APIobject van de Veiligheid van het Document
Voordat u programmatisch een Document Security-servicebewerking kunt uitvoeren, moet u een Document Security-service-clientobject maken.
wint een document van Word terug
Hiermee wordt een Word-document opgehaald om een beleid toe te passen. Nadat u een beleid op het document van Word toepast, worden de gebruikers beperkt wanneer het gebruiken van het document. Als het beleid bijvoorbeeld niet toestaat dat het document offline wordt geopend, moeten gebruikers online zijn om het document te openen.
pas een bestaand beleid op het document van Word toe
Als u een beleid wilt toepassen op een Word-document, moet u verwijzen naar een bestaand beleid en opgeven tot welke beleidsset het beleid behoort. De gebruiker die de verbindingseigenschappen instelt, moet toegang hebben tot het opgegeven beleid. Als dat niet het geval is, treedt een uitzondering op.
sparen het document van Word
Nadat de documentbeveiligingsservice een beleid heeft toegepast op een Word-document, kunt u het met een beleid beveiligde Word-document opslaan als een DOC-bestand.
zie ook
Inclusief AEM Forms Java-bibliotheekbestanden
Een beleid toepassen op een Word-document met behulp van de Java API apply-a-policy-to-a-word-document-using-the-java-api
Een beleid toepassen op een Word-document met behulp van de API voor documentbeveiliging (Java):
-
Inclusief projectbestanden.
Neem client-JAR-bestanden, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project.
-
Maak een API-object voor Document Security Client.
- Maak een
ServiceClientFactory
-object dat verbindingseigenschappen bevat. - Maak een
DocumentSecurityClient
-object door de constructor ervan te gebruiken en hetServiceClientFactory
-object door te geven.
- Maak een
-
Een Word-document ophalen.
- Maak een
java.io.FileInputStream
-object dat het Word-document vertegenwoordigt door de constructor ervan te gebruiken en een tekenreekswaarde door te geven die de locatie van het Word-document aangeeft. - Maak een
com.adobe.idp.Document
-object door de constructor ervan te gebruiken en hetjava.io.FileInputStream
-object door te geven.
- Maak een
-
Pas een bestaand beleid op het document van Word toe.
-
Maak een
DocumentManager
-object door de methodeDocumentSecurityClient
objectgetDocumentManager
aan te roepen. -
Pas een beleid toe op het Word-document door de methode
protectDocument
van hetDocumentManager
-object aan te roepen en de volgende waarden door te geven:- Het
com.adobe.idp.Document
-object dat het Word-document bevat waarop het beleid wordt toegepast. - Een tekenreekswaarde die de naam van het document aangeeft.
- Een tekenreekswaarde die de naam opgeeft van de beleidsset waartoe het beleid behoort. U kunt een
null
-waarde opgeven die resulteert in het gebruik van deMyPolicies
-beleidsset. - Een tekenreekswaarde die de beleidsnaam opgeeft.
- Een tekenreekswaarde die de naam vertegenwoordigt van het gebruikersbeheerdomein van de gebruiker die de uitgever van het document is. Deze parameterwaarde is optioneel en kan null zijn (als deze parameter null is, moet de volgende parameterwaarde null zijn).
- Een tekenreekswaarde die de naam vertegenwoordigt van de canonieke naam van de gebruiker van de gebruikersmanager die de uitgever van het document is. Deze parameterwaarde is optioneel en kan
null
zijn (als deze parameternull
is, moet de vorige parameterwaardenull
zijn). - A
com.adobe.livecycle.rightsmanagement.Locale
die de landinstelling vertegenwoordigt die wordt gebruikt voor het selecteren van de sjabloon MS Office. Deze parameterwaarde is optioneel en u kuntnull
opgeven.
De methode
protectDocument
retourneert eenRMSecureDocumentResult
-object dat het door een beleid beveiligde Word-document bevat. - Het
-
-
Sla het Word-document op.
- Roep de methode
getProtectedDoc
van hetRMSecureDocumentResult
-object aan om het door het beleid beveiligde Word-document op te halen. Deze methode retourneert eencom.adobe.idp.Document
-object. - Maak een
java.io.File
-object en controleer of de bestandsextensie DOC is. - Roep de methode
copyToFile
van het objectcom.adobe.idp.Document
aan om de inhoud van het objectDocument
naar het bestand te kopiëren (gebruik het objectDocument
dat door de methodegetProtectedDoc
is geretourneerd).
- Roep de methode
de voorbeelden van de Code
Zie het volgende snelle begin voor codevoorbeelden met gebruik van de Document Security-service:
- "Snel starten (SOAP modus): beleid toepassen op een Word-document met behulp van de Java API"
Een beleid toepassen op een Word-document met behulp van de webservice-API apply-a-policy-to-a-word-document-using-the-web-service-api
Pas een beleid op een document van Word toe door de Veiligheid API van het Document (Webdienst) te gebruiken:
-
Inclusief projectbestanden.
Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie:
http://localhost:8080/soap/services/DocumentSecurityService?WSDL&lc_version=9.0.1
.note note NOTE Vervang localhost
door het IP-adres van de server die als host fungeert voor AEM Forms. -
Maak een API-object voor Document Security Client.
-
Maak een
DocumentSecurityServiceClient
-object met de standaardconstructor. -
Maak een
DocumentSecurityServiceClient.Endpoint.Address
-object met deSystem.ServiceModel.EndpointAddress
-constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeldhttp://localhost:8080/soap/services/DocumentSecurityService?WSDL
.) U hoeft het attribuutlc_version
niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.) -
Maak een
System.ServiceModel.BasicHttpBinding
-object door de waarde van hetDocumentSecurityServiceClient.Endpoint.Binding
-veld op te halen. De geretourneerde waarde wordt gecast naarBasicHttpBinding
. -
Stel het veld
MessageEncoding
van hetSystem.ServiceModel.BasicHttpBinding
-object in opWSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt. -
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
- Wijs de gebruikersnaam van het AEM aan het veld
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
toe. - Wijs de bijbehorende wachtwoordwaarde toe aan het veld
DocumentSecurityServiceClient.ClientCredentials.UserName.Password
. - Wijs de constante waarde
HttpClientCredentialType.Basic
toe aan het veldBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Wijs de gebruikersnaam van het AEM aan het veld
-
Wijs de constante waarde
BasicHttpSecurityMode.TransportCredentialOnly
toe aan het veldBasicHttpBindingSecurity.Security.Mode
.
-
-
Een Word-document ophalen.
- Maak een
BLOB
-object met behulp van de constructor. HetBLOB
-object wordt gebruikt om een Word-document op te slaan waarop een beleid wordt toegepast. - Maak een
System.IO.FileStream
-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het Word-document en de modus waarin het bestand moet worden geopend, vertegenwoordigt. - Maak een bytearray waarin de inhoud van het object
System.IO.FileStream
wordt opgeslagen. Bepaal de grootte van de bytearray door de eigenschapLength
van het objectSystem.IO.FileStream
op te halen. - Vul de bytearray met streamgegevens door de methode
Read
van het objectSystem.IO.FileStream
aan te roepen. Geef de bytearray, de startpositie en de streamlengte door om te lezen. - Vul het
BLOB
-object door hetMTOM
-veld ervan toe te wijzen met de inhoud van de bytearray.
- Maak een
-
Pas een bestaand beleid op het document van Word toe.
Pas een beleid toe op het Word-document door de methode
protectDocument
van hetDocumentSecurityServiceClient
-object aan te roepen en de volgende waarden door te geven:- Het
BLOB
-object dat het Word-document bevat waarop het beleid wordt toegepast. - Een tekenreekswaarde die de naam van het document aangeeft.
- Een tekenreekswaarde die de naam opgeeft van de beleidsset waartoe het beleid behoort. U kunt een
null
-waarde opgeven die resulteert in het gebruik van deMyPolicies
-beleidsset. - Een tekenreekswaarde die de beleidsnaam opgeeft.
- Een tekenreekswaarde die de naam vertegenwoordigt van het gebruikersbeheerdomein van de gebruiker die de uitgever van het document is. Deze parameterwaarde is optioneel en kan null zijn (als deze parameter null is, moet de volgende parameterwaarde
null
zijn). - Een tekenreekswaarde die de naam vertegenwoordigt van de canonieke naam van de gebruiker van de gebruikersmanager die de uitgever van het document is. Deze parameterwaarde is optioneel en kan null zijn (als deze parameter null is, moet de vorige parameterwaarde
null
zijn). - Een
RMLocale
-waarde die de waarde van de landinstelling opgeeft (bijvoorbeeldRMLocale.en
). - Een parameter van de koordoutput die wordt gebruikt om de waarde van beleidsidentificatie op te slaan.
- Een parameter van de koordoutput die wordt gebruikt om de beleid-beschermde herkenningstekenwaarde op te slaan.
- Een parameter van de koordoutput die wordt gebruikt om het mime type (bijvoorbeeld,
application/doc
) op te slaan.
De methode
protectDocument
retourneert eenBLOB
-object dat het door een beleid beveiligde Word-document bevat. - Het
-
Sla het Word-document op.
- Maak een
System.IO.FileStream
-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het met een beleid beveiligde Word-document vertegenwoordigt. - Maak een bytearray waarin de gegevensinhoud wordt opgeslagen van het object
BLOB
dat door de methodeprotectDocument
is geretourneerd. Vul de bytearray met de waarde van het gegevenslidMTOM
van het objectBLOB
. - Maak een
System.IO.BinaryWriter
-object door de constructor ervan aan te roepen en hetSystem.IO.FileStream
-object door te geven. - Schrijf de inhoud van de bytearray naar een Word-bestand door de methode
Write
van het objectSystem.IO.BinaryWriter
aan te roepen en de bytearray door te geven.
- Maak een
de voorbeelden van de Code
Zie het volgende snelle begin voor codevoorbeelden met gebruik van de Document Security-service:
- "Quick Start (MTOM): Applying a policy to a Word document using the web service API "
Beleid verwijderen uit Word-documenten removing-policies-from-word-documents
U kunt een beleid uit een beleid-beschermd document van Word verwijderen om veiligheid uit het document te verwijderen. Dat wil zeggen, als u niet langer wilt dat het document wordt beschermd door een beleid. Als u een beleid-beschermd document van Word met een nieuwer beleid wilt bijwerken, dan in plaats van het verwijderen van het beleid en het toevoegen van het bijgewerkte beleid, is het efficiënter om het beleid te schakelen.
Overzicht van de stappen summary_of_steps-12
Voer de volgende stappen uit om een beleid te verwijderen uit een Word-document dat met een beleid is beveiligd:
- Projectbestanden opnemen
- Maak een API-object voor Document Security Client.
- Hiermee haalt u een Word-document op dat met een beleid is beveiligd.
- Verwijder het beleid uit het Word-document.
- De onbeveiligde Word-documenten opslaan
omvat projectdossiers
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.
creeer een voorwerp van de Cliënt API van de Veiligheid van het Document
Voordat u via programmacode een bewerking met de documentbeveiligingsservice kunt uitvoeren, maakt u een clientobject van de documentbeveiligingsservice.
wint een beleid-beschermd document van Word terug
Woord-document dat door een beleid is beveiligd, ophalen om een beleid te verwijderen. Als u probeert om een beleid uit een document van Word te verwijderen dat niet door een beleid wordt beschermd, zult u een uitzondering veroorzaken.
verwijder het beleid uit het document van Word
U kunt een beleid uit een beleid-beschermd document van Word verwijderen op voorwaarde dat een beheerder in de verbindingsmontages wordt gespecificeerd. Als dat niet het geval is, moet het beleid dat wordt gebruikt om een document te beveiligen de toestemming SWITCH_POLICY
bevatten om een beleid uit een document van Word te verwijderen. De gebruiker die is opgegeven in de AEM Forms-verbindingsinstellingen moet ook over deze machtiging beschikken. Anders wordt een uitzondering gegenereerd.
sparen het onbeveiligde document van Word
Nadat de documentbeveiligingsservice een beleid uit een Word-document heeft verwijderd, kunt u het onbeveiligde Word-document opslaan als een DOC-bestand.
zie ook
Inclusief AEM Forms Java-bibliotheekbestanden
Een beleid verwijderen uit een Word-document met de Java API remove-a-policy-from-a-word-document-using-the-java-api
Verwijder een beleid uit een beleid-beschermd document van Word door de Veiligheid API van het Document (Java) te gebruiken:
-
Projectbestanden opnemen
Neem client-JAR-bestanden, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project.
-
Een API-object voor documentbeveiliging maken
- Maak een
ServiceClientFactory
-object dat verbindingseigenschappen bevat. - Maak een
RightsManagementClient
-object door de constructor ervan te gebruiken en hetServiceClientFactory
-object door te geven.
- Maak een
-
Een met beleid beveiligd Word-document ophalen
- Maak een
java.io.FileInputStream
-object dat het beleidsbeveiligde Word-document vertegenwoordigt door de constructor ervan te gebruiken en een tekenreekswaarde door te geven die de locatie van het Word-document aangeeft. - Maak een
com.adobe.idp.Document
-object door de constructor ervan te gebruiken en hetjava.io.FileInputStream
-object door te geven.
- Maak een
-
Het beleid verwijderen uit het Word-document
- Maak een
DocumentManager
-object door de methodeRightsManagementClient
objectgetDocumentManager
aan te roepen. - Verwijder een beleid uit het Word-document door de methode
removeSecurity
van hetDocumentManager
-object aan te roepen en hetcom.adobe.idp.Document
-object door te geven dat het door een beleid beveiligde Word-document bevat. Deze methode retourneert eencom.adobe.idp.Document
-object dat een onbeveiligd Word-document bevat.
- Maak een
-
Het onbeveiligde Word-document opslaan
- Maak een
java.io.File
-object en controleer of de bestandsextensie DOC is. - Roep de methode
copyToFile
van het objectDocument
aan om de inhoud van het objectDocument
naar het bestand te kopiëren (gebruik het objectDocument
dat door de methoderemoveSecurity
is geretourneerd).
- Maak een
de voorbeelden van de Code
Zie het volgende snelle begin voor codevoorbeelden met gebruik van de Document Security-service:
- "Snel starten (SOAP modus): Een beleid verwijderen uit een Word-document met de Java API "
Een beleid verwijderen uit een Word-document met de webservice-API remove-a-policy-from-a-word-document-using-the-web-service-api
Verwijder een beleid uit een beleid-beschermd document van Word door de Veiligheid API van het Document (Webdienst te gebruiken:
-
Projectbestanden opnemen
Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Vervang localhost
door het IP-adres van de server die als host fungeert voor AEM Forms. -
Een API-object voor documentbeveiliging maken
-
Maak een
RightsManagementServiceClient
-object met de standaardconstructor. -
Maak een
RightsManagementServiceClient.Endpoint.Address
-object met deSystem.ServiceModel.EndpointAddress
-constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeldhttp://localhost:8080/soap/services/RightsManagementService?WSDL
.) U hoeft het attribuutlc_version
niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.) -
Maak een
System.ServiceModel.BasicHttpBinding
-object door de waarde van hetRightsManagementServiceClient.Endpoint.Binding
-veld op te halen. De geretourneerde waarde wordt gecast naarBasicHttpBinding
. -
Stel het veld
MessageEncoding
van hetSystem.ServiceModel.BasicHttpBinding
-object in opWSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt. -
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
- Wijs de gebruikersnaam van het AEM aan het veld
RightsManagementServiceClient.ClientCredentials.UserName.UserName
toe. - Wijs de bijbehorende wachtwoordwaarde toe aan het veld
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Wijs de constante waarde
HttpClientCredentialType.Basic
toe aan het veldBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Wijs de gebruikersnaam van het AEM aan het veld
-
Wijs de constante waarde
BasicHttpSecurityMode.TransportCredentialOnly
toe aan het veldBasicHttpBindingSecurity.Security.Mode
.
-
-
Een met beleid beveiligd Word-document ophalen
- Maak een
BLOB
-object met behulp van de constructor. HetBLOB
-object wordt gebruikt om het door een beleid beveiligde Word-document op te slaan waaruit het beleid wordt verwijderd. - Maak een
System.IO.FileStream
-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het Word-document en de modus waarin het bestand moet worden geopend, vertegenwoordigt. - Maak een bytearray waarin de inhoud van het object
System.IO.FileStream
wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschapLength
van het objectSystem.IO.FileStream
op te halen. - Vul de bytearray met streamgegevens door de methode
Read
van het objectSystem.IO.FileStream
aan te roepen en de bytearray, de startpositie en de lengte van de stream door te geven om te lezen. - Vul het
BLOB
-object door hetMTOM
-veld ervan toe te wijzen met de inhoud van de bytearray.
- Maak een
-
Het beleid verwijderen uit het Word-document
Verwijder het beleid uit het Word-document door de methode
removePolicySecurity
van hetRightsManagementServiceClient
-object aan te roepen en hetBLOB
-object door te geven dat het door het beleid beveiligde Word-document bevat. Deze methode retourneert eenBLOB
-object dat een onbeveiligd Word-document bevat. -
Het onbeveiligde Word-document opslaan
- Maak een
System.IO.FileStream
-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het onbeveiligde Word-document vertegenwoordigt. - Maak een bytearray waarin de gegevensinhoud wordt opgeslagen van het object
BLOB
dat door de methoderemovePolicySecurity
is geretourneerd. Vul de bytearray met de waarde van het veldMTOM
van het objectBLOB
. - Maak een
System.IO.BinaryWriter
-object door de constructor ervan aan te roepen en hetSystem.IO.FileStream
-object door te geven.
- Maak een
de voorbeelden van de Code
Zie het volgende snelle begin voor codevoorbeelden met gebruik van de Document Security-service:
- "Quick Start (MTOM): Removing a policy from a Word document using the web service API"
zie ook