Documenten beveiligen met beleid

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:

• Microsoft Office 2003-bestanden (DOC-, XLS-, PPT-bestanden)
• Microsoft Office 2007-bestanden (DOCX-, XLSX-, PPTX-bestanden)
• PTC Pro/E-bestanden

Voor de duidelijkheid bespreken de volgende twee secties hoe te met de documenten van Word te werken:

• Beleid toepassen op Word-documenten
• Beleid verwijderen uit Word-documenten

U kunt deze taken uitvoeren met de documentbeveiligingsservice:

• Beleid maken. Zie Beleid maken voor meer informatie.
• Beleid wijzigen. Zie Beleid wijzigen voor meer informatie.
• Beleid verwijderen. Zie Beleid verwijderen voor meer informatie.
• Beleid toepassen op PDF-documenten. Zie Beleid toepassen op PDF-documenten voor meer informatie.
• Beleid verwijderen uit PDF-documenten. Zie Beleid verwijderen uit PDF-documenten voor meer informatie.
• Met een beleid beveiligde documenten van Inspect. Zie Met beleid beveiligde PDF-documenten controleren voor meer informatie.
• Toegang tot PDF-documenten intrekken. Zie Toegang tot documenten intrekken voor meer informatie.
• Toegang tot ingetrokken documenten opnieuw instellen. Zie Toegang tot ingetrokken documenten opnieuw instellen voor meer informatie.
• Watermerken maken. Zie Watermerken maken voor meer informatie.
• Zoeken naar gebeurtenissen. Zie Zoeken naar gebeurtenissen voor meer informatie.

Beleid maken

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:

• Geef de personen op die het document kunnen openen. Ontvangers kunnen tot uw organisatie behoren of zich buiten uw organisatie bevinden.
• Geef op hoe ontvangers het document kunnen gebruiken. U kunt de toegang tot verschillende Acrobat- en Adobe Reader-functies beperken. Deze functies omvatten de mogelijkheid om tekst af te drukken en te kopiëren, handtekeningen toe te voegen en opmerkingen toe te voegen aan een document.
• Wijzig de toegangs- en beveiligingsinstellingen op elk gewenst moment, zelfs nadat u het document met beveiliging hebt gedistribueerd.
• Controleer het gebruik van het document nadat u het hebt verspreid. U kunt zien hoe het document wordt gebruikt en wie het gebruikt. U kunt bijvoorbeeld erachter komen wanneer iemand het document heeft geopend.

Beleid maken met behulp van webservices

Wanneer u een beleid maakt met de webservice-API, verwijst u naar een bestaand XML-bestand (Portable Document Rights Language) waarin het beleid wordt beschreven. Beleidsmachtigingen en de principal worden gedefinieerd in het PDRL-document. Het volgende XML-document is een voorbeeld van een PDRL-document.

 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <Policy PolicyInstanceVersion="1" PolicyID="5DA3F847-DE76-F9CC-63EA-49A8D59154DE" PolicyCreationTime="2004-08-30T00:02:28.294+00:00" PolicyType="1" PolicySchemaVersion="1.0" PolicyName="SDK Test Policy -4344050357301573237" PolicyDescription="An SDK Test policy" xmlns="https://www.adobe.com/schema/1.0/pdrl">
       <PolicyEntry>
          <ns1:Permission PermissionName="com.adobe.aps.onlineOpen" Access="ALLOW" xmlns:ns1="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />

          <ns2:Permission PermissionName="com.adobe.aps.offlineOpen" Access="ALLOW" xmlns:ns2="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />

          <ns3:Permission PermissionName="com.adobe.aps.pdf.editNotes" Access="ALLOW" xmlns:ns3="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />

          <ns4:Permission PermissionName="com.adobe.aps.pdf.fillAndSign" Access="ALLOW" xmlns:ns4="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
          <Principal PrincipalNameType="SYSTEM">
             <PrincipalDomain>EDC_SPECIAL</PrincipalDomain>

             <PrincipalName>all_internal_users</PrincipalName>
          </Principal>
       </PolicyEntry>
       <PolicyEntry>
          <ns5:Permission PermissionName="com.adobe.aps.onlineOpen" Access="ALLOW" xmlns:ns5="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />

          <ns6:Permission PermissionName="com.adobe.aps.offlineOpen" Access="ALLOW" xmlns:ns6="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />

          <ns7:Permission PermissionName="com.adobe.aps.pdf.copy" Access="ALLOW" xmlns:ns7="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />

          <ns8:Permission PermissionName="com.adobe.aps.pdf.printLow" Access="ALLOW" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" xmlns:ns8="https://www.adobe.com/schema/1.0/pdrl" />

          <ns9:Permission PermissionName="com.adobe.aps.policySwitch" Access="ALLOW" xmlns:ns9="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />

          <ns10:Permission PermissionName="com.adobe.aps.revoke" Access="ALLOW" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" xmlns:ns10="https://www.adobe.com/schema/1.0/pdrl" />

          <ns11:Permission PermissionName="com.adobe.aps.pdf.edit" Access="ALLOW" xmlns:ns11="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />

          <ns12:Permission PermissionName="com.adobe.aps.pdf.editNotes" Access="ALLOW" xmlns:ns12="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />

          <ns13:Permission PermissionName="com.adobe.aps.pdf.fillAndSign" Access="ALLOW" xmlns:ns13="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />

          <ns14:Permission PermissionName="com.adobe.aps.pdf.printHigh" Access="ALLOW" xmlns:ns14="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />

          <Principal PrincipalNameType="SYSTEM">
             <PrincipalDomain>EDC_SPECIAL</PrincipalDomain>

             <PrincipalName>publisher</PrincipalName>
          </Principal>
       </PolicyEntry>

       <OfflineLeasePeriod>
          <Duration>P31D</Duration>
       </OfflineLeasePeriod>

       <AuditSettings isTracked="true" />

       <PolicyValidityPeriod isAbsoluteTime="false">
          <ValidityPeriodRelative>
             <NotBeforeRelative>PT0S</NotBeforeRelative>

             <NotAfterRelative>P20D</NotAfterRelative>
          </ValidityPeriodRelative>
       </PolicyValidityPeriod>
 </Policy>

Overzicht van stappen

Voer de volgende stappen uit om een beleid te maken:

1. Inclusief projectbestanden.
2. Maak een API-object voor Document Security Client.
3. Stel de kenmerken van het beleid in.
4. Maak een beleidsvermelding.
5. Registreer het beleid.

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:

• adobe-rightsmanagement-client.jar
• namespace.jar (als AEM Forms wordt opgesteld op JBoss)
• jaxb-api.jar (als AEM Forms wordt geïmplementeerd op JBoss)
• jaxb-impl.jar (als AEM Forms wordt geïmplementeerd op JBoss)
• jaxb-libs.jar (als AEM Forms wordt geïmplementeerd op JBoss)
• jaxb-xjc.jar (als AEM Forms wordt geïmplementeerd op JBoss)
• relaxngDatatype.jar (als AEM Forms wordt geïmplementeerd op JBoss)
• xsdlib.jar (als AEM Forms wordt geïmplementeerd op JBoss)
• adobe-livecycle-client.jar
• adobe-usermanager-client.jar
• adobe-utilities.jar
• jbossall-client.jar (gebruik een ander JAR-bestand als AEM Forms niet is geïmplementeerd op JBoss)

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:

• Een bepaald aantal dagen dat het document toegankelijk is vanaf het moment dat het document wordt gepubliceerd
• Een einddatum waarna het document niet toegankelijk is
• Een specifiek datumbereik waarvoor het document toegankelijk is
• Altijd geldig

U kunt alleen een begindatum opgeven, wat betekent dat het beleid geldig is na de begindatum. Als u slechts een einddatum specificeert, is het beleid geldig tot de einddatum. Er wordt echter een uitzondering gegenereerd als zowel een begindatum als een einddatum niet zijn gedefinieerd.

Wanneer u kenmerken instelt die tot een beleid behoren, kunt u ook versleutelingsinstellingen instellen. Deze versleutelingsinstellingen zijn van invloed wanneer het beleid wordt toegepast op een document. U kunt de volgende versleutelingswaarden opgeven:

• AES256: Vertegenwoordigt het AES encryptiealgoritme met een sleutel met 256 bits.
• AES128: Vertegenwoordigt het AES encryptiealgoritme met een sleutel met 128 bits.
• NoEncryption: Vertegenwoordigt geen encryptie.

Als u de optie NoEncryption opgeeft, kunt u de optie PlaintextMetadata niet instellen op false. Wanneer u dit probeert, wordt een uitzondering gegenereerd.

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:

• Maak en registreer een beleidsvermelding waarmee een groep een document alleen online kan bekijken en ontvangers het niet kunnen kopiëren.
• Koppel de beleidsvermelding aan het beleid.
• Beveilig een document met het beleid door Acrobat te gebruiken.

Hierdoor kunnen ontvangers het document alleen online bekijken en niet kopiëren. Het document blijft beveiligd totdat de beveiliging ervan is verwijderd.

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 Java API

Een beleid maken met de API voor documentbeveiliging (Java):

1. Inclusief projectbestanden.

   Neem client-JAR-bestanden, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project.

2. Maak een API-object voor Document Security Client.

   • Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat.
   • Maak een DocumentSecurityClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.

3. Stel de kenmerken van het beleid in.

   • Maak een Policy-object door de statische methode createPolicy van het object aan te roepen. InfomodelObjectFactory Deze methode retourneert een Policy-object.
   • Stel het kenmerk name van het beleid in door de methode setName van het object Policy aan te roepen en een tekenreekswaarde door te geven die de naam van het beleid aangeeft.
   • Stel de beschrijving van het beleid in door de methode setDescription van het object Policy aan te roepen en een tekenreekswaarde door te geven die de beschrijving van het beleid opgeeft.
   • Stel de beleidsset in waartoe het nieuwe beleid behoort door de methode 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.)
   • Maak de geldigheidsperiode van het beleid door de statische methode createValidityPeriod van het object InfomodelObjectFactory aan te roepen. Deze methode retourneert een ValidityPeriod-object.
   • Stel het aantal dagen in waarvoor een document dat met een beleid is beveiligd, toegankelijk is door de methode setRelativeExpirationDays van het object ValidityPeriod aan te roepen en een geheel getal door te geven dat het aantal dagen opgeeft.
   • Stel de geldigheidsperiode van het beleid in door de methode setValidityPeriod van het object Policy aan te roepen en het object ValidityPeriod door te geven.

4. Maak een beleidsvermelding.

   • Creeer een beleidsingang door de statische methode createPolicyEntry van het InfomodelObjectFactory voorwerp aan te halen. Deze methode retourneert een PolicyEntry-object.
   • Geef de bevoegdheden van het beleid op door de statische methode 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.)
   • Voeg de toestemming aan de beleidsingang toe door de 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).
   • Creeer het beleidshoofd door de statische methode 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.
   • Voeg de principal aan de beleidsingang toe door de PolicyEntry methode van het voorwerp setPrincipalaan te halen en het Principal voorwerp over te gaan.
   • Voeg de beleidsingang aan het beleid toe door de Policy methode addPolicyEntry van objecten aan te halen en het PolicyEntry voorwerp over te gaan.

5. 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:

     • Het 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.

   OPMERKING

   Verwijs bij het maken van een beleid naar een bestaande beleidsset. Als u een beleidsset opgeeft die niet bestaat, wordt een uitzondering gegenereerd.

Zie het volgende voor codevoorbeelden met de Document Security-service:

• "Snel starten (SOAP-modus): Beleid maken met de Java API"

Een beleid maken met de webservice-API

Een beleid maken met de API voor documentbeveiliging (webservice):

1. 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.

   OPMERKING

   Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.

2. 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:

     • Wijs de gebruikersnaam voor het AEM aan het veld RightsManagementServiceClient.ClientCredentials.UserName.UserName toe.
     • Wijs de overeenkomstige wachtwoordwaarde aan het gebied RightsManagementServiceClient.ClientCredentials.UserName.Password toe.
     • Wijs de constante waarde HttpClientCredentialType.Basic aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType toe.

   • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly aan het veld BasicHttpBindingSecurity.Security.Mode toe.

3. Stel de kenmerken van het beleid in.

   • Maak een PolicySpec-object met de constructor ervan.
   • Stel de naam van het beleid in door een tekenreekswaarde toe te wijzen aan het name-gegevenslid van het object.PolicySpec
   • Stel de beschrijving van het beleid in door een tekenreekswaarde toe te wijzen aan het description-gegevenslid van het object.PolicySpec
   • Stel de beleidsset in waartoe het beleid behoort door een tekenreekswaarde toe te wijzen aan het 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.)
   • Stel de offline leaseperiode van het beleid in door een geheel-getalwaarde toe te wijzen aan het offlineLeasePeriod-gegevenslid van het object PolicySpec.
   • Stel het 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.

4. 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.

5. Registreer het beleid.

   Registreer het beleid door de methode registerPolicy van het DocumentSecurityServiceClient voorwerp aan te halen en de volgende waarden over te gaan:

   • Het PolicySpec-object dat het te registreren beleid vertegenwoordigt.
   • Een tekenreekswaarde die staat voor de beleidsset waartoe het beleid behoort. U kunt een null waarde specificeren die in het beleid resulteert dat aan wordt toegevoegd 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.

   OPMERKING

   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:

• "Snel starten (MTOM): Beleid maken met de webservice-API"
• "Quick Start (SwaRef): Beleid maken met de webservice-API"

Beleid wijzigen

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.

Overzicht van stappen

Voer de volgende stappen uit om een bestaand beleid te wijzigen:

1. Inclusief projectbestanden.
2. Maak een API-object voor Document Security Client.
3. Een bestaand beleid ophalen.
4. Beleidskenmerken wijzigen.
5. Werk het beleid bij.

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.

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.

Bestaand beleid wijzigen met de Java API

Wijzig een bestaand beleid met de API voor documentbeveiliging (Java):

1. Inclusief projectbestanden.

   Neem client-JAR-bestanden, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project.

2. Maak een API-object voor Document Security Client.

   • Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat.
   • Maak een RightsManagementClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.

3. 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"

     • Een tekenreekswaarde die staat voor de naam van de beleidsset waartoe het beleid behoort. U kunt null specificeren die in MyPolicies gebruikte beleidsreeks resulteert.
     • Een tekenreekswaarde die de naam van het beleid vertegenwoordigt.

4. 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.

5. 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.

Bestaand beleid wijzigen met de webservice-API

Wijzig een bestaand beleid met de API voor documentbeveiliging (webservice):

1. 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.

   OPMERKING

   Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.

2. 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:

     • Wijs de gebruikersnaam voor het AEM aan het veld RightsManagementServiceClient.ClientCredentials.UserName.UserName toe.
     • Wijs de overeenkomstige wachtwoordwaarde aan het gebied RightsManagementServiceClient.ClientCredentials.UserName.Password toe.
     • Wijs de constante waarde HttpClientCredentialType.Basic aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType toe.

   • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly aan het veld BasicHttpBindingSecurity.Security.Mode toe.

3. 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:

   • Een tekenreekswaarde die de naam van de beleidsset opgeeft waartoe het beleid behoort. U kunt null specificeren die in MyPolicies gebruikte beleidsreeks resulteert.
   • Een tekenreekswaarde die de naam van het beleid aangeeft.

4. Stel de kenmerken van het beleid in.

   Verander de attributen van het beleid om aan uw bedrijfsvereisten te voldoen.

5. 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:

• "Snel starten (MTOM): Een beleid wijzigen met de webservice-API"
• "Quick Start (SwaRef): Een beleid wijzigen met de webservice-API"

Verwijderen van beleid

U kunt een bestaand beleid verwijderen met de Java API voor documentbeveiliging of de webservice-API. Nadat een beleid is verwijderd, kan het niet meer worden gebruikt om documenten te beschermen. Bestaande documenten die door het beleid worden beschermd, zijn echter nog steeds beveiligd. U kunt een beleid schrappen wanneer nieuwere beschikbaar wordt.

Overzicht van stappen

Voer de volgende stappen uit om een bestaand beleid te verwijderen:

1. Projectbestanden opnemen
2. Maak een API-object voor Document Security Client.
3. Verwijder het beleid.

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.

Beleid verwijderen met de Java API

Een beleid verwijderen met de API voor documentbeveiliging (Java):

1. Inclusief projectbestanden.

   Neem client-JAR-bestanden, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project.

2. Maak een API-object voor Document Security Client.

   • Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat.
   • Maak een RightsManagementClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.

3. 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:

     • Een tekenreekswaarde die de naam van de beleidsset opgeeft waartoe het beleid behoort. U kunt null specificeren die in MyPolicies gebruikte beleidsreeks resulteert.
     • Een tekenreekswaarde die de naam aangeeft van het beleid dat moet worden verwijderd.

Codevoorbeelden

Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:

• "Snel starten (SOAP-modus): Een beleid verwijderen met de Java API"

Beleid verwijderen met de webservice-API

Verwijder een beleid met de API voor documentbeveiliging (webservice):

1. 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.

   OPMERKING

   Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.

2. 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:

     • Wijs de gebruikersnaam voor het AEM aan het veld RightsManagementServiceClient.ClientCredentials.UserName.UserName toe.
     • Wijs de overeenkomstige wachtwoordwaarde aan het gebied RightsManagementServiceClient.ClientCredentials.UserName.Password toe.
     • Wijs de constante waarde HttpClientCredentialType.Basic aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType toe.

   • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly aan het veld BasicHttpBindingSecurity.Security.Mode toe.

3. Verwijder het beleid.

   Verwijder een beleid door de methode deletePolicy van het object RightsManagementServiceClient aan te roepen en de volgende waarden door te geven:

   • Een tekenreekswaarde die de naam van de beleidsset opgeeft waartoe het beleid behoort. U kunt null specificeren die in MyPolicies gebruikte beleidsreeks resulteert.
   • Een tekenreekswaarde die de naam aangeeft van het beleid dat moet worden verwijderd.

Codevoorbeelden

Zie Snel aan de slag voor codevoorbeelden met de Document Security-service:

• "Snel starten (MTOM): Een beleid verwijderen met de webservice-API"
• "Quick Start (SwaRef): Een beleid verwijderen met de webservice-API"

Beleid toepassen op PDF-documenten

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.

Overzicht van stappen

Voer de volgende stappen uit om een beleid toe te passen op een PDF-document:

1. Inclusief projectbestanden.
2. Maak een API-object voor Document Security Client.
3. Hiermee wordt een PDF-document opgehaald waarop een beleid is toegepast.
4. Pas een bestaand beleid toe op het PDF-document.
5. Sla het met beleid beveiligde PDF-document op.

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 de Java API

Een beleid toepassen op een PDF-document met behulp van de API voor documentbeveiliging (Java):

1. Inclusief projectbestanden.

   Neem client-JAR-bestanden, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project.

2. Maak een API-object voor Document Security Client.

   • Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat.
   • Maak een RightsManagementClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.

3. Een PDF-document ophalen.

   • Maak een 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.
   • Maak een com.adobe.idp.Document-object door de constructor ervan te gebruiken en het object java.io.FileInputStream door te geven.

4. 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:

     • Het com.adobe.idp.Document-object dat het PDF-document bevat waarop het beleid wordt toegepast.
     • Een tekenreekswaarde die de naam van het document aangeeft.
     • Een tekenreekswaarde die de naam opgeeft van de beleidsset waartoe het beleid behoort. U kunt een null waarde specificeren die in MyPolicies gebruikte beleidsreeks resulteert.
     • Een tekenreekswaarde die de beleidsnaam opgeeft.
     • Een tekenreekswaarde die de naam vertegenwoordigt van het gebruikersbeheerdomein van de gebruiker die de uitgever van het document is. Deze parameterwaarde is optioneel en kan null zijn (als deze parameter null is, moet de volgende parameterwaarde null zijn).
     • Een tekenreekswaarde die de naam vertegenwoordigt van de canonieke naam van de gebruiker van de gebruikersmanager die de uitgever van het document is. Deze parameterwaarde is optioneel en kan null zijn (als deze parameter null is, moet de vorige parameterwaarde null zijn).
     • A 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.

5. Sla het PDF-document op.

   • Roep de methode 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.
   • Maak een java.io.File-object en controleer of de bestandsextensie PDF is.
   • Roep de methode 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:

• "Snel starten (EJB-modus): Een beleid toepassen op een PDF-document met de Java API"
• "Snel starten (SOAP-modus): Een beleid toepassen op een PDF-document met de Java API"

Zie ook

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Een beleid toepassen op een PDF-document met behulp van de webservice-API

Een beleid toepassen op een PDF-document met behulp van de API voor documentbeveiliging (webservice):

1. 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.

   OPMERKING

   Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.

2. 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:

     • Wijs de gebruikersnaam voor het AEM aan het veld RightsManagementServiceClient.ClientCredentials.UserName.UserName toe.
     • Wijs de overeenkomstige wachtwoordwaarde aan het gebied RightsManagementServiceClient.ClientCredentials.UserName.Password toe.
     • Wijs de constante waarde HttpClientCredentialType.Basic aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType toe.

   • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly aan het veld BasicHttpBindingSecurity.Security.Mode toe.

3. Een PDF-document ophalen.

   • Maak een BLOB-object met de constructor ervan. Met het object BLOB wordt een PDF-document opgeslagen waarop een beleid wordt toegepast.
   • Maak een System.IO.FileStream-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het PDF-document en de modus waarin het bestand moet worden geopend, vertegenwoordigt.
   • Maak een bytearray waarin de inhoud van het object System.IO.FileStream wordt opgeslagen. Bepaal de grootte van de bytearray door de System.IO.FileStream-eigenschap van het object Length op te halen.
   • Vul de bytearray met streamgegevens door de methode Read van het object System.IO.FileStream aan te roepen. Geef de bytearray, de startpositie en de streamlengte door om te lezen.
   • Vul het BLOB-object door het MTOM-veld toe te wijzen met de inhoud van de bytearray.

4. 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:

   • Het BLOB-object dat het PDF-document bevat waarop het beleid wordt toegepast.
   • Een tekenreekswaarde die de naam van het document aangeeft.
   • Een tekenreekswaarde die de naam opgeeft van de beleidsset waartoe het beleid behoort. U kunt een null waarde specificeren die in MyPolicies gebruikte beleidsreeks resulteert.
   • Een tekenreekswaarde die de beleidsnaam opgeeft.
   • Een tekenreekswaarde die de naam vertegenwoordigt van het gebruikersbeheerdomein van de gebruiker die de uitgever van het document is. Deze parameterwaarde is optioneel en kan null zijn (als deze parameter null is, moet de volgende parameterwaarde null zijn).
   • Een tekenreekswaarde die de naam vertegenwoordigt van de canonieke naam van de gebruiker van de gebruikersmanager die de uitgever van het document is. Deze parameterwaarde is optioneel en kan null zijn (als deze parameter null is, moet de vorige parameterwaarde null zijn).
   • Een waarde RMLocale die de waarde van de landinstelling opgeeft (bijvoorbeeld RMLocale.en).
   • Een parameter van de koordoutput die wordt gebruikt om de waarde van beleidsidentificatie op te slaan.
   • Een parameter van de koordoutput die wordt gebruikt om de beleid-beschermde herkenningstekenwaarde op te slaan.
   • Een parameter van de koordoutput die wordt gebruikt om het mime type (bijvoorbeeld, application/pdf) op te slaan.

   De methode protectDocument retourneert een BLOB-object dat het met een beleid beveiligde PDF-document bevat.

5. Sla het PDF-document op.

   • Maak een System.IO.FileStream-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het met een beleid beveiligde PDF-document vertegenwoordigt.
   • Maak een bytearray met de gegevensinhoud van het object BLOB dat door de methode protectDocument is geretourneerd. Vul de bytearray met de waarde van het BLOB-gegevenslid van het object MTOM.
   • Maak een System.IO.BinaryWriter-object door de constructor ervan aan te roepen en het object System.IO.FileStream door te geven.
   • Schrijf de inhoud van de bytearray naar een PDF-bestand door de methode 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:

• "Snel starten (MTOM): Een beleid toepassen op een PDF-document met behulp van de webservice-API."
• "Quick Start (SwaRef): Een beleid toepassen op een PDF-document met behulp van de webservice-API."

Beleid verwijderen uit PDF-documenten

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.

Overzicht van stappen

Voer de volgende stappen uit om een beleid te verwijderen uit een PDF-document dat met een beleid is beveiligd:

1. Projectbestanden opnemen
2. Maak een API-object voor Document Security Client.
3. Hiermee haalt u een PDF-document op dat met een beleid is beveiligd.
4. Verwijder het beleid uit het PDF-document.
5. Sla het onbeveiligde PDF-document op.

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 met de Java API

Een beleid verwijderen uit een PDF-document dat met een beleid is beveiligd, met de API voor documentbeveiliging (Java):

1. Inclusief projectbestanden.

   Neem client-JAR-bestanden, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project.

2. Maak een API-object voor Document Security Client.

   • Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat.
   • Maak een DocumentSecurityClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.

3. Hiermee haalt u een PDF-document op dat met een beleid is beveiligd.

   • Maak een java.io.FileInputStream-object dat het met een beleid beveiligde PDF-document vertegenwoordigt door de constructor ervan te gebruiken en een tekenreekswaarde door te geven die de locatie van het PDF-document aangeeft.
   • Maak een com.adobe.idp.Document-object door de constructor ervan te gebruiken en het object java.io.FileInputStream door te geven.

4. Verwijder het beleid uit het PDF-document.

   • Maak een DocumentManager-object door de methode getDocumentManager van het object DocumentSecurityClient aan te roepen.
   • Verwijder een beleid uit het PDF-document door de methode 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.

5. Sla het onbeveiligde PDF-document op.

   • Maak een java.io.File-object en controleer of de bestandsextensie PDF is.
   • Roep de methode 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:

• "Snel starten (SOAP-modus): Een beleid verwijderen uit een PDF-document met de Java API"

Een beleid verwijderen met de webservice-API

Een beleid verwijderen uit een PDF-document dat met een beleid is beveiligd met de API voor documentbeveiliging (webservice):

1. 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.

   OPMERKING

   Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.

2. 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:

     • Wijs de gebruikersnaam voor het AEM aan het veld DocumentSecurityServiceClient.ClientCredentials.UserName.UserName toe.
     • Wijs de overeenkomstige wachtwoordwaarde aan het gebied DocumentSecurityServiceClient.ClientCredentials.UserName.Password toe.
     • Wijs de constante waarde HttpClientCredentialType.Basic aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType toe.

   • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly aan het veld BasicHttpBindingSecurity.Security.Mode toe.

3. Hiermee haalt u een PDF-document op dat met een beleid is beveiligd.

   • Maak een BLOB-object met de constructor ervan. Met het object BLOB wordt het met een beleid beveiligde PDF-document opgeslagen waaruit het beleid wordt verwijderd.
   • Maak een System.IO.FileStream-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het PDF-document en de modus waarin het bestand moet worden geopend, vertegenwoordigt.
   • Maak een bytearray waarin de inhoud van het object System.IO.FileStream wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschap System.IO.FileStream van het object Length op te halen.
   • Vul de bytearray met streamgegevens door de methode 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.
   • Vul het BLOB-object door het MTOM-veld toe te wijzen met de inhoud van de bytearray.

4. 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.

5. Sla het onbeveiligde PDF-document op.

   • Maak een System.IO.FileStream-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het onbeveiligde PDF-document vertegenwoordigt.
   • Maak een bytearray met de gegevensinhoud van het object BLOB dat door de methode removePolicySecurity is geretourneerd. Vul de bytearray met de waarde van het veld BLOB van het object MTOM.
   • Maak een 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:

• "Snel starten (MTOM): Een beleid uit een PDF-document verwijderen met de webservice-API"
• "Quick Start (SwaRef): Een beleid uit een PDF-document verwijderen met de webservice-API"

Zie ook

AEM Forms aanroepen met MTOM

AEM Forms aanroepen met SwaRef

Toegang tot documenten intrekken

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.

Overzicht van stappen

Voer de volgende stappen uit om een document dat met een beleid is beveiligd, in te trekken:

1. Inclusief projectbestanden.
2. Maak een API-object voor Document Security Client.
3. Hiermee haalt u een PDF-document op dat met een beleid is beveiligd.
4. Intrekken van het 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 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.

Zie ook

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Beleid toepassen op PDF-documenten

Toegang tot ingetrokken documenten opnieuw instellen

Toegang tot documenten intrekken met de Java API

Toegang tot een met beleid beveiligd PDF-document intrekken met de API voor documentbeveiliging (Java):

1. Projectbestanden opnemen

   Neem client-JAR-bestanden, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project.

2. Een API-object voor documentbeveiliging maken

   • Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat.
   • Maak een DocumentSecurityClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.

3. Een met beleid beveiligd PDF-document ophalen

   • Maak een java.io.FileInputStream-object dat het met een beleid beveiligde PDF-document vertegenwoordigt door de constructor ervan te gebruiken en een tekenreekswaarde door te geven die de locatie van het PDF-document aangeeft.
   • Maak een com.adobe.idp.Document-object door de constructor ervan te gebruiken en het object java.io.FileInputStream door te geven.

4. 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:

     • Een tekenreekswaarde die de waarde van de licentie-id van het document met beleidsbeveiliging opgeeft (geef de geretourneerde waarde op van de methode DocumentManager van het object).getLicenseId
     • Een statisch gegevenslid van de interface License die de reden specificeert om het document in te trekken. U kunt bijvoorbeeld License.DOCUMENT_REVISED opgeven.
     • Een 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:

• "Snel starten (SOAP-modus): Een document intrekken met de Java API"

Toegang tot documenten intrekken met de webservice-API

De toegang tot een met beleid beveiligd PDF-document intrekken met de API voor documentbeveiliging (webservice):

1. 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.

   OPMERKING

   Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.

2. 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:

     • Wijs de gebruikersnaam voor het AEM aan het veld DocumentSecurityServiceClient.ClientCredentials.UserName.UserName toe.
     • Wijs de overeenkomstige wachtwoordwaarde aan het gebied DocumentSecurityServiceClient.ClientCredentials.UserName.Password toe.
     • Wijs de constante waarde HttpClientCredentialType.Basic aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType toe.

   • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly aan het veld BasicHttpBindingSecurity.Security.Mode toe.

3. Een met beleid beveiligd PDF-document ophalen

   • Maak een BLOB-object met de constructor ervan. Met het object BLOB wordt een met een beleid beveiligd PDF-document opgeslagen dat wordt ingetrokken.
   • Maak een System.IO.FileStream-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie vertegenwoordigt van het PDF-document dat met een beleid is beveiligd en de modus waarin het bestand moet worden geopend.
   • Maak een bytearray waarin de inhoud van het object System.IO.FileStream wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschap System.IO.FileStream van het object Length op te halen.
   • Vul de bytearray met streamgegevens door de methode 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.
   • Vul het BLOB-object door het MTOM-veld toe te wijzen met de inhoud van de bytearray.

4. 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:

     • Een tekenreekswaarde die de waarde van de licentie-id van het document met beleidsbeveiliging opgeeft (geef de geretourneerde waarde op van de methode DocumentSecurityServiceService van het object).getLicenseId
     • Een statisch gegevenslid van de Reason-opsomming dat de reden opgeeft om het document in te trekken. U kunt bijvoorbeeld Reason.DOCUMENT_REVISED opgeven.
     • Een 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:

• "Snel starten (MTOM): Een document intrekken met de webservice-API"
• "Quick Start (SwaRef): Een document intrekken met de webservice-API"

Zie ook

Beleid verwijderen uit Word-documenten

AEM Forms aanroepen met MTOM

AEM Forms aanroepen met SwaRef

Toegang tot ingetrokken documenten opnieuw instellen

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.

Overzicht van stappen

Voer de volgende stappen uit om de toegang tot een ingetrokken PDF-document te herstellen:

1. Inclusief projectbestanden.
2. Maak een API-object voor Document Security Client.
3. Haal de licentie-id van het ingetrokken PDF-document op.
4. Toegang tot het ingetrokken PDF-document opnieuw instellen.

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 ingetrokken documenten opnieuw instellen met de Java API

Toegang tot een ingetrokken document opnieuw instellen met de API voor documentbeveiliging (Java):

1. Inclusief projectbestanden.

   Neem client-JAR-bestanden, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project.

2. Maak een API-object voor Document Security Client.

   • Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat.
   • Maak een DocumentSecurityClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.

3. Haal de licentie-id van het ingetrokken PDF-document op.

   • Maak een java.io.FileInputStream-object dat het ingetrokken PDF-document vertegenwoordigt door de constructor ervan te gebruiken en een tekenreekswaarde door te geven die de locatie van het PDF-document aangeeft.
   • Maak een com.adobe.idp.Document-object door de constructor ervan te gebruiken en het object java.io.FileInputStream door te geven.
   • Maak een DocumentManager-object door de methode getDocumentManager van het object DocumentSecurityClient aan te roepen.
   • Haal de waarde van de licentie-id van het ingetrokken document op door de methode 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.

4. Toegang tot het ingetrokken PDF-document opnieuw instellen.

   • Maak een LicenseManager-object door de methode getLicenseManager van het object DocumentSecurityClient aan te roepen.
   • Herstel de toegang tot het ingetrokken PDF-document door de methode 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:

• "Snel starten (SOAP-modus): Toegang tot een ingetrokken document opnieuw instellen met de webservice-API"

Toegang tot ingetrokken documenten opnieuw instellen met de webservice-API

Toegang tot een ingetrokken document opnieuw instellen met de API voor documentbeveiliging (webservice):

1. 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.

   OPMERKING

   Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.

2. 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:

     • Wijs de gebruikersnaam voor het AEM aan het veld DocumentSecurityServiceClient.ClientCredentials.UserName.UserName toe.
     • Wijs de overeenkomstige wachtwoordwaarde aan het gebied DocumentSecurityServiceClient.ClientCredentials.UserName.Password toe.
     • Wijs de constante waarde HttpClientCredentialType.Basic aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType toe.

   • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly aan het veld BasicHttpBindingSecurity.Security.Mode toe.

3. Haal de licentie-id van het ingetrokken PDF-document op.

   • Maak een BLOB-object met de constructor ervan. Met het object BLOB wordt een ingetrokken PDF-document opgeslagen waartoe toegang wordt hersteld.
   • Maak een System.IO.FileStream-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het ingetrokken PDF-document en de modus waarin het bestand moet worden geopend, vertegenwoordigt.
   • Maak een bytearray waarin de inhoud van het object System.IO.FileStream wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschap System.IO.FileStream van het object Length op te halen.
   • Vul de bytearray met streamgegevens door de methode 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.
   • Vul het BLOB-object door het MTOM-veld toe te wijzen met de inhoud van de bytearray.

4. Toegang tot het ingetrokken PDF-document opnieuw instellen.

   • Haal de waarde van de licentie-id van het ingetrokken document op door de methode 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.
   • Herstel de toegang tot het ingetrokken PDF-document door de methode 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:

• "Snel starten (MTOM): Toegang tot een ingetrokken document opnieuw instellen met de webservice-API"
• "Quick Start (SwaRef): Toegang tot een ingetrokken document opnieuw instellen met de webservice-API"

Zie ook

AEM Forms aanroepen met MTOM

AEM Forms aanroepen met SwaRef

Met beleid beveiligde PDF-documenten controleren

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.

Overzicht van stappen

Voer de volgende stappen uit om een PDF-document te inspecteren dat met een beleid is beveiligd:

1. Inclusief projectbestanden.
2. Maak een API-object voor Document Security Client.
3. Haal een document op dat met een beleid is beveiligd om te inspecteren.
4. Verkrijg informatie over het beleid-beschermde 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 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

Met Inspect Policy beveiligde PDF-documenten met de Java API

Inspect a policy-protected PDF document by the Document Security Service API (Java):

1. 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.

2. Maak een API-object voor Document Security Client.

   • Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat. (Zie Verbindingseigenschappen instellen.)
   • Maak een RightsManagementClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.

3. Haal een document op dat met een beleid is beveiligd om te inspecteren.

   • Maak een 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.
   • Maak een com.adobe.idp.Document-object door de constructor ervan te gebruiken en het object java.io.FileInputStream door te geven.

4. Inspect het document.

   • Maak een DocumentManager-object door de methode getDocumentManager van het object RightsManagementClient aan te roepen.
   • Inspect het document met beveiligingsbeleid door de methode 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.

5. 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:

• "Snel starten (SOAP-modus): Met beleid beveiligde PDF-documenten controleren met de Java API"

Met Inspect Policy beveiligde PDF-documenten met de webservice-API

Inspect a policy protected PDF document by the Document Security Service API (webservice):

1. 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.

   OPMERKING

   Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.

2. 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:

     • Wijs de gebruikersnaam voor het AEM aan het veld RightsManagementServiceClient.ClientCredentials.UserName.UserName toe.
     • Wijs de overeenkomstige wachtwoordwaarde aan het gebied RightsManagementServiceClient.ClientCredentials.UserName.Password toe.
     • Wijs de constante waarde HttpClientCredentialType.Basic aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType toe.

   • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly aan het veld BasicHttpBindingSecurity.Security.Mode toe.

3. Haal een document op dat met een beleid is beveiligd om te inspecteren.

   • Maak een BLOB-object met de constructor ervan. Met het object BLOB wordt een PDF-document opgeslagen dat moet worden geïnspecteerd.
   • Maak een System.IO.FileStream-object door de constructor ervan aan te roepen. Geef een tekenreekswaarde door die staat voor de bestandslocatie van het PDF-document en de modus waarin het bestand moet worden geopend.
   • Maak een bytearray waarin de inhoud van het object System.IO.FileStream wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschap System.IO.FileStream van het object Length op te halen.
   • Vul de bytearray met streamgegevens door de methode Read van het object System.IO.FileStream aan te roepen. Geef de bytearray, de startpositie en de streamlengte door om te lezen.
   • Vul het BLOB-object door het MTOM-veld toe te wijzen met de inhoud van de bytearray.

4. 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.

5. 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:

• "Snel starten (MTOM): Met beleid beveiligde PDF-documenten controleren met de webservice-API"
• "Quick Start (SwaRef): Met beleid beveiligde PDF-documenten controleren met de webservice-API"

Zie ook

AEM Forms aanroepen met MTOM

AEM Forms aanroepen met SwaRef

Watermerken maken

Watermerken helpen de veiligheid van een document te waarborgen door het document op unieke wijze te identificeren en de inbreuk op het auteursrecht te controleren. U kunt bijvoorbeeld een watermerk maken en plaatsen dat op alle pagina's van een document de tekst Vertrouwelijk aangeeft. Nadat u een watermerk hebt gemaakt, kunt u dit opnemen in een beleid. U kunt dus het watermerkkenmerk van het beleid instellen met het nieuwe watermerk. Nadat een beleid met een watermerk is toegepast op een document, wordt het watermerk weergegeven in het document dat met een beleid is beveiligd.

Overzicht van stappen

Voer de volgende stappen uit om een watermerk te maken:

1. Inclusief projectbestanden.
2. Maak een API-object voor Document Security Client.
3. Stel de kenmerken van de watermerken in.
4. Registreer het watermerk bij de Dienst van de Veiligheid van het 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. 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:

• Eigen tekst
• DateIncluded
• UserIdIncluded
• UserNameIncluded

De volgende tabel bevat een lijst met sleutel- en waardeparen die zijn vereist voor het maken van een watermerk met behulp van webservices.

Sleutelnaam	Beschrijving	Waarde
WaterBackCmd:IS_USERNAME_ENABLED	Hiermee wordt opgegeven of de gebruikersnaam van de gebruiker die het document opent, deel uitmaakt van het watermerk.	Waar of Onwaar
WaterBackCmd:IS_USERID_ENABLED	Hiermee wordt opgegeven of de identificatie van de gebruiker die het document opent, deel uitmaakt van het watermerk.	Waar of Onwaar
WaterBackCmd:IS_CURRENTDATE_ENABLED	Hiermee wordt opgegeven of de huidige datum deel uitmaakt van het watermerk.	Waar of Onwaar
WaterBackCmd:IS_CUSTOMTEXT_ENABLED	Als deze waarde true is, moet de waarde van de aangepaste tekst worden opgegeven met WaterBackCmd:SRCTEXT.	Waar of Onwaar
WaterBackCmd:OPACITY	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.
WaterBackCmd:ROTATION	Hiermee wordt de rotatie van het watermerk opgegeven. De standaardwaarde is 0 graden.	Een waarde tussen 0 en 359.
WaterBackCmd:SCALE	Als deze waarde wordt opgegeven, moet WaterBackCmd:IS_SIZE_ENABLED aanwezig zijn en moet de waarde true zijn. Als dit kenmerk niet is opgegeven, wordt het standaardgedrag aan de pagina aangepast.	Een waarde die groter is dan 0.0 en kleiner dan of gelijk aan 1.0.
WaterBackCmd:HORIZ_ALIGN	Geeft de horizontale uitlijning van het watermerk aan. De standaardwaarde is gecentreerd.	links, midden of rechts
WaterBackCmd:VERT_ALIGN	Geeft de verticale uitlijning van het watermerk aan. De standaardwaarde is gecentreerd.	boven, midden of onder
WaterBackCmd:IS_USE_BACKGROUND	Hiermee wordt opgegeven of het watermerk een achtergrond is. De standaardwaarde is false.	Waar of Onwaar
WaterBackCmd:IS_SIZE_ENABLED	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
WaterBackCmd:SRCTEXT	Hiermee wordt de aangepaste tekst voor een watermerk opgegeven. Als deze waarde aanwezig is, moet WaterBackCmd:IS_CUSTOMTEXT_ENABLED ook aanwezig zijn en op waar worden geplaatst.	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

Watermerken maken met de Java API

Een watermerk maken met de API voor documentbeveiliging (Java):

1. Inclusief projectbestanden.

   Neem JAR-bestanden van de client, zoals de adobe-rightsmanagement-client.jar, op in het klassepad van uw Java-project.

2. Maak een API-object voor Document Security Client.

   • Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat.
   • Maak een RightsManagementClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.

3. De kenmerken van het watermerk instellen

   • Maak een Watermark-object door de statische methode createWatermark van het object aan te roepen. InfomodelObjectFactory Deze methode retourneert een Watermark-object.
   • Stel het naamkenmerk van het watermerk in door de methode setName van het object Watermark aan te roepen en een tekenreekswaarde door te geven die de naam van het beleid aangeeft.
   • Stel het achtergrondkenmerk van het watermerk in door de methode setBackground van het 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.
   • Stel het aangepaste tekstkenmerk van het watermerk in door de methode setCustomText van het object Watermark aan te roepen en een tekenreekswaarde door te geven die de tekst van het watermerk vertegenwoordigt.
   • Stel het kenmerk opacity van het watermerk in door de methode setOpacity van het 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.

4. Registreer het watermerk.

   • Maak een WatermarkManager-object door de methode getWatermarkManager van het object RightsManagementClient aan te roepen. Deze methode retourneert een WatermarkManager-object.
   • Registreer het watermerk door de methode 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:

• "Snel starten (SOAP-modus): Watermerken maken met de Java API"

Watermerken maken met de webservice-API

Een watermerk maken met de API voor documentbeveiliging (webservice):

1. 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.

   OPMERKING

   Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.

2. 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:

     • Wijs de gebruikersnaam voor het AEM aan het veld RightsManagementServiceClient.ClientCredentials.UserName.UserName toe.
     • Wijs de overeenkomstige wachtwoordwaarde aan het gebied RightsManagementServiceClient.ClientCredentials.UserName.Password toe.
     • Wijs de constante waarde HttpClientCredentialType.Basic aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType toe.

   • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly aan het veld BasicHttpBindingSecurity.Security.Mode toe.

3. Stel de kenmerken van het watermerk in.

   • Maak een WatermarkSpec-object door de constructor WatermarkSpec aan te roepen.
   • Stel de naam van het watermerk in door een tekenreekswaarde toe te wijzen aan het WatermarkSpec-gegevenslid van het object.name
   • Stel het kenmerk id van het watermerk in door een tekenreekswaarde toe te wijzen aan het WatermarkSpec-gegevenslid van het object id.
   • Voor elke watermerkeigenschap die moet worden ingesteld, maakt u een afzonderlijk MyMapOf_xsd_string_To_xsd_anyType_Item-object.
   • Stel de hoofdwaarde in door een waarde toe te wijzen aan het MyMapOf_xsd_string_To_xsd_anyType_Item-gegevenslid van het object (bijvoorbeeld WaterBackCmd:OPACITY)).key
   • Stel de waarde in door een waarde toe te wijzen aan het MyMapOf_xsd_string_To_xsd_anyType_Item-gegevenslid van het value-object (bijvoorbeeld .25).
   • Maak een 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.
   • Wijs het MyArrayOf_xsd_anyType-object toe aan het WatermarkSpec-gegevenslid van het object.values

4. 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:

• "Snel starten (MTOM): Een watermerk maken met de webservice-API"
• "Quick Start (SwaRef): Een watermerk maken met de webservice-API"

Zie ook

AEM Forms aanroepen met MTOM

AEM Forms aanroepen met SwaRef

Watermerken wijzigen

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.

Overzicht van stappen

Voer de volgende stappen uit om een watermerk te wijzigen:

1. Inclusief projectbestanden.
2. Maak een API-object voor Document Security Client.
3. Haal het watermerk op dat u wilt wijzigen.
4. Stel de kenmerken van de watermerken in.
5. Werk het watermerk bij.

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.

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

Watermerken maken

Watermerken wijzigen met de Java API

Een watermerk wijzigen met de API voor documentbeveiliging (Java):

1. Inclusief projectbestanden.

   Neem client-JAR-bestanden, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project.

2. Maak een API-object voor Document Security Client.

   • Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat.
   • Maak een DocumentSecurityClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.

3. 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.

4. 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.

   OPMERKING

   In dit voorbeeld wordt alleen het kenmerk opacity gewijzigd.

5. Werk het watermerk bij.

   • Werk het watermerk bij door de methode 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.

Watermerken wijzigen met de webservice-API

Wijzig een watermerk met de API voor documentbeveiliging (webservice):

1. 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.

   OPMERKING

   Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.

2. 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:

     • Wijs de gebruikersnaam voor het AEM aan het veld DocumentSecurityServiceClient.ClientCredentials.UserName.UserName toe.
     • Wijs de overeenkomstige wachtwoordwaarde aan het gebied DocumentSecurityServiceClient.ClientCredentials.UserName.Password toe.
     • Wijs de constante waarde HttpClientCredentialType.Basic aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType toe.

   • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly aan het veld BasicHttpBindingSecurity.Security.Mode toe.

3. 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.

4. Stel de kenmerken van het watermerk in.

   • Voor elke watermerkeigenschap die moet worden bijgewerkt, maakt u een afzonderlijk MyMapOf_xsd_string_To_xsd_anyType_Item-object.
   • Stel de hoofdwaarde in door een waarde toe te wijzen aan het MyMapOf_xsd_string_To_xsd_anyType_Item-gegevenslid van het object (bijvoorbeeld WaterBackCmd:OPACITY)).key
   • Stel de waarde in door een waarde toe te wijzen aan het MyMapOf_xsd_string_To_xsd_anyType_Item-gegevenslid van het value-object (bijvoorbeeld .50).
   • Maak een 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.
   • Wijs het MyArrayOf_xsd_anyType-object toe aan het WatermarkSpec-gegevenslid van het object.values

5. 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:

• "Snel starten (MTOM): Een watermerk wijzigen met de webservice-API"

Zoeken naar gebeurtenissen

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:

• Beheerdersgebeurtenissen zijn handelingen die betrekking hebben op een beheerder, zoals het maken van een nieuwe beheerdersaccount.
• Documentgebeurtenissen zijn handelingen die betrekking hebben op een document, zoals het sluiten van een document dat met een beleid is beveiligd.
• Beleidsgebeurtenissen zijn acties die betrekking hebben op een beleid, zoals het maken van een nieuw beleid.
• De gebeurtenissen van de dienst zijn acties met betrekking tot de dienst van het Rights Management, zoals het synchroniseren met de gebruikersfolder.

U kunt zoeken naar specifieke gebeurtenissen met de Rights Management Java API of de webservice-API. Door naar gebeurtenissen te zoeken, kunt u taken uitvoeren, zoals het creëren van een logboekdossier van bepaalde gebeurtenissen.

Overzicht van stappen

Voer de volgende stappen uit om te zoeken naar een Rights Management-gebeurtenis:

1. Inclusief projectbestanden.
2. Maak een Rights Management Client API-object.
3. Geef de gebeurtenis op waarnaar u wilt zoeken.
4. Zoeken naar de 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

Zoeken naar gebeurtenissen met de Java API

U kunt naar gebeurtenissen zoeken met de API voor Rights Managementen (Java):

1. Projectbestanden opnemen

   Neem client-JAR-bestanden, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project.

2. 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.

3. Geef de gebeurtenissen op waarnaar u wilt zoeken

   • Maak een EventManager-object door de methode getEventManager van het object DocumentSecurityClient aan te roepen. Deze methode retourneert een EventManager-object.
   • Maak een EventSearchFilter-object door de constructor ervan aan te roepen.
   • Geef de gebeurtenis op waarnaar moet worden gezocht door de methode setEventCode van het 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.
   OPMERKING

   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.

4. 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:

• "Snel starten (SOAP): Zoeken naar gebeurtenissen met de Java API"

Zoeken naar gebeurtenissen met de webservice-API

U kunt naar gebeurtenissen zoeken met de Rights Management-API (webservice):

1. 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.

   OPMERKING

   Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.

2. 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:

     • Wijs de gebruikersnaam voor het AEM aan het veld DocumentSecurityServiceClient.ClientCredentials.UserName.UserName toe.
     • Wijs de overeenkomstige wachtwoordwaarde aan het gebied DocumentSecurityServiceClient.ClientCredentials.UserName.Password toe.
     • Wijs de constante waarde HttpClientCredentialType.Basic aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType toe.

   • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly aan het veld BasicHttpBindingSecurity.Security.Mode toe.

3. Geef de gebeurtenissen op waarnaar u wilt zoeken

   • Maak een EventSpec-object met de constructor ervan.
   • Geef het begin op van de tijdsperiode waarin de gebeurtenis heeft plaatsgevonden door het 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.
   • Wijs de waarde true toe aan het EventSpec gegevenslid van het object.firstTime.dateSpecified
   • Geef het einde van de tijdsperiode waarin de gebeurtenis heeft plaatsgevonden op door het 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.
   • Wijs de waarde true toe aan het EventSpec gegevenslid van het object.lastTime.dateSpecified
   • Stel de gebeurtenis waarnaar moet worden gezocht in door een tekenreekswaarde toe te wijzen aan het 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
   ALL_EVENTS	999
   USER_CHANGE_PASSWORD_EVENT	1000
   USER_REGISTER_EVENT	1001
   USER_PREREGISTER_EVENT	1002
   USER_ACTIVATE_EVENT	1003
   USER_DEACTIVATE_EVENT	1004
   USER_AUTHENTICATE_EVENT	1005
   USER_AUTHENTICATE_DENY_EVENT	1006
   USER_ACCOUNT_LOCK_EVENT	1007
   USER_DELETE_EVENT	1008
   USER_UPDATE_PROFILE_EVENT	1009
   DOCUMENT_VIEW_EVENT	2000
   DOCUMENT_PRINT_LOW_EVENT	2001
   DOCUMENT_PRINT_HIGH_EVENT	2002
   DOCUMENT_SIGN_EVENT	2003
   DOCUMENT_ADD_ANNOTATION_EVENT	2004
   DOCUMENT_FORM_FILL_EVENT	2005
   DOCUMENT_CLOSE_EVENT	2006
   DOCUMENT_MODIFY_EVENT	2007
   DOCUMENT_CHANGE_SECURITY_HANDLER_EVENT	2008
   DOCUMENT_SWITCH_POLICY_EVENT	2009
   DOCUMENT_REVOKE_EVENT	2010
   $1	2011
   DOCUMENT_SECURE_EVENT	2012
   DOCUMENT_UNKNOWN_CLIENT_EVENT	2013
   DOCUMENT_CHANGE_REVOKE_URL_EVENT	2014
   POLICY_CHANGE_EVENT	3000
   POLICY_ENABLE_EVENT	3001
   POLICY_DISABLE_EVENT	3002
   POLICY_CREATE_EVENT	3003
   POLICY_DELETE_EVENT	3004
   POLICY_CHANGE_OWNER_EVENT	3005
   SERVER_CLIENT_SYNC_EVENT	4000
   SERVER_SYNC_DIR_INFO_EVENT	4001
   SERVER_SYNC_DIR_COMPLETE_EVENT	4002
   SERVER_VERSION_MISMATCH_EVENT	4003
   SERVER_CONFIG_CHANGE_EVENT	4004
   SERVER_ENABLE_OFFLINE_ACCESS_EVENT	4005
   ADMIN_ADD_EVENT	5000
   ADMIN_DELETE_EVENT	5001
   ADMIN_EDIT_EVENT	5002
   ADMIN_ACTIVATE_EVENT	5003
   ADMIN_DEACTIVATE_EVENT	5004
   ERROR_DIRECTORY_SERVICE_EVENT	6000
   CREATED_POLICYSET_EVENT	7000
   DELETED_POLICYSET_EVENT	7001
   MODIFIED_POLICYSET_EVENT	7002

4. 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:

• "Snel starten (MTOM): Zoeken naar gebeurtenissen met de webservice-API"
• "Quick Start (SwaRef): Zoeken naar gebeurtenissen met de webservice-API"

Zie ook

AEM Forms aanroepen met MTOM

AEM Forms aanroepen met SwaRef

Beleid toepassen op Word-documenten

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.

Overzicht van stappen

Voer de volgende stappen uit om een beleid toe te passen op een Word-document:

1. Inclusief projectbestanden.
2. Maak een API-object voor Document Security Client.
3. Hiermee wordt een Word-document opgehaald waarop een beleid wordt toegepast.
4. Pas een bestaand beleid op het document van Word toe.
5. Sla het door het beleid beveiligde Word-document op.

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 de Java API

Een beleid toepassen op een Word-document met behulp van de API voor documentbeveiliging (Java):

1. Inclusief projectbestanden.

   Neem client-JAR-bestanden, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project.

2. Maak een API-object voor Document Security Client.

   • Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat.
   • Maak een DocumentSecurityClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.

3. Hiermee haalt u een Word-document op.

   • Maak een java.io.FileInputStream-object dat het Word-document vertegenwoordigt door de constructor ervan te gebruiken en een tekenreekswaarde door te geven die de locatie van het Word-document aangeeft.
   • Maak een com.adobe.idp.Document-object door de constructor ervan te gebruiken en het object java.io.FileInputStream door te geven.

4. 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:

     • Het com.adobe.idp.Document-object dat het Word-document bevat waarop het beleid wordt toegepast.
     • Een tekenreekswaarde die de naam van het document aangeeft.
     • Een tekenreekswaarde die de naam opgeeft van de beleidsset waartoe het beleid behoort. U kunt een null waarde specificeren die in MyPolicies gebruikte beleidsreeks resulteert.
     • Een tekenreekswaarde die de beleidsnaam opgeeft.
     • Een tekenreekswaarde die de naam vertegenwoordigt van het gebruikersbeheerdomein van de gebruiker die de uitgever van het document is. Deze parameterwaarde is optioneel en kan null zijn (als deze parameter null is, moet de volgende parameterwaarde null zijn).
     • Een tekenreekswaarde die de naam vertegenwoordigt van de canonieke naam van de gebruiker van de gebruikersmanager die de uitgever van het document is. Deze parameterwaarde is optioneel en kan null zijn (als deze parameter null is, moet de vorige parameterwaarde null zijn).
     • A 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.

5. Sla het Word-document op.

   • Roep de methode RMSecureDocumentResult van het object getProtectedDoc aan om het document van Word met beveiligingsbeleid te verkrijgen. Deze methode retourneert een com.adobe.idp.Document-object.
   • Maak een java.io.File-object en zorg dat de bestandsextensie DOC is.
   • Roep de methode 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:

• "Snel starten (SOAP-modus): Een beleid toepassen op een Word-document met de Java API"

Een beleid toepassen op een Word-document met behulp van de webservice-API

Pas een beleid op een document van Word toe door de Veiligheid API van het Document (Webdienst) te gebruiken:

1. 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.

   OPMERKING

   Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.

2. 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:

     • Wijs de gebruikersnaam voor het AEM aan het veld DocumentSecurityServiceClient.ClientCredentials.UserName.UserName toe.
     • Wijs de overeenkomstige wachtwoordwaarde aan het gebied DocumentSecurityServiceClient.ClientCredentials.UserName.Password toe.
     • Wijs de constante waarde HttpClientCredentialType.Basic aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType toe.

   • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly aan het veld BasicHttpBindingSecurity.Security.Mode toe.

3. Hiermee haalt u een Word-document op.

   • Maak een BLOB-object met de constructor ervan. Het object BLOB wordt gebruikt om een Word-document op te slaan waarop een beleid wordt toegepast.
   • Maak een System.IO.FileStream-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het Word-document en de modus waarin het bestand moet worden geopend, vertegenwoordigt.
   • Maak een bytearray waarin de inhoud van het object System.IO.FileStream wordt opgeslagen. Bepaal de grootte van de bytearray door de System.IO.FileStream-eigenschap van het object Length op te halen.
   • Vul de bytearray met streamgegevens door de methode Read van het object System.IO.FileStream aan te roepen. Geef de bytearray, de startpositie en de streamlengte door om te lezen.
   • Vul het BLOB-object door het MTOM-veld toe te wijzen met de inhoud van de bytearray.

4. 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:

   • Het BLOB-object dat het Word-document bevat waarop het beleid wordt toegepast.
   • Een tekenreekswaarde die de naam van het document aangeeft.
   • Een tekenreekswaarde die de naam opgeeft van de beleidsset waartoe het beleid behoort. U kunt een null waarde specificeren die in MyPolicies gebruikte beleidsreeks resulteert.
   • Een tekenreekswaarde die de beleidsnaam opgeeft.
   • Een tekenreekswaarde die de naam vertegenwoordigt van het gebruikersbeheerdomein van de gebruiker die de uitgever van het document is. Deze parameterwaarde is optioneel en kan null zijn (als deze parameter null is, moet de volgende parameterwaarde null zijn).
   • Een tekenreekswaarde die de naam vertegenwoordigt van de canonieke naam van de gebruiker van de gebruikersmanager die de uitgever van het document is. Deze parameterwaarde is optioneel en kan null zijn (als deze parameter null is, moet de vorige parameterwaarde null zijn).
   • Een waarde RMLocale die de waarde van de landinstelling opgeeft (bijvoorbeeld RMLocale.en).
   • Een parameter van de koordoutput die wordt gebruikt om de waarde van beleidsidentificatie op te slaan.
   • Een parameter van de koordoutput die wordt gebruikt om de beleid-beschermde herkenningstekenwaarde op te slaan.
   • Een parameter van de koordoutput die wordt gebruikt om het mime type (bijvoorbeeld, application/doc) op te slaan.

   De methode protectDocument retourneert een BLOB-object dat het document bevat dat door het beleid is beveiligd.

5. Sla het Word-document op.

   • Maak een System.IO.FileStream-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het met een beleid beveiligde Word-document vertegenwoordigt.
   • Maak een bytearray met de gegevensinhoud van het object BLOB dat door de methode protectDocument is geretourneerd. Vul de bytearray met de waarde van het BLOB-gegevenslid van het object MTOM.
   • Maak een System.IO.BinaryWriter-object door de constructor ervan aan te roepen en het object System.IO.FileStream door te geven.
   • Schrijf de inhoud van de bytearray naar een Word-bestand door de methode 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:

• "Snel starten (MTOM): Een beleid toepassen op een Word-document met behulp van de webservice-API"

Beleid verwijderen uit Word-documenten

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.

Overzicht van stappen

Voer de volgende stappen uit om een beleid te verwijderen uit een Word-document dat met een beleid is beveiligd:

1. Projectbestanden opnemen
2. Maak een API-object voor Document Security Client.
3. Hiermee haalt u een Word-document op dat met een beleid is beveiligd.
4. Verwijder het beleid uit het Word-document.
5. De onbeveiligde Word-documenten opslaan

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

Een beleid verwijderen uit een Word-document met de Java API

Verwijder een beleid uit een beleid-beschermd document van Word door de Veiligheid API van het Document (Java) te gebruiken:

1. Projectbestanden opnemen

   Neem client-JAR-bestanden, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project.

2. Een API-object voor documentbeveiliging maken

   • Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat.
   • Maak een RightsManagementClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.

3. Een met beleid beveiligd Word-document ophalen

   • Maak een java.io.FileInputStream-object dat het beleidsbeveiligde Word-document vertegenwoordigt door de constructor ervan te gebruiken en een tekenreekswaarde door te geven die de locatie van het Word-document aangeeft.
   • Maak een com.adobe.idp.Document-object door de constructor ervan te gebruiken en het object java.io.FileInputStream door te geven.

4. Het beleid verwijderen uit het Word-document

   • Maak een DocumentManager-object door de methode getDocumentManager van het object RightsManagementClient aan te roepen.
   • Verwijder een beleid uit het document van Word door de 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.

5. Het onbeveiligde Word-document opslaan

   • Maak een java.io.File-object en zorg dat de bestandsextensie DOC is.
   • Roep de methode 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:

• "Snel starten (SOAP-modus): Een beleid verwijderen uit een Word-document met de Java API"

Een beleid verwijderen uit een Word-document met de webservice-API

Verwijder een beleid uit een beleid-beschermd document van Word door de Veiligheid API van het Document (Webdienst te gebruiken:

1. 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.

   OPMERKING

   Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.

2. 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:

     • Wijs de gebruikersnaam voor het AEM aan het veld RightsManagementServiceClient.ClientCredentials.UserName.UserName toe.
     • Wijs de overeenkomstige wachtwoordwaarde aan het gebied RightsManagementServiceClient.ClientCredentials.UserName.Password toe.
     • Wijs de constante waarde HttpClientCredentialType.Basic aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType toe.

   • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly aan het veld BasicHttpBindingSecurity.Security.Mode toe.

3. Een met beleid beveiligd Word-document ophalen

   • Maak een 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.
   • Maak een System.IO.FileStream-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het Word-document en de modus waarin het bestand moet worden geopend, vertegenwoordigt.
   • Maak een bytearray waarin de inhoud van het object System.IO.FileStream wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschap System.IO.FileStream van het object Length op te halen.
   • Vul de bytearray met streamgegevens door de methode 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.
   • Vul het BLOB-object door het MTOM-veld toe te wijzen met de inhoud van de bytearray.

4. 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.

5. Het onbeveiligde Word-document opslaan

   • Maak een System.IO.FileStream-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het onbeveiligde Word-document vertegenwoordigt.
   • Maak een bytearray met de gegevensinhoud van het object BLOB dat door de methode removePolicySecurity is geretourneerd. Vul de bytearray met de waarde van het veld BLOB van het object MTOM.
   • Maak een 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:

• "Snel starten (MTOM): Een beleid verwijderen uit een Word-document met de webservice-API"

Zie ook

AEM Forms aanroepen met MTOM