Informatie over de Document Security Service
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.
Met de Document Security-service wordt voorkomen dat informatie buiten het bereik van de gebruiker wordt verspreid doordat gebruikers de controle kunnen behouden over de manier waarop ontvangers het met een beleid beveiligde PDF-document 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:
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:
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Referentie van de Diensten voor AEM Forms.
U kunt beleid programmatisch maken met de Java API voor documentbeveiliging of de webservice-API. Een beleid is een inzameling van informatie die de montages van de documentveiligheid, gemachtigde 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:
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>
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Referentie van de Diensten voor AEM Forms.
Voer de volgende stappen uit om een beleid te maken:
Projectbestanden opnemen
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:
Zie Including AEM Forms Java-bibliotheekbestanden voor informatie over de locatie van deze JAR-bestanden.
Een API-object voor documentbeveiliging maken
Voordat u via programmacode een bewerking met de documentbeveiligingsservice kunt uitvoeren, maakt u een clientobject van de documentbeveiligingsservice.
De kenmerken van het beleid instellen
Stel beleidskenmerken in om een beleid te maken. Een verplicht kenmerk is de naam van het beleid. 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:
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:
Als u de optie NoEncryption
opgeeft, kunt u de optie PlaintextMetadata
niet instellen op false
. Wanneer u dit probeert, wordt een uitzondering gegenereerd.
Voor informatie over andere attributen die u kunt plaatsen, zie de Policy
interfacebeschrijving in AEM Forms API Verwijzing.
Een beleidsitem maken
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:
Hierdoor kunnen ontvangers het document alleen online bekijken en niet kopiëren. Het document blijft beveiligd totdat de beveiliging ervan is verwijderd.
Het beleid registreren
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 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.
ServiceClientFactory
-object dat verbindingseigenschappen bevat.DocumentSecurityClient
-object door de constructor ervan te gebruiken en het object ServiceClientFactory
door te geven.Stel de kenmerken van het beleid in.
Policy
-object door de statische methode createPolicy
van het object aan te roepen. InfomodelObjectFactory
Deze methode retourneert een Policy
-object.setName
van het object Policy
aan te roepen en een tekenreekswaarde door te geven die de naam van het beleid aangeeft.setDescription
van het object Policy
aan te roepen en een tekenreekswaarde door te geven die de beschrijving van het beleid opgeeft.setPolicySetName
van het object Policy
aan te roepen en een tekenreekswaarde door te geven die de naam van de beleidsset opgeeft. (U kunt null
voor deze parameterwaarde specificeren die in het beleid resulteert dat aan Mijn Beleid wordt toegevoegd.)createValidityPeriod
van het object InfomodelObjectFactory
aan te roepen. Deze methode retourneert een ValidityPeriod
-object.setRelativeExpirationDays
van het object ValidityPeriod
aan te roepen en een geheel getal door te geven dat het aantal dagen opgeeft.setValidityPeriod
van het object Policy
aan te roepen en het object ValidityPeriod
door te geven.Maak een beleidsvermelding.
createPolicyEntry
van het InfomodelObjectFactory
voorwerp aan te halen. Deze methode retourneert een PolicyEntry
-object.createPermission
van het object InfomodelObjectFactory
aan te roepen. Geef een statisch gegevenslid door dat tot de Permission
interface behoort die de toestemming vertegenwoordigt. Deze methode retourneert een Permission
-object. Als u bijvoorbeeld de machtiging wilt toevoegen waarmee gebruikers gegevens kunnen kopiëren uit een PDF-document dat met een beleid is beveiligd, geeft u Permission.COPY
door. (Herhaal deze stap voor elke machtiging die u wilt toevoegen.)PolicyEntry
methode van het voorwerp addPermission
aan te halen en het Permission
voorwerp over te gaan. (Herhaal deze stap voor elk Permission
-object dat u hebt gemaakt).createSpecialPrincipal
van het InfomodelObjectFactory
voorwerp aan te halen. Geef een gegevenslid door dat tot het InfomodelObjectFactory
voorwerp behoort dat het hoofd vertegenwoordigt. Deze methode retourneert een Principal
-object. Als u bijvoorbeeld de uitgever van het document als hoofd wilt toevoegen, geeft u InfomodelObjectFactory.PUBLISHER_PRINCIPAL
door.PolicyEntry
methode van het voorwerp setPrincipal
aan te halen en het Principal
voorwerp over te gaan.Policy
methode addPolicyEntry
van objecten aan te halen en het PolicyEntry
voorwerp over te gaan.Registreer het beleid.
Maak een PolicyManager
-object door de methode getPolicyManager
van het object DocumentSecurityClient
aan te roepen.
Registreer het beleid door de methode registerPolicy
van het PolicyManager
voorwerp aan te halen en de volgende waarden over te gaan:
Policy
-object dat het te registreren beleid vertegenwoordigt.Een tekenreekswaarde die staat voor de beleidsset waartoe het beleid behoort.
Als u binnen de verbindingsinstellingen een beheerdersaccount voor AEM formulieren gebruikt om het object DocumentSecurityClient
te maken, geeft u de naam van de beleidsset op wanneer u de methode registerPolicy
aanroept. Als u een null
waarde voor de beleidsreeks doorgeeft, 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 niet het nieuwe beleid aan deze beleidsreeks wilt toevoegen, dan specificeer een naam van de beleidsreeks wanneer u de registerPolicy
methode aanhaalt.
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:
Een beleid maken met de API voor documentbeveiliging (webservice):
Inclusief projectbestanden.
Creeer een project van Microsoft .NET dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
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 de constructor System.ServiceModel.EndpointAddress
. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/RightsManagementService?WSDL
). U hoeft het lc_version
-kenmerk niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)
Maak een System.ServiceModel.BasicHttpBinding
-object door de waarde van het veld RightsManagementServiceClient.Endpoint.Binding
op te halen. Cast de terugkeerwaarde aan BasicHttpBinding
.
Stel het veld System.ServiceModel.BasicHttpBinding
van het object MessageEncoding
in op WSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
toe.RightsManagementServiceClient.ClientCredentials.UserName.Password
toe.HttpClientCredentialType.Basic
aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType
toe.Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly
aan het veld BasicHttpBindingSecurity.Security.Mode
toe.
Stel de kenmerken van het beleid in.
PolicySpec
-object met de constructor ervan.name
-gegevenslid van het object.PolicySpec
description
-gegevenslid van het object.PolicySpec
PolicySpec
-gegevenslid van het object. policySetName
U moet een bestaande naam voor een beleidsset opgeven. (U kunt null
voor deze parameterwaarde specificeren die in het beleid dat aan Mijn Beleid wordt toegevoegd.)offlineLeasePeriod
-gegevenslid van het object PolicySpec
.PolicySpec
-gegevenslid van het object policyXml
in met een tekenreekswaarde die PDRL XML-gegevens vertegenwoordigt. Om deze taak uit te voeren, creeer een .NET StreamReader
voorwerp door zijn aannemer te gebruiken. Geef de locatie van een PDRL XML-bestand dat het beleid vertegenwoordigt, door aan de constructor StreamReader
. Roep vervolgens de methode StreamReader
van het object ReadLine
aan en wijs de geretourneerde waarde toe aan een tekenreeksvariabele. Doorlopen van het object StreamReader
totdat de methode ReadLine
null retourneert. Wijs de tekenreeksvariabele toe aan het PolicySpec
-gegevenslid van het policyXml
-object.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 PDRL-document.
Registreer het beleid.
Registreer het beleid door de methode registerPolicy
van het DocumentSecurityServiceClient
voorwerp aan te halen en de volgende waarden over te gaan:
PolicySpec
-object dat het te registreren beleid vertegenwoordigt.null
waarde specificeren die in het beleid resulteert dat aan wordt toegevoegd MyPolicy beleidsreeks.Als u binnen de verbindingsinstellingen een beheerdersaccount voor AEM formulieren gebruikt om het object DocumentSecurityClient
te maken, geeft u de naam van de beleidsset op wanneer u de methode registerPolicy
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 niet het nieuwe beleid aan deze beleidsreeks wilt toevoegen, dan specificeer een naam van de beleidsreeks wanneer u de registerPolicy
methode aanhaalt.
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.
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
U kunt een bestaand beleid wijzigen met de Java API voor documentbeveiliging of de webservice-API. Om veranderingen in een bestaand beleid aan te brengen, 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 nieuw 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. U kunt dan naar het bestaande beleid verwijzen door de PolicySpec.getPolicyXml
methode te gebruiken en de beleidsattributen te wijzigen door de toepasselijke methodes te gebruiken. U kunt bijvoorbeeld de offline leaseperiode wijzigen door de methode PolicySpec.setOfflineLeasePeriod
aan te roepen.
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Referentie van de Diensten voor AEM Forms.
Voer de volgende stappen uit om een bestaand beleid te wijzigen:
Projectbestanden opnemen
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.
Een API-object voor documentbeveiliging maken
Voordat u via programmacode een bewerking voor documentbeveiliging kunt uitvoeren, moet u een client-object voor documentbeveiliging maken. Als u de Java API gebruikt, maakt u een RightsManagementClient
-object. Als u de API voor documentbeveiliging gebruikt, maakt u een RightsManagementServiceService
-object.
Een bestaand beleid ophalen
U moet een bestaand beleid terugwinnen om het te wijzigen. Om een beleid terug te winnen, specificeer de beleidsnaam en het beleid plaatste waartot het beleid behoort. Als u een null
waarde voor de naam van de beleidsreeks specificeert, wordt het beleid teruggewonnen van Mijn Beleid beleidsreeks.
De kenmerken van het beleid instellen
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 PolicySpec
genegeerd. Als u de offline leaseperiode wilt bijwerken, wijzigt u het element OfflineLeasePeriod
in het XML-document PDRL. Verwijs dan naar het bijgewerkte document PDRL van XML door PolicySpec
het gegevenslid van de interface policyXML
te gebruiken.
Voor informatie over andere attributen die u kunt plaatsen, zie de Policy
interfacebeschrijving in AEM Forms API Verwijzing.
Het beleid bijwerken
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.
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.
ServiceClientFactory
-object dat verbindingseigenschappen bevat.RightsManagementClient
-object door de constructor ervan te gebruiken en het object ServiceClientFactory
door te geven.Een bestaand beleid ophalen.
Maak een PolicyManager
-object door de methode getPolicyManager
van het object RightsManagementClient
aan te roepen.
Maak een Policy
-object dat het beleid vertegenwoordigt dat moet worden bijgewerkt door de methode getPolicy
van het object PolicyManager
aan te roepen en de volgende waarden door te geven"
null
specificeren die in MyPolicies
gebruikte beleidsreeks resulteert.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 object Policy
aan.
Werk het beleid bij.
Werk het beleid bij door PolicyManager
methode updatePolicy
van voorwerp aan te halen. Geef het object Policy
door dat het beleid vertegenwoordigt dat moet worden bijgewerkt.
Codevoorbeelden
Zie de modus Snel starten (SOAP-modus) voor codevoorbeelden met de Document Security-service: Een beleid wijzigen met de Java API-sectie.
Wijzig een bestaand beleid met de API voor documentbeveiliging (webservice):
Inclusief projectbestanden.
Creeer een project van Microsoft .NET dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
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 de constructor System.ServiceModel.EndpointAddress
. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/RightsManagementService?WSDL
). U hoeft het lc_version
-kenmerk niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)
Maak een System.ServiceModel.BasicHttpBinding
-object door de waarde van het veld RightsManagementServiceClient.Endpoint.Binding
op te halen. Cast de terugkeerwaarde aan BasicHttpBinding
.
Stel het veld System.ServiceModel.BasicHttpBinding
van het object MessageEncoding
in op WSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
toe.RightsManagementServiceClient.ClientCredentials.UserName.Password
toe.HttpClientCredentialType.Basic
aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType
toe.Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly
aan het veld BasicHttpBindingSecurity.Security.Mode
toe.
Een bestaand beleid ophalen.
Maak een PolicySpec
-object dat het beleid vertegenwoordigt dat moet worden gewijzigd door de methode getPolicy
van het object RightsManagementServiceClient
aan te roepen en de volgende waarden door te geven:
null
specificeren die in MyPolicies
gebruikte beleidsreeks resulteert.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 RightsManagementServiceClient
methode updatePolicyFromSDK
van het voorwerp aan te halen en het PolicySpec
voorwerp over te gaan dat het bij te werken beleid vertegenwoordigt.
Codevoorbeelden
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
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.
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Referentie van de Diensten voor AEM Forms.
Voer de volgende stappen uit om een bestaand beleid te verwijderen:
Projectbestanden opnemen
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.
Een API-object voor documentbeveiliging maken
Voordat u programmatisch een Document Security-servicebewerking kunt uitvoeren, moet u een Document Security-service-clientobject maken. Als u de Java API gebruikt, maakt u een RightsManagementClient
-object. Als u de API voor documentbeveiliging gebruikt, maakt u een RightsManagementServiceService
-object.
Het beleid verwijderen
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 treedt een uitzondering op. En als u probeert een beleid te verwijderen dat niet bestaat, treedt een uitzondering op.
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.
ServiceClientFactory
-object dat verbindingseigenschappen bevat.RightsManagementClient
-object door de constructor ervan te gebruiken en het object ServiceClientFactory
door te geven.Verwijder het beleid.
Maak een PolicyManager
-object door de methode getPolicyManager
van het object RightsManagementClient
aan te roepen.
Verwijder het beleid door de methode deletePolicy
van het object PolicyManager
aan te roepen en de volgende waarden door te geven:
null
specificeren die in MyPolicies
gebruikte beleidsreeks resulteert.Codevoorbeelden
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
Verwijder een beleid met de API voor documentbeveiliging (webservice):
Inclusief projectbestanden.
Creeer een project van Microsoft .NET dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
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 de constructor System.ServiceModel.EndpointAddress
. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/RightsManagementService?WSDL
). U hoeft het lc_version
-kenmerk niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)
Maak een System.ServiceModel.BasicHttpBinding
-object door de waarde van het veld RightsManagementServiceClient.Endpoint.Binding
op te halen. Cast de terugkeerwaarde aan BasicHttpBinding
.
Stel het veld System.ServiceModel.BasicHttpBinding
van het object MessageEncoding
in op WSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
toe.RightsManagementServiceClient.ClientCredentials.UserName.Password
toe.HttpClientCredentialType.Basic
aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType
toe.Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly
aan het veld BasicHttpBindingSecurity.Security.Mode
toe.
Verwijder het beleid.
Verwijder een beleid door de methode deletePolicy
van het object RightsManagementServiceClient
aan te roepen en de volgende waarden door te geven:
null
specificeren die in MyPolicies
gebruikte beleidsreeks resulteert.Codevoorbeelden
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
U kunt een beleid toepassen op een PDF-document om het document te beveiligen. Als u een beleid toepast op een PDF-document, beperkt u de 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.
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Referentie van de Diensten voor AEM Forms.
Voer de volgende stappen uit om een beleid toe te passen op een PDF-document:
Projectbestanden opnemen
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.
Een API-object voor documentbeveiliging maken
Voordat u via programmacode een bewerking met de documentbeveiligingsservice kunt uitvoeren, maakt u een clientobject van de documentbeveiligingsservice. Als u de Java API gebruikt, maakt u een DocumentSecurityClient
-object. Als u de API voor documentbeveiliging gebruikt, maakt u een DocumentSecurityServiceService
-object.
Een PDF-document ophalen
U kunt een PDF-document ophalen om een beleid toe te passen. Nadat u een beleid op het PDF-document hebt toegepast, worden gebruikers beperkt wanneer ze het document gebruiken. Als het beleid bijvoorbeeld niet toestaat dat het document offline wordt geopend, moeten gebruikers online zijn om het document te openen.
Een bestaand beleid toepassen op het PDF-document
Als u een beleid wilt toepassen op een PDF-document, verwijst u naar een bestaand beleid en geeft u op 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.
Het PDF-document opslaan
Nadat de documentbeveiligingsservice een beleid heeft toegepast op een PDF-document, kunt u het met een beleid beveiligde PDF-document opslaan als een PDF-bestand.
Zie ook
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Toegang tot documenten intrekken
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.
ServiceClientFactory
-object dat verbindingseigenschappen bevat.RightsManagementClient
-object door de constructor ervan te gebruiken en het object ServiceClientFactory
door te geven.Een PDF-document ophalen.
java.io.FileInputStream
-object dat het PDF-document vertegenwoordigt met behulp van de bijbehorende constructor. Geef een tekenreekswaarde door die de locatie van het PDF-document aangeeft.com.adobe.idp.Document
-object door de constructor ervan te gebruiken en het object java.io.FileInputStream
door te geven.Pas een bestaand beleid toe op het PDF-document.
Maak een DocumentManager
-object door de methode getDocumentManager
van het object RightsManagementClient
aan te roepen.
Pas een beleid toe op het PDF-document door de methode DocumentManager
van het object protectDocument
aan te roepen en de volgende waarden door te geven:
com.adobe.idp.Document
-object dat het PDF-document bevat waarop het beleid wordt toegepast.null
waarde specificeren die in MyPolicies
gebruikte beleidsreeks resulteert.null
zijn (als deze parameter null is, moet de vorige parameterwaarde null
zijn).com.adobe.livecycle.rightsmanagement.Locale
die de scène vertegenwoordigt die voor het selecteren van het malplaatje van MS Office wordt gebruikt. Deze parameterwaarde is optioneel en wordt niet gebruikt voor PDF-documenten. Als u een PDF-document wilt beveiligen, geeft u null
op.De methode protectDocument
retourneert een RMSecureDocumentResult
-object dat het met een beleid beveiligde PDF-document bevat.
Sla het PDF-document op.
RMSecureDocumentResult
van het object getProtectedDoc
aan om het met een beleid beveiligde PDF-document op te halen. Deze methode retourneert een com.adobe.idp.Document
-object.java.io.File
-object en controleer of de bestandsextensie PDF is.com.adobe.idp.Document
van het object copyToFile
aan om de inhoud van het object Document
naar het bestand te kopiëren (zorg dat u het object Document
gebruikt dat door de methode getProtectedDoc
is geretourneerd).Codevoorbeelden
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
Zie ook
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Een beleid toepassen op een PDF-document met behulp van de API voor documentbeveiliging (webservice):
Inclusief projectbestanden.
Creeer een project van Microsoft .NET dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
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 de constructor System.ServiceModel.EndpointAddress
. Geef een tekenreekswaarde die de WSDL opgeeft door aan de Forms-service (bijvoorbeeld http://localhost:8080/soap/services/RightsManagementService?WSDL
). U hoeft het lc_version
-kenmerk niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)
Maak een System.ServiceModel.BasicHttpBinding
-object door de waarde van het veld RightsManagementServiceClient.Endpoint.Binding
op te halen. Cast de terugkeerwaarde aan BasicHttpBinding
.
Stel het veld System.ServiceModel.BasicHttpBinding
van het object MessageEncoding
in op WSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
toe.RightsManagementServiceClient.ClientCredentials.UserName.Password
toe.HttpClientCredentialType.Basic
aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType
toe.Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly
aan het veld BasicHttpBindingSecurity.Security.Mode
toe.
Een PDF-document ophalen.
BLOB
-object met de constructor ervan. Met het object BLOB
wordt een PDF-document opgeslagen waarop een beleid wordt toegepast.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.System.IO.FileStream
wordt opgeslagen. Bepaal de grootte van de bytearray door de System.IO.FileStream
-eigenschap van het object Length
op te halen.Read
van het object System.IO.FileStream
aan te roepen. Geef de bytearray, de startpositie en de streamlengte door om te lezen.BLOB
-object door het MTOM
-veld toe te wijzen met de inhoud van de bytearray.Pas een bestaand beleid toe op het PDF-document.
Pas een beleid toe op het PDF-document door de methode RightsManagementServiceClient
van het object protectDocument
aan te roepen en de volgende waarden door te geven:
BLOB
-object dat het PDF-document bevat waarop het beleid wordt toegepast.null
waarde specificeren die in MyPolicies
gebruikte beleidsreeks resulteert.null
zijn).null
zijn).RMLocale
die de waarde van de landinstelling opgeeft (bijvoorbeeld RMLocale.en
).application/pdf
) op te slaan.De methode protectDocument
retourneert een BLOB
-object dat het met een beleid beveiligde PDF-document bevat.
Sla het PDF-document op.
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.BLOB
dat door de methode protectDocument
is geretourneerd. Vul de bytearray met de waarde van het BLOB
-gegevenslid van het object MTOM
.System.IO.BinaryWriter
-object door de constructor ervan aan te roepen en het object System.IO.FileStream
door te geven.Write
van het object System.IO.BinaryWriter
aan te roepen en de bytearray door te geven.Codevoorbeelden
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
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 dat als u het document niet langer wilt beschermen 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.
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Referentie van de Diensten voor AEM Forms.
Voer de volgende stappen uit om een beleid te verwijderen uit een PDF-document dat met een beleid is beveiligd:
Projectbestanden opnemen
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.
Een API-object voor documentbeveiliging maken
Voordat u via programmacode een bewerking met de documentbeveiligingsservice kunt uitvoeren, maakt u een clientobject van de documentbeveiligingsservice.
Een met beleid beveiligd PDF-document ophalen
U kunt een met een beleid beveiligd PDF-document ophalen om een beleid te verwijderen. Als u probeert een beleid te verwijderen uit een PDF-document dat niet wordt beveiligd door een beleid, veroorzaakt u een uitzondering.
Het beleid verwijderen uit het PDF-document
U kunt een beleid uit een beleid-beschermd PDF document verwijderen op voorwaarde dat een beheerder in de verbindingsmontages wordt gespecificeerd. Als dat niet het geval is, moet het beleid waarmee een document wordt beveiligd de SWITCH_POLICY
-machtiging bevatten om een beleid uit een PDF-document te kunnen verwijderen. De gebruiker die is opgegeven in de AEM Forms-verbindingsinstellingen moet ook over deze machtiging beschikken. Anders wordt een uitzondering gegenereerd.
Het onbeveiligde PDF-document opslaan
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
Verbindingseigenschappen instellen
Beleid toepassen op PDF-documenten
Een beleid verwijderen uit een PDF-document dat met een beleid is beveiligd, 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.
ServiceClientFactory
-object dat verbindingseigenschappen bevat.DocumentSecurityClient
-object door de constructor ervan te gebruiken en het object ServiceClientFactory
door te geven.Hiermee haalt u een PDF-document op dat met een beleid is beveiligd.
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.com.adobe.idp.Document
-object door de constructor ervan te gebruiken en het object java.io.FileInputStream
door te geven.Verwijder het beleid uit het PDF-document.
DocumentManager
-object door de methode getDocumentManager
van het object DocumentSecurityClient
aan te roepen.DocumentManager
van het object removeSecurity
aan te roepen en het object com.adobe.idp.Document
door te geven dat het met een beleid beveiligde PDF-document bevat. Deze methode retourneert een com.adobe.idp.Document
-object dat een onbeveiligd PDF-document bevat.Sla het onbeveiligde PDF-document op.
java.io.File
-object en controleer of de bestandsextensie PDF is.Document
van het object copyToFile
aan om de inhoud van het object Document
naar het bestand te kopiëren (zorg dat u het object Document
gebruikt dat door de methode removeSecurity
is geretourneerd).Codevoorbeelden
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
Een beleid verwijderen uit een PDF-document dat met een beleid is beveiligd met de API voor documentbeveiliging (webservice):
Inclusief projectbestanden.
Creeer een project van Microsoft .NET dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
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 de constructor System.ServiceModel.EndpointAddress
. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/RightsManagementService?WSDL
). U hoeft het lc_version
-kenmerk niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)
Maak een System.ServiceModel.BasicHttpBinding
-object door de waarde van het veld DocumentSecurityServiceClient.Endpoint.Binding
op te halen. Cast de terugkeerwaarde aan BasicHttpBinding
.
Stel het veld System.ServiceModel.BasicHttpBinding
van het object MessageEncoding
in op WSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
toe.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
toe.HttpClientCredentialType.Basic
aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType
toe.Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly
aan het veld BasicHttpBindingSecurity.Security.Mode
toe.
Hiermee haalt u een PDF-document op dat met een beleid is beveiligd.
BLOB
-object met de constructor ervan. Met het object BLOB
wordt het met een beleid beveiligde PDF-document opgeslagen waaruit het beleid wordt verwijderd.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.System.IO.FileStream
wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschap System.IO.FileStream
van het object Length
op te halen.Read
van het object System.IO.FileStream
aan te roepen en de bytearray, de startpositie en de lengte van de stream door te geven om te lezen.BLOB
-object door het MTOM
-veld toe te wijzen met de inhoud van de bytearray.Verwijder het beleid uit het PDF-document.
Verwijder het beleid uit het PDF-document door de methode DocumentSecurityServiceClient
van het object removePolicySecurity
aan te roepen en het object BLOB
door te geven dat het met een beleid beveiligde PDF-document bevat. Deze methode retourneert een BLOB
-object dat een onbeveiligd PDF-document bevat.
Sla het onbeveiligde PDF-document op.
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.BLOB
dat door de methode removePolicySecurity
is geretourneerd. Vul de bytearray met de waarde van het veld BLOB
van het object MTOM
.System.IO.BinaryWriter
-object door de constructor ervan aan te roepen en het object System.IO.FileStream
door te geven.Codevoorbeelden
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
Zie ook
AEM Forms aanroepen met SwaRef
U kunt de toegang tot een PDF-document dat met een beleid is beveiligd, intrekken. Hierdoor zijn alle kopieën van het document niet toegankelijk 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.
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Referentie van de Diensten voor AEM Forms.
Voer de volgende stappen uit om een document dat met een beleid is beveiligd, in te trekken:
Projectbestanden opnemen
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.
Een API-object voor documentbeveiliging maken
Voordat u programmatisch een Document Security-servicebewerking kunt uitvoeren, moet u een Document Security-service-clientobject maken.
Een met beleid beveiligd PDF-document ophalen
U moet een met een beleid beveiligd PDF-document ophalen om het te kunnen intrekken. U kunt een document dat al is ingetrokken of dat niet door een beleid beveiligd is, niet intrekken.
Als u de waarde van de licentie-id van het document weet dat met een beleid is beveiligd, hoeft u het PDF-document dat met een beleid is beveiligd, niet op te halen. In de meeste gevallen zult u het PDF-document echter moeten ophalen om de waarde van de licentie-id te verkrijgen.
Intrekken van het document dat met een beleid is beveiligd
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.
Als u een document probeert in te trekken dat al is ingetrokken, wordt een uitzondering gegenereerd.
Zie ook
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Beleid toepassen op PDF-documenten
Toegang tot ingetrokken documenten opnieuw instellen
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
ServiceClientFactory
-object dat verbindingseigenschappen bevat.DocumentSecurityClient
-object door de constructor ervan te gebruiken en het object ServiceClientFactory
door te geven.Een met beleid beveiligd PDF-document ophalen
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.com.adobe.idp.Document
-object door de constructor ervan te gebruiken en het object java.io.FileInputStream
door te geven.Intrekken van het document dat met een beleid is beveiligd
Maak een DocumentManager
-object door de methode getDocumentManager
van het object DocumentSecurityClient
aan te roepen.
Haal de waarde van de licentie-id van het document dat door het beleid wordt beveiligd, op door de methode DocumentManager
van het object getLicenseId
aan te roepen. Geef het com.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 methode getLicenseManager
van het object DocumentSecurityClient
aan te roepen.
Intrekken van het document dat met een beleid is beveiligd door de methode LicenseManager
van het object revokeLicense
aan te roepen en de volgende waarden door te geven:
DocumentManager
van het object).getLicenseId
License
die de reden specificeert om het document in te trekken. U kunt bijvoorbeeld License.DOCUMENT_REVISED
opgeven.java.net.URL
-waarde die de locatie opgeeft waar een gereviseerd document zich bevindt. Als u een gebruiker niet aan een andere URL wilt opnieuw richten, dan kunt u null
overgaan.Codevoorbeelden
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
De toegang tot een met beleid beveiligd PDF-document intrekken met de API voor documentbeveiliging (webservice):
Projectbestanden opnemen
Creeer een project van Microsoft .NET dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
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 de constructor System.ServiceModel.EndpointAddress
. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/RightsManagementService?WSDL
). U hoeft het lc_version
-kenmerk niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)
Maak een System.ServiceModel.BasicHttpBinding
-object door de waarde van het veld DocumentSecurityServiceClient.Endpoint.Binding
op te halen. Cast de terugkeerwaarde aan BasicHttpBinding
.
Stel het veld System.ServiceModel.BasicHttpBinding
van het object MessageEncoding
in op WSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
toe.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
toe.HttpClientCredentialType.Basic
aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType
toe.Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly
aan het veld BasicHttpBindingSecurity.Security.Mode
toe.
Een met beleid beveiligd PDF-document ophalen
BLOB
-object met de constructor ervan. Met het object BLOB
wordt een met een beleid beveiligd PDF-document opgeslagen dat wordt ingetrokken.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.System.IO.FileStream
wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschap System.IO.FileStream
van het object Length
op te halen.Read
van het object System.IO.FileStream
aan te roepen en de bytearray, de startpositie en de lengte van de stream door te geven om te lezen.BLOB
-object door het MTOM
-veld toe te wijzen met de inhoud van de bytearray.Intrekken van het document dat met een beleid is beveiligd
Haal de waarde van de licentie-id van het document dat door het beleid wordt beveiligd, op door de methode DocumentSecurityServiceClient
van het object getLicenseID
aan te roepen en het object BLOB
door te geven dat het document vertegenwoordigt dat door het beleid wordt beveiligd. Deze methode retourneert een tekenreekswaarde die de licentie-id vertegenwoordigt.
Intrekken van het document dat met een beleid is beveiligd door de methode DocumentSecurityServiceClient
van het object revokeLicense
aan te roepen en de volgende waarden door te geven:
DocumentSecurityServiceService
van het object).getLicenseId
Reason
-opsomming dat de reden opgeeft om het document in te trekken. U kunt bijvoorbeeld Reason.DOCUMENT_REVISED
opgeven.string
-waarde die de URL-locatie opgeeft waarnaar een gereviseerd document zich bevindt. Als u een gebruiker niet aan een andere URL wilt opnieuw richten, dan kunt u null
overgaan.Codevoorbeelden
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
Zie ook
Beleid verwijderen uit Word-documenten
AEM Forms aanroepen met SwaRef
U kunt de toegang tot een ingetrokken PDF-document opnieuw instellen, zodat alle kopieën van het ingetrokken document toegankelijk zijn voor gebruikers. Wanneer een gebruiker een hersteld document opent dat werd ingetrokken, kan de gebruiker het document bekijken.
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Referentie van de Diensten voor AEM Forms.
Voer de volgende stappen uit om de toegang tot een ingetrokken PDF-document te herstellen:
Projectbestanden opnemen
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.
Een API-object voor documentbeveiliging maken
Voordat u programmatisch een Document Security-servicebewerking kunt uitvoeren, moet u een Document Security-service-clientobject maken. Als u de Java API gebruikt, maakt u een DocumentSecurityClient
-object. Als u de API voor documentbeveiliging gebruikt, maakt u een DocumentSecurityServiceService
-object.
De licentie-id van het ingetrokken PDF-document ophalen
U moet de licentie-id van het ingetrokken PDF-document ophalen om een ingetrokken PDF-document opnieuw in te stellen. 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.
Toegang tot het ingetrokken PDF-document opnieuw instellen
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
Beleid toepassen op PDF-documenten
Toegang tot documenten intrekken
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.
ServiceClientFactory
-object dat verbindingseigenschappen bevat.DocumentSecurityClient
-object door de constructor ervan te gebruiken en het object ServiceClientFactory
door te geven.Haal de licentie-id van het ingetrokken PDF-document op.
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.com.adobe.idp.Document
-object door de constructor ervan te gebruiken en het object java.io.FileInputStream
door te geven.DocumentManager
-object door de methode getDocumentManager
van het object DocumentSecurityClient
aan te roepen.DocumentManager
van het object getLicenseId
aan te roepen en het object com.adobe.idp.Document
door te geven dat het ingetrokken document vertegenwoordigt. Deze methode retourneert een tekenreekswaarde die de licentie-id vertegenwoordigt.Toegang tot het ingetrokken PDF-document opnieuw instellen.
LicenseManager
-object door de methode getLicenseManager
van het object DocumentSecurityClient
aan te roepen.unrevokeLicense
van het object LicenseManager
aan te roepen en de waarde van de licentie-id van het ingetrokken document door te geven.Codevoorbeelden
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
Toegang tot een ingetrokken document opnieuw instellen met de API voor documentbeveiliging (webservice):
Inclusief projectbestanden.
Creeer een project van Microsoft .NET dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
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 de constructor System.ServiceModel.EndpointAddress
. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/RightsManagementService?WSDL
). U hoeft het lc_version
-kenmerk niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)
Maak een System.ServiceModel.BasicHttpBinding
-object door de waarde van het veld DocumentSecurityServiceClient.Endpoint.Binding
op te halen. Cast de terugkeerwaarde aan BasicHttpBinding
.
Stel het veld System.ServiceModel.BasicHttpBinding
van het object MessageEncoding
in op WSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
toe.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
toe.HttpClientCredentialType.Basic
aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType
toe.Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly
aan het veld BasicHttpBindingSecurity.Security.Mode
toe.
Haal de licentie-id van het ingetrokken PDF-document op.
BLOB
-object met de constructor ervan. Met het object BLOB
wordt een ingetrokken PDF-document opgeslagen waartoe toegang wordt hersteld.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.System.IO.FileStream
wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschap System.IO.FileStream
van het object Length
op te halen.Read
van het object System.IO.FileStream
aan te roepen en de bytearray, de startpositie en de lengte van de stream door te geven om te lezen.BLOB
-object door het MTOM
-veld toe te wijzen met de inhoud van de bytearray.Toegang tot het ingetrokken PDF-document opnieuw instellen.
DocumentSecurityServiceClient
van het object getLicenseID
aan te roepen en het object BLOB
door te geven dat het ingetrokken document vertegenwoordigt. Deze methode retourneert een tekenreekswaarde die de licentie-id vertegenwoordigt.unrevokeLicense
van het object DocumentSecurityServiceClient
aan te roepen en een tekenreekswaarde door te geven die de waarde van de licentie-id van het ingetrokken PDF-document opgeeft (geef de geretourneerde waarde van de methode getLicenseId
van het object DocumentSecurityServiceClient
door).Codevoorbeelden
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
Zie ook
AEM Forms aanroepen met SwaRef
U kunt de API (Java en webservice) voor documentbeveiliging gebruiken om PDF-documenten die met een beleid zijn beveiligd, te inspecteren. Als u PDF-documenten inspecteert die met een beleid zijn beveiligd, wordt informatie over het met een beleid beveiligde PDF-document 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 een document te inspecteren dat met een beleid is beveiligd met behulp van LiveCycle 8.x (of eerder), wordt een uitzondering gegenereerd.
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Referentie van de Diensten voor AEM Forms.
Voer de volgende stappen uit om een PDF-document te inspecteren dat met een beleid is beveiligd:
Projectbestanden opnemen
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.
Een API-object voor documentbeveiliging maken
Voordat u via programmacode een bewerking met de documentbeveiligingsservice kunt uitvoeren, maakt u een clientobject van de documentbeveiligingsservice. Als u de Java API gebruikt, maakt u een RightsManagementClient
-object. Als u de API voor documentbeveiliging gebruikt, maakt u een RightsManagementServiceService
-object.
Een document ophalen dat met een beleid is beveiligd om te worden geïnspecteerd
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.
Het document Inspect
Nadat u een document hebt opgehaald dat met een beleid is beveiligd, kunt u het controleren.
Informatie opvragen over het document dat met een beleid is beveiligd
Nadat u een PDF-document hebt gecontroleerd dat met een beleid is beveiligd, kunt u er informatie over verkrijgen. U kunt bijvoorbeeld bepalen welk beleid wordt gebruikt om het document te beveiligen.
Als u een document met een beleid beveiligt dat tot Mijn Beleid behoort en dan RMInspectResult.getPolicysetName
of RMInspectResult.getPolicysetId
roept, is ongeldig teruggekeerd.
Als het document wordt beveiligd met behulp van een beleid dat in een beleidsreeks (buiten Mijn Beleid) bevat dan RMInspectResult.getPolicysetName
en RMInspectResult.getPolicysetId
terugkeer geldige koorden.
Zie ook
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Inspect a policy-protected PDF document by the Document Security Service API (Java):
Inclusief projectbestanden.
Neem client-JAR-bestanden, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project. Zie Including AEM Forms Java-bibliotheekbestanden voor informatie over de locatie van deze bestanden.
Maak een API-object voor Document Security Client.
ServiceClientFactory
-object dat verbindingseigenschappen bevat. (Zie Verbindingseigenschappen instellen.)RightsManagementClient
-object door de constructor ervan te gebruiken en het object ServiceClientFactory
door te geven.Haal een document op dat met een beleid is beveiligd om te inspecteren.
java.io.FileInputStream
-object dat het met een beleid beveiligde PDF-document vertegenwoordigt met de constructor ervan. Geef een tekenreekswaarde door die de locatie van het PDF-document aangeeft.com.adobe.idp.Document
-object door de constructor ervan te gebruiken en het object java.io.FileInputStream
door te geven.Inspect het document.
DocumentManager
-object door de methode getDocumentManager
van het object RightsManagementClient
aan te roepen.inspectDocument
van het object LicenseManager
aan te roepen. Geef het com.adobe.idp.Document
-object door dat het met een beleid beveiligde PDF-document bevat. Deze methode retourneert een RMInspectResult
-object dat informatie bevat over het document dat met een beleid is beveiligd.Verkrijg informatie over het beleid-beschermde document.
Om informatie over het beleid-beschermde document te verkrijgen, haal de aangewezen methode aan die RMInspectResult
voorwerp behoort. Als u bijvoorbeeld de naam van het beleid wilt ophalen, roept u de methode getPolicyName
van het object RMInspectResult
aan.
Codevoorbeelden
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
Inspect a policy protected PDF document by the Document Security Service API (webservice):
Inclusief projectbestanden.
Creeer een project van Microsoft .NET dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
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 de constructor System.ServiceModel.EndpointAddress
. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/RightsManagementService?WSDL
). U hoeft het lc_version
-kenmerk niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)
Maak een System.ServiceModel.BasicHttpBinding
-object door de waarde van het veld RightsManagementServiceClient.Endpoint.Binding
op te halen. Cast de terugkeerwaarde aan BasicHttpBinding
.
Stel het veld System.ServiceModel.BasicHttpBinding
van het object MessageEncoding
in op WSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
toe.RightsManagementServiceClient.ClientCredentials.UserName.Password
toe.HttpClientCredentialType.Basic
aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType
toe.Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly
aan het veld BasicHttpBindingSecurity.Security.Mode
toe.
Haal een document op dat met een beleid is beveiligd om te inspecteren.
BLOB
-object met de constructor ervan. Met het object BLOB
wordt een PDF-document opgeslagen dat moet worden geïnspecteerd.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.System.IO.FileStream
wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschap System.IO.FileStream
van het object Length
op te halen.Read
van het object System.IO.FileStream
aan te roepen. Geef de bytearray, de startpositie en de streamlengte door om te lezen.BLOB
-object door het MTOM
-veld toe te wijzen met de inhoud van de bytearray.Inspect het document.
Inspect het document met beveiligingsbeleid door de methode inspectDocument
van het object RightsManagementServiceClient
aan te roepen. Geef het BLOB
-object door dat het met een beleid beveiligde PDF-document bevat. Deze methode retourneert een RMInspectResult
-object dat informatie bevat over het document dat met een beleid is beveiligd.
Verkrijg informatie over het beleid-beschermde document.
Om informatie over het beleid-beschermde document te verkrijgen, krijg de waarde van het aangewezen gebied dat tot het RMInspectResult
voorwerp behoort. Als u bijvoorbeeld de naam van het beleid wilt ophalen, krijgt u de waarde van het veld RMInspectResult
van het object.policyName
Codevoorbeelden
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
Zie ook
AEM Forms aanroepen met SwaRef
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.
Alleen gebruikers met beheerdersrechten voor documentbeveiliging kunnen watermerken maken. Dit betekent dat u een dergelijke gebruiker moet opgeven wanneer u verbindingsinstellingen definieert die vereist zijn om een Document Security Service Client-object te maken.
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Referentie van de Diensten voor AEM Forms.
Voer de volgende stappen uit om een watermerk te maken:
Projectbestanden opnemen
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.
Een API-object voor documentbeveiliging maken
Voordat u programmatisch een Document Security-servicebewerking kunt uitvoeren, moet u een Document Security-service-clientobject maken. Als u de Java API gebruikt, maakt u een RightsManagementClient
-object. Als u de API voor documentbeveiliging gebruikt, maakt u een RightsManagementServiceService
-object.
De kenmerken van watermerken instellen
Als u een nieuw 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:
De volgende tabel bevat een lijst met sleutel- en waardeparen die zijn vereist voor het maken van een watermerk met behulp van webservices.
Sleutelnaam |
Beschrijving |
Waarde |
---|---|---|
|
Hiermee wordt opgegeven of de gebruikersnaam van de gebruiker die het document opent, deel uitmaakt van het watermerk. |
Waar of Onwaar |
|
Hiermee wordt opgegeven of de identificatie van de gebruiker die het document opent, deel uitmaakt van het watermerk. |
Waar of Onwaar |
|
Hiermee wordt opgegeven of de huidige datum deel uitmaakt van het watermerk. |
Waar of Onwaar |
|
Als deze waarde true is, moet de waarde van de aangepaste tekst worden opgegeven met |
Waar of Onwaar |
|
Hiermee bepaalt u de dekking van het watermerk. De standaardwaarde is 0,5 als deze niet is opgegeven. |
Een waarde tussen 0,0 en 1,0. |
|
Hiermee wordt de rotatie van het watermerk opgegeven. De standaardwaarde is 0 graden. |
Een waarde tussen 0 en 359. |
|
Als deze waarde wordt opgegeven, moet |
Een waarde die groter is dan 0.0 en kleiner dan of gelijk aan 1.0. |
|
Geeft de horizontale uitlijning van het watermerk aan. De standaardwaarde is gecentreerd. |
links, midden of rechts |
|
Geeft de verticale uitlijning van het watermerk aan. De standaardwaarde is gecentreerd. |
boven, midden of onder |
|
Hiermee wordt opgegeven of het watermerk een achtergrond is. De standaardwaarde is false. |
Waar of Onwaar |
|
True if a custom scale is specified. Als deze waarde true is, moet SCALE ook worden opgegeven. Als deze waarde false is, wordt de standaardwaarde op pagina toegepast. |
Waar of Onwaar |
|
Hiermee wordt de aangepaste tekst voor een watermerk opgegeven. Als deze waarde aanwezig is, moet |
Waar of Onwaar |
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.
Het watermerk registreren
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
Verbindingseigenschappen instellen
Beleid toepassen op PDF-documenten
Een watermerk maken met de API voor documentbeveiliging (Java):
Inclusief projectbestanden.
Neem JAR-bestanden van de client, zoals de adobe-rightsmanagement-client.jar
, op in het klassepad van uw Java-project.
Maak een API-object voor Document Security Client.
ServiceClientFactory
-object dat verbindingseigenschappen bevat.RightsManagementClient
-object door de constructor ervan te gebruiken en het object ServiceClientFactory
door te geven.De kenmerken van het watermerk instellen
Watermark
-object door de statische methode createWatermark
van het object aan te roepen. InfomodelObjectFactory
Deze methode retourneert een Watermark
-object.setName
van het object Watermark
aan te roepen en een tekenreekswaarde door te geven die de naam van het beleid aangeeft.setBackground
van het object Watermark
aan te roepen en true
door te geven. Door dit kenmerk in te stellen, verschijnt het watermerk op de achtergrond van het document.setCustomText
van het object Watermark
aan te roepen en een tekenreekswaarde door te geven die de tekst van het watermerk vertegenwoordigt.setOpacity
van het object Watermark
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.Registreer het watermerk.
WatermarkManager
-object door de methode getWatermarkManager
van het object RightsManagementClient
aan te roepen. Deze methode retourneert een WatermarkManager
-object.registerWatermark
van het object WatermarkManager
aan te roepen en het object Watermark
door te geven dat het te registreren watermerk vertegenwoordigt. Deze methode retourneert een tekenreekswaarde die de identificatiewaarde van het watermerk vertegenwoordigt.Codevoorbeelden
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
Een watermerk maken met de API voor documentbeveiliging (webservice):
Maak een API-object voor Document Security Client.
Creeer een project van Microsoft .NET dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
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 de constructor System.ServiceModel.EndpointAddress
. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/RightsManagementService?WSDL
). U hoeft het lc_version
-kenmerk niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)
Maak een System.ServiceModel.BasicHttpBinding
-object door de waarde van het veld RightsManagementServiceClient.Endpoint.Binding
op te halen. Cast de terugkeerwaarde aan BasicHttpBinding
.
Stel het veld System.ServiceModel.BasicHttpBinding
van het object MessageEncoding
in op WSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
toe.RightsManagementServiceClient.ClientCredentials.UserName.Password
toe.HttpClientCredentialType.Basic
aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType
toe.Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly
aan het veld BasicHttpBindingSecurity.Security.Mode
toe.
Stel de kenmerken van het watermerk in.
WatermarkSpec
-object door de constructor WatermarkSpec
aan te roepen.WatermarkSpec
-gegevenslid van het object.name
id
van het watermerk in door een tekenreekswaarde toe te wijzen aan het WatermarkSpec
-gegevenslid van het object id
.MyMapOf_xsd_string_To_xsd_anyType_Item
-object.MyMapOf_xsd_string_To_xsd_anyType_Item
-gegevenslid van het object (bijvoorbeeld WaterBackCmd:OPACITY)
).key
MyMapOf_xsd_string_To_xsd_anyType_Item
-gegevenslid van het value
-object (bijvoorbeeld .25
).MyArrayOf_xsd_anyType
-object. Roep voor elk MyMapOf_xsd_string_To_xsd_anyType_Item
-object de methode Add
van het MyArrayOf_xsd_anyType
-object aan. Geef het object MyMapOf_xsd_string_To_xsd_anyType_Item
door.MyArrayOf_xsd_anyType
-object toe aan het WatermarkSpec
-gegevenslid van het object.values
Registreer het watermerk.
Registreer het watermerk door de methode registerWatermark
van het object RightsManagementServiceClient
aan te roepen en het object WatermarkSpec
door te geven dat het te registreren watermerk vertegenwoordigt.
Codevoorbeelden
Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:
Zie ook
AEM Forms aanroepen met SwaRef
U kunt een bestaand watermerk wijzigen met de Java API voor documentbeveiliging of de webservice-API. Als u wijzigingen wilt aanbrengen in een bestaand watermerk, haalt u het watermerk op, wijzigt u de kenmerken ervan en werkt u het watermerk 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. Dit betekent dat bestaande PDF-documenten die het watermerk bevatten, niet worden gewijzigd.
Alleen gebruikers met beheerdersrechten voor documentbeveiliging kunnen watermerken wijzigen. Dit betekent dat u een dergelijke gebruiker moet opgeven wanneer u verbindingsinstellingen definieert die vereist zijn om een Document Security Service Client-object te maken.
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Referentie van de Diensten voor AEM Forms.
Voer de volgende stappen uit om een watermerk te wijzigen:
Projectbestanden opnemen
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.
Een API-object voor documentbeveiliging maken
Voordat u programmatisch een Document Security-servicebewerking kunt uitvoeren, moet u een Document Security-service-clientobject maken. Als u de Java API gebruikt, maakt u een DocumentSecurityClient
-object. Als u de API voor documentbeveiliging gebruikt, maakt u een DocumentSecurityServiceService
-object.
Het te wijzigen watermerk ophalen
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.
De kenmerken van watermerken instellen
Als u een bestaand watermerk wilt wijzigen, wijzigt u de waarde van een of meer kenmerken van het watermerk. 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 attribuut dat u wilt wijzigen WaterBackCmd:OPACITY
is, moet u de andere waarden plaatsen goed zijn.
Wanneer u de Java API gebruikt om een watermerk te wijzigen, hoeft u niet alle kenmerken op te geven. Stel het watermerkkenmerk in dat u wilt wijzigen.
Zie Watermerken maken voor informatie over de namen van watermerkkenmerken.
Het watermerk bijwerken
Nadat u de kenmerken van een watermerk hebt gewijzigd, moet u het watermerk bijwerken.
Zie ook
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Een watermerk wijzigen 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.
ServiceClientFactory
-object dat verbindingseigenschappen bevat.DocumentSecurityClient
-object door de constructor ervan te gebruiken en het object ServiceClientFactory
door te geven.Haal het watermerk op dat u wilt wijzigen.
Maak een WatermarkManager
-object door de methode getWatermarkManager
van het object DocumentSecurityClient
aan te roepen en een tekenreekswaarde door te geven die de naam van het watermerk opgeeft. Deze methode retourneert een Watermark
-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 object Watermark
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.
In dit voorbeeld wordt alleen het kenmerk opacity gewijzigd.
Werk het watermerk bij.
updateWatermark
van het object WatermarkManager
aan te roepen en geef het object Watermark
door waarvan het kenmerk is gewijzigd.Codevoorbeelden
Zie de modus Snel starten (SOAP-modus) voor codevoorbeelden met de Document Security-service: Een watermerk wijzigen met de Java API-sectie.
Wijzig een watermerk met de API voor documentbeveiliging (webservice):
Inclusief projectbestanden.
Creeer een project van Microsoft .NET dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
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 de constructor System.ServiceModel.EndpointAddress
. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/DocumentSecurityService?WSDL
). U hoeft het lc_version
-kenmerk niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)
Maak een System.ServiceModel.BasicHttpBinding
-object door de waarde van het veld DocumentSecurityServiceClient.Endpoint.Binding
op te halen. Cast de terugkeerwaarde aan BasicHttpBinding
.
Stel het veld System.ServiceModel.BasicHttpBinding
van het object MessageEncoding
in op WSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
toe.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
toe.HttpClientCredentialType.Basic
aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType
toe.Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly
aan het veld BasicHttpBindingSecurity.Security.Mode
toe.
Haal het watermerk op dat u wilt wijzigen.
Haal het watermerk op dat u wilt wijzigen door de methode getWatermarkByName
van het object DocumentSecurityServiceClient
aan te roepen. Geef een tekenreekswaarde door die de naam van het watermerk aangeeft. Deze methode retourneert een WatermarkSpec
-object dat het watermerk vertegenwoordigt dat moet worden gewijzigd.
Stel de kenmerken van het watermerk in.
MyMapOf_xsd_string_To_xsd_anyType_Item
-object.MyMapOf_xsd_string_To_xsd_anyType_Item
-gegevenslid van het object (bijvoorbeeld WaterBackCmd:OPACITY)
).key
MyMapOf_xsd_string_To_xsd_anyType_Item
-gegevenslid van het value
-object (bijvoorbeeld .50
).MyArrayOf_xsd_anyType
-object. Roep voor elk MyMapOf_xsd_string_To_xsd_anyType_Item
-object de methode Add
van het MyArrayOf_xsd_anyType
-object aan. Geef het object MyMapOf_xsd_string_To_xsd_anyType_Item
door.MyArrayOf_xsd_anyType
-object toe aan het WatermarkSpec
-gegevenslid van het object.values
Werk het watermerk bij.
Werk het watermerk bij door de methode updateWatermark
van het object DocumentSecurityServiceClient
aan te roepen en het object WatermarkSpec
door te geven dat het watermerk vertegenwoordigt dat moet worden gewijzigd.
Codevoorbeelden
Zie het volgende snelle begin voor codevoorbeelden met gebruik van de Document Security-service:
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:
U kunt zoeken naar specifieke gebeurtenissen met 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.
Voor meer informatie over de dienst van het Rights Management, zie de Verwijzing van de Diensten voor AEM Forms.
Voer de volgende stappen uit om te zoeken naar een Rights Management-gebeurtenis:
Projectbestanden opnemen
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.
Een Rights Management Client API-object maken
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. Als u de Java API gebruikt, maakt u een DocumentSecurityClient
-object. Als u de API van de Webdienst van het Rights Management gebruikt, creeer een DocumentSecurityServiceService
voorwerp.
Geef de gebeurtenissen op waarnaar u wilt zoeken
U moet de gebeurtenis opgeven waarnaar u wilt zoeken. U kunt bijvoorbeeld zoeken naar het beleid om een gebeurtenis te maken, die optreedt wanneer een nieuw beleid wordt gemaakt.
Zoeken 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
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
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 een ServiceClientFactory
-object door te geven dat verbindingseigenschappen bevat.
Geef de gebeurtenissen op waarnaar u wilt zoeken
EventManager
-object door de methode getEventManager
van het object DocumentSecurityClient
aan te roepen. Deze methode retourneert een EventManager
-object.EventSearchFilter
-object door de constructor ervan aan te roepen.setEventCode
van het object EventSearchFilter
aan te roepen en een lid van een statisch gegeven door te geven dat tot de klasse EventManager
behoort die de gebeurtenis vertegenwoordigt waarnaar moet worden gezocht. Als u bijvoorbeeld wilt zoeken naar het beleid, maakt u een gebeurtenis door EventManager.POLICY_CREATE_EVENT
door te geven.U kunt aanvullende zoekcriteria definiëren door objectmethoden EventSearchFilter
aan te roepen. Roep bijvoorbeeld de methode setUserName
aan om een gebruiker op te geven die aan de gebeurtenis is gekoppeld.
Zoeken naar de gebeurtenis
Zoek naar de gebeurtenis door de methode searchForEvents
van het EventManager
voorwerp aan te roepen en het EventSearchFilter
voorwerp over te gaan dat de criteria van het gebeurtenisonderzoek bepaalt. Deze methode retourneert een array van Event
-objecten.
Codevoorbeelden
Voor codevoorbeelden die de dienst van het Rights Management gebruiken, zie Snel begint:
U kunt naar gebeurtenissen zoeken met de Rights Management-API (webservice):
Projectbestanden opnemen
Creeer een project van Microsoft .NET dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
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 de constructor System.ServiceModel.EndpointAddress
. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/RightsManagementService?WSDL
). U hoeft het lc_version
-kenmerk niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)
Maak een System.ServiceModel.BasicHttpBinding
-object door de waarde van het veld DocumentSecurityServiceClient.Endpoint.Binding
op te halen. Cast de terugkeerwaarde aan BasicHttpBinding
.
Stel het veld System.ServiceModel.BasicHttpBinding
van het object MessageEncoding
in op WSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
toe.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
toe.HttpClientCredentialType.Basic
aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType
toe.Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly
aan het veld BasicHttpBindingSecurity.Security.Mode
toe.
Geef de gebeurtenissen op waarnaar u wilt zoeken
EventSpec
-object met de constructor ervan.EventSpec
-gegevenslid van het object firstTime.date
in te stellen met DataTime
-instantie die het begin van het datumbereik vertegenwoordigt op het moment dat de gebeurtenis plaatsvond.true
toe aan het EventSpec
gegevenslid van het object.firstTime.dateSpecified
EventSpec
-gegevenslid van het object lastTime.date
in te stellen met DataTime
-instantie die het einde van het datumbereik vertegenwoordigt op het moment dat de gebeurtenis plaatsvond.true
toe aan het EventSpec
gegevenslid van het object.lastTime.dateSpecified
eventCode
-gegevenslid van het object. EventSpec
In de volgende tabel worden de numerieke waarden weergegeven die u aan deze eigenschap kunt toewijzen:Het type Event |
Waarde |
---|---|
|
999 |
|
1000 |
|
1001 |
|
1002 |
|
1003 |
|
1004 |
|
1005 |
|
1006 |
|
1007 |
|
1008 |
|
1009 |
|
2000 |
|
2001 |
|
2002 |
|
2003 |
|
2004 |
|
2005 |
|
2006 |
|
2007 |
|
2008 |
|
2009 |
|
2010 |
|
2011 |
|
2012 |
|
2013 |
|
2014 |
|
3000 |
|
3001 |
|
3002 |
|
3003 |
|
3004 |
|
3005 |
|
4000 |
|
4001 |
|
4002 |
|
4003 |
|
4004 |
|
4005 |
|
5000 |
|
5001 |
|
5002 |
|
5003 |
|
5004 |
|
6000 |
|
7000 |
|
7001 |
|
7002 |
Zoeken naar de gebeurtenis
Zoek naar de gebeurtenis door de DocumentSecurityServiceClient
methode van objecten searchForEvents
aan te roepen en het EventSpec
voorwerp over te gaan dat de gebeurtenis vertegenwoordigt waarvoor om te zoeken en het maximumaantal resultaten. Deze methode keert een MyArrayOf_xsd_anyType
inzameling terug waar elk element een AuditSpec
instantie is. Met behulp van een AuditSpec
-instantie kunt u informatie opvragen over de gebeurtenis, zoals het tijdstip waarop deze heeft plaatsgevonden. De AuditSpec
-instantie bevat een timestamp
-gegevenslid dat deze informatie opgeeft.
Codevoorbeelden
Voor codevoorbeelden die de dienst van het Rights Management gebruiken, zie Snel begint:
Zie ook
AEM Forms aanroepen met SwaRef
Naast PDF-documenten ondersteunt de Rights Management-service extra 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.
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Referentie van de Diensten voor AEM Forms.
Voer de volgende stappen uit om een beleid toe te passen op een Word-document:
Projectbestanden opnemen
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.
Een API-object voor documentbeveiliging maken
Voordat u programmatisch een Document Security-servicebewerking kunt uitvoeren, moet u een Document Security-service-clientobject maken.
Een Word-document ophalen
U moet een Word-document opvragen 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.
Een bestaand beleid toepassen op het Word-document
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.
Het Word-document opslaan
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
Verbindingseigenschappen instellen
Toegang tot documenten intrekken
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.
ServiceClientFactory
-object dat verbindingseigenschappen bevat.DocumentSecurityClient
-object door de constructor ervan te gebruiken en het object ServiceClientFactory
door te geven.Hiermee haalt u een Word-document op.
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.com.adobe.idp.Document
-object door de constructor ervan te gebruiken en het object java.io.FileInputStream
door te geven.Pas een bestaand beleid op het document van Word toe.
Maak een DocumentManager
-object door de methode getDocumentManager
van het object DocumentSecurityClient
aan te roepen.
Pas een beleid op het document van Word toe door de DocumentManager
methode van objecten protectDocument
aan te halen en de volgende waarden over te gaan:
com.adobe.idp.Document
-object dat het Word-document bevat waarop het beleid wordt toegepast.null
waarde specificeren die in MyPolicies
gebruikte beleidsreeks resulteert.null
zijn (als deze parameter null
is, moet de vorige parameterwaarde null
zijn).com.adobe.livecycle.rightsmanagement.Locale
die de scène vertegenwoordigt die voor het selecteren van het malplaatje van MS Office wordt gebruikt. Deze parameterwaarde is optioneel en u kunt null
opgeven.De methode protectDocument
retourneert een RMSecureDocumentResult
-object dat het document bevat dat door het beleid is beveiligd.
Sla het Word-document op.
RMSecureDocumentResult
van het object getProtectedDoc
aan om het document van Word met beveiligingsbeleid te verkrijgen. Deze methode retourneert een com.adobe.idp.Document
-object.java.io.File
-object en zorg dat de bestandsextensie DOC is.com.adobe.idp.Document
van het object copyToFile
aan om de inhoud van het object Document
naar het bestand te kopiëren (zorg dat u het object Document
gebruikt dat door de methode getProtectedDoc
is geretourneerd).Codevoorbeelden
Zie het volgende snelle begin voor codevoorbeelden met gebruik van de Document Security-service:
Pas een beleid op een document van Word toe door de Veiligheid API van het Document (Webdienst) te gebruiken:
Inclusief projectbestanden.
Creeer een project van Microsoft .NET dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt: http://localhost:8080/soap/services/DocumentSecurityService?WSDL&lc_version=9.0.1
.
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 de constructor System.ServiceModel.EndpointAddress
. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/DocumentSecurityService?WSDL
). U hoeft het lc_version
-kenmerk niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)
Maak een System.ServiceModel.BasicHttpBinding
-object door de waarde van het veld DocumentSecurityServiceClient.Endpoint.Binding
op te halen. Cast de terugkeerwaarde aan BasicHttpBinding
.
Stel het veld System.ServiceModel.BasicHttpBinding
van het object MessageEncoding
in op WSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
toe.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
toe.HttpClientCredentialType.Basic
aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType
toe.Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly
aan het veld BasicHttpBindingSecurity.Security.Mode
toe.
Hiermee haalt u een Word-document op.
BLOB
-object met de constructor ervan. Het object BLOB
wordt gebruikt om een Word-document op te slaan waarop een beleid wordt toegepast.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.System.IO.FileStream
wordt opgeslagen. Bepaal de grootte van de bytearray door de System.IO.FileStream
-eigenschap van het object Length
op te halen.Read
van het object System.IO.FileStream
aan te roepen. Geef de bytearray, de startpositie en de streamlengte door om te lezen.BLOB
-object door het MTOM
-veld toe te wijzen met de inhoud van de bytearray.Pas een bestaand beleid op het document van Word toe.
Pas een beleid op het document van Word toe door de DocumentSecurityServiceClient
methode van objecten protectDocument
aan te halen en de volgende waarden over te gaan:
BLOB
-object dat het Word-document bevat waarop het beleid wordt toegepast.null
waarde specificeren die in MyPolicies
gebruikte beleidsreeks resulteert.null
zijn).null
zijn).RMLocale
die de waarde van de landinstelling opgeeft (bijvoorbeeld RMLocale.en
).application/doc
) op te slaan.De methode protectDocument
retourneert een BLOB
-object dat het document bevat dat door het beleid is beveiligd.
Sla het Word-document op.
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.BLOB
dat door de methode protectDocument
is geretourneerd. Vul de bytearray met de waarde van het BLOB
-gegevenslid van het object MTOM
.System.IO.BinaryWriter
-object door de constructor ervan aan te roepen en het object System.IO.FileStream
door te geven.Write
van het object System.IO.BinaryWriter
aan te roepen en de bytearray door te geven.Codevoorbeelden
Zie het volgende snelle begin voor codevoorbeelden met gebruik van de Document Security-service:
U kunt een beleid uit een beleid-beschermd document van Word verwijderen om veiligheid uit het document te verwijderen. Dat wil zeggen dat als u het document niet langer wilt beschermen 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.
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Referentie van de Diensten voor AEM Forms.
Voer de volgende stappen uit om een beleid te verwijderen uit een Word-document dat met een beleid is beveiligd:
Projectbestanden opnemen
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.
Een API-object voor documentbeveiliging maken
Voordat u via programmacode een bewerking met de documentbeveiligingsservice kunt uitvoeren, maakt u een clientobject van de documentbeveiligingsservice.
Een met beleid beveiligd Word-document ophalen
U moet een beleid-beschermd document van Word terugwinnen 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.
Het beleid verwijderen uit het Word-document
U kunt een beleid uit een beleid-beschermd document van Word verwijderen op voorwaarde dat een beheerder in de verbindingsmontages wordt gespecificeerd. Als niet, dan moet het beleid dat wordt gebruikt om een document te beveiligen SWITCH_POLICY
toestemming 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.
Het onbeveiligde Word-document opslaan
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
Verbindingseigenschappen instellen
Beleid toepassen op Word-documenten
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
ServiceClientFactory
-object dat verbindingseigenschappen bevat.RightsManagementClient
-object door de constructor ervan te gebruiken en het object ServiceClientFactory
door te geven.Een met beleid beveiligd Word-document ophalen
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.com.adobe.idp.Document
-object door de constructor ervan te gebruiken en het object java.io.FileInputStream
door te geven.Het beleid verwijderen uit het Word-document
DocumentManager
-object door de methode getDocumentManager
van het object RightsManagementClient
aan te roepen.DocumentManager
methode van objecten removeSecurity
te roepen en het com.adobe.idp.Document
voorwerp over te gaan dat het beleid-beschermde document van Word bevat. Deze methode retourneert een com.adobe.idp.Document
-object dat een onbeveiligd Word-document bevat.Het onbeveiligde Word-document opslaan
java.io.File
-object en zorg dat de bestandsextensie DOC is.Document
van het object copyToFile
aan om de inhoud van het object Document
naar het bestand te kopiëren (zorg dat u het object Document
gebruikt dat door de methode removeSecurity
is geretourneerd).Codevoorbeelden
Zie het volgende snelle begin voor codevoorbeelden met gebruik van de Document Security-service:
Verwijder een beleid uit een beleid-beschermd document van Word door de Veiligheid API van het Document (Webdienst te gebruiken:
Projectbestanden opnemen
Creeer een project van Microsoft .NET dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
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 de constructor System.ServiceModel.EndpointAddress
. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/RightsManagementService?WSDL
). U hoeft het lc_version
-kenmerk niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)
Maak een System.ServiceModel.BasicHttpBinding
-object door de waarde van het veld RightsManagementServiceClient.Endpoint.Binding
op te halen. Cast de terugkeerwaarde aan BasicHttpBinding
.
Stel het veld System.ServiceModel.BasicHttpBinding
van het object MessageEncoding
in op WSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
toe.RightsManagementServiceClient.ClientCredentials.UserName.Password
toe.HttpClientCredentialType.Basic
aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType
toe.Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly
aan het veld BasicHttpBindingSecurity.Security.Mode
toe.
Een met beleid beveiligd Word-document ophalen
BLOB
-object met de constructor ervan. Het BLOB
voorwerp wordt gebruikt om het beleid-beschermde document van Word op te slaan waarvan het beleid wordt verwijderd.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.System.IO.FileStream
wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschap System.IO.FileStream
van het object Length
op te halen.Read
van het object System.IO.FileStream
aan te roepen en de bytearray, de startpositie en de lengte van de stream door te geven om te lezen.BLOB
-object door het MTOM
-veld toe te wijzen met de inhoud van de bytearray.Het beleid verwijderen uit het Word-document
Verwijder het beleid uit het document van Word door de RightsManagementServiceClient
methode van objecten removePolicySecurity
aan te roepen en het BLOB
voorwerp over te gaan dat het beleid-beschermde document van Word bevat. Deze methode retourneert een BLOB
-object dat een onbeveiligd Word-document bevat.
Het onbeveiligde Word-document opslaan
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.BLOB
dat door de methode removePolicySecurity
is geretourneerd. Vul de bytearray met de waarde van het veld BLOB
van het object MTOM
.System.IO.BinaryWriter
-object door de constructor ervan aan te roepen en het object System.IO.FileStream
door te geven.Codevoorbeelden
Zie het volgende snelle begin voor codevoorbeelden met gebruik van de Document Security-service:
Zie ook