Documenten beveiligen met beleid protecting-documents-with-policies

de Steekproeven en de voorbeelden in dit document zijn slechts voor AEM Forms op milieu JEE.

Ongeveer de Dienst van de Veiligheid van het Document

Met de Document Security-service kunnen gebruikers op dynamische wijze instellingen voor vertrouwelijkheid toepassen op Adobe PDF-documenten en de controle houden over de documenten, ongeacht de mate waarin deze worden verspreid.

De dienst van de Veiligheid van het Document verhindert informatie zich voorbij het bereik van de gebruiker te verspreiden door de gebruikers toe te laten om controle over te houden hoe de ontvangers het beleid-beschermde document van de PDF gebruiken. Een gebruiker kan opgeven wie een document mag openen, hoe hij het kan gebruiken en het document na de verspreiding ervan controleren. Een gebruiker kan ook dynamisch de toegang tot een document beheren dat met een beleid is beveiligd en kan de toegang tot het document zelfs dynamisch intrekken.

De service Documentbeveiliging beschermt ook andere bestandstypen, zoals Microsoft Word-bestanden (DOC-bestanden). U kunt de client-API voor documentbeveiliging gebruiken om met deze bestandstypen te werken. De volgende versies worden ondersteund:

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

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

U kunt deze taken uitvoeren met de documentbeveiligingsservice:

NOTE
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Verwijzing van de Diensten voor AEM Forms.

Beleid maken creating-policies

U kunt beleid programmatisch maken met de Java API voor documentbeveiliging of de webservice-API. A beleid is een inzameling van informatie die de montages van de documentveiligheid, erkende gebruikers, en gebruiksrechten omvat. U kunt een willekeurig aantal beleidsregels maken en opslaan met de beveiligingsinstellingen die geschikt zijn voor verschillende situaties en gebruikers.

Het beleid laat u toe om deze taken uit te voeren:

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

Beleid maken met behulp van webservices creating-a-policy-using-web-services

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

       <AuditSettings isTracked="true" />

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

             <NotAfterRelative>P20D</NotAfterRelative>
          </ValidityPeriodRelative>
       </PolicyValidityPeriod>
 </Policy>
NOTE
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Verwijzing van de Diensten voor AEM Forms.

Overzicht van de stappen summary-of-steps

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.

omvat projectdossiers

Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.

De volgende JAR-bestanden moeten worden toegevoegd aan het klassepad van uw project:

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

Voor informatie over de plaats van deze JAR dossiers, zie Inclusief de bibliotheekdossiers van AEM Forms Java.

creeer een voorwerp van de Cliënt API van de Veiligheid van het Document

Voordat u via programmacode een bewerking met de documentbeveiligingsservice kunt uitvoeren, maakt u een clientobject van de documentbeveiligingsservice.

plaats de attributen van het beleid

Stel beleidskenmerken in om een beleid te maken. Een verplicht kenmerk is de beleidsnaam. Beleidsnamen moeten uniek zijn voor elke beleidsset. Een beleidsset is gewoon een verzameling van beleidsmaatregelen. Er kunnen twee beleid met dezelfde naam zijn als het beleid tot afzonderlijke beleidsreeksen behoort. Twee beleid binnen één beleidsset kan echter niet dezelfde beleidsnaam hebben.

Een ander nuttig kenmerk dat moet worden ingesteld, is de geldigheidsperiode. Een geldigheidsperiode is de periode waarin een document dat onder een beleid valt, toegankelijk is voor geautoriseerde ontvangers. Als u dit kenmerk niet instelt, is het beleid altijd geldig.

U kunt een geldigheidsperiode instellen op een van de volgende opties:

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

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

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

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

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

NOTE
Voor informatie over andere attributen die u kunt plaatsen, zie de Policy interfacebeschrijving in de AEM Forms API Verwijzing.

creeer een beleidsingang

Een beleidsingang verbindt hoofden, die groepen en gebruikers zijn, en toestemmingen aan een beleid. Een beleid moet ten minste één beleidslijn hebben. Stel bijvoorbeeld dat u de volgende taken uitvoert:

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

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

registreer het beleid

Een nieuw beleid moet worden geregistreerd alvorens het kan worden gebruikt. Nadat u een beleid hebt geregistreerd, kunt u het gebruiken om documenten te beschermen.

Een beleid maken met de Java API create-a-policy-using-the-java-api

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

  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 ServiceClientFactory -object door te geven.
  3. Stel de kenmerken van het beleid in.

    • Maak een Policy -object door de statische methode InfomodelObjectFactory van het object createPolicy aan te roepen. 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.
    • Geef de beleidsset op 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 dat aan wordt toegevoegd Mijn Beleid beleidsreeks.)
    • 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.

    • Maak een beleidsitem door de statische methode createPolicyEntry van het object InfomodelObjectFactory aan te roepen. Deze methode retourneert een PolicyEntry -object.
    • Geef de beleidsmachtigingen 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 met een beleid beveiligd PDF-document, geeft u Permission.COPY door. (Herhaal deze stap voor elke machtiging die u wilt toevoegen.)
    • Voeg de machtiging aan de beleidsvermelding toe door de methode addPermission van het object PolicyEntry aan te roepen en het object Permission door te geven. (Herhaal deze stap voor elk Permission -object dat u hebt gemaakt).
    • Maak de beleidshoofd door de statische methode createSpecialPrincipal van het object InfomodelObjectFactory aan te roepen. Geef een gegevenslid door dat behoort tot het InfomodelObjectFactory -object dat de principal 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 het hoofd aan de beleidsingang toe door de setPrincipal methode van objecten PolicyEntry aan te roepen en het Principal voorwerp over te gaan.
    • Voeg de beleidsvermelding aan het beleid toe door de methode addPolicyEntry van het object Policy aan te roepen en het object PolicyEntry door te geven.
  5. Registreer het beleid.

    • Maak een PolicyManager -object door de methode DocumentSecurityClient object getPolicyManager aan te roepen.

    • Registreer het beleid door de methode registerPolicy van het object PolicyManager aan te roepen en de volgende waarden door te geven:

      • 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 DocumentSecurityClient -object te maken, geeft u de naam van de beleidsset op wanneer u de methode registerPolicy aanroept. Als u een null waarde voor de beleidsreeks overgaat, wordt het beleid gecreeerd in de beheerders Mijn Beleid beleidsreeks.

    Als u een gebruiker van de Veiligheid van het Document binnen verbindingsmontages gebruikt, dan kunt u de overbelaste registerPolicy methode aanhalen die slechts het beleid goedkeurt. U hoeft dus geen naam voor de beleidsset op te geven. Nochtans, wordt het beleid toegevoegd aan de beleidsreeks genoemd Mijn Beleid. Als u het nieuwe beleid niet aan deze beleidreeks wilt toevoegen, dan specificeer een naam van de beleidsreeks wanneer u de registerPolicy methode aanhaalt.

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

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

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

Beleid maken met de webservice-API create-a-policy-using-the-web-service-api

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

  1. Inclusief projectbestanden.

    Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .

    note note
    NOTE
    Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.
  2. Maak een API-object voor Document Security Client.

    • Maak een DocumentSecurityServiceClient -object met de standaardconstructor.

    • Maak een DocumentSecurityServiceClient.Endpoint.Address -object met de System.ServiceModel.EndpointAddress -constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/RightsManagementService?WSDL .) U hoeft het attribuut lc_version niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)

    • Maak een System.ServiceModel.BasicHttpBinding -object door de waarde van het RightsManagementServiceClient.Endpoint.Binding -veld op te halen. De geretourneerde waarde wordt gecast naar BasicHttpBinding .

    • Stel het veld MessageEncoding van het System.ServiceModel.BasicHttpBinding -object 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 van het AEM aan het veld RightsManagementServiceClient.ClientCredentials.UserName.UserName toe.
      • Wijs de bijbehorende wachtwoordwaarde toe aan het veld RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Wijs de constante waarde HttpClientCredentialType.Basic toe aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly toe aan het veld BasicHttpBindingSecurity.Security.Mode .

  3. Stel de kenmerken van het beleid in.

    • Maak een PolicySpec -object met behulp van de constructor.
    • Stel de naam van het beleid in door een tekenreekswaarde toe te wijzen aan het name -gegevenslid van het PolicySpec -object.
    • Stel de beschrijving van het beleid in door een tekenreekswaarde toe te wijzen aan het description -gegevenslid van het PolicySpec -object.
    • Geef de beleidsset op waartoe het beleid behoort door een tekenreekswaarde toe te wijzen aan het gegevenslid policySetName van het PolicySpec -object. Geef een bestaande naam voor een beleidsset op. (U kunt null voor deze parameterwaarde specificeren die in het beleid dat aan wordt toegevoegd Mijn Beleid.)
    • Stel de offline leaseperiode van het beleid in door een geheel-getalwaarde toe te wijzen aan het gegevenslid offlineLeasePeriod van het PolicySpec -object.
    • Stel het gegevenslid policyXml van het PolicySpec -object 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 ReadLine van het object StreamReader 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 gegevenslid policyXml van het PolicySpec -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 PDF-document.

  5. Registreer het beleid.

    Registreer het beleid door de methode registerPolicy van het object DocumentSecurityServiceClient aan te roepen en de volgende waarden door te geven:

    • Het PolicySpec -object dat het te registreren beleid vertegenwoordigt.
    • Een tekenreekswaarde die staat voor de beleidsset waartoe het beleid behoort. U kunt een null waarde specificeren die in het beleid resulteert dat aan wordt toegevoegd MyPolices beleidsreeks.

    Als u binnen de verbindingsinstellingen een beheerdersaccount voor AEM formulieren gebruikt om het DocumentSecurityClient -object te maken, geeft u de naam van de beleidsset op wanneer u de 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 het nieuwe beleid niet aan deze beleidreeks wilt toevoegen, dan specificeer een naam van de beleidsreeks wanneer u de registerPolicy methode aanhaalt.

    note note
    NOTE
    Wanneer het creëren van een beleid en u specificeert een beleidsreeks, zorg ervoor dat u een bestaande beleidsreeks specificeert. Als u een beleidsset opgeeft die niet bestaat, wordt een uitzondering gegenereerd.

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

  • "Quick Start (MTOM): Creating a policy using the web service API"
  • "Quick Start (SwaRef): Creating a policy using the web service API"

Beleid wijzigen modifying-policies

U kunt een bestaand beleid wijzigen met de Java API voor documentbeveiliging of de webservice-API. Om een bestaand beleid te veranderen, wint u het terug, wijzigt het, en werkt dan het beleid op de server bij. Stel dat u een bestaand beleid ophaalt en de geldigheidsperiode ervan verlengt. Voordat de wijziging van kracht wordt, moet u het beleid bijwerken.

U kunt een beleid wijzigen wanneer de bedrijfsvereisten veranderen en het beleid niet meer op deze vereisten wijst. In plaats van een beleid te maken, kunt u gewoon een bestaand beleid bijwerken.

Als u beleidskenmerken wilt wijzigen met behulp van een webservice (bijvoorbeeld met Java-proxyklassen die zijn gemaakt met JAX-WS), moet u ervoor zorgen dat het beleid is geregistreerd bij de Document Security-service. Vervolgens kunt u naar het bestaande beleid verwijzen met de methode PolicySpec.getPolicyXml en de beleidskenmerken wijzigen met de toepasselijke methoden. U kunt bijvoorbeeld de offline leaseperiode wijzigen door de methode PolicySpec.setOfflineLeasePeriod aan te roepen.

NOTE
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Verwijzing van de Diensten voor AEM Forms.

Overzicht van de stappen summary_of_steps-1

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.

omvat projectdossiers

Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.

creeer een voorwerp van de Cliënt API van de Veiligheid van het Document

Voordat u via programmacode een bewerking voor documentbeveiliging kunt uitvoeren, moet u een client-object voor documentbeveiliging maken. Maak een RightsManagementClient -object als u de Java API gebruikt. Als u de webservice-API voor documentbeveiliging gebruikt, maakt u een RightsManagementServiceService -object.

wint een bestaand beleid terug

Haal een bestaand beleid op om het te wijzigen. Om een beleid terug te winnen, specificeer de beleidsnaam en het beleid dat wordt geplaatst waartot het beleid behoort. Als u een null waarde voor de naam van de beleidsreeks specificeert, wordt het beleid teruggewonnen van Mijn 2} beleidsreeks van Beleid.

plaats de attributen van het beleid

Als u een beleid wilt wijzigen, wijzigt u de waarde van beleidskenmerken. Het enige beleidskenmerk dat u niet kunt wijzigen, is het naamkenmerk. Bijvoorbeeld, om de off-line huurperiode van het beleid te veranderen, kunt u de waarde van de off-line de huurperiode van het beleid attributen wijzigen.

Wanneer u de offline leaseperiode van een beleid wijzigt met behulp van een webservice, wordt het veld offlineLeasePeriod in de interface van PolicySpec genegeerd. Als u de offline leaseperiode wilt bijwerken, wijzigt u het element OfflineLeasePeriod in het PDF XML-document. Verwijs vervolgens naar het bijgewerkte PDRL XML-document met het policyXML -gegevenslid van de interface PolicySpec .

NOTE
Voor informatie over andere attributen die u kunt plaatsen, zie de Policy interfacebeschrijving in de AEM Forms API Verwijzing.

werk het beleid bij

Voordat de wijzigingen die u in een beleid aanbrengt, worden doorgevoerd, moet u het beleid bijwerken met de documentbeveiligingsservice. Wijzigingen in beleid dat documenten beveiligt, worden de volgende keer dat het document met beveiligingsbeleid wordt gesynchroniseerd met de documentbeveiligingsservice bijgewerkt.

Bestaand beleid wijzigen met de Java API modify-existing-policies-using-the-java-api

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

  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 ServiceClientFactory -object door te geven.
  3. Een bestaand beleid ophalen.

    • Maak een PolicyManager -object door de methode RightsManagementClient object getPolicyManager aan te roepen.

    • Maak een Policy -object dat het beleid vertegenwoordigt dat moet worden bijgewerkt door de methode van het PolicyManager object getPolicy aan te roepen en de volgende waarden door te geven."

      • Een tekenreekswaarde die staat voor de naam van de beleidsset waartoe het beleid behoort. U kunt null opgeven die als resultaat heeft dat de MyPolicies -beleidsset wordt gebruikt.
      • 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 de methode updatePolicy van het PolicyManager -object aan te roepen. Geef het Policy -object door dat het beleid vertegenwoordigt dat moet worden bijgewerkt.

de voorbeelden van de Code

Zie Snel starten (modus SOAP): Een beleid wijzigen met de Java API-sectie voor codevoorbeelden met de documentbeveiligingsservice.

Bestaand beleid wijzigen met de webservice-API modify-existing-policies-using-the-web-service-api

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

  1. Inclusief projectbestanden.

    Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .

    note note
    NOTE
    Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.
  2. Maak een API-object voor Document Security Client.

    • Maak een RightsManagementServiceClient -object met de standaardconstructor.

    • Maak een RightsManagementServiceClient.Endpoint.Address -object met de System.ServiceModel.EndpointAddress -constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/RightsManagementService?WSDL .) U hoeft het attribuut lc_version niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)

    • Maak een System.ServiceModel.BasicHttpBinding -object door de waarde van het RightsManagementServiceClient.Endpoint.Binding -veld op te halen. De geretourneerde waarde wordt gecast naar BasicHttpBinding .

    • Stel het veld MessageEncoding van het System.ServiceModel.BasicHttpBinding -object 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 van het AEM aan het veld RightsManagementServiceClient.ClientCredentials.UserName.UserName toe.
      • Wijs de bijbehorende wachtwoordwaarde toe aan het veld RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Wijs de constante waarde HttpClientCredentialType.Basic toe aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly toe aan het veld BasicHttpBindingSecurity.Security.Mode .

  3. Een bestaand beleid ophalen.

    Maak een PolicySpec -object dat het beleid vertegenwoordigt dat moet worden gewijzigd door de methode RightsManagementServiceClient object getPolicy aan te roepen en de volgende waarden door te geven:

    • Een tekenreekswaarde die de naam van de beleidsset opgeeft waartoe het beleid behoort. U kunt null opgeven die als resultaat heeft dat de MyPolicies -beleidsset wordt gebruikt.
    • Een tekenreekswaarde die de naam van het beleid opgeeft.
  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 methode updatePolicyFromSDK van het object RightsManagementServiceClient aan te roepen en het object PolicySpec door te geven dat het bij te werken beleid vertegenwoordigt.

de voorbeelden van de Code

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

  • "Quick Start (MTOM): Modifying a policy using the web service API"
  • "Quick Start (SwaRef): Modifying a policy using the web service API"

Beleid verwijderen deleting-policies

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

NOTE
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Verwijzing van de Diensten voor AEM Forms.

Overzicht van de stappen summary_of_steps-2

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.

omvat projectdossiers

Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.

creeer een voorwerp van de Cliënt API van de Veiligheid van het Document

Voordat u programmatisch een Document Security-servicebewerking kunt uitvoeren, moet u een Document Security-service-clientobject maken. Maak een RightsManagementClient -object als u de Java API gebruikt. Als u de webservice-API voor documentbeveiliging gebruikt, maakt u een RightsManagementServiceService -object.

Schrap het beleid

Als u een beleid wilt verwijderen, geeft u het beleid op dat u wilt verwijderen en de beleidsset waartoe het beleid behoort. De gebruiker van wie de montages worden gebruikt om AEM Forms aan te halen moet toestemming hebben om het beleid te schrappen; anders komt een uitzondering voor. En als u probeert een beleid te verwijderen dat niet bestaat, treedt een uitzondering op.

Beleid verwijderen met de Java API delete-policies-using-the-java-api

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

  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 ServiceClientFactory -object door te geven.
  3. Verwijder het beleid.

    • Maak een PolicyManager -object door de methode RightsManagementClient object getPolicyManager 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 opgeven die als resultaat heeft dat de MyPolicies -beleidsset wordt gebruikt.
      • Een tekenreekswaarde die de naam aangeeft van het beleid dat moet worden verwijderd.

de voorbeelden van de Code

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

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

Beleid verwijderen met de webservice-API delete-policies-using-the-web-service-api

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

  1. Inclusief projectbestanden.

    Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .

    note note
    NOTE
    Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.
  2. Maak een API-object voor Document Security Client.

    • Maak een RightsManagementServiceClient -object met de standaardconstructor.

    • Maak een RightsManagementServiceClient.Endpoint.Address -object met de System.ServiceModel.EndpointAddress -constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/RightsManagementService?WSDL .) U hoeft het attribuut lc_version niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)

    • Maak een System.ServiceModel.BasicHttpBinding -object door de waarde van het RightsManagementServiceClient.Endpoint.Binding -veld op te halen. De geretourneerde waarde wordt gecast naar BasicHttpBinding .

    • Stel het veld MessageEncoding van het System.ServiceModel.BasicHttpBinding -object 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 van het AEM aan het veld RightsManagementServiceClient.ClientCredentials.UserName.UserName toe.
      • Wijs de bijbehorende wachtwoordwaarde toe aan het veld RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Wijs de constante waarde HttpClientCredentialType.Basic toe aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly toe aan het veld BasicHttpBindingSecurity.Security.Mode .

  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 opgeven die als resultaat heeft dat de MyPolicies -beleidsset wordt gebruikt.
    • Een tekenreekswaarde die de naam aangeeft van het beleid dat moet worden verwijderd.

de voorbeelden van de Code

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

  • "Quick Start (MTOM): Deleting a policy using the web service API"
  • "Quick Start (SwaRef): Deleting a policy using the web service API"

Beleid toepassen op PDF-documenten applying-policies-to-pdf-documents

U kunt een beleid op een document van de PDF toepassen om het document te beveiligen. Door een beleid op een document van de PDF toe te passen, beperkt u toegang tot het document. U kunt geen beleid op een document toepassen als het document reeds met een beleid wordt beveiligd.

Terwijl het document is geopend, kunt u ook de toegang tot Acrobat- en Adobe Reader-functies beperken, zoals de mogelijkheid om tekst af te drukken en te kopiëren, wijzigingen aan te brengen en handtekeningen en opmerkingen aan een document toe te voegen. Bovendien kunt u een met een beleid beveiligd PDF-document intrekken wanneer u niet langer wilt dat gebruikers het document openen.

U kunt het gebruik van een document dat met een beleid is beveiligd controleren nadat u het hebt verspreid. Dat wil zeggen dat u kunt zien hoe het document wordt gebruikt en wie het gebruikt. U kunt bijvoorbeeld zien wanneer iemand het document heeft geopend.

NOTE
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Verwijzing van de Diensten voor AEM Forms.

Overzicht van de stappen summary_of_steps-3

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 op het document van de PDF toe.
  5. Sla het met beleid beveiligde PDF-document op.

omvat projectdossiers

Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.

creeer een Cliënt APIobject van de Veiligheid van het Document

Voordat u via programmacode een bewerking met de documentbeveiligingsservice kunt uitvoeren, maakt u een clientobject van de documentbeveiligingsservice. Maak een DocumentSecurityClient -object als u de Java API gebruikt. Als u de webservice-API voor documentbeveiliging gebruikt, maakt u een DocumentSecurityServiceService -object.

wint een document van PDF terug

U kunt een PDF-document ophalen om een beleid toe te passen. Nadat u een beleid op het document van de PDF toepast, worden de gebruikers beperkt wanneer het gebruiken van het document. Als het beleid bijvoorbeeld niet toestaat dat het document offline wordt geopend, moeten gebruikers online zijn om het document te openen.

pas een bestaand beleid op het document van PDF toe

Om een beleid op een document van de PDF toe te passen, verwijs een bestaand beleid en specificeer welk beleid het beleid tot behoort. De gebruiker die de verbindingseigenschappen instelt, moet toegang hebben tot het opgegeven beleid. Als dat niet het geval is, treedt een uitzondering op.

sparen het document van de PDF

Nadat de dienst van de Veiligheid van het Document een beleid op een document van de PDF toepast, kunt u het beleid-beschermde document van de PDF als PDF dossier bewaren.

zie ook

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Toegang tot documenten intrekken

Een beleid toepassen op een PDF-document met de Java API apply-a-policy-to-a-pdf-document-using-the-java-api

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

  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 ServiceClientFactory -object door te geven.
  3. Een PDF-document ophalen.

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

    • Maak een DocumentManager -object door de methode RightsManagementClient object getDocumentManager aan te roepen.

    • Pas een beleid toe op het document PDF door de methode protectDocument van het object DocumentManager aan te roepen en de volgende waarden door te geven:

      • Het com.adobe.idp.Document -object dat het PDF-document bevat waarop het beleid wordt toegepast.
      • Een tekenreekswaarde die de naam van het document aangeeft.
      • Een tekenreekswaarde die de naam opgeeft van de beleidsset waartoe het beleid behoort. U kunt een null -waarde opgeven die resulteert in het gebruik van de MyPolicies -beleidsset.
      • Een tekenreekswaarde die de beleidsnaam opgeeft.
      • Een tekenreekswaarde die de naam vertegenwoordigt van het gebruikersbeheerdomein van de gebruiker die de uitgever van het document is. Deze parameterwaarde is optioneel en kan null zijn (als deze parameter null is, moet de volgende parameterwaarde null zijn).
      • Een tekenreekswaarde die de naam vertegenwoordigt van de canonieke naam van de gebruiker van de gebruikersmanager die de uitgever van het document is. Deze parameterwaarde is optioneel en kan null zijn (als deze parameter null is, moet de vorige parameterwaarde null zijn).
      • A com.adobe.livecycle.rightsmanagement.Locale die de landinstelling vertegenwoordigt die wordt gebruikt voor het selecteren van de sjabloon MS Office. Deze parameterwaarde is optioneel en wordt niet gebruikt voor PDF-documenten. Geef null op om een PDF-document te beveiligen.

      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 getProtectedDoc van het RMSecureDocumentResult -object aan om het met 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 copyToFile van het object com.adobe.idp.Document aan om de inhoud van het object Document naar het bestand te kopiëren (gebruik het object Document dat door de methode getProtectedDoc is geretourneerd).

de voorbeelden van de Code

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

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

zie ook

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Een beleid toepassen op een PDF-document met de webservice-API apply-a-policy-to-a-pdf-document-using-the-web-service-api

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

  1. Inclusief projectbestanden.

    Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .

    note note
    NOTE
    Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.
  2. Maak een API-object voor Document Security Client.

    • Maak een RightsManagementServiceClient -object met de standaardconstructor.

    • Maak een RightsManagementServiceClient.Endpoint.Address -object met de System.ServiceModel.EndpointAddress -constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de Forms-service (bijvoorbeeld http://localhost:8080/soap/services/RightsManagementService?WSDL .) U hoeft het attribuut lc_version niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)

    • Maak een System.ServiceModel.BasicHttpBinding -object door de waarde van het RightsManagementServiceClient.Endpoint.Binding -veld op te halen. De geretourneerde waarde wordt gecast naar BasicHttpBinding .

    • Stel het veld MessageEncoding van het System.ServiceModel.BasicHttpBinding -object 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 van het AEM aan het veld RightsManagementServiceClient.ClientCredentials.UserName.UserName toe.
      • Wijs de bijbehorende wachtwoordwaarde toe aan het veld RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Wijs de constante waarde HttpClientCredentialType.Basic toe aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly toe aan het veld BasicHttpBindingSecurity.Security.Mode .

  3. Een PDF-document ophalen.

    • Maak een BLOB -object met behulp van de constructor. Het BLOB -object wordt gebruikt om een PDF-document op te slaan waarop een beleid wordt toegepast.
    • Maak een System.IO.FileStream -object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het PDF-document en de modus waarin het bestand moet worden geopend, vertegenwoordigt.
    • Maak een bytearray waarin de inhoud van het object System.IO.FileStream wordt opgeslagen. Bepaal de grootte van de bytearray door de eigenschap Length van het object System.IO.FileStream 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 ervan toe te wijzen met de inhoud van de bytearray.
  4. Pas een bestaand beleid op het document van de PDF toe.

    Pas een beleid toe op het document PDF door de methode protectDocument van het object RightsManagementServiceClient aan te roepen en de volgende waarden door te geven:

    • Het BLOB -object dat het PDF-document bevat waarop het beleid wordt toegepast.
    • Een tekenreekswaarde die de naam van het document aangeeft.
    • Een tekenreekswaarde die de naam opgeeft van de beleidsset waartoe het beleid behoort. U kunt een null -waarde opgeven die resulteert in het gebruik van de MyPolicies -beleidsset.
    • Een tekenreekswaarde die de beleidsnaam opgeeft.
    • Een tekenreekswaarde die de naam vertegenwoordigt van het gebruikersbeheerdomein van de gebruiker die de uitgever van het document is. Deze parameterwaarde is optioneel en kan null zijn (als deze parameter null is, moet de volgende parameterwaarde null zijn).
    • Een tekenreekswaarde die de naam vertegenwoordigt van de canonieke naam van de gebruiker van de gebruikersmanager die de uitgever van het document is. Deze parameterwaarde is optioneel en kan null zijn (als deze parameter null is, moet de vorige parameterwaarde null zijn).
    • Een RMLocale -waarde die de waarde van de landinstelling opgeeft (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 waarin de gegevensinhoud wordt opgeslagen van het object BLOB dat door de methode protectDocument is geretourneerd. Vul de bytearray met de waarde van het gegevenslid MTOM van het object BLOB .
    • Maak een System.IO.BinaryWriter -object door de constructor ervan aan te roepen en het System.IO.FileStream -object 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.

de voorbeelden van de Code

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

  • "Snel starten (MTOM): beleid toepassen op een PDF-document met behulp van de webservice-API"
  • "Quick Start (SwaRef): Applying a policy to a PDF document using the web service API "

Beleid verwijderen uit PDF-documenten removing-policies-from-pdf-documents

U kunt een beleid verwijderen uit een document dat met een beleid is beveiligd om de beveiliging van het document te verwijderen. Dat wil zeggen, als u niet langer wilt dat het document wordt beschermd door een beleid. Als u een beleid-beschermd document met een nieuwer beleid wilt bijwerken, dan in plaats van het beleid te verwijderen en het bijgewerkte beleid toe te voegen, is het efficiënter om het beleid te schakelen.

NOTE
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Verwijzing van de Diensten voor AEM Forms.

Overzicht van de stappen summary_of_steps-4

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

  1. Projectbestanden opnemen
  2. Maak een API-object voor Document Security Client.
  3. Hiermee wordt een met beleid beveiligd PDF-document opgehaald.
  4. Verwijder het beleid uit het document van de PDF.
  5. Sla het onbeveiligde PDF-document op.

omvat projectdossiers

Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.

creeer een voorwerp van de Cliënt API van de Veiligheid van het Document

Voordat u via programmacode een bewerking met de documentbeveiligingsservice kunt uitvoeren, maakt u een clientobject van de documentbeveiligingsservice.

wint een beleid-beschermd document van PDF terug

U kunt een met een beleid beveiligd PDF-document ophalen om een beleid te verwijderen. Als u probeert om een beleid uit een document te verwijderen van de PDF dat niet door een beleid wordt beschermd, zult u een uitzondering veroorzaken.

verwijder het beleid uit het document van PDF

U kunt een beleid uit een beleid-beschermd document van de PDF verwijderen op voorwaarde dat een beheerder in de verbindingsmontages wordt gespecificeerd. Als dat niet het geval is, moet het beleid dat wordt gebruikt om een document te beveiligen de toestemming SWITCH_POLICY bevatten om een beleid uit een document van de PDF te verwijderen. De gebruiker die is opgegeven in de AEM Forms-verbindingsinstellingen moet ook over deze machtiging beschikken. Anders wordt een uitzondering gegenereerd.

sparen het onbeveiligde document van PDF

Nadat de documentbeveiligingsservice een beleid uit een PDF-document heeft verwijderd, kunt u het onbeveiligde PDF-document opslaan als een PDF-bestand.

zie ook

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Beleid toepassen op PDF-documenten

Een beleid verwijderen uit een PDF-document met de Java API remove-a-policy-from-a-pdf-document-using-the-java-api

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

  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 ServiceClientFactory -object door te geven.
  3. Hiermee wordt een met beleid beveiligd PDF-document opgehaald.

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

    • Maak een DocumentManager -object door de methode DocumentSecurityClient object getDocumentManager aan te roepen.
    • Verwijder een beleid uit het PDF-document door de methode removeSecurity van het DocumentManager -object aan te roepen en het com.adobe.idp.Document -object 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 copyToFile van het object Document aan om de inhoud van het object Document naar het bestand te kopiëren (gebruik het object Document dat door de methode removeSecurity is geretourneerd).

de voorbeelden van de Code

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

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

Een beleid verwijderen met de webservice-API remove-a-policy-using-the-web-service-api

Verwijder een beleid uit een beleid-beschermd document van de PDF gebruikend de Veiligheid API van het Document (Webdienst):

  1. Inclusief projectbestanden.

    Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .

    note note
    NOTE
    Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.
  2. Maak een API-object voor Document Security Client.

    • Maak een DocumentSecurityServiceClient -object met de standaardconstructor.

    • Maak een DocumentSecurityServiceClient.Endpoint.Address -object met de System.ServiceModel.EndpointAddress -constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/RightsManagementService?WSDL .) U hoeft het attribuut lc_version niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)

    • Maak een System.ServiceModel.BasicHttpBinding -object door de waarde van het DocumentSecurityServiceClient.Endpoint.Binding -veld op te halen. De geretourneerde waarde wordt gecast naar BasicHttpBinding .

    • Stel het veld MessageEncoding van het System.ServiceModel.BasicHttpBinding -object 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 van het AEM aan het veld DocumentSecurityServiceClient.ClientCredentials.UserName.UserName toe.
      • Wijs de bijbehorende wachtwoordwaarde toe aan het veld DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • Wijs de constante waarde HttpClientCredentialType.Basic toe aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly toe aan het veld BasicHttpBindingSecurity.Security.Mode .

  3. Hiermee wordt een met beleid beveiligd PDF-document opgehaald.

    • Maak een BLOB -object met behulp van de constructor. Het BLOB -object wordt gebruikt om het met een beleid beveiligde PDF-document op te slaan waaruit het beleid wordt verwijderd.
    • Maak een System.IO.FileStream -object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het PDF-document en de modus waarin het bestand moet worden geopend, vertegenwoordigt.
    • Maak een bytearray waarin de inhoud van het object System.IO.FileStream wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschap Length van het object System.IO.FileStream 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 ervan toe te wijzen met de inhoud van de bytearray.
  4. Verwijder het beleid uit het document van de PDF.

    Verwijder het beleid uit het document PDF door de methode removePolicySecurity van het object DocumentSecurityServiceClient aan te roepen en het object BLOB door te geven dat het document met beveiligde PDF 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 waarin de gegevensinhoud wordt opgeslagen van het object BLOB dat door de methode removePolicySecurity is geretourneerd. Vul de bytearray met de waarde van het veld MTOM van het object BLOB .
    • Maak een System.IO.BinaryWriter -object door de constructor ervan aan te roepen en het System.IO.FileStream -object door te geven.

de voorbeelden van de Code

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

  • "Quick Start (MTOM): Remoting a policy from a PDF document using the web service API "
  • "Quick Start (SwaRef): Removing a policy from a PDF document using the web service API"

zie ook

AEM Forms aanroepen met MTOM

AEM Forms aanroepen met SwaRef

Toegang tot documenten intrekken revoking-access-to-documents

U kunt de toegang tot een met een beleid beveiligd PDF-document intrekken, waardoor alle kopieën van het document niet toegankelijk zijn voor gebruikers. Wanneer een gebruiker een ingetrokken PDF-document probeert te openen, wordt deze doorgestuurd naar een opgegeven URL waar een gereviseerd document kan worden weergegeven. De URL waarnaar de gebruiker is omgeleid, moet via programmacode worden opgegeven. Wanneer u de toegang tot een document intrekt, wordt de wijziging van kracht wanneer de gebruiker opnieuw synchroniseert met de documentbeveiligingsservice door het document dat met een beleid is beveiligd online te openen.

De mogelijkheid om de toegang tot een document in te trekken biedt extra beveiliging. Stel dat er een nieuwere versie van een document beschikbaar is en dat u niet langer wilt dat iemand de verouderde versie bekijkt. In dit geval kan de toegang tot het oudere document worden ingetrokken en kan niemand het document bekijken tenzij de toegang wordt hersteld.

NOTE
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Verwijzing van de Diensten voor AEM Forms.

Overzicht van de stappen summary_of_steps-5

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

  1. Inclusief projectbestanden.
  2. Maak een API-object voor Document Security Client.
  3. Hiermee wordt een met beleid beveiligd PDF-document opgehaald.
  4. Intrekken van het document dat met een beleid is beveiligd.

omvat projectdossiers

Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.

creeer een voorwerp van de Cliënt API van de Veiligheid van het Document

Voordat u programmatisch een Document Security-servicebewerking kunt uitvoeren, moet u een Document Security-service-clientobject maken.

wint een beleid-beschermd document van PDF terug

Haal een document met een door het beleid beschermde PDF op om het in te trekken. U kunt een document dat al is ingetrokken of dat niet door een beleid beveiligd is, niet intrekken.

Als u de waarde van de vergunningsidentificatie van het beleid-beschermde document kent, dan is het niet noodzakelijk om het beleid-beschermde document van de PDF terug te winnen. In de meeste gevallen moet u echter het PDF-document ophalen om de waarde van de licentie-id op te halen.

trekt het beleid-beschermde document in

Als u een document wilt intrekken dat met een beleid is beveiligd, geeft u de licentie-id op van het document dat met een beleid is beveiligd. Daarnaast kunt u de URL opgeven van een document dat de gebruiker kan bekijken wanneer hij of zij probeert het ingetrokken document te openen. Dat wil zeggen dat een verouderd document wordt ingetrokken. Wanneer een gebruiker het ingetrokken document probeert te openen, wordt een bijgewerkt document weergegeven in plaats van het ingetrokken document.

NOTE
Als u een document probeert in te trekken dat al is ingetrokken, wordt een uitzondering gegenereerd.

zie ook

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Beleid toepassen op PDF-documenten

Toegang tot ingetrokken documenten opnieuw instellen

Toegang tot documenten intrekken met de Java API revoke-access-to-documents-using-the-java-api

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

  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 ServiceClientFactory -object 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 java.io.FileInputStream -object door te geven.
  4. Intrekken van het document dat met een beleid is beveiligd

    • Maak een DocumentManager -object door de methode DocumentSecurityClient object getDocumentManager aan te roepen.

    • Haal de waarde van de licentie-id van het document dat met een beleid is beveiligd, op door de methode getLicenseId van het object DocumentManager 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 DocumentSecurityClient object getLicenseManager aan te roepen.

    • Intrekken van het document dat met een beleid is beveiligd door de methode revokeLicense van het object LicenseManager aan te roepen en de volgende waarden door te geven:

      • Een tekenreekswaarde die de waarde van de licentie-id van het document met beleidsbeveiliging opgeeft (geef de geretourneerde waarde van de methode getLicenseId van het object DocumentManager op).
      • Een statisch gegevenslid van de interface License dat de reden opgeeft 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 naar een andere URL wilt omleiden, kunt u null doorgeven.

de voorbeelden van de Code

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

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

Toegang tot documenten intrekken met de webservice-API revoke-access-to-documents-using-the-web-service-api

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

  1. Projectbestanden opnemen

    Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .

    note note
    NOTE
    Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.
  2. Een API-object voor documentbeveiliging maken

    • Maak een DocumentSecurityServiceClient -object met de standaardconstructor.

    • Maak een DocumentSecurityServiceClient.Endpoint.Address -object met de System.ServiceModel.EndpointAddress -constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/RightsManagementService?WSDL .) U hoeft het attribuut lc_version niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)

    • Maak een System.ServiceModel.BasicHttpBinding -object door de waarde van het DocumentSecurityServiceClient.Endpoint.Binding -veld op te halen. De geretourneerde waarde wordt gecast naar BasicHttpBinding .

    • Stel het veld MessageEncoding van het System.ServiceModel.BasicHttpBinding -object 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 van het AEM aan het veld DocumentSecurityServiceClient.ClientCredentials.UserName.UserName toe.
      • Wijs de bijbehorende wachtwoordwaarde toe aan het veld DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • Wijs de constante waarde HttpClientCredentialType.Basic toe aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly toe aan het veld BasicHttpBindingSecurity.Security.Mode .

  3. Een met beleid beveiligd PDF-document ophalen

    • Maak een BLOB -object met behulp van de constructor. Het BLOB -object wordt gebruikt om een met een beleid beveiligd PDF-document op te slaan dat wordt ingetrokken.
    • Maak een System.IO.FileStream -object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie vertegenwoordigt van het PDF-document dat met een beleid is beveiligd en de modus waarin het bestand moet worden geopend.
    • Maak een bytearray waarin de inhoud van het object System.IO.FileStream wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschap Length van het object System.IO.FileStream 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 ervan 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 met een beleid is beveiligd, op door de methode getLicenseID van het object DocumentSecurityServiceClient aan te roepen en het object BLOB door te geven dat het document vertegenwoordigt dat met een beleid is beveiligd. Deze methode retourneert een tekenreekswaarde die de licentie-id vertegenwoordigt.

    • Intrekken van het document dat met een beleid is beveiligd door de methode revokeLicense van het object DocumentSecurityServiceClient aan te roepen en de volgende waarden door te geven:

      • Een tekenreekswaarde die de waarde van de licentie-id van het document met beleidsbeveiliging opgeeft (geef de geretourneerde waarde van de methode getLicenseId van het object DocumentSecurityServiceService op).
      • Een statisch gegevenslid van de opsomming Reason 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 naar een andere URL wilt omleiden, kunt u null doorgeven.

de voorbeelden van de Code

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

  • "Quick Start (MTOM): Revoking a document using the web service API"
  • "Quick Start (SwaRef): Revoking a document using the web service API"

zie ook

Beleid verwijderen uit Word-documenten

AEM Forms aanroepen met MTOM

AEM Forms aanroepen met SwaRef

Toegang tot ingetrokken documenten opnieuw instellen reinstating-access-to-revoked-documents

U kunt de toegang tot een ingetrokken PDF-document opnieuw instellen, zodat alle exemplaren van het ingetrokken document toegankelijk zijn voor gebruikers. Wanneer een gebruiker een hersteld document opent dat werd ingetrokken, kan de gebruiker het document bekijken.

NOTE
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Verwijzing van de Diensten voor AEM Forms.

Overzicht van de stappen summary_of_steps-6

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 licentiecode van het ingetrokken PDF-document op.
  4. Open het ingetrokken PDF-document opnieuw.

omvat projectdossiers

Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.

creeer een voorwerp van de Cliënt API van de Veiligheid van het Document

Voordat u programmatisch een Document Security-servicebewerking kunt uitvoeren, moet u een Document Security-service-clientobject maken. Maak een DocumentSecurityClient -object als u de Java API gebruikt. Als u de webservice-API voor documentbeveiliging gebruikt, maakt u een DocumentSecurityServiceService -object.

wint het vergunningsherkenningsteken van het ingetrokken document van PDF terug

Haal de licentie-id van het ingetrokken PDF-document op om een ingetrokken PDF-document opnieuw in te voeren. Nadat u de waarde van de licentie-id hebt gekregen, kunt u een ingetrokken document opnieuw installeren. Als u probeert een document opnieuw in te voegen dat niet is ingetrokken, veroorzaakt u een uitzondering.

herstelt toegang tot het ingetrokken document van PDF

Als u de toegang tot een ingetrokken PDF-document wilt herstellen, moet u de licentie-id van het ingetrokken document opgeven. Als u probeert toegang te herstellen tot een PDF-document dat niet is ingetrokken, veroorzaakt u een uitzondering.

zie ook

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Beleid toepassen op PDF-documenten

Toegang tot documenten intrekken

Toegang tot ingetrokken documenten opnieuw instellen met de Java API reinstate-access-to-revoked-documents-using-the-java-api

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

  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 ServiceClientFactory -object door te geven.
  3. Haal de licentiecode van het ingetrokken PDF-document op.

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

    • Maak een LicenseManager -object door de methode DocumentSecurityClient object getLicenseManager aan te roepen.
    • Herstel de toegang tot het ingetrokken PDF-document door de methode unrevokeLicense van het LicenseManager -object aan te roepen en de waarde van de licentie-id van het ingetrokken document door te geven.

de voorbeelden van de Code

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

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

Toegang tot ingetrokken documenten opnieuw instellen met de webservice-API reinstate-access-to-revoked-documents-using-the-web-service-api

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

  1. Inclusief projectbestanden.

    Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .

    note note
    NOTE
    Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.
  2. Maak een API-object voor Document Security Client.

    • Maak een DocumentSecurityServiceClient -object met de standaardconstructor.

    • Maak een DocumentSecurityServiceClient.Endpoint.Address -object met de System.ServiceModel.EndpointAddress -constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/RightsManagementService?WSDL .) U hoeft het attribuut lc_version niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)

    • Maak een System.ServiceModel.BasicHttpBinding -object door de waarde van het DocumentSecurityServiceClient.Endpoint.Binding -veld op te halen. De geretourneerde waarde wordt gecast naar BasicHttpBinding .

    • Stel het veld MessageEncoding van het System.ServiceModel.BasicHttpBinding -object 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 van het AEM aan het veld DocumentSecurityServiceClient.ClientCredentials.UserName.UserName toe.
      • Wijs de bijbehorende wachtwoordwaarde toe aan het veld DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • Wijs de constante waarde HttpClientCredentialType.Basic toe aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly toe aan het veld BasicHttpBindingSecurity.Security.Mode .

  3. Haal de licentiecode van het ingetrokken PDF-document op.

    • Maak een BLOB -object met behulp van de constructor. Het BLOB -object wordt gebruikt om een ingetrokken PDF-document op te slaan waartoe toegang wordt hersteld.
    • Maak een System.IO.FileStream -object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het ingetrokken PDF-document en de modus waarin het bestand moet worden geopend, vertegenwoordigt.
    • Maak een bytearray waarin de inhoud van het object System.IO.FileStream wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschap Length van het object System.IO.FileStream 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 ervan toe te wijzen met de inhoud van de bytearray.
  4. Open het ingetrokken PDF-document opnieuw.

    • Haal de waarde van de licentie-id van het ingetrokken document op door de methode getLicenseID van het object DocumentSecurityServiceClient 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 licentie-id-waarde van het ingetrokken PDF-document opgeeft (geef de geretourneerde waarde van de methode DocumentSecurityServiceClient van het object getLicenseId door).

de voorbeelden van de Code

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

  • "Snel starten (MTOM): Toegang tot een ingetrokken document opnieuw instellen met de webservice-API"
  • "Quick Start (SwaRef): Reinsting access to a revoked document using the web service API"

zie ook

AEM Forms aanroepen met MTOM

AEM Forms aanroepen met SwaRef

Met beleid beveiligde PDF-documenten controleren inspecting-policy-protected-pdf-documents

U kunt de API voor documentbeveiligingsservice (Java en webservice) gebruiken om met beleid beveiligde PDF-documenten te inspecteren. Wanneer u documenten met door een beleid beveiligde PDF controleert, wordt informatie over het document met door een beleid beveiligde PDF geretourneerd. U kunt bijvoorbeeld bepalen welk beleid is gebruikt om het document te beveiligen en op welke datum het document is beveiligd.

U kunt deze taak niet uitvoeren als uw versie van LiveCycle 8.x of een vroegere versie is. Ondersteuning voor het inspecteren van documenten die met een beleid zijn beveiligd, wordt toegevoegd in AEM Forms. Als u probeert om een beleid-beschermd document te inspecteren gebruikend LiveCycle 8.x (of vroeger), wordt een uitzondering geworpen.

NOTE
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Verwijzing van de Diensten voor AEM Forms.

Overzicht van de stappen summary_of_steps-7

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

  1. Inclusief projectbestanden.
  2. Maak een API-object voor Document Security Client.
  3. Haal een document op dat met een beleid is beveiligd en dat u wilt inspecteren.
  4. Informatie opvragen over het document dat met een beleid is beveiligd.

omvat projectdossiers

Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u de proxybestanden opnemen.

creeer een voorwerp van de Cliënt API van de Veiligheid van het Document

Voordat u via programmacode een bewerking met de documentbeveiligingsservice kunt uitvoeren, maakt u een clientobject van de documentbeveiligingsservice. Maak een RightsManagementClient -object als u de Java API gebruikt. Als u de webservice-API voor documentbeveiliging gebruikt, maakt u een RightsManagementServiceService -object.

wint een beleid-beschermd document terug om te inspecteren

Als u een document wilt inspecteren dat met een beleid is beveiligd, haalt u het op. Als u een document probeert te inspecteren dat niet met een beleid wordt beveiligd of wordt ingetrokken, wordt een uitzondering gegenereerd.

Inspect het document

Nadat u een document hebt opgehaald dat met een beleid is beveiligd, kunt u het controleren.

verkrijg informatie over het beleid-beschermde document

Nadat u een beleid-beschermd document van de PDF inspecteert, kunt u informatie over het verkrijgen. U kunt bijvoorbeeld bepalen welk beleid wordt gebruikt om het document te beveiligen.

Als u een document beveiligt met een beleid dat tot Mijn Beleid behoort en vervolgens RMInspectResult.getPolicysetName of RMInspectResult.getPolicysetId aanroept, wordt null geretourneerd.

Als het document is beveiligd met een beleid dat zich in een beleidsset bevindt (anders dan Mijn beleid), retourneren RMInspectResult.getPolicysetName en RMInspectResult.getPolicysetId geldige tekenreeksen.

zie ook

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Inspect Policy Protected PDF Documents using the Java API inspect-policy-protected-pdf-documents-using-the-java-api

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

  1. Inclusief projectbestanden.

    Neem JAR-bestanden voor clients, zoals adobe-rightManagement-client.jar, op in het klassenpad van uw Java-project. Voor informatie over de plaats van deze dossiers, zie Inclusief de bibliotheekdossiers van AEM Forms Java.

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

    • Maak een ServiceClientFactory -object dat verbindingseigenschappen bevat. (Zie Plaatsende verbindingseigenschappen.)
    • Maak een RightsManagementClient -object door de constructor ervan te gebruiken en het ServiceClientFactory -object door te geven.
  3. Haal een document op dat met een beleid is beveiligd en dat u wilt inspecteren.

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

    • Maak een DocumentManager -object door de methode RightsManagementClient object getDocumentManager aan te roepen.
    • Inspect het document dat met een beleid is beveiligd 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. Informatie opvragen over het document dat met een beleid is beveiligd.

    Als u informatie wilt verkrijgen over het document dat met een beleid is beveiligd, roept u de juiste methode aan die bij het object RMInspectResult hoort. Als u bijvoorbeeld de naam van het beleid wilt ophalen, roept u de methode getPolicyName van het object RMInspectResult aan.

de voorbeelden van de Code

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

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

Inspect Policy Protected PDF Documents using the web service API inspect-policy-protected-pdf-documents-using-the-web-service-api

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

  1. Inclusief projectbestanden.

    Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .

    note note
    NOTE
    Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.
  2. Maak een API-object voor Document Security Client.

    • Maak een RightsManagementServiceClient -object met de standaardconstructor.

    • Maak een RightsManagementServiceClient.Endpoint.Address -object met de System.ServiceModel.EndpointAddress -constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/RightsManagementService?WSDL .) U hoeft het attribuut lc_version niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)

    • Maak een System.ServiceModel.BasicHttpBinding -object door de waarde van het RightsManagementServiceClient.Endpoint.Binding -veld op te halen. De geretourneerde waarde wordt gecast naar BasicHttpBinding .

    • Stel het veld MessageEncoding van het System.ServiceModel.BasicHttpBinding -object 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 van het AEM aan het veld RightsManagementServiceClient.ClientCredentials.UserName.UserName toe.
      • Wijs de bijbehorende wachtwoordwaarde toe aan het veld RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Wijs de constante waarde HttpClientCredentialType.Basic toe aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly toe aan het veld BasicHttpBindingSecurity.Security.Mode .

  3. Haal een document op dat met een beleid is beveiligd en dat u wilt inspecteren.

    • Maak een BLOB -object met behulp van de constructor. Het BLOB -object wordt gebruikt om een PDF-document op te slaan dat moet worden gecontroleerd.
    • Maak een System.IO.FileStream -object door de constructor ervan aan te roepen. Geef een tekenreekswaarde door die staat voor de bestandslocatie van het PDF-document en de modus waarin het bestand moet worden geopend.
    • Maak een bytearray waarin de inhoud van het object System.IO.FileStream wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschap Length van het object System.IO.FileStream 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 ervan toe te wijzen met de inhoud van de bytearray.
  4. Inspect het document.

    Inspect het document dat met een beleid is beveiligd 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. Informatie opvragen over het document dat met een beleid is beveiligd.

    Als u informatie wilt verkrijgen over het document dat met een beleid is beveiligd, vraagt u de waarde op van het veld dat hoort bij het object RMInspectResult . Als u bijvoorbeeld de naam van het beleid wilt ophalen, haalt u de waarde op van het veld policyName van het RMInspectResult -object.

de voorbeelden van de Code

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

  • "Snel starten (MTOM): met beleid beveiligde PDF-documenten inspecteren met de webservice-API"
  • "Quick Start (SwaRef): met een beleid beveiligde PDF-documenten inspecteren met behulp van de webservice-API"

zie ook

AEM Forms aanroepen met MTOM

AEM Forms aanroepen met SwaRef

Watermerken maken creating-watermarks

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

NOTE
Alleen gebruikers met beheerdersrechten voor documentbeveiliging kunnen watermerken maken. Dit betekent dat u een dergelijke gebruiker moet opgeven wanneer u verbindingsinstellingen definieert die vereist zijn om een Document Security Service Client-object te maken.
NOTE
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Verwijzing van de Diensten voor AEM Forms.

Overzicht van de stappen summary_of_steps-8

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 Document Security Service.

omvat projectdossiers

Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.

creeer een voorwerp van de Cliënt API van de Veiligheid van het Document

Voordat u programmatisch een Document Security-servicebewerking kunt uitvoeren, moet u een Document Security-service-clientobject maken. Maak een RightsManagementClient -object als u de Java API gebruikt. Als u de webservice-API voor documentbeveiliging gebruikt, maakt u een RightsManagementServiceService -object.

plaats de watermerkattributen

Als u een watermerk wilt maken, moet u de kenmerken van het watermerk instellen. Het kenmerk name moet altijd worden gedefinieerd. Naast het kenmerk name moet u ten minste een van de volgende kenmerken instellen:

  • Aangepaste tekst
  • DateIncluded
  • UserIdIncluded
  • UserNameIncluded

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

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 groter 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 true worden ingesteld.
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.

Register het watermerk

Een nieuw watermerk moet bij de dienst van de Veiligheid van het Document worden geregistreerd alvorens het kan worden gebruikt. Nadat u een watermerk hebt geregistreerd, kunt u dit gebruiken binnen het beleid.

zie ook

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Beleid toepassen op PDF-documenten

Watermerken maken met de Java API create-watermarks-using-the-java-api

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

  1. Inclusief projectbestanden.

    Neem client JAR-bestanden, zoals de adobe-rightsmanagement-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 ServiceClientFactory -object door te geven.
  3. De kenmerken van het watermerk instellen

    • Maak een Watermark -object door de statische methode InfomodelObjectFactory van het object createWatermark aan te roepen. Deze methode retourneert een Watermark -object.
    • Stel het name-kenmerk 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 door te geven true . 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 RightsManagementClient object getWatermarkManager 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.

de voorbeelden van de Code

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

  • "Snel starten (SOAP modus): een watermerk maken met de Java API"

Watermerken maken met de webservice-API create-watermarks-using-the-web-service-api

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

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

    Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .

    note note
    NOTE
    Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.
  2. Maak een API-object voor Document Security Client.

    • Maak een RightsManagementServiceClient -object met de standaardconstructor.

    • Maak een RightsManagementServiceClient.Endpoint.Address -object met de System.ServiceModel.EndpointAddress -constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/RightsManagementService?WSDL .) U hoeft het attribuut lc_version niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)

    • Maak een System.ServiceModel.BasicHttpBinding -object door de waarde van het RightsManagementServiceClient.Endpoint.Binding -veld op te halen. De geretourneerde waarde wordt gecast naar BasicHttpBinding .

    • Stel het veld MessageEncoding van het System.ServiceModel.BasicHttpBinding -object 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 van het AEM aan het veld RightsManagementServiceClient.ClientCredentials.UserName.UserName toe.
      • Wijs de bijbehorende wachtwoordwaarde toe aan het veld RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Wijs de constante waarde HttpClientCredentialType.Basic toe aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly toe aan het veld BasicHttpBindingSecurity.Security.Mode .

  3. Stel de kenmerken van het watermerk in.

    • Maak een WatermarkSpec -object door de WatermarkSpec -constructor aan te roepen.
    • Stel de naam van het watermerk in door een tekenreekswaarde toe te wijzen aan het gegevenslid name van het WatermarkSpec -object.
    • Stel het kenmerk id van het watermerk in door een tekenreekswaarde toe te wijzen aan het gegevenslid van het WatermarkSpec object id .
    • Maak een afzonderlijk MyMapOf_xsd_string_To_xsd_anyType_Item -object voor elke watermerkeigenschap die moet worden ingesteld.
    • Stel de sleutelwaarde in door een waarde toe te wijzen aan het key -gegevenslid van het MyMapOf_xsd_string_To_xsd_anyType_Item -object (bijvoorbeeld WaterBackCmd:OPACITY) .
    • Stel de waarde in door een waarde toe te wijzen aan het value data-lid .25 van het MyMapOf_xsd_string_To_xsd_anyType_Item -object.
    • Maak een MyArrayOf_xsd_anyType -object. Roep voor elk MyMapOf_xsd_string_To_xsd_anyType_Item -object de methode MyArrayOf_xsd_anyType object Add aan. Geef het object MyMapOf_xsd_string_To_xsd_anyType_Item door.
    • Wijs het MyArrayOf_xsd_anyType -object toe aan het gegevenslid van het WatermarkSpec 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.

de voorbeelden van de Code

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

  • "Quick Start (MTOM): Creating a watermark using the web service API"
  • "Quick Start (SwaRef): Creating a watermark using the web service API"

zie ook

AEM Forms aanroepen met MTOM

AEM Forms aanroepen met SwaRef

Watermerken wijzigen modifying-watermarks

U kunt een bestaand watermerk wijzigen met de Java API voor documentbeveiliging of de webservice-API. Als u een bestaand watermerk wilt wijzigen, haalt u het op, wijzigt u de kenmerken en werkt u het vervolgens bij op de server. Stel dat u een watermerk ophaalt en het kenmerk Dekking wijzigt. Voordat de wijziging van kracht wordt, moet u het watermerk bijwerken.

Wanneer u een watermerk wijzigt, is de wijziging van invloed op toekomstige documenten waarop het watermerk is toegepast. Dat wil zeggen dat bestaande PDF-documenten die het watermerk bevatten, niet worden beïnvloed.

NOTE
Alleen gebruikers met beheerdersrechten voor documentbeveiliging kunnen watermerken wijzigen. Dit betekent dat u een dergelijke gebruiker moet opgeven wanneer u verbindingsinstellingen definieert die vereist zijn om een Document Security Service Client-object te maken.
NOTE
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Verwijzing van de Diensten voor AEM Forms.

Overzicht van de stappen summary_of_steps-9

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.

omvat projectdossiers

Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.

creeer een voorwerp van de Cliënt API van de Veiligheid van het Document

Voordat u programmatisch een Document Security-servicebewerking kunt uitvoeren, moet u een Document Security-service-clientobject maken. Maak een DocumentSecurityClient -object als u de Java API gebruikt. Als u de webservice-API voor documentbeveiliging gebruikt, maakt u een DocumentSecurityServiceService -object.

wint het watermerk terug om te wijzigen

Als u een watermerk wilt wijzigen, moet u een bestaand watermerk ophalen. U kunt een watermerk terugwinnen door zijn naam te specificeren of door zijn herkenningstekenwaarde te specificeren.

plaats de watermerkattributen

Als u een bestaand watermerk wilt wijzigen, wijzigt u de waarde van een of meer watermerkkenmerken. Wanneer u via programmacode een watermerk bijwerkt met behulp van een webservice, moet u alle kenmerken instellen die oorspronkelijk zijn ingesteld, zelfs als de waarde niet verandert. Stel bijvoorbeeld dat de volgende watermerkkenmerken zijn ingesteld: WaterBackCmd:IS_USERID_ENABLED , WaterBackCmd:IS_CUSTOMTEXT_ENABLED , WaterBackCmd:OPACITY en WaterBackCmd:SRCTEXT . Hoewel het enige kenmerk dat u wilt wijzigen WaterBackCmd:OPACITY is, moet u de andere waarden instellen.

NOTE
Wanneer u de Java API gebruikt om een watermerk te wijzigen, hoeft u niet alle kenmerken op te geven. Stel het watermerkkenmerk in dat u wilt wijzigen.
NOTE
Voor informatie over de namen van de watermerkattributen, zie Creërend Watermerken.

werk het watermerk bij

Nadat u de kenmerken van een watermerk hebt gewijzigd, moet u het watermerk bijwerken.

zie ook

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Watermerken maken

Watermerken wijzigen met de Java API modify-watermarks-using-the-java-api

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

  1. Inclusief projectbestanden.

    Neem JAR-bestanden voor clients, 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 ServiceClientFactory -object door te geven.
  3. Haal het watermerk op dat u wilt wijzigen.

    Maak een WatermarkManager -object door de methode DocumentSecurityClient object getWatermarkManager aan te roepen en geef een tekenreekswaarde door 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.

    note note
    NOTE
    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.

de voorbeelden van de Code

Zie Snel starten (modus SOAP): Een watermerk wijzigen met behulp van de Java API-sectie voor codevoorbeelden met de documentbeveiligingsservice.

Watermerken wijzigen met de webservice-API modify-watermarks-using-the-web-service-api

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

  1. Inclusief projectbestanden.

    Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .

    note note
    NOTE
    Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.
  2. Maak een API-object voor Document Security Client.

    • Maak een DocumentSecurityServiceClient -object met de standaardconstructor.

    • Maak een RightsManagementServiceClient.Endpoint.Address -object met de System.ServiceModel.EndpointAddress -constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/DocumentSecurityService?WSDL .) U hoeft het attribuut lc_version niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)

    • Maak een System.ServiceModel.BasicHttpBinding -object door de waarde van het DocumentSecurityServiceClient.Endpoint.Binding -veld op te halen. De geretourneerde waarde wordt gecast naar BasicHttpBinding .

    • Stel het veld MessageEncoding van het System.ServiceModel.BasicHttpBinding -object 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 van het AEM aan het veld DocumentSecurityServiceClient.ClientCredentials.UserName.UserName toe.
      • Wijs de bijbehorende wachtwoordwaarde toe aan het veld DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • Wijs de constante waarde HttpClientCredentialType.Basic toe aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly toe aan het veld BasicHttpBindingSecurity.Security.Mode .

  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.

    • Maak een afzonderlijk MyMapOf_xsd_string_To_xsd_anyType_Item -object voor elke watermerkeigenschap die moet worden bijgewerkt.
    • Stel de sleutelwaarde in door een waarde toe te wijzen aan het key -gegevenslid van het MyMapOf_xsd_string_To_xsd_anyType_Item -object (bijvoorbeeld WaterBackCmd:OPACITY) .
    • Stel de waarde in door een waarde toe te wijzen aan het value data-lid .50 van het MyMapOf_xsd_string_To_xsd_anyType_Item -object.
    • Maak een MyArrayOf_xsd_anyType -object. Roep voor elk MyMapOf_xsd_string_To_xsd_anyType_Item -object de methode MyArrayOf_xsd_anyType object Add aan. Geef het object MyMapOf_xsd_string_To_xsd_anyType_Item door.
    • Wijs het MyArrayOf_xsd_anyType -object toe aan het gegevenslid van het WatermarkSpec 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.

de voorbeelden van de Code

Zie het volgende snelle begin voor codevoorbeelden met gebruik van de Document Security-service:

  • "Quick Start (MTOM): Modifying a watermark using the web service API"

Zoeken naar gebeurtenissen searching-for-events

De dienst van het Rights Management volgt specifieke acties aangezien zij voorkomen, zoals het toepassen van een beleid op een document, het openen van een beleid-beschermd document, en het intrekken van toegang tot documenten. Gebeurteniscontrole moet zijn ingeschakeld voor de service Rights Management of gebeurtenissen worden niet bijgehouden.

Gebeurtenissen behoren tot een van de volgende categorieën:

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

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

NOTE
Voor meer informatie over de dienst van het Rights Management, zie Verwijzing van de Diensten voor AEM Forms.

Overzicht van de stappen summary_of_steps-10

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.

omvat projectdossiers

Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.

creeer een voorwerp van de Cliënt van het Rights Management API

Alvorens u een de dienstverrichting van het Rights Management programmatically kunt uitvoeren, moet u een voorwerp van de de dienstcliënt van het Rights Management tot stand brengen. Maak een DocumentSecurityClient -object als u de Java API gebruikt. Als u de API voor webservices van het Rights Management gebruikt, maakt u een DocumentSecurityServiceService -object.

specificeer de gebeurtenissen om te zoeken

Geef op naar welke gebeurtenis moet worden gezocht. U kunt bijvoorbeeld zoeken naar het beleid om een gebeurtenis te maken, die optreedt wanneer een nieuw beleid wordt gemaakt.

Onderzoek naar de gebeurtenis

Nadat u de gebeurtenis hebt opgegeven waarnaar moet worden gezocht, kunt u de Java API voor Rights Managementen of de API voor webservices van Rights Managementen gebruiken om naar de gebeurtenis te zoeken.

zie ook

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Zoeken naar gebeurtenissen met de Java API search-for-events-using-the-java-api

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

  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 DocumentSecurityClient object getEventManager 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 het type static data door te geven dat behoort tot de klasse EventManager die de gebeurtenis vertegenwoordigt waarnaar moet worden gezocht. Als u bijvoorbeeld wilt zoeken naar de gebeurtenis create voor het beleid, geeft u EventManager.POLICY_CREATE_EVENT door.
    note note
    NOTE
    U kunt aanvullende zoekcriteria definiëren door objectmethoden van 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 object EventManager aan te roepen en het object EventSearchFilter door te geven dat de zoekcriteria voor de gebeurtenis definieert. Deze methode retourneert een array van Event -objecten.

de voorbeelden van de Code

Voor codevoorbeelden die de dienst van het Rights Management gebruiken, zie Snel begint:

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

Zoeken naar gebeurtenissen met de webservice-API search-for-events-using-the-web-service-api

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

  1. Projectbestanden opnemen

    Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .

    note note
    NOTE
    Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.
  2. Een Rights Management Client API-object maken

    • Maak een DocumentSecurityServiceClient -object met de standaardconstructor.

    • Maak een DocumentSecurityServiceClient.Endpoint.Address -object met de System.ServiceModel.EndpointAddress -constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/RightsManagementService?WSDL .) U hoeft het attribuut lc_version niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)

    • Maak een System.ServiceModel.BasicHttpBinding -object door de waarde van het DocumentSecurityServiceClient.Endpoint.Binding -veld op te halen. De geretourneerde waarde wordt gecast naar BasicHttpBinding .

    • Stel het veld MessageEncoding van het System.ServiceModel.BasicHttpBinding -object 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 van het AEM aan het veld DocumentSecurityServiceClient.ClientCredentials.UserName.UserName toe.
      • Wijs de bijbehorende wachtwoordwaarde toe aan het veld DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • Wijs de constante waarde HttpClientCredentialType.Basic toe aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly toe aan het veld BasicHttpBindingSecurity.Security.Mode .

  3. Geef de gebeurtenissen op waarnaar u wilt zoeken

    • Maak een EventSpec -object met behulp van de constructor.
    • Geef het begin op van de periode waarin de gebeurtenis heeft plaatsgevonden door het firstTime.date data member van het EventSpec object in te stellen op de DataTime -instantie die het begin van het datumbereik vertegenwoordigt op het moment dat de gebeurtenis plaatsvond.
    • Wijs de waarde true toe aan het gegevenslid EventSpec object firstTime.dateSpecified .
    • Geef het einde van de periode waarin de gebeurtenis heeft plaatsgevonden op door het lastTime.date data member van het EventSpec object in te stellen op de DataTime -instantie die het einde van het datumbereik vertegenwoordigt toen de gebeurtenis plaatsvond.
    • Wijs de waarde true toe aan het gegevenslid EventSpec object lastTime.dateSpecified .
    • Stel de gebeurtenis waarnaar moet worden gezocht in door een tekenreekswaarde toe te wijzen aan het gegevenslid eventCode van het EventSpec -object. In de volgende tabel worden de numerieke waarden weergegeven die u aan deze eigenschap kunt toewijzen:
    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 18-row-2 19-row-2 20-row-2 21-row-2 22-row-2 23-row-2 24-row-2 25-row-2 26-row-2 27-row-2 28-row-2 29-row-2 30-row-2 31-row-2 32-row-2 33-row-2 34-row-2 35-row-2 36-row-2 37-row-2 38-row-2 39-row-2 40-row-2 41-row-2 42-row-2 43-row-2 44-row-2 45-row-2 46-row-2 47-row-2
    Het type Event Waarde
    ALL_EVENTS 999
    USER_CHANGE_PASSWORD_EVENT 1000
    USER_REGISTER_EVENT 1001
    USER_PREREGISTER_EVENT 1002
    USER_ACTIVATE_EVENT 1003
    USER_DEACTIVATE_EVENT 1004
    USER_AUTHENTICATE_EVENT 1005
    USER_AUTHENTICATE_DENY_EVENT 1006
    USER_ACCOUNT_LOCK_EVENT 1007
    USER_DELETE_EVENT 1008
    USER_UPDATE_PROFILE_EVENT 1009
    DOCUMENT_VIEW_EVENT 2000
    DOCUMENT_PRINT_LOW_EVENT 2001
    DOCUMENT_PRINT_HIGH_EVENT 2002
    DOCUMENT_SIGN_EVENT 2003
    DOCUMENT_ADD_ANNOTATION_EVENT 2004
    DOCUMENT_FORM_FILL_EVENT 2005
    DOCUMENT_CLOSE_EVENT 2006
    DOCUMENT_MODIFY_EVENT 2007
    DOCUMENT_CHANGE_SECURITY_HANDLER_EVENT 2008
    DOCUMENT_SWITCH_POLICY_EVENT 2009
    DOCUMENT_REVOKE_EVENT 2010
    $1 2011
    DOCUMENT_SECURE_EVENT 2012
    DOCUMENT_UNKNOWN_CLIENT_EVENT 2013
    DOCUMENT_CHANGE_REVOKE_URL_EVENT 2014
    POLICY_CHANGE_EVENT 3000
    POLICY_ENABLE_EVENT 3001
    POLICY_DISABLE_EVENT 3002
    POLICY_CREATE_EVENT 3003
    POLICY_DELETE_EVENT 3004
    POLICY_CHANGE_OWNER_EVENT 3005
    SERVER_CLIENT_SYNC_EVENT 4000
    SERVER_SYNC_DIR_INFO_EVENT 4001
    SERVER_SYNC_DIR_COMPLETE_EVENT 4002
    SERVER_VERSION_MISMATCH_EVENT 4003
    SERVER_CONFIG_CHANGE_EVENT 4004
    SERVER_ENABLE_OFFLINE_ACCESS_EVENT 4005
    ADMIN_ADD_EVENT 5000
    ADMIN_DELETE_EVENT 5001
    ADMIN_EDIT_EVENT 5002
    ADMIN_ACTIVATE_EVENT 5003
    ADMIN_DEACTIVATE_EVENT 5004
    ERROR_DIRECTORY_SERVICE_EVENT 6000
    CREATED_POLICYSET_EVENT 7000
    DELETED_POLICYSET_EVENT 7001
    MODIFIED_POLICYSET_EVENT 7002
  4. Zoeken naar de gebeurtenis

    Zoek naar de gebeurtenis door de methode searchForEvents van het object DocumentSecurityServiceClient aan te roepen en het object EventSpec door te geven dat de gebeurtenis vertegenwoordigt waarnaar moet worden gezocht en het maximale aantal resultaten. Deze methode retourneert een MyArrayOf_xsd_anyType -verzameling waarbij elk element een AuditSpec -instantie is. Met behulp van een AuditSpec -instantie kunt u informatie opvragen over de gebeurtenis, zoals de tijd dat deze heeft plaatsgevonden. De instantie AuditSpec bevat een timestamp -gegevenslid dat deze informatie opgeeft.

de voorbeelden van de Code

Voor codevoorbeelden die de dienst van het Rights Management gebruiken, zie Snel begint:

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

zie ook

AEM Forms aanroepen met MTOM

AEM Forms aanroepen met SwaRef

Beleid toepassen op Word-documenten applying-policies-to-word-documents

Naast PDF-documenten biedt de Rights Management-service ondersteuning voor aanvullende documentindelingen, zoals een Microsoft Word-document (DOC-bestand) en andere Microsoft Office-bestandsindelingen. U kunt bijvoorbeeld een beleid toepassen op een Word-document om dit te beveiligen. Door een beleid op een document van Word toe te passen, beperkt u toegang tot het document. U kunt geen beleid op een document toepassen als het document reeds met een beleid wordt beveiligd.

U kunt het gebruik van een beleid-beschermd document van Word controleren nadat u het verspreidt. Dat wil zeggen dat u kunt zien hoe het document wordt gebruikt en wie het gebruikt. U kunt bijvoorbeeld zien wanneer iemand het document heeft geopend.

NOTE
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Verwijzing van de Diensten voor AEM Forms.

Overzicht van de stappen summary_of_steps-11

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.

omvat projectdossiers

Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.

creeer een Cliënt APIobject van de Veiligheid van het Document

Voordat u programmatisch een Document Security-servicebewerking kunt uitvoeren, moet u een Document Security-service-clientobject maken.

wint een document van Word terug

Hiermee wordt een Word-document opgehaald om een beleid toe te passen. Nadat u een beleid op het document van Word toepast, worden de gebruikers beperkt wanneer het gebruiken van het document. Als het beleid bijvoorbeeld niet toestaat dat het document offline wordt geopend, moeten gebruikers online zijn om het document te openen.

pas een bestaand beleid op het document van Word toe

Als u een beleid wilt toepassen op een Word-document, moet u verwijzen naar een bestaand beleid en opgeven tot welke beleidsset het beleid behoort. De gebruiker die de verbindingseigenschappen instelt, moet toegang hebben tot het opgegeven beleid. Als dat niet het geval is, treedt een uitzondering op.

sparen het document van Word

Nadat de documentbeveiligingsservice een beleid heeft toegepast op een Word-document, kunt u het met een beleid beveiligde Word-document opslaan als een DOC-bestand.

zie ook

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Toegang tot documenten intrekken

Een beleid toepassen op een Word-document met behulp van de Java API apply-a-policy-to-a-word-document-using-the-java-api

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

  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 ServiceClientFactory -object door te geven.
  3. Een Word-document ophalen.

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

    • Maak een DocumentManager -object door de methode DocumentSecurityClient object getDocumentManager aan te roepen.

    • Pas een beleid toe op het Word-document door de methode protectDocument van het DocumentManager -object aan te roepen en de volgende waarden door te geven:

      • Het com.adobe.idp.Document -object dat het Word-document bevat waarop het beleid wordt toegepast.
      • Een tekenreekswaarde die de naam van het document aangeeft.
      • Een tekenreekswaarde die de naam opgeeft van de beleidsset waartoe het beleid behoort. U kunt een null -waarde opgeven die resulteert in het gebruik van de MyPolicies -beleidsset.
      • Een tekenreekswaarde die de beleidsnaam opgeeft.
      • Een tekenreekswaarde die de naam vertegenwoordigt van het gebruikersbeheerdomein van de gebruiker die de uitgever van het document is. Deze parameterwaarde is optioneel en kan null zijn (als deze parameter null is, moet de volgende parameterwaarde null zijn).
      • Een tekenreekswaarde die de naam vertegenwoordigt van de canonieke naam van de gebruiker van de gebruikersmanager die de uitgever van het document is. Deze parameterwaarde is optioneel en kan null zijn (als deze parameter null is, moet de vorige parameterwaarde null zijn).
      • A com.adobe.livecycle.rightsmanagement.Locale die de landinstelling vertegenwoordigt die wordt gebruikt voor het selecteren van de sjabloon MS Office. Deze parameterwaarde is optioneel en u kunt null opgeven.

      De methode protectDocument retourneert een RMSecureDocumentResult -object dat het door een beleid beveiligde Word-document bevat.

  5. Sla het Word-document op.

    • Roep de methode getProtectedDoc van het RMSecureDocumentResult -object aan om het door het beleid beveiligde Word-document op te halen. Deze methode retourneert een com.adobe.idp.Document -object.
    • Maak een java.io.File -object en controleer of de bestandsextensie DOC is.
    • Roep de methode copyToFile van het object com.adobe.idp.Document aan om de inhoud van het object Document naar het bestand te kopiëren (gebruik het object Document dat door de methode getProtectedDoc is geretourneerd).

de voorbeelden van de Code

Zie het volgende snelle begin voor codevoorbeelden met gebruik van de Document Security-service:

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

Een beleid toepassen op een Word-document met behulp van de webservice-API apply-a-policy-to-a-word-document-using-the-web-service-api

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

  1. Inclusief projectbestanden.

    Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie: http://localhost:8080/soap/services/DocumentSecurityService?WSDL&lc_version=9.0.1 .

    note note
    NOTE
    Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.
  2. Maak een API-object voor Document Security Client.

    • Maak een DocumentSecurityServiceClient -object met de standaardconstructor.

    • Maak een DocumentSecurityServiceClient.Endpoint.Address -object met de System.ServiceModel.EndpointAddress -constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/DocumentSecurityService?WSDL .) U hoeft het attribuut lc_version niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)

    • Maak een System.ServiceModel.BasicHttpBinding -object door de waarde van het DocumentSecurityServiceClient.Endpoint.Binding -veld op te halen. De geretourneerde waarde wordt gecast naar BasicHttpBinding .

    • Stel het veld MessageEncoding van het System.ServiceModel.BasicHttpBinding -object 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 van het AEM aan het veld DocumentSecurityServiceClient.ClientCredentials.UserName.UserName toe.
      • Wijs de bijbehorende wachtwoordwaarde toe aan het veld DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • Wijs de constante waarde HttpClientCredentialType.Basic toe aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly toe aan het veld BasicHttpBindingSecurity.Security.Mode .

  3. Een Word-document ophalen.

    • Maak een BLOB -object met behulp van de constructor. Het BLOB -object wordt gebruikt om een Word-document op te slaan waarop een beleid wordt toegepast.
    • Maak een System.IO.FileStream -object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het Word-document en de modus waarin het bestand moet worden geopend, vertegenwoordigt.
    • Maak een bytearray waarin de inhoud van het object System.IO.FileStream wordt opgeslagen. Bepaal de grootte van de bytearray door de eigenschap Length van het object System.IO.FileStream 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 ervan toe te wijzen met de inhoud van de bytearray.
  4. Pas een bestaand beleid op het document van Word toe.

    Pas een beleid toe op het Word-document door de methode protectDocument van het DocumentSecurityServiceClient -object aan te roepen en de volgende waarden door te geven:

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

  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 waarin de gegevensinhoud wordt opgeslagen van het object BLOB dat door de methode protectDocument is geretourneerd. Vul de bytearray met de waarde van het gegevenslid MTOM van het object BLOB .
    • Maak een System.IO.BinaryWriter -object door de constructor ervan aan te roepen en het System.IO.FileStream -object 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.

de voorbeelden van de Code

Zie het volgende snelle begin voor codevoorbeelden met gebruik van de Document Security-service:

  • "Quick Start (MTOM): Applying a policy to a Word document using the web service API "

Beleid verwijderen uit Word-documenten removing-policies-from-word-documents

U kunt een beleid uit een beleid-beschermd document van Word verwijderen om veiligheid uit het document te verwijderen. Dat wil zeggen, als u niet langer wilt dat het document wordt beschermd door een beleid. Als u een beleid-beschermd document van Word met een nieuwer beleid wilt bijwerken, dan in plaats van het verwijderen van het beleid en het toevoegen van het bijgewerkte beleid, is het efficiënter om het beleid te schakelen.

NOTE
Voor meer informatie over de dienst van de Veiligheid van het Document, zie Verwijzing van de Diensten voor AEM Forms.

Overzicht van de stappen summary_of_steps-12

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

  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

omvat projectdossiers

Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.

creeer een voorwerp van de Cliënt API van de Veiligheid van het Document

Voordat u via programmacode een bewerking met de documentbeveiligingsservice kunt uitvoeren, maakt u een clientobject van de documentbeveiligingsservice.

wint een beleid-beschermd document van Word terug

Woord-document dat door een beleid is beveiligd, ophalen om een beleid te verwijderen. Als u probeert om een beleid uit een document van Word te verwijderen dat niet door een beleid wordt beschermd, zult u een uitzondering veroorzaken.

verwijder het beleid uit het document van Word

U kunt een beleid uit een beleid-beschermd document van Word verwijderen op voorwaarde dat een beheerder in de verbindingsmontages wordt gespecificeerd. Als dat niet het geval is, moet het beleid dat wordt gebruikt om een document te beveiligen de toestemming SWITCH_POLICY bevatten om een beleid uit een document van Word te verwijderen. De gebruiker die is opgegeven in de AEM Forms-verbindingsinstellingen moet ook over deze machtiging beschikken. Anders wordt een uitzondering gegenereerd.

sparen het onbeveiligde document van Word

Nadat de documentbeveiligingsservice een beleid uit een Word-document heeft verwijderd, kunt u het onbeveiligde Word-document opslaan als een DOC-bestand.

zie ook

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Beleid toepassen op Word-documenten

Een beleid verwijderen uit een Word-document met de Java API remove-a-policy-from-a-word-document-using-the-java-api

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

  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 ServiceClientFactory -object 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 java.io.FileInputStream -object door te geven.
  4. Het beleid verwijderen uit het Word-document

    • Maak een DocumentManager -object door de methode RightsManagementClient object getDocumentManager aan te roepen.
    • Verwijder een beleid uit het Word-document door de methode removeSecurity van het DocumentManager -object aan te roepen en het com.adobe.idp.Document -object door te geven dat het door een beleid beveiligde Word-document 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 controleer of de bestandsextensie DOC is.
    • Roep de methode copyToFile van het object Document aan om de inhoud van het object Document naar het bestand te kopiëren (gebruik het object Document dat door de methode removeSecurity is geretourneerd).

de voorbeelden van de Code

Zie het volgende snelle begin voor codevoorbeelden met gebruik van de Document Security-service:

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

Een beleid verwijderen uit een Word-document met de webservice-API remove-a-policy-from-a-word-document-using-the-web-service-api

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

  1. Projectbestanden opnemen

    Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .

    note note
    NOTE
    Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.
  2. Een API-object voor documentbeveiliging maken

    • Maak een RightsManagementServiceClient -object met de standaardconstructor.

    • Maak een RightsManagementServiceClient.Endpoint.Address -object met de System.ServiceModel.EndpointAddress -constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/RightsManagementService?WSDL .) U hoeft het attribuut lc_version niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)

    • Maak een System.ServiceModel.BasicHttpBinding -object door de waarde van het RightsManagementServiceClient.Endpoint.Binding -veld op te halen. De geretourneerde waarde wordt gecast naar BasicHttpBinding .

    • Stel het veld MessageEncoding van het System.ServiceModel.BasicHttpBinding -object 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 van het AEM aan het veld RightsManagementServiceClient.ClientCredentials.UserName.UserName toe.
      • Wijs de bijbehorende wachtwoordwaarde toe aan het veld RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Wijs de constante waarde HttpClientCredentialType.Basic toe aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly toe aan het veld BasicHttpBindingSecurity.Security.Mode .

  3. Een met beleid beveiligd Word-document ophalen

    • Maak een BLOB -object met behulp van de constructor. Het BLOB -object wordt gebruikt om het door een beleid beveiligde Word-document op te slaan waaruit het beleid wordt verwijderd.
    • Maak een System.IO.FileStream -object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het Word-document en de modus waarin het bestand moet worden geopend, vertegenwoordigt.
    • Maak een bytearray waarin de inhoud van het object System.IO.FileStream wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschap Length van het object System.IO.FileStream 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 ervan toe te wijzen met de inhoud van de bytearray.
  4. Het beleid verwijderen uit het Word-document

    Verwijder het beleid uit het Word-document door de methode removePolicySecurity van het RightsManagementServiceClient -object aan te roepen en het BLOB -object door te geven dat het door het beleid beveiligde Word-document 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 waarin de gegevensinhoud wordt opgeslagen van het object BLOB dat door de methode removePolicySecurity is geretourneerd. Vul de bytearray met de waarde van het veld MTOM van het object BLOB .
    • Maak een System.IO.BinaryWriter -object door de constructor ervan aan te roepen en het System.IO.FileStream -object door te geven.

de voorbeelden van de Code

Zie het volgende snelle begin voor codevoorbeelden met gebruik van de Document Security-service:

  • "Quick Start (MTOM): Removing a policy from a Word document using the web service API"

zie ook

AEM Forms aanroepen met MTOM

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2