DokumentationAEM 6.5Användarhandbok

Skydda dokument med regler protecting-documents-with-policies

Last update: Sat Jul 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Utvecklare

Exempel och exempel i det här dokumentet gäller endast för AEM Forms i JEE-miljö.

Om dokumentsäkerhetstjänsten

Med Document Security kan man dynamiskt lägga in sekretessinställningar i Adobe PDF-dokument och styra dokumenten, oavsett hur de distribueras.

Dokumentsäkerhetstjänsten förhindrar att information sprids utanför användarens räckhåll genom att användarna kan behålla kontrollen över hur mottagarna använder det profilskyddade PDF-dokumentet. Användaren kan ange vem som får öppna ett dokument, begränsa hur det får användas och övervaka dokumentet när det har distribuerats. En användare kan också dynamiskt styra åtkomsten till ett policyskyddat dokument och kan till och med dynamiskt återkalla åtkomsten till dokumentet.

Dokumentsäkerhetstjänsten skyddar även andra filtyper, till exempel Microsoft Word-filer (DOC-filer). Du kan använda API:t för dokumentsäkerhetsklienten för att arbeta med dessa filtyper. Följande versioner stöds:

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

Följande två avsnitt beskriver tydligt hur du arbetar med Word-dokument:

Du kan utföra följande uppgifter med tjänsten Dokumentsäkerhet:

NOTE
Mer information om Document Security-tjänsten finns i Tjänstreferens för AEM Forms.

Skapa profiler creating-policies

Du kan skapa profiler programmatiskt med Java API:t för dokumentsäkerhet eller webbtjänstAPI:t. En princip är en samling information som innehåller dokumentskyddsinställningar, behöriga användare och användningsrättigheter. Du kan skapa och spara valfritt antal profiler med hjälp av skyddsinställningar som passar olika situationer och användare.

Med hjälp av profiler kan du utföra följande uppgifter:

  • Ange vilka personer som kan öppna dokumentet. Mottagarna kan antingen tillhöra eller vara externa till din organisation.
  • Ange hur mottagarna kan använda dokumentet. Du kan begränsa åtkomsten till olika funktioner i Acrobat och Adobe Reader. Bland dessa funktioner finns möjligheten att skriva ut och kopiera text, lägga till signaturer och lägga till kommentarer i ett dokument.
  • Ändra inställningar för åtkomst och säkerhet när som helst, även efter att du distribuerat det profilskyddade dokumentet.
  • Övervaka hur dokumentet används när du har distribuerat det. Du kan se hur dokumentet används och vem som använder det. Du kan till exempel ta reda på när någon har öppnat dokumentet.

Skapa en profil med hjälp av webbtjänster creating-a-policy-using-web-services

När du skapar en profil med webbtjänstens API ska du referera till en befintlig PDF-fil (Portable Document Rights Language) som beskriver principen. Principbehörigheter och huvudobjekt definieras i PDRL-dokumentet. Följande XML-dokument är ett exempel på ett PDRL-dokument.

 <?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
Mer information om Document Security-tjänsten finns i Tjänstreferens för AEM Forms.

Sammanfattning av steg summary-of-steps

Så här skapar du en profil:

  1. Inkludera projektfiler.
  2. Skapa ett API-objekt för Document Security Client.
  3. Ange principens attribut.
  4. Skapa en princippost.
  5. Registrera policyn.

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.

Följande JAR-filer måste läggas till i projektets klassökväg:

  • adobe-rightsmanagement-client.jar
  • namespace.jar (om AEM Forms distribueras på JBoss)
  • jaxb-api.jar (om AEM Forms används på JBoss)
  • jaxb-impl.jar (om AEM Forms används på JBoss)
  • jaxb-libs.jar (om AEM Forms körs på JBoss)
  • jaxb-xjc.jar (om AEM Forms används på JBoss)
  • relaxngDatatype.jar (om AEM Forms körs på JBoss)
  • xsdlib.jar (om AEM Forms körs på JBoss)
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar
  • jbossall-client.jar (använd en annan JAR-fil om AEM Forms inte är distribuerat på JBoss)

Mer information om platsen för dessa JAR-filer finns i Inkludera AEM Forms Java-biblioteksfiler.

Skapa ett API-objekt för dokumentsäkerhetsklienten

Skapa ett klientobjekt för tjänsten Dokumentsäkerhet innan du programmässigt utför en åtgärd.

Ange principens attribut

Om du vill skapa en profil anger du principattribut. Ett obligatoriskt attribut är principnamnet. Principnamnen måste vara unika för varje principuppsättning. En policyuppsättning är bara en samling policyer. Det kan finnas två principer med samma namn om profilerna tillhör separata principuppsättningar. Två principer i en enskild principuppsättning kan dock inte ha samma principnamn.

Ett annat användbart attribut är giltighetsperioden. En giltighetsperiod är den tidsperiod under vilken ett policyskyddat dokument är tillgängligt för behöriga mottagare. Om du inte anger det här attributet är principen alltid giltig.

En giltighetsperiod kan anges till något av följande alternativ:

  • Ett visst antal dagar som dokumentet är tillgängligt från den tidpunkt då dokumentet publiceras
  • Ett slutdatum efter vilket dokumentet inte är tillgängligt
  • Ett visst datumintervall som dokumentet är tillgängligt för
  • Alltid giltig

Du kan bara ange ett startdatum, vilket resulterar i att profilen är giltig efter startdatumet. Om du bara anger ett slutdatum gäller profilen fram till slutdatumet. Ett undantag genereras emellertid om både ett startdatum och ett slutdatum inte har definierats.

När du anger attribut som tillhör en profil kan du även ange krypteringsinställningar. Dessa krypteringsinställningar påverkar när profilen tillämpas på ett dokument. Du kan ange följande krypteringsvärden:

  • AES256: Representerar AES-krypteringsalgoritmen med en 256-bitars nyckel.
  • AES128: Representerar AES-krypteringsalgoritmen med en 128-bitars nyckel.
  • Ingen kryptering: Representerar ingen kryptering.

När du anger alternativet NoEncryption kan du inte ange alternativet PlaintextMetadata till false. Om du försöker göra det genereras ett undantag.

NOTE
Mer information om andra attribut som du kan ange finns i Policy-gränssnittsbeskrivningen i AEM Forms API Reference.

Skapa en princippost

En princippost kopplar principer, som är grupper och användare, och behörigheter till en princip. En princip måste ha minst en princippost. Anta till exempel att du utför följande uppgifter:

  • Skapa och registrera en princippost som gör det möjligt för en grupp att endast visa ett dokument online och förhindrar mottagarna från att kopiera det.
  • Koppla principposten till profilen.
  • Skydda ett dokument med profilen med Acrobat.

Dessa åtgärder gör att mottagarna bara kan visa dokumentet online och inte kan kopiera det. Dokumentet förblir säkert tills du har tagit bort skyddet från det.

Registrera profilen

En ny princip måste registreras innan den kan användas. När du har registrerat en profil kan du använda den för att skydda dokument.

Skapa en profil med Java API create-a-policy-using-the-java-api

Skapa en profil med hjälp av API:t för dokumentsäkerhet (Java):

  1. Inkludera projektfiler.

    Inkludera JAR-klientfiler, som adobe-rightsmanagement-client.jar, i Java-projektets klassökväg.

  2. Skapa ett API-objekt för Document Security Client.

    • Skapa ett ServiceClientFactory-objekt som innehåller anslutningsegenskaper.
    • Skapa ett DocumentSecurityClient-objekt med hjälp av dess konstruktor och skicka ServiceClientFactory-objektet.

  3. Ange principens attribut.

    • Skapa ett Policy-objekt genom att anropa InfomodelObjectFactory-objektets statiska createPolicy-metod. Den här metoden returnerar ett Policy-objekt.
    • Ange principens namnattribut genom att anropa Policy-objektets setName-metod och skicka ett strängvärde som anger principnamnet.
    • Ange principens beskrivning genom att anropa Policy-objektets setDescription-metod och skicka ett strängvärde som anger principens beskrivning.
    • Ange den principuppsättning som den nya principen tillhör genom att anropa Policy-objektets setPolicySetName-metod och skicka ett strängvärde som anger principuppsättningens namn. (Du kan ange null för det här parametervärdet som resulterar i att principen läggs till i principuppsättningen Mina principer.)
    • Skapa principens giltighetsperiod genom att anropa InfomodelObjectFactory-objektets statiska createValidityPeriod-metod. Den här metoden returnerar ett ValidityPeriod-objekt.
    • Ange antalet dagar som ett principskyddat dokument är tillgängligt för genom att anropa ValidityPeriod-objektets setRelativeExpirationDays-metod och skicka ett heltalsvärde som anger antalet dagar.
    • Ange principens giltighetsperiod genom att anropa Policy-objektets setValidityPeriod-metod och skicka ValidityPeriod-objektet.

  4. Skapa en princippost.

    • Skapa en princippost genom att anropa InfomodelObjectFactory-objektets statiska createPolicyEntry-metod. Den här metoden returnerar ett PolicyEntry-objekt.
    • Ange principens behörigheter genom att anropa InfomodelObjectFactory-objektets statiska createPermission-metod. Skicka en statisk datamedlem som tillhör gränssnittet Permission som representerar behörigheten. Den här metoden returnerar ett Permission-objekt. Om du till exempel vill lägga till behörigheten som gör att användare kan kopiera data från ett principskyddat PDF-dokument, skickar du Permission.COPY. (Upprepa det här steget för varje behörighet att lägga till).
    • Lägg till behörigheten till principposten genom att anropa PolicyEntry-objektets addPermission-metod och skicka Permission-objektet. (Upprepa det här steget för varje Permission-objekt som du har skapat).
    • Skapa principobjektet genom att anropa InfomodelObjectFactory-objektets statiska createSpecialPrincipal-metod. Skicka en datamedlem som tillhör objektet InfomodelObjectFactory som representerar huvudkontot. Den här metoden returnerar ett Principal-objekt. Om du till exempel vill lägga till utgivaren av dokumentet som huvudnamn skickar du InfomodelObjectFactory.PUBLISHER_PRINCIPAL.
    • Lägg till huvudkontot i principposten genom att anropa PolicyEntry-objektets setPrincipal-metod och skicka Principal-objektet.
    • Lägg till principposten i principen genom att anropa Policy-objektets addPolicyEntry-metod och skicka PolicyEntry-objektet.

  5. Registrera policyn.

    • Skapa ett PolicyManager-objekt genom att anropa DocumentSecurityClient-objektets getPolicyManager-metod.

    • Registrera principen genom att anropa PolicyManager-objektets registerPolicy-metod och skicka följande värden:

      • Objektet Policy som representerar principen som ska registreras.

    • Ett strängvärde som representerar den principuppsättning som principen tillhör.

    Om du använder ett AEM formuläradministratörskonto i anslutningsinställningarna för att skapa objektet DocumentSecurityClient anger du namnet på principuppsättningen när du anropar metoden registerPolicy. Om du skickar ett null-värde för principuppsättningen skapas principen i administratörens Mina principer -principuppsättning.

    Om du använder en dokumentsäkerhetsanvändare i anslutningsinställningarna kan du anropa den överlagrade metoden registerPolicy som bara accepterar principen. Du behöver alltså inte ange namnet på principuppsättningen. Principen läggs dock till i principuppsättningen med namnet Mina principer. Om du inte vill lägga till den nya principen i den här principinställningen anger du ett principuppsättningsnamn när du anropar metoden registerPolicy.

    note note
    NOTE
    Referera till en befintlig principuppsättning när du skapar en profil. Om du anger en principuppsättning som inte finns genereras ett undantag.

Följande kodexempel innehåller information om hur du använder Document Security-tjänsten:

  • "Snabbstart (SOAP läge): Skapa en profil med Java API"

Skapa en profil med webbtjänstens API create-a-policy-using-the-web-service-api

Skapa en profil med hjälp av API:t för dokumentsäkerhet (webbtjänsten):

  1. Inkludera projektfiler.

    Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

    note note
    NOTE
    Ersätt localhost med IP-adressen för servern som är värd för AEM Forms.

  2. Skapa ett API-objekt för Document Security Client.

    • Skapa ett DocumentSecurityServiceClient-objekt med hjälp av dess standardkonstruktor.

    • Skapa ett DocumentSecurityServiceClient.Endpoint.Address-objekt med konstruktorn System.ServiceModel.EndpointAddress. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempel http://localhost:8080/soap/services/RightsManagementService?WSDL). Du behöver inte använda attributet lc_version. Detta attribut används när du skapar en tjänstreferens.)

    • Skapa ett System.ServiceModel.BasicHttpBinding-objekt genom att hämta värdet för fältet RightsManagementServiceClient.Endpoint.Binding. Skicka returvärdet till BasicHttpBinding.

    • Ställ in System.ServiceModel.BasicHttpBinding-objektets MessageEncoding-fält till WSMessageEncoding.Mtom. Detta värde garanterar att MTOM används.

    • Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:

      • Tilldela användarnamnet för AEM formulär till fältet RightsManagementServiceClient.ClientCredentials.UserName.UserName.
      • Tilldela motsvarande lösenordsvärde till fältet RightsManagementServiceClient.ClientCredentials.UserName.Password.
      • Tilldela konstantvärdet HttpClientCredentialType.Basic till fältet BasicHttpBindingSecurity.Transport.ClientCredentialType.

    • Tilldela konstantvärdet BasicHttpSecurityMode.TransportCredentialOnly till fältet BasicHttpBindingSecurity.Security.Mode.

  3. Ange principens attribut.

    • Skapa ett PolicySpec-objekt med hjälp av dess konstruktor.
    • Ange principens namn genom att tilldela ett strängvärde till PolicySpec-objektets name-datamedlem.
    • Ange principens beskrivning genom att tilldela ett strängvärde till PolicySpec-objektets description-datamedlem.
    • Ange den principuppsättning som principen tillhör genom att tilldela ett strängvärde till PolicySpec-objektets policySetName-datamedlem. Ange ett befintligt principuppsättningsnamn. (Du kan ange null för det här parametervärdet som resulterar i att principen läggs till i Mina principer.)
    • Ange principens offlinelåneperiod genom att tilldela ett heltalsvärde till PolicySpec-objektets offlineLeasePeriod-datamedlem.
    • Ange policyXml-objektets PolicySpec-datamedlem med ett strängvärde som representerar PDRL-XML-data. Om du vill utföra den här åtgärden skapar du ett .NET StreamReader-objekt med hjälp av dess konstruktor. Skicka platsen för en PDRL XML-fil som representerar principen till konstruktorn StreamReader. Anropa sedan metoden ReadLine för objektet StreamReader och tilldela returvärdet till en strängvariabel. Upprepa genom objektet StreamReader tills metoden ReadLine returnerar null. Tilldela strängvariabeln till PolicySpec-objektets policyXml-datamedlem.

  4. Skapa en princippost.

    Du behöver inte skapa en princippost när du skapar en profil med webbtjänstens API för dokumentsäkerhet. Posten för profilen definieras i PDRL-dokumentet.

  5. Registrera policyn.

    Registrera principen genom att anropa DocumentSecurityServiceClient-objektets registerPolicy-metod och skicka följande värden:

    • Objektet PolicySpec som representerar principen som ska registreras.
    • Ett strängvärde som representerar den principuppsättning som principen tillhör. Du kan ange ett null-värde som resulterar i att principen läggs till i principuppsättningen MyPolices.

    Om du använder ett AEM formuläradministratörskonto i anslutningsinställningarna för att skapa objektet DocumentSecurityClient anger du namnet på principuppsättningen när du anropar metoden registerPolicy.

    Om du använder en Document SecurityDocument Security-användare i anslutningsinställningarna kan du anropa den överlagrade registerPolicy-metoden som bara accepterar principen. Du behöver alltså inte ange namnet på principuppsättningen. Principen läggs dock till i principuppsättningen med namnet Mina principer. Om du inte vill lägga till den nya principen i den här principinställningen anger du ett principuppsättningsnamn när du anropar metoden registerPolicy.

    note note
    NOTE
    När du skapar en profil och anger en principuppsättning måste du ange en befintlig principuppsättning. Om du anger en principuppsättning som inte finns genereras ett undantag.

Följande snabbstarter innehåller kodexempel på hur du använder dokumentsäkerhetstjänsten:

  • "Snabbstart (MTOM): Skapa en princip med hjälp av webbtjänstens API"
  • "Snabbstart (SwaRef): Skapa en princip med hjälp av webbtjänstens API"

Ändra principer modifying-policies

Du kan ändra en befintlig profil med Java API:t för dokumentsäkerhet eller webbtjänstens API. Om du vill ändra en befintlig princip hämtar du den, ändrar den och uppdaterar sedan principen på servern. Anta till exempel att du hämtar en befintlig princip och förlänger dess giltighetsperiod. Du måste uppdatera profilen innan ändringen börjar gälla.

Du kan ändra en profil när affärskraven ändras och profilen inte längre speglar dessa krav. I stället för att skapa en profil kan du helt enkelt uppdatera en befintlig profil.

Om du vill ändra principattribut med en webbtjänst (till exempel med Java-proxyklasser som har skapats med JAX-WS) måste du se till att profilen har registrerats med dokumentsäkerhetstjänsten. Du kan sedan referera till den befintliga profilen med metoden PolicySpec.getPolicyXml och ändra principattributen med de tillämpliga metoderna. Du kan till exempel ändra offlinelåneperioden genom att anropa metoden PolicySpec.setOfflineLeasePeriod.

NOTE
Mer information om Document Security-tjänsten finns i Tjänstreferens för AEM Forms.

Sammanfattning av steg summary_of_steps-1

Så här ändrar du en befintlig princip:

  1. Inkludera projektfiler.
  2. Skapa ett API-objekt för Document Security Client.
  3. Hämta en befintlig princip.
  4. Ändra profilattribut.
  5. Uppdatera profilen.

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.

Skapa ett API-objekt för dokumentsäkerhetsklienten

Innan du programmässigt kan utföra en Document Security-tjänståtgärd måste du skapa ett klientobjekt för Document Security-tjänsten. Om du använder Java API skapar du ett RightsManagementClient-objekt. Om du använder webbtjänstens API för dokumentsäkerhet skapar du ett RightsManagementServiceService-objekt.

Hämta en befintlig princip

Hämta en befintlig princip om du vill ändra den. Om du vill hämta en princip anger du principnamnet och den principuppsättning som principen tillhör. Om du anger ett null-värde för principuppsättningens namn hämtas principen från principuppsättningen Mina principer .

Ange principens attribut

Om du vill ändra en profil ändrar du värdet för principattributen. Det enda principattribut som du inte kan ändra är namnattributet. Om du till exempel vill ändra principens låneperiod offline kan du ändra värdet på principens attribut för låneperiod offline.

När en princips offlinelåneperiod ändras med en webbtjänst ignoreras fältet offlineLeasePeriod i PolicySpec-gränssnittet. Om du vill uppdatera offlinelåneperioden ändrar du elementet OfflineLeasePeriod i PDRL XML-dokumentet. Referera sedan till det uppdaterade PDRL XML-dokumentet med policyXML-gränssnittets PolicySpec-datamedlem.

NOTE
Mer information om andra attribut som du kan ange finns i Policy-gränssnittsbeskrivningen i AEM Forms API Reference.

Uppdatera principen

Innan de ändringar du gör i en profil börjar gälla måste du uppdatera den med tjänsten Dokumentsäkerhet. Ändringar i profiler som skyddar dokument uppdateras nästa gång det profilskyddade dokumentet synkroniseras med dokumentsäkerhetstjänsten.

Ändra befintliga profiler med Java API modify-existing-policies-using-the-java-api

Ändra en befintlig profil med hjälp av dokumentsäkerhets-API (Java):

  1. Inkludera projektfiler.

    Inkludera JAR-klientfiler, som adobe-rightsmanagement-client.jar, i Java-projektets klassökväg.

  2. Skapa ett API-objekt för Document Security Client.

    • Skapa ett ServiceClientFactory-objekt som innehåller anslutningsegenskaper.
    • Skapa ett RightsManagementClient-objekt med hjälp av dess konstruktor och skicka ServiceClientFactory-objektet.

  3. Hämta en befintlig princip.

    • Skapa ett PolicyManager-objekt genom att anropa RightsManagementClient-objektets getPolicyManager-metod.

    • Skapa ett Policy-objekt som representerar principen som ska uppdateras genom att anropa PolicyManager-objektets getPolicy-metod och skicka följande värden"

      • Ett strängvärde som representerar namnet på den principuppsättning som principen tillhör. Du kan ange null som resulterar i att principuppsättningen MyPolicies används.
      • Ett strängvärde som representerar principnamnet.

  4. Ange principens attribut.

    Ändra regelns attribut så att de uppfyller företagets krav. Om du till exempel vill ändra principens låneperiod offline anropar du Policy-objektets setOfflineLeasePeriod-metod.

  5. Uppdatera profilen.

    Uppdatera principen genom att anropa PolicyManager-objektets updatePolicy-metod. Skicka objektet Policy som representerar principen som ska uppdateras.

Kodexempel

Exempel på kod som använder dokumentsäkerhetstjänsten finns i Snabbstart(SOAP): Ändra en profil med hjälp av Java API-avsnittet.

Ändra befintliga profiler med webbtjänstens API modify-existing-policies-using-the-web-service-api

Ändra en befintlig profil med hjälp av API:t för dokumentsäkerhet (webbtjänsten):

  1. Inkludera projektfiler.

    Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

    note note
    NOTE
    Ersätt localhost med IP-adressen för servern som är värd för AEM Forms.

  2. Skapa ett API-objekt för Document Security Client.

    • Skapa ett RightsManagementServiceClient-objekt med hjälp av dess standardkonstruktor.

    • Skapa ett RightsManagementServiceClient.Endpoint.Address-objekt med konstruktorn System.ServiceModel.EndpointAddress. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempel http://localhost:8080/soap/services/RightsManagementService?WSDL). Du behöver inte använda attributet lc_version. Detta attribut används när du skapar en tjänstreferens.)

    • Skapa ett System.ServiceModel.BasicHttpBinding-objekt genom att hämta värdet för fältet RightsManagementServiceClient.Endpoint.Binding. Skicka returvärdet till BasicHttpBinding.

    • Ställ in System.ServiceModel.BasicHttpBinding-objektets MessageEncoding-fält till WSMessageEncoding.Mtom. Detta värde garanterar att MTOM används.

    • Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:

      • Tilldela användarnamnet för AEM formulär till fältet RightsManagementServiceClient.ClientCredentials.UserName.UserName.
      • Tilldela motsvarande lösenordsvärde till fältet RightsManagementServiceClient.ClientCredentials.UserName.Password.
      • Tilldela konstantvärdet HttpClientCredentialType.Basic till fältet BasicHttpBindingSecurity.Transport.ClientCredentialType.

    • Tilldela konstantvärdet BasicHttpSecurityMode.TransportCredentialOnly till fältet BasicHttpBindingSecurity.Security.Mode.

  3. Hämta en befintlig princip.

    Skapa ett PolicySpec-objekt som representerar principen som ska ändras genom att anropa RightsManagementServiceClient-objektets getPolicy-metod och skicka följande värden:

    • Ett strängvärde som anger namnet på den principuppsättning som principen tillhör. Du kan ange null som resulterar i att principuppsättningen MyPolicies används.
    • Ett strängvärde som anger principens namn.

  4. Ange principens attribut.

    Ändra regelns attribut så att de uppfyller företagets krav.

  5. Uppdatera profilen.

    Uppdatera principen genom att anropa RightsManagementServiceClient-objektets updatePolicyFromSDK-metod och skicka PolicySpec-objektet som representerar principen som ska uppdateras.

Kodexempel

Följande snabbstarter innehåller kodexempel på hur du använder dokumentsäkerhetstjänsten:

  • "Snabbstart (MTOM): Ändra en princip med hjälp av webbtjänstens API"
  • "Snabbstart (SwaRef): Ändra en princip med hjälp av webbtjänstens API"

Ta bort profiler deleting-policies

Du kan ta bort en befintlig princip med Java API:t för dokumentsäkerhet eller webbtjänstens API. När en profil har tagits bort kan den inte längre användas för att skydda dokument. Befintliga principskyddade dokument som använder profilen är dock fortfarande skyddade. Du kan ta bort en profil när en nyare blir tillgänglig.

NOTE
Mer information om Document Security-tjänsten finns i Tjänstreferens för AEM Forms.

Sammanfattning av steg summary_of_steps-2

Så här tar du bort en befintlig princip:

  1. Inkludera projektfiler
  2. Skapa ett API-objekt för Document Security Client.
  3. Ta bort profilen.

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.

Skapa ett API-objekt för dokumentsäkerhetsklienten

Innan du programmässigt kan utföra en dokumentsäkerhetstjänståtgärd måste du skapa ett klientobjekt för dokumentsäkerhetstjänsten. Om du använder Java API skapar du ett RightsManagementClient-objekt. Om du använder webbtjänstens API för dokumentsäkerhet skapar du ett RightsManagementServiceService-objekt.

Ta bort profilen

Om du vill ta bort en profil anger du vilken princip som ska tas bort och vilken principuppsättning som principen tillhör. Den användare vars inställningar används för att anropa AEM Forms måste ha behörighet att ta bort profilen, annars inträffar ett undantag. Om du försöker ta bort en princip som inte finns inträffar ett undantag.

Ta bort profiler med Java API delete-policies-using-the-java-api

Ta bort en profil med hjälp av dokumentsäkerhets-API (Java):

  1. Inkludera projektfiler.

    Inkludera JAR-klientfiler, som adobe-rightsmanagement-client.jar, i Java-projektets klassökväg.

  2. Skapa ett API-objekt för Document Security Client.

    • Skapa ett ServiceClientFactory-objekt som innehåller anslutningsegenskaper.
    • Skapa ett RightsManagementClient-objekt med hjälp av dess konstruktor och skicka ServiceClientFactory-objektet.

  3. Ta bort profilen.

    • Skapa ett PolicyManager-objekt genom att anropa RightsManagementClient-objektets getPolicyManager-metod.

    • Ta bort principen genom att anropa PolicyManager-objektets deletePolicy-metod och skicka följande värden:

      • Ett strängvärde som anger namnet på den principuppsättning som principen tillhör. Du kan ange null som resulterar i att principuppsättningen MyPolicies används.
      • Ett strängvärde som anger namnet på principen som ska tas bort.

Kodexempel

Följande snabbstarter innehåller kodexempel på hur du använder dokumentsäkerhetstjänsten:

  • "Snabbstart (SOAP läge): Ta bort en princip med Java API"

Ta bort profiler med webbtjänstens API delete-policies-using-the-web-service-api

Ta bort en profil med hjälp av API:t för dokumentsäkerhet (webbtjänsten):

  1. Inkludera projektfiler.

    Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

    note note
    NOTE
    Ersätt localhost med IP-adressen för servern som är värd för AEM Forms.

  2. Skapa ett API-objekt för Document Security Client.

    • Skapa ett RightsManagementServiceClient-objekt med hjälp av dess standardkonstruktor.

    • Skapa ett RightsManagementServiceClient.Endpoint.Address-objekt med konstruktorn System.ServiceModel.EndpointAddress. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempel http://localhost:8080/soap/services/RightsManagementService?WSDL). Du behöver inte använda attributet lc_version. Detta attribut används när du skapar en tjänstreferens.)

    • Skapa ett System.ServiceModel.BasicHttpBinding-objekt genom att hämta värdet för fältet RightsManagementServiceClient.Endpoint.Binding. Skicka returvärdet till BasicHttpBinding.

    • Ställ in System.ServiceModel.BasicHttpBinding-objektets MessageEncoding-fält till WSMessageEncoding.Mtom. Detta värde garanterar att MTOM används.

    • Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:

      • Tilldela användarnamnet för AEM formulär till fältet RightsManagementServiceClient.ClientCredentials.UserName.UserName.
      • Tilldela motsvarande lösenordsvärde till fältet RightsManagementServiceClient.ClientCredentials.UserName.Password.
      • Tilldela konstantvärdet HttpClientCredentialType.Basic till fältet BasicHttpBindingSecurity.Transport.ClientCredentialType.

    • Tilldela konstantvärdet BasicHttpSecurityMode.TransportCredentialOnly till fältet BasicHttpBindingSecurity.Security.Mode.

  3. Ta bort profilen.

    Ta bort en princip genom att anropa RightsManagementServiceClient-objektets deletePolicy-metod och skicka följande värden:

    • Ett strängvärde som anger namnet på den principuppsättning som principen tillhör. Du kan ange null som resulterar i att principuppsättningen MyPolicies används.
    • Ett strängvärde som anger namnet på principen som ska tas bort.

Kodexempel

Följande snabbstarter innehåller kodexempel på hur du använder dokumentsäkerhetstjänsten:

  • "Snabbstart (MTOM): Ta bort en princip med hjälp av webbtjänstens API"
  • "Snabbstart (SwaRef): Ta bort en princip med webbtjänstens API"

Tillämpa principer på PDF-dokument applying-policies-to-pdf-documents

Du kan tillämpa en profil på ett PDF-dokument för att skydda dokumentet. Genom att tillämpa en profil på ett PDF-dokument begränsar du åtkomsten till dokumentet. Du kan inte tillämpa en profil på ett dokument om dokumentet redan är skyddat med en profil.

Medan dokumentet är öppet kan du även begränsa åtkomsten till Acrobat- och Adobe Reader-funktioner, inklusive möjligheten att skriva ut och kopiera text, göra ändringar samt lägga till signaturer och kommentarer i ett dokument. Dessutom kan du återkalla ett profilskyddat PDF-dokument när du inte längre vill att användarna ska få åtkomst till dokumentet.

Du kan övervaka användningen av ett profilskyddat dokument när du har distribuerat det. Det innebär att du kan se hur dokumentet används och vem som använder det. Du kan till exempel ta reda på när någon har öppnat dokumentet.

NOTE
Mer information om Document Security-tjänsten finns i Tjänstreferens för AEM Forms.

Sammanfattning av steg summary_of_steps-3

Så här använder du en profil för ett PDF-dokument:

  1. Inkludera projektfiler.
  2. Skapa ett API-objekt för Document Security Client.
  3. Hämta ett PDF-dokument som en profil tillämpas på.
  4. Använd en befintlig profil för dokumentet i PDF.
  5. Spara det principskyddade PDF-dokumentet.

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.

Skapa ett API-objekt för dokumentsäkerhetsklienten

Skapa ett klientobjekt för tjänsten Dokumentsäkerhet innan du programmässigt utför en åtgärd. Om du använder Java API skapar du ett DocumentSecurityClient-objekt. Om du använder webbtjänstens API för dokumentsäkerhet skapar du ett DocumentSecurityServiceService-objekt.

Hämta ett PDF-dokument

Du kan hämta ett PDF-dokument för att tillämpa en profil. När du har tillämpat en profil på dokumentet i PDF begränsas användare när dokumentet används. Om profilen t.ex. inte aktiverar dokumentet för att öppnas offline måste användarna vara online för att kunna öppna dokumentet.

Använd en befintlig princip i dokumentet PDF

Om du vill tillämpa en profil på ett PDF-dokument refererar du till en befintlig princip och anger vilken principuppsättning som policyn tillhör. Användaren som anger anslutningsegenskaperna måste ha tillgång till den angivna principen. Annars inträffar ett undantag.

Spara PDF-dokumentet

När dokumentsäkerhetstjänsten har tillämpat en profil på ett PDF-dokument kan du spara det profilskyddade PDF-dokumentet som en PDF-fil.

Se även

Inkludera AEM Forms Java-biblioteksfiler

Ange anslutningsegenskaper

Återkalla åtkomst till dokument

Tillämpa en profil på ett PDF-dokument med Java API apply-a-policy-to-a-pdf-document-using-the-java-api

Tillämpa en profil på ett PDF-dokument med hjälp av dokumentets säkerhets-API (Java):

  1. Inkludera projektfiler.

    Inkludera JAR-klientfiler, som adobe-rightsmanagement-client.jar, i Java-projektets klassökväg.

  2. Skapa ett API-objekt för Document Security Client.

    • Skapa ett ServiceClientFactory-objekt som innehåller anslutningsegenskaper.
    • Skapa ett RightsManagementClient-objekt med hjälp av dess konstruktor och skicka ServiceClientFactory-objektet.

  3. Hämta ett PDF-dokument.

    • Skapa ett java.io.FileInputStream-objekt som representerar PDF-dokumentet med hjälp av dess konstruktor. Skicka ett strängvärde som anger platsen för PDF-dokumentet.
    • Skapa ett com.adobe.idp.Document-objekt med hjälp av dess konstruktor och skicka java.io.FileInputStream-objektet.

  4. Använd en befintlig profil för dokumentet i PDF.

    • Skapa ett DocumentManager-objekt genom att anropa RightsManagementClient-objektets getDocumentManager-metod.

    • Tillämpa en profil på PDF-dokumentet genom att anropa DocumentManager-objektets protectDocument-metod och skicka följande värden:

      • Det com.adobe.idp.Document-objekt som innehåller det PDF-dokument som principen tillämpas på.
      • Ett strängvärde som anger dokumentets namn.
      • Ett strängvärde som anger namnet på den principuppsättning som principen tillhör. Du kan ange ett null-värde som resulterar i att principuppsättningen MyPolicies används.
      • Ett strängvärde som anger principnamnet.
      • Ett strängvärde som representerar namnet på användarhanterardomänen för den användare som är dokumentets utgivare. Det här parametervärdet är valfritt och kan vara null (om parametern är null måste nästa parametervärde vara null).
      • Ett strängvärde som representerar namnet på den kanoniska användaren av användarhanteraren som är dokumentets utgivare. Det här parametervärdet är valfritt och kan vara null (om parametern är null måste det föregående parametervärdet vara null).
      • En com.adobe.livecycle.rightsmanagement.Locale som representerar det språkområde som används för att välja MS Office-mallen. Det här parametervärdet är valfritt och används inte för PDF-dokument. Ange null om du vill skydda ett PDF-dokument.

      Metoden protectDocument returnerar ett RMSecureDocumentResult-objekt som innehåller det principskyddade PDF-dokumentet.

  5. Spara dokumentet PDF.

    • Anropa RMSecureDocumentResult-objektets getProtectedDoc-metod för att hämta det principskyddade PDF-dokumentet. Den här metoden returnerar ett com.adobe.idp.Document-objekt.
    • Skapa ett java.io.File-objekt och kontrollera att filtillägget är PDF.
    • Anropa com.adobe.idp.Document-objektets copyToFile-metod för att kopiera innehållet i Document-objektet till filen (se till att du använder det Document-objekt som returnerades av metoden getProtectedDoc).

Kodexempel

Följande snabbstarter innehåller kodexempel på hur du använder dokumentsäkerhetstjänsten:

  • "Snabbstart (EJB-läge): Tillämpa en princip på ett PDF-dokument med Java API"
  • "Snabbstart (SOAP läge): Tillämpa en princip på ett PDF-dokument med Java API"

Se även

Inkludera AEM Forms Java-biblioteksfiler

Ange anslutningsegenskaper

Tillämpa en profil på ett PDF-dokument med hjälp av webbtjänstens API apply-a-policy-to-a-pdf-document-using-the-web-service-api

Tillämpa en profil på ett PDF-dokument med hjälp av API:t för dokumentsäkerhet (webbtjänsten):

  1. Inkludera projektfiler.

    Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

    note note
    NOTE
    Ersätt localhost med IP-adressen för servern som är värd för AEM Forms.

  2. Skapa ett API-objekt för Document Security Client.

    • Skapa ett RightsManagementServiceClient-objekt med hjälp av dess standardkonstruktor.

    • Skapa ett RightsManagementServiceClient.Endpoint.Address-objekt med konstruktorn System.ServiceModel.EndpointAddress. Skicka ett strängvärde som anger WSDL till Forms-tjänsten (till exempel http://localhost:8080/soap/services/RightsManagementService?WSDL). Du behöver inte använda attributet lc_version. Detta attribut används när du skapar en tjänstreferens.)

    • Skapa ett System.ServiceModel.BasicHttpBinding-objekt genom att hämta värdet för fältet RightsManagementServiceClient.Endpoint.Binding. Skicka returvärdet till BasicHttpBinding.

    • Ställ in System.ServiceModel.BasicHttpBinding-objektets MessageEncoding-fält till WSMessageEncoding.Mtom. Detta värde garanterar att MTOM används.

    • Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:

      • Tilldela användarnamnet för AEM formulär till fältet RightsManagementServiceClient.ClientCredentials.UserName.UserName.
      • Tilldela motsvarande lösenordsvärde till fältet RightsManagementServiceClient.ClientCredentials.UserName.Password.
      • Tilldela konstantvärdet HttpClientCredentialType.Basic till fältet BasicHttpBindingSecurity.Transport.ClientCredentialType.

    • Tilldela konstantvärdet BasicHttpSecurityMode.TransportCredentialOnly till fältet BasicHttpBindingSecurity.Security.Mode.

  3. Hämta ett PDF-dokument.

    • Skapa ett BLOB-objekt med hjälp av dess konstruktor. Objektet BLOB används för att lagra ett PDF-dokument som en princip tillämpas på.
    • Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för PDF-dokumentet och läget som filen ska öppnas i.
    • Skapa en bytearray som lagrar innehållet i objektet System.IO.FileStream. Ta reda på bytearraystorleken genom att hämta System.IO.FileStream-objektets Length-egenskap.
    • Fyll i bytearrayen med strömdata genom att anropa System.IO.FileStream-objektets Read-metod. Skicka bytearrayen, startpositionen och strömlängden som ska läsas.
    • Fyll BLOB-objektet genom att tilldela dess MTOM-fält med innehållet i bytearrayen.

  4. Använd en befintlig profil för dokumentet i PDF.

    Tillämpa en profil på PDF-dokumentet genom att anropa RightsManagementServiceClient-objektets protectDocument-metod och skicka följande värden:

    • Det BLOB-objekt som innehåller det PDF-dokument som principen tillämpas på.
    • Ett strängvärde som anger dokumentets namn.
    • Ett strängvärde som anger namnet på den principuppsättning som principen tillhör. Du kan ange ett null-värde som resulterar i att principuppsättningen MyPolicies används.
    • Ett strängvärde som anger principnamnet.
    • Ett strängvärde som representerar namnet på användarhanterardomänen för den användare som är dokumentets utgivare. Det här parametervärdet är valfritt och kan vara null (om parametern är null måste nästa parametervärde vara null).
    • Ett strängvärde som representerar namnet på den kanoniska användaren av användarhanteraren som är dokumentets utgivare. Det här parametervärdet är valfritt och kan vara null (om parametern är null måste det föregående parametervärdet vara null).
    • Ett RMLocale-värde som anger språkvärdet (till exempel RMLocale.en).
    • En strängutdataparameter som används för att lagra principens identifierarvärde.
    • En strängutdataparameter som används för att lagra det principskyddade identifierarvärdet.
    • En strängutdataparameter som används för att lagra mime-typen (till exempel application/pdf).

    Metoden protectDocument returnerar ett BLOB-objekt som innehåller det principskyddade PDF-dokumentet.

  5. Spara dokumentet PDF.

    • Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för det principskyddade PDF-dokumentet.
    • Skapa en bytearray som lagrar datainnehållet för objektet BLOB som returnerades av metoden protectDocument. Fyll i bytearrayen genom att hämta värdet för BLOB-objektets MTOM-datamedlem.
    • Skapa ett System.IO.BinaryWriter-objekt genom att anropa dess konstruktor och skicka System.IO.FileStream-objektet.
    • Skriv bytearrayens innehåll till en PDF-fil genom att anropa System.IO.BinaryWriter-objektets Write-metod och skicka bytearrayen.

Kodexempel

Följande snabbstarter innehåller kodexempel på hur du använder dokumentsäkerhetstjänsten:

  • "Snabbstart (MTOM): Tillämpa en princip på ett PDF-dokument med hjälp av webbtjänstens API"
  • "Snabbstart (SwaRef): Tillämpa en princip på ett PDF-dokument med hjälp av webbtjänstens API "

Ta bort profiler från PDF-dokument removing-policies-from-pdf-documents

Du kan ta bort en profil från ett profilskyddat dokument om du vill ta bort skyddet från dokumentet. Det vill säga om du inte längre vill att dokumentet ska skyddas av en profil. Om du vill uppdatera ett policyskyddat dokument med en nyare profil är det effektivare att byta profil i stället för att ta bort profilen och lägga till den uppdaterade profilen.

NOTE
Mer information om Document Security-tjänsten finns i Tjänstreferens för AEM Forms.

Sammanfattning av steg summary_of_steps-4

Så här tar du bort en profil från ett principskyddat PDF-dokument:

  1. Inkludera projektfiler
  2. Skapa ett API-objekt för Document Security Client.
  3. Hämta ett policyskyddat PDF-dokument.
  4. Ta bort profilen från dokumentet PDF.
  5. Spara det oskyddade PDF-dokumentet.

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.

Skapa ett API-objekt för dokumentsäkerhetsklienten

Skapa ett klientobjekt för tjänsten Dokumentsäkerhet innan du programmässigt utför en åtgärd.

Hämta ett principskyddat PDF-dokument

Du kan hämta ett principskyddat PDF-dokument om du vill ta bort en profil. Om du försöker ta bort en princip från ett PDF-dokument som inte skyddas av en profil genereras ett undantagsfel.

Ta bort profilen från dokumentet PDF

Du kan ta bort en princip från ett principskyddat PDF-dokument under förutsättning att en administratör anges i anslutningsinställningarna. Om inte måste principen som används för att skydda ett dokument innehålla behörigheten SWITCH_POLICY för att ta bort en princip från ett PDF-dokument. Dessutom måste den användare som anges i AEM Forms anslutningsinställningar också ha den behörigheten. Annars genereras ett undantag.

Spara det oskyddade PDF-dokumentet

När dokumentskyddstjänsten har tagit bort en profil från ett PDF-dokument kan du spara det oskyddade PDF-dokumentet som en PDF-fil.

Se även

Inkludera AEM Forms Java-biblioteksfiler

Ange anslutningsegenskaper

Tillämpa principer på PDF-dokument

Ta bort en profil från ett PDF-dokument med Java API remove-a-policy-from-a-pdf-document-using-the-java-api

Ta bort en profil från ett principskyddat PDF-dokument med hjälp av dokumentsäkerhets-API (Java):

  1. Inkludera projektfiler.

    Inkludera JAR-klientfiler, som adobe-rightsmanagement-client.jar, i Java-projektets klassökväg.

  2. Skapa ett API-objekt för Document Security Client.

    • Skapa ett ServiceClientFactory-objekt som innehåller anslutningsegenskaper.
    • Skapa ett DocumentSecurityClient-objekt med hjälp av dess konstruktor och skicka ServiceClientFactory-objektet.

  3. Hämta ett policyskyddat PDF-dokument.

    • Skapa ett java.io.FileInputStream-objekt som representerar det principskyddade PDF-dokumentet genom att använda dess konstruktor och skicka ett strängvärde som anger platsen för PDF-dokumentet.
    • Skapa ett com.adobe.idp.Document-objekt med hjälp av dess konstruktor och skicka java.io.FileInputStream-objektet.

  4. Ta bort profilen från dokumentet PDF.

    • Skapa ett DocumentManager-objekt genom att anropa DocumentSecurityClient-objektets getDocumentManager-metod.
    • Ta bort en princip från PDF-dokumentet genom att anropa DocumentManager-objektets removeSecurity-metod och skicka com.adobe.idp.Document-objektet som innehåller det principskyddade PDF-dokumentet. Den här metoden returnerar ett com.adobe.idp.Document-objekt som innehåller ett oskyddat PDF-dokument.

  5. Spara det oskyddade PDF-dokumentet.

    • Skapa ett java.io.File-objekt och kontrollera att filtillägget är PDF.
    • Anropa Document-objektets copyToFile-metod för att kopiera innehållet i Document-objektet till filen (se till att du använder det Document-objekt som returnerades av metoden removeSecurity).

Kodexempel

Följande snabbstarter innehåller kodexempel på hur du använder dokumentsäkerhetstjänsten:

  • "Snabbstart (SOAP läge): Ta bort en princip från ett PDF-dokument med Java API"

Ta bort en princip med webbtjänstens API remove-a-policy-using-the-web-service-api

Ta bort en profil från ett principskyddat PDF-dokument med hjälp av dokumentsäkerhets-API:t (webbtjänsten):

  1. Inkludera projektfiler.

    Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

    note note
    NOTE
    Ersätt localhost med IP-adressen för servern som är värd för AEM Forms.

  2. Skapa ett API-objekt för Document Security Client.

    • Skapa ett DocumentSecurityServiceClient-objekt med hjälp av dess standardkonstruktor.

    • Skapa ett DocumentSecurityServiceClient.Endpoint.Address-objekt med konstruktorn System.ServiceModel.EndpointAddress. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempel http://localhost:8080/soap/services/RightsManagementService?WSDL). Du behöver inte använda attributet lc_version. Detta attribut används när du skapar en tjänstreferens.)

    • Skapa ett System.ServiceModel.BasicHttpBinding-objekt genom att hämta värdet för fältet DocumentSecurityServiceClient.Endpoint.Binding. Skicka returvärdet till BasicHttpBinding.

    • Ställ in System.ServiceModel.BasicHttpBinding-objektets MessageEncoding-fält till WSMessageEncoding.Mtom. Detta värde garanterar att MTOM används.

    • Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:

      • Tilldela användarnamnet för AEM formulär till fältet DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
      • Tilldela motsvarande lösenordsvärde till fältet DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
      • Tilldela konstantvärdet HttpClientCredentialType.Basic till fältet BasicHttpBindingSecurity.Transport.ClientCredentialType.

    • Tilldela konstantvärdet BasicHttpSecurityMode.TransportCredentialOnly till fältet BasicHttpBindingSecurity.Security.Mode.

  3. Hämta ett policyskyddat PDF-dokument.

    • Skapa ett BLOB-objekt med hjälp av dess konstruktor. Objektet BLOB används för att lagra det principskyddade PDF-dokumentet som principen tas bort från.
    • Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för PDF-dokumentet och läget som filen ska öppnas i.
    • Skapa en bytearray som lagrar innehållet i objektet System.IO.FileStream. Du kan bestämma storleken på bytearrayen genom att hämta System.IO.FileStream-objektets Length-egenskap.
    • Fyll i bytearrayen med strömdata genom att anropa System.IO.FileStream-objektets Read-metod och skicka bytearrayen, startpositionen och strömlängden som ska läsas.
    • Fyll BLOB-objektet genom att tilldela dess MTOM-fält med innehållet i bytearrayen.

  4. Ta bort profilen från dokumentet PDF.

    Ta bort principen från dokumentet PDF genom att anropa DocumentSecurityServiceClient-objektets removePolicySecurity-metod och skicka det BLOB-objekt som innehåller det principskyddade PDF-dokumentet. Den här metoden returnerar ett BLOB-objekt som innehåller ett oskyddat PDF-dokument.

  5. Spara det oskyddade PDF-dokumentet.

    • Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för det oskyddade PDF-dokumentet.
    • Skapa en bytearray som lagrar datainnehållet för objektet BLOB som returnerades av metoden removePolicySecurity. Fyll i bytearrayen genom att hämta värdet för BLOB-objektets MTOM-fält.
    • Skapa ett System.IO.BinaryWriter-objekt genom att anropa dess konstruktor och skicka System.IO.FileStream-objektet.

Kodexempel

Följande snabbstarter innehåller kodexempel på hur du använder dokumentsäkerhetstjänsten:

  • "Snabbstart (MTOM): Ta bort en princip från ett PDF-dokument med hjälp av webbtjänstens API "
  • "Snabbstart (SwaRef): Ta bort en princip från ett PDF-dokument med hjälp av webbtjänstens API"

Se även

Anropa AEM Forms med MTOM

Anropa AEM Forms med SwaRef

Återkalla åtkomst till dokument revoking-access-to-documents

Du kan återkalla åtkomsten till ett profilskyddat PDF-dokument, vilket gör att alla kopior av dokumentet inte är tillgängliga för användarna. När en användare försöker öppna ett återkallat PDF-dokument omdirigeras de till en angiven URL där ett ändrat dokument kan visas. URL:en som användaren omdirigeras till måste anges programmatiskt. När du återkallar åtkomsten till ett dokument träder ändringen i kraft nästa gång användaren synkroniserar med dokumentsäkerhetstjänsten genom att öppna det profilskyddade dokumentet online.

Möjligheten att återkalla åtkomst till ett dokument ger ytterligare säkerhet. Anta till exempel att en nyare version av ett dokument är tillgänglig och att du inte längre vill att någon ska visa den inaktuella versionen. I det här fallet kan åtkomsten till det äldre dokumentet återkallas och ingen kan visa dokumentet om inte åtkomsten återupprättas.

NOTE
Mer information om Document Security-tjänsten finns i Tjänstreferens för AEM Forms.

Sammanfattning av steg summary_of_steps-5

Så här återkallar du ett principskyddat dokument:

  1. Inkludera projektfiler.
  2. Skapa ett API-objekt för Document Security Client.
  3. Hämta ett policyskyddat PDF-dokument.
  4. Återkalla det profilskyddade dokumentet.

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.

Skapa ett API-objekt för dokumentsäkerhetsklienten

Innan du programmässigt kan utföra en dokumentsäkerhetstjänståtgärd måste du skapa ett klientobjekt för dokumentsäkerhetstjänsten.

Hämta ett principskyddat PDF-dokument

Hämta ett principskyddat PDF-dokument om du vill återkalla det. Du kan inte återkalla ett dokument som redan har återkallats eller som inte är ett principskyddat dokument.

Om du känner till licensvärdet för det profilskyddade dokumentet behöver du inte hämta det profilskyddade PDF-dokumentet. I de flesta fall måste du dock hämta PDF-dokumentet för att få fram värdet för licensidentifieraren.

Återkalla det principskyddade dokumentet

Om du vill återkalla ett profilskyddat dokument anger du ID för licensen för det profilskyddade dokumentet. Du kan dessutom ange URL:en för ett dokument som användaren kan visa när han/hon försöker öppna det återkallade dokumentet. Anta alltså att ett inaktuellt dokument återkallas. När en användare försöker öppna det återkallade dokumentet visas ett uppdaterat dokument i stället för det återkallade dokumentet.

NOTE
Om du försöker återkalla ett dokument som redan har återkallats genereras ett undantag.

Se även

Inkludera AEM Forms Java-biblioteksfiler

Ange anslutningsegenskaper

Tillämpa principer på PDF-dokument

Återställa åtkomst till återkallade dokument

Återkalla åtkomst till dokument med Java API revoke-access-to-documents-using-the-java-api

Återkalla åtkomst till ett principskyddat PDF-dokument med hjälp av dokumentsäkerhets-API (Java):

  1. Inkludera projektfiler

    Inkludera JAR-klientfiler, som adobe-rightsmanagement-client.jar, i Java-projektets klassökväg.

  2. Skapa ett API-objekt för Document Security Client

    • Skapa ett ServiceClientFactory-objekt som innehåller anslutningsegenskaper.
    • Skapa ett DocumentSecurityClient-objekt med hjälp av dess konstruktor och skicka ServiceClientFactory-objektet.

  3. Hämta ett profilskyddat PDF-dokument

    • Skapa ett java.io.FileInputStream-objekt som representerar det principskyddade PDF-dokumentet genom att använda dess konstruktor och skicka ett strängvärde som anger platsen för PDF-dokumentet.
    • Skapa ett com.adobe.idp.Document-objekt med hjälp av dess konstruktor och skicka java.io.FileInputStream-objektet.

  4. Återkalla det profilskyddade dokumentet

    • Skapa ett DocumentManager-objekt genom att anropa DocumentSecurityClient-objektets getDocumentManager-metod.

    • Hämta ID-värdet för licensen för det principskyddade dokumentet genom att anropa DocumentManager-objektets getLicenseId-metod. Skicka det com.adobe.idp.Document-objekt som representerar det principskyddade dokumentet. Den här metoden returnerar ett strängvärde som representerar licensens identifierarvärde.

    • Skapa ett LicenseManager-objekt genom att anropa DocumentSecurityClient-objektets getLicenseManager-metod.

    • Återkalla det principskyddade dokumentet genom att anropa LicenseManager-objektets revokeLicense-metod och skicka följande värden:

      • Ett strängvärde som anger det principskyddade dokumentets ID-värde (ange returvärdet för DocumentManager-objektets getLicenseId -metod).
      • En statisk datamedlem i gränssnittet License som anger orsaken till att dokumentet återkallas. Du kan till exempel ange License.DOCUMENT_REVISED.
      • Ett java.net.URL-värde som anger platsen där ett reviderat dokument finns. Om du inte vill omdirigera en användare till en annan URL kan du skicka null.

Kodexempel

Följande snabbstarter innehåller kodexempel på hur du använder dokumentsäkerhetstjänsten:

  • "Snabbstart (SOAP läge): Återkalla ett dokument med Java API"

Återkalla åtkomst till dokument med hjälp av webbtjänstens API revoke-access-to-documents-using-the-web-service-api

Återkalla åtkomst till ett principskyddat PDF-dokument med hjälp av API:t för dokumentsäkerhet (webbtjänsten):

  1. Inkludera projektfiler

    Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

    note note
    NOTE
    Ersätt localhost med IP-adressen för servern som är värd för AEM Forms.

  2. Skapa ett API-objekt för Document Security Client

    • Skapa ett DocumentSecurityServiceClient-objekt med hjälp av dess standardkonstruktor.

    • Skapa ett DocumentSecurityServiceClient.Endpoint.Address-objekt med konstruktorn System.ServiceModel.EndpointAddress. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempel http://localhost:8080/soap/services/RightsManagementService?WSDL). Du behöver inte använda attributet lc_version. Detta attribut används när du skapar en tjänstreferens.)

    • Skapa ett System.ServiceModel.BasicHttpBinding-objekt genom att hämta värdet för fältet DocumentSecurityServiceClient.Endpoint.Binding. Skicka returvärdet till BasicHttpBinding.

    • Ställ in System.ServiceModel.BasicHttpBinding-objektets MessageEncoding-fält till WSMessageEncoding.Mtom. Detta värde garanterar att MTOM används.

    • Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:

      • Tilldela användarnamnet för AEM formulär till fältet DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
      • Tilldela motsvarande lösenordsvärde till fältet DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
      • Tilldela konstantvärdet HttpClientCredentialType.Basic till fältet BasicHttpBindingSecurity.Transport.ClientCredentialType.

    • Tilldela konstantvärdet BasicHttpSecurityMode.TransportCredentialOnly till fältet BasicHttpBindingSecurity.Security.Mode.

  3. Hämta ett profilskyddat PDF-dokument

    • Skapa ett BLOB-objekt med hjälp av dess konstruktor. Objektet BLOB används för att lagra ett principskyddat PDF-dokument som har återkallats.
    • Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för det principskyddade PDF-dokumentet som ska återkallas samt läget som filen ska öppnas i.
    • Skapa en bytearray som lagrar innehållet i objektet System.IO.FileStream. Du kan bestämma storleken på bytearrayen genom att hämta System.IO.FileStream-objektets Length-egenskap.
    • Fyll i bytearrayen med strömdata genom att anropa System.IO.FileStream-objektets Read-metod och skicka bytearrayen, startpositionen och strömlängden som ska läsas.
    • Fyll BLOB-objektet genom att tilldela dess MTOM-fält med innehållet i bytearrayen.

  4. Återkalla det profilskyddade dokumentet

    • Hämta det principskyddade dokumentets ID-värde för licens genom att anropa DocumentSecurityServiceClient-objektets getLicenseID-metod och skicka BLOB-objektet som representerar det principskyddade dokumentet. Den här metoden returnerar ett strängvärde som representerar licens-ID:t.

    • Återkalla det principskyddade dokumentet genom att anropa DocumentSecurityServiceClient-objektets revokeLicense-metod och skicka följande värden:

      • Ett strängvärde som anger det principskyddade dokumentets ID-värde (ange returvärdet för DocumentSecurityServiceService-objektets getLicenseId -metod).
      • En statisk datamedlem av uppräkningen Reason som anger orsaken till att dokumentet återkallas. Du kan till exempel ange Reason.DOCUMENT_REVISED.
      • Ett string-värde som anger URL-platsen där ett reviderat dokument finns. Om du inte vill omdirigera en användare till en annan URL kan du skicka null.

Kodexempel

Följande snabbstarter innehåller kodexempel på hur du använder dokumentsäkerhetstjänsten:

  • "Snabbstart (MTOM): Återkalla ett dokument med hjälp av webbtjänstens API"
  • "Snabbstart (SwaRef): Återkalla ett dokument med hjälp av webbtjänstens API"

Se även

Ta bort profiler från Word-dokument

Anropa AEM Forms med MTOM

Anropa AEM Forms med SwaRef

Återställa åtkomst till återkallade dokument reinstating-access-to-revoked-documents

Du kan återställa åtkomsten till ett återkallat PDF-dokument, vilket gör att alla kopior av det återkallade dokumentet blir tillgängliga för användarna. När en användare öppnar ett återskapat dokument som har återkallats kan användaren visa dokumentet.

NOTE
Mer information om Document Security-tjänsten finns i Tjänstreferens för AEM Forms.

Sammanfattning av steg summary_of_steps-6

Så här återställer du åtkomsten till ett återkallat PDF-dokument:

  1. Inkludera projektfiler.
  2. Skapa ett API-objekt för Document Security Client.
  3. Hämta licensidentifieraren för det återkallade PDF-dokumentet.
  4. Återställa åtkomst till det återkallade PDF-dokumentet.

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.

Skapa ett API-objekt för dokumentsäkerhetsklienten

Innan du programmässigt kan utföra en dokumentsäkerhetstjänståtgärd måste du skapa ett klientobjekt för dokumentsäkerhetstjänsten. Om du använder Java API skapar du ett DocumentSecurityClient-objekt. Om du använder webbtjänstens API för dokumentsäkerhet skapar du ett DocumentSecurityServiceService-objekt.

Hämta licensidentifieraren för det spärrade PDF-dokumentet

Hämta licensidentifieraren för det återkallade PDF-dokumentet för att återskapa ett återkallat PDF-dokument. När du har fått fram licensens ID-värde kan du återskapa ett återkallat dokument. Om du försöker återskapa ett dokument som inte har återkallats genereras ett undantag.

Återskapa åtkomst till det återkallade PDF-dokumentet

Om du vill återupprätta åtkomsten till ett återkallat PDF-dokument måste du ange det återkallade dokumentets Licensidentifierare. Om du försöker återupprätta åtkomsten till ett PDF-dokument som inte har återkallats genereras ett undantagsfel.

Se även

Inkludera AEM Forms Java-biblioteksfiler

Ange anslutningsegenskaper

Tillämpa principer på PDF-dokument

Återkalla åtkomst till dokument

Återställa åtkomst till återkallade dokument med Java API reinstate-access-to-revoked-documents-using-the-java-api

Återskapa åtkomst till ett återkallat dokument med hjälp av dokumentsäkerhets-API (Java):

  1. Inkludera projektfiler.

    Inkludera JAR-klientfiler, som adobe-rightsmanagement-client.jar, i Java-projektets klassökväg.

  2. Skapa ett API-objekt för Document Security Client.

    • Skapa ett ServiceClientFactory-objekt som innehåller anslutningsegenskaper.
    • Skapa ett DocumentSecurityClient-objekt med hjälp av dess konstruktor och skicka ServiceClientFactory-objektet.

  3. Hämta licensidentifieraren för det återkallade PDF-dokumentet.

    • Skapa ett java.io.FileInputStream-objekt som representerar det spärrade PDF-dokumentet genom att använda dess konstruktor och skicka ett strängvärde som anger platsen för PDF-dokumentet.
    • Skapa ett com.adobe.idp.Document-objekt med hjälp av dess konstruktor och skicka java.io.FileInputStream-objektet.
    • Skapa ett DocumentManager-objekt genom att anropa DocumentSecurityClient-objektets getDocumentManager-metod.
    • Hämta ID-värdet för det återkallade dokumentet genom att anropa DocumentManager-objektets getLicenseId-metod och skicka com.adobe.idp.Document-objektet som representerar det återkallade dokumentet. Den här metoden returnerar ett strängvärde som representerar licens-ID:t.

  4. Återställa åtkomst till det återkallade PDF-dokumentet.

    • Skapa ett LicenseManager-objekt genom att anropa DocumentSecurityClient-objektets getLicenseManager-metod.
    • Återskapa åtkomst till det återkallade PDF-dokumentet genom att anropa LicenseManager-objektets unrevokeLicense-metod och skicka licensidentitetsvärdet för det återkallade dokumentet.

Kodexempel

Följande snabbstarter innehåller kodexempel på hur du använder dokumentsäkerhetstjänsten:

  • "Snabbstart (SOAP läge): Återställa åtkomst till ett återkallat dokument med hjälp av webbtjänstens API"

Återställa åtkomst till återkallade dokument med hjälp av webbtjänstens API reinstate-access-to-revoked-documents-using-the-web-service-api

Återställa åtkomst till ett återkallat dokument med hjälp av API:t för dokumentsäkerhet (webbtjänsten):

  1. Inkludera projektfiler.

    Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

    note note
    NOTE
    Ersätt localhost med IP-adressen för servern som är värd för AEM Forms.

  2. Skapa ett API-objekt för Document Security Client.

    • Skapa ett DocumentSecurityServiceClient-objekt med hjälp av dess standardkonstruktor.

    • Skapa ett DocumentSecurityServiceClient.Endpoint.Address-objekt med konstruktorn System.ServiceModel.EndpointAddress. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempel http://localhost:8080/soap/services/RightsManagementService?WSDL). Du behöver inte använda attributet lc_version. Detta attribut används när du skapar en tjänstreferens.)

    • Skapa ett System.ServiceModel.BasicHttpBinding-objekt genom att hämta värdet för fältet DocumentSecurityServiceClient.Endpoint.Binding. Skicka returvärdet till BasicHttpBinding.

    • Ställ in System.ServiceModel.BasicHttpBinding-objektets MessageEncoding-fält till WSMessageEncoding.Mtom. Detta värde garanterar att MTOM används.

    • Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:

      • Tilldela användarnamnet för AEM formulär till fältet DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
      • Tilldela motsvarande lösenordsvärde till fältet DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
      • Tilldela konstantvärdet HttpClientCredentialType.Basic till fältet BasicHttpBindingSecurity.Transport.ClientCredentialType.

    • Tilldela konstantvärdet BasicHttpSecurityMode.TransportCredentialOnly till fältet BasicHttpBindingSecurity.Security.Mode.

  3. Hämta licensidentifieraren för det återkallade PDF-dokumentet.

    • Skapa ett BLOB-objekt med hjälp av dess konstruktor. Objektet BLOB används för att lagra ett återkallat PDF-dokument som åtkomsten återställs till.
    • Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för det spärrade PDF-dokumentet och läget som filen ska öppnas i.
    • Skapa en bytearray som lagrar innehållet i objektet System.IO.FileStream. Du kan bestämma storleken på bytearrayen genom att hämta System.IO.FileStream-objektets Length-egenskap.
    • Fyll i bytearrayen med strömdata genom att anropa System.IO.FileStream-objektets Read-metod och skicka bytearrayen, startpositionen och strömlängden som ska läsas.
    • Fyll BLOB-objektet genom att tilldela dess MTOM-fält med innehållet i bytearrayen.

  4. Återställa åtkomst till det återkallade PDF-dokumentet.

    • Hämta ID-värdet för det återkallade dokumentet genom att anropa DocumentSecurityServiceClient-objektets getLicenseID-metod och skicka BLOB-objektet som representerar det återkallade dokumentet. Den här metoden returnerar ett strängvärde som representerar licens-ID:t.
    • Återskapa åtkomst till det återkallade PDF-dokumentet genom att anropa DocumentSecurityServiceClient-objektets unrevokeLicense-metod och skicka ett strängvärde som anger det återkallade PDF-dokumentets ID-värde (skicka returvärdet för DocumentSecurityServiceClient-objektets getLicenseId -metod).

Kodexempel

Följande snabbstarter innehåller kodexempel på hur du använder dokumentsäkerhetstjänsten:

  • "Snabbstart (MTOM): Återställa åtkomst till ett återkallat dokument med hjälp av webbtjänstens API"
  • "Snabbstart (SwaRef): Återställa åtkomst till ett återkallat dokument med hjälp av webbtjänstens API"

Se även

Anropa AEM Forms med MTOM

Anropa AEM Forms med SwaRef

Inspektera skyddat PDF-dokument inspecting-policy-protected-pdf-documents

Du kan använda API:t för dokumentsäkerhetstjänsten (Java och webbtjänsten) för att inspektera policyskyddade PDF-dokument. När du inspekterar principskyddade PDF-dokument returneras information om det principskyddade PDF-dokumentet. Du kan till exempel bestämma vilken profil som användes för att skydda dokumentet och datumet då dokumentet var skyddat.

Du kan inte utföra den här åtgärden om LiveCyclet är version 8.x eller tidigare. I AEM Forms finns stöd för att inspektera policyskyddade dokument. Om du försöker inspektera ett principskyddat dokument med LiveCycle 8.x (eller tidigare) genereras ett undantag.

NOTE
Mer information om Document Security-tjänsten finns i Tjänstreferens för AEM Forms.

Sammanfattning av steg summary_of_steps-7

Så här inspekterar du ett principskyddat PDF-dokument:

  1. Inkludera projektfiler.
  2. Skapa ett API-objekt för Document Security Client.
  3. Hämta ett profilskyddat dokument som ska inspekteras.
  4. Hämta information om det profilskyddade dokumentet.

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java, inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du ta med proxyfilerna.

Skapa ett API-objekt för dokumentsäkerhetsklienten

Skapa ett klientobjekt för tjänsten Dokumentsäkerhet innan du programmässigt utför en åtgärd. Om du använder Java API skapar du ett RightsManagementClient-objekt. Om du använder webbtjänstens API för dokumentsäkerhet skapar du ett RightsManagementServiceService-objekt.

Hämta ett principskyddat dokument som ska inspekteras

Hämta ett policyskyddat dokument om du vill inspektera det. Om du försöker inspektera ett dokument som inte är skyddat med en profil eller som har återkallats genereras ett undantag.

Inspect dokumentet

När du har hämtat ett policyskyddat dokument kan du inspektera det.

Hämta information om det principskyddade dokumentet

När du har inspekterat ett policyskyddat PDF-dokument kan du få information om det. Du kan till exempel bestämma vilken profil som ska användas för att skydda dokumentet.

Om du skyddar ett dokument med en princip som tillhör Mina principer och sedan anropar RMInspectResult.getPolicysetName eller RMInspectResult.getPolicysetId returneras null.

Om dokumentet är skyddat med en profil som finns i en principuppsättning (annan än Mina principer) returnerar RMInspectResult.getPolicysetName och RMInspectResult.getPolicysetId giltiga strängar.

Se även

Inkludera AEM Forms Java-biblioteksfiler

Ange anslutningsegenskaper

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

Inspect är ett policyskyddat PDF-dokument med hjälp av API:t för dokumentsäkerhetstjänsten (Java):

  1. Inkludera projektfiler.

    Inkludera JAR-klientfiler, t.ex. adobe-rightsmanagement-client.jar, i Java-projektets klassökväg. Mer information om platsen för dessa filer finns i Inkludera AEM Forms Java-biblioteksfiler.

  2. Skapa ett API-objekt för Document Security Client.

    • Skapa ett ServiceClientFactory-objekt som innehåller anslutningsegenskaper. (Se Ange anslutningsegenskaper.)
    • Skapa ett RightsManagementClient-objekt med hjälp av dess konstruktor och skicka ServiceClientFactory-objektet.

  3. Hämta ett profilskyddat dokument som ska inspekteras.

    • Skapa ett java.io.FileInputStream-objekt som representerar det principskyddade PDF-dokumentet med hjälp av dess konstruktor. Skicka ett strängvärde som anger platsen för PDF-dokumentet.
    • Skapa ett com.adobe.idp.Document-objekt med hjälp av dess konstruktor och skicka java.io.FileInputStream-objektet.

  4. Inspect dokumentet.

    • Skapa ett DocumentManager-objekt genom att anropa RightsManagementClient-objektets getDocumentManager-metod.
    • Inspect det principskyddade dokumentet genom att anropa LicenseManager-objektets inspectDocument-metod. Skicka det com.adobe.idp.Document-objekt som innehåller det principskyddade PDF-dokumentet. Den här metoden returnerar ett RMInspectResult-objekt som innehåller information om det principskyddade dokumentet.

  5. Hämta information om det profilskyddade dokumentet.

    Om du vill få information om det principskyddade dokumentet anropar du rätt metod som tillhör objektet RMInspectResult. Om du till exempel vill hämta principnamnet anropar du RMInspectResult-objektets getPolicyName-metod.

Kodexempel

Följande snabbstarter innehåller kodexempel på hur du använder dokumentsäkerhetstjänsten:

  • "Snabbstart (SOAP läge): Inspektera principskyddade PDF-dokument med Java API"

Inspect Policy Protected PDF Documents med hjälp av webbtjänstens API inspect-policy-protected-pdf-documents-using-the-web-service-api

Inspect är ett policyskyddat PDF-dokument med hjälp av API:t för dokumentsäkerhetstjänsten (webbtjänsten):

  1. Inkludera projektfiler.

    Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

    note note
    NOTE
    Ersätt localhost med IP-adressen för servern som är värd för AEM Forms.

  2. Skapa ett API-objekt för Document Security Client.

    • Skapa ett RightsManagementServiceClient-objekt med hjälp av dess standardkonstruktor.

    • Skapa ett RightsManagementServiceClient.Endpoint.Address-objekt med konstruktorn System.ServiceModel.EndpointAddress. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempel http://localhost:8080/soap/services/RightsManagementService?WSDL). Du behöver inte använda attributet lc_version. Detta attribut används när du skapar en tjänstreferens.)

    • Skapa ett System.ServiceModel.BasicHttpBinding-objekt genom att hämta värdet för fältet RightsManagementServiceClient.Endpoint.Binding. Skicka returvärdet till BasicHttpBinding.

    • Ställ in System.ServiceModel.BasicHttpBinding-objektets MessageEncoding-fält till WSMessageEncoding.Mtom. Detta värde garanterar att MTOM används.

    • Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:

      • Tilldela användarnamnet för AEM formulär till fältet RightsManagementServiceClient.ClientCredentials.UserName.UserName.
      • Tilldela motsvarande lösenordsvärde till fältet RightsManagementServiceClient.ClientCredentials.UserName.Password.
      • Tilldela konstantvärdet HttpClientCredentialType.Basic till fältet BasicHttpBindingSecurity.Transport.ClientCredentialType.

    • Tilldela konstantvärdet BasicHttpSecurityMode.TransportCredentialOnly till fältet BasicHttpBindingSecurity.Security.Mode.

  3. Hämta ett profilskyddat dokument som ska inspekteras.

    • Skapa ett BLOB-objekt med hjälp av dess konstruktor. Objektet BLOB används för att lagra ett PDF-dokument som ska inspekteras.
    • Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor. Skicka ett strängvärde som representerar filplatsen för PDF-dokumentet och läget som filen ska öppnas i.
    • Skapa en bytearray som lagrar innehållet i objektet System.IO.FileStream. Du kan bestämma storleken på bytearrayen genom att hämta System.IO.FileStream-objektets Length-egenskap.
    • Fyll i bytearrayen med strömdata genom att anropa System.IO.FileStream-objektets Read-metod. Skicka bytearrayen, startpositionen och strömlängden som ska läsas.
    • Fyll BLOB-objektet genom att tilldela dess MTOM-fält med innehållet i bytearrayen.

  4. Inspect dokumentet.

    Inspect det principskyddade dokumentet genom att anropa RightsManagementServiceClient-objektets inspectDocument-metod. Skicka det BLOB-objekt som innehåller det principskyddade PDF-dokumentet. Den här metoden returnerar ett RMInspectResult-objekt som innehåller information om det principskyddade dokumentet.

  5. Hämta information om det profilskyddade dokumentet.

    Hämta information om det principskyddade dokumentet genom att hämta värdet för det relevanta fältet som tillhör objektet RMInspectResult. Om du till exempel vill hämta principnamnet hämtar du värdet för RMInspectResult-objektets policyName-fält.

Kodexempel

Följande snabbstarter innehåller kodexempel på hur du använder dokumentsäkerhetstjänsten:

  • "Snabbstart (MTOM): Inspektera principskyddade PDF-dokument med webbtjänstens API"
  • "Snabbstart (SwaRef): Inspektera principskyddade PDF-dokument med webbtjänstens API"

Se även

Anropa AEM Forms med MTOM

Anropa AEM Forms med SwaRef

Skapa vattenstämplar creating-watermarks

Vattenstämplar säkerställer dokumentets säkerhet genom att unikt identifiera dokumentet och kontrollera upphovsrättsintrång. Du kan t.ex. skapa och placera en vattenstämpel med statusen Konfidentiellt på alla sidor i ett dokument. När du har skapat en vattenstämpel kan du inkludera den som en del av en profil. Det innebär att du kan ställa in principens vattenstämpelattribut med den nya vattenstämpeln. När en profil som innehåller en vattenstämpel har tillämpats på ett dokument, visas vattenstämpeln i det profilskyddade dokumentet.

NOTE
Endast användare med administratörsbehörighet för dokumentsäkerhet kan skapa vattenstämplar. Det innebär att du måste ange en sådan användare när du definierar de anslutningsinställningar som krävs för att skapa ett klientobjekt för tjänsten Dokumentsäkerhet.
NOTE
Mer information om Document Security-tjänsten finns i Tjänstreferens för AEM Forms.

Sammanfattning av steg summary_of_steps-8

Så här skapar du en vattenstämpel:

  1. Inkludera projektfiler.
  2. Skapa ett API-objekt för Document Security Client.
  3. Ange vattenstämpelattribut.
  4. Registrera vattenstämpeln hos Document Security-tjänsten.

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.

Skapa ett API-objekt för dokumentsäkerhetsklienten

Innan du programmässigt kan utföra en dokumentsäkerhetstjänståtgärd måste du skapa ett klientobjekt för dokumentsäkerhetstjänsten. Om du använder Java API skapar du ett RightsManagementClient-objekt. Om du använder webbtjänstens API för dokumentsäkerhet skapar du ett RightsManagementServiceService-objekt.

Ange vattenstämpelattribut

Om du vill skapa en vattenstämpel måste du ange vattenstämpelattribut. Namnattributet måste alltid definieras. Förutom name-attributet måste du ange minst ett av följande attribut:

  • Egen text
  • DatumInkluderat
  • Användar-IDInkluderat
  • AnvändarnamnInkluderat

I följande tabell visas de nyckel- och värdepar som krävs när du skapar en vattenstämpel med hjälp av webbtjänster.

Nyckelnamn
Beskrivning
Värde
WaterBackCmd:IS_USERNAME_ENABLED
Anger om användarnamnet för användaren som öppnar dokumentet är en del av vattenstämpeln.
Sant eller falskt
WaterBackCmd:IS_USERID_ENABLED
Anger om identifieringen av användaren som öppnar dokumentet är en del av vattenstämpeln.
Sant eller falskt
WaterBackCmd:IS_CURRENTDATE_ENABLED
Anger om det aktuella datumet är en del av vattenstämpeln.
Sant eller falskt
WaterBackCmd:IS_CUSTOMTEXT_ENABLED
Om värdet är true måste värdet för den anpassade texten anges med WaterBackCmd:SRCTEXT.
Sant eller falskt
WaterBackCmd:OPACITY
Anger vattenstämpelns opacitet. Standardvärdet är 0,5 om det inte anges.
Ett värde mellan 0,0 och 1,0.
WaterBackCmd:ROTATION
Anger vattenstämpelns rotation. Standardvärdet är 0 grader.
Ett värde mellan 0 och 359.
WaterBackCmd:SCALE
Om det här värdet anges måste WaterBackCmd:IS_SIZE_ENABLED finnas och värdet måste vara true. Om det här attributet inte anges anpassas standardbeteendet till sidan.
Ett värde större än 0,0 och mindre än eller lika med 1,0.
WaterBackCmd:HORIZ_ALIGN
Anger vattenstämpelns vågräta justering. Standardvärdet är center.
vänster, mitten eller höger
WaterBackCmd:VERT_ALIGN
Anger vattenstämpelns lodräta justering. Standardvärdet är center.
överkant, mitten eller nederkant
WaterBackCmd:IS_USE_BACKGROUND
Anger om vattenstämpeln är en bakgrund. Standardvärdet är false.
Sant eller falskt
WaterBackCmd:IS_SIZE_ENABLED
True om en anpassad skala har angetts. Om det här värdet är true måste även SCALE anges. Om det här värdet är false anpassas standardvärdet till sidan.
Sant eller falskt
WaterBackCmd:SRCTEXT
Anger den anpassade texten för en vattenstämpel. Om det här värdet finns måste WaterBackCmd:IS_CUSTOMTEXT_ENABLED också finnas och anges till true.
Sant eller falskt

Alla vattenstämplar måste ha något av följande attribut definierade:

  • WaterBackCmd:IS_USERNAME_ENABLED
  • WaterBackCmd:IS_USERID_ENABLED
  • WaterBackCmd:IS_CURRENTDATE_ENABLED
  • WaterBackCmd:IS_CUSTOMTEXT_ENABLED

Alla andra attribut är valfria.

Registrera vattenstämpeln

En ny vattenstämpel måste registreras hos dokumentsäkerhetstjänsten innan den kan användas. När du har registrerat en vattenstämpel kan du använda den inom profiler.

Se även

Inkludera AEM Forms Java-biblioteksfiler

Ange anslutningsegenskaper

Tillämpa principer på PDF-dokument

Skapa vattenstämplar med Java API create-watermarks-using-the-java-api

Skapa en vattenstämpel med API:t för dokumentsäkerhet (Java):

  1. Inkludera projektfiler.

    Inkludera klient-JAR-filer, till exempel adobe-rightsmanagement-client.jar, i Java-projektets klasssökväg.

  2. Skapa ett API-objekt för Document Security Client.

    • Skapa ett ServiceClientFactory-objekt som innehåller anslutningsegenskaper.
    • Skapa ett RightsManagementClient-objekt med hjälp av dess konstruktor och skicka ServiceClientFactory-objektet.

  3. Ange vattenstämpelattribut

    • Skapa ett Watermark-objekt genom att anropa InfomodelObjectFactory-objektets statiska createWatermark-metod. Den här metoden returnerar ett Watermark-objekt.
    • Ange vattenstämpelns namnattribut genom att anropa Watermark-objektets setName-metod och skicka ett strängvärde som anger principnamnet.
    • Ange vattenstämpelns bakgrundsattribut genom att anropa Watermark-objektets setBackground-metod och skicka true. Om du anger det här attributet visas vattenstämpeln i dokumentets bakgrund.
    • Ange vattenstämpelns anpassade textattribut genom att anropa Watermark-objektets setCustomText-metod och skicka ett strängvärde som representerar vattenstämpelns text.
    • Ange vattenstämpelns opacitetsattribut genom att anropa Watermark-objektets setOpacity-metod och skicka ett heltalsvärde som anger opacitetsnivån. Värdet 100 anger att vattenstämpeln är helt ogenomskinlig och värdet 0 anger att vattenstämpeln är helt genomskinlig.

  4. Registrera vattenstämpeln.

    • Skapa ett WatermarkManager-objekt genom att anropa RightsManagementClient-objektets getWatermarkManager-metod. Den här metoden returnerar ett WatermarkManager-objekt.
    • Registrera vattenstämpeln genom att anropa WatermarkManager-objektets registerWatermark-metod och skicka Watermark-objektet som representerar vattenstämpeln som ska registreras. Den här metoden returnerar ett strängvärde som representerar vattenstämpelns ID-värde.

Kodexempel

Följande snabbstarter innehåller kodexempel på hur du använder dokumentsäkerhetstjänsten:

  • "Snabbstart (SOAP läge): Skapa en vattenstämpel med Java API"

Skapa vattenstämplar med webbtjänstens API create-watermarks-using-the-web-service-api

Skapa en vattenstämpel med API:t för dokumentsäkerhet (webbtjänst):

  1. Skapa ett API-objekt för Document Security Client.

    Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

    note note
    NOTE
    Ersätt localhost med IP-adressen för servern som är värd för AEM Forms.

  2. Skapa ett API-objekt för Document Security Client.

    • Skapa ett RightsManagementServiceClient-objekt med hjälp av dess standardkonstruktor.

    • Skapa ett RightsManagementServiceClient.Endpoint.Address-objekt med konstruktorn System.ServiceModel.EndpointAddress. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempel http://localhost:8080/soap/services/RightsManagementService?WSDL). Du behöver inte använda attributet lc_version. Detta attribut används när du skapar en tjänstreferens.)

    • Skapa ett System.ServiceModel.BasicHttpBinding-objekt genom att hämta värdet för fältet RightsManagementServiceClient.Endpoint.Binding. Skicka returvärdet till BasicHttpBinding.

    • Ställ in System.ServiceModel.BasicHttpBinding-objektets MessageEncoding-fält till WSMessageEncoding.Mtom. Detta värde garanterar att MTOM används.

    • Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:

      • Tilldela användarnamnet för AEM formulär till fältet RightsManagementServiceClient.ClientCredentials.UserName.UserName.
      • Tilldela motsvarande lösenordsvärde till fältet RightsManagementServiceClient.ClientCredentials.UserName.Password.
      • Tilldela konstantvärdet HttpClientCredentialType.Basic till fältet BasicHttpBindingSecurity.Transport.ClientCredentialType.

    • Tilldela konstantvärdet BasicHttpSecurityMode.TransportCredentialOnly till fältet BasicHttpBindingSecurity.Security.Mode.

  3. Ange vattenstämpelattribut.

    • Skapa ett WatermarkSpec-objekt genom att anropa konstruktorn WatermarkSpec.
    • Ange vattenstämpelns namn genom att tilldela ett strängvärde till WatermarkSpec-objektets name-datamedlem.
    • Ange vattenstämpelns id-attribut genom att tilldela ett strängvärde till WatermarkSpec-objektets id-datamedlem.
    • Skapa ett separat MyMapOf_xsd_string_To_xsd_anyType_Item-objekt för varje vattenstämpelegenskap som ska anges.
    • Ange nyckelvärdet genom att tilldela ett värde till MyMapOf_xsd_string_To_xsd_anyType_Item-objektets key-datamedlem (till exempel WaterBackCmd:OPACITY)).
    • Ange värdet genom att tilldela ett värde till MyMapOf_xsd_string_To_xsd_anyType_Item-objektets value-datamedlem (till exempel .25).
    • Skapa ett MyArrayOf_xsd_anyType-objekt. Anropa Add-metoden för varje MyMapOf_xsd_string_To_xsd_anyType_Item-objekt. MyArrayOf_xsd_anyType Skicka objektet MyMapOf_xsd_string_To_xsd_anyType_Item.
    • Tilldela objektet MyArrayOf_xsd_anyType till WatermarkSpec-objektets values-datamedlem.

  4. Registrera vattenstämpeln.

    Registrera vattenstämpeln genom att anropa RightsManagementServiceClient-objektets registerWatermark-metod och skicka WatermarkSpec-objektet som representerar vattenstämpeln som ska registreras.

Kodexempel

Följande snabbstarter innehåller kodexempel på hur du använder dokumentsäkerhetstjänsten:

  • "Snabbstart (MTOM): Skapa en vattenstämpel med hjälp av webbtjänstens API"
  • "Snabbstart (SwaRef): Skapa en vattenstämpel med hjälp av webbtjänstens API"

Se även

Anropa AEM Forms med MTOM

Anropa AEM Forms med SwaRef

Ändra vattenstämplar modifying-watermarks

Du kan ändra en befintlig vattenstämpel med API:t för dokumentsäkerhet, Java eller webbtjänst. Om du vill ändra en befintlig vattenstämpel hämtar du den, ändrar dess attribut och uppdaterar den sedan på servern. Anta till exempel att du hämtar en vattenstämpel och ändrar dess opacitetsattribut. Du måste uppdatera vattenstämpeln innan ändringen börjar gälla.

När du ändrar en vattenstämpel påverkas framtida dokument med vattenstämpeln. Befintliga PDF-dokument som innehåller vattenstämpeln påverkas alltså inte.

NOTE
Endast användare med administratörsbehörighet för dokumentsäkerhet kan ändra vattenstämplar. Det innebär att du måste ange en sådan användare när du definierar de anslutningsinställningar som krävs för att skapa ett klientobjekt för tjänsten Dokumentsäkerhet.
NOTE
Mer information om Document Security-tjänsten finns i Tjänstreferens för AEM Forms.

Sammanfattning av steg summary_of_steps-9

Så här ändrar du en vattenstämpel:

  1. Inkludera projektfiler.
  2. Skapa ett API-objekt för Document Security Client.
  3. Hämta vattenstämpeln som du vill ändra.
  4. Ange vattenstämpelattribut.
  5. Uppdatera vattenstämpeln.

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.

Skapa ett API-objekt för dokumentsäkerhetsklienten

Innan du programmässigt kan utföra en dokumentsäkerhetstjänståtgärd måste du skapa ett klientobjekt för dokumentsäkerhetstjänsten. Om du använder Java API skapar du ett DocumentSecurityClient-objekt. Om du använder webbtjänstens API för dokumentsäkerhet skapar du ett DocumentSecurityServiceService-objekt.

Hämta vattenstämpeln för att ändra

Om du vill ändra en vattenstämpel måste du hämta en befintlig vattenstämpel. Du kan hämta en vattenstämpel genom att ange dess namn eller genom att ange dess identifierarvärde.

Ange vattenstämpelattribut

Om du vill ändra en befintlig vattenstämpel ändrar du värdet för ett eller flera vattenstämpelattribut. När du uppdaterar en vattenstämpel med hjälp av en webbtjänst måste du ange alla attribut som ursprungligen var angivna, även om värdet inte ändras. Anta till exempel att följande vattenstämpelattribut har angetts: WaterBackCmd:IS_USERID_ENABLED, WaterBackCmd:IS_CUSTOMTEXT_ENABLED, WaterBackCmd:OPACITY och WaterBackCmd:SRCTEXT. Även om det enda attributet som du vill ändra är WaterBackCmd:OPACITY, måste du ange de andra värdena korrekt.

NOTE
När du använder Java API för att ändra en vattenstämpel behöver du inte ange alla attribut. Ange vattenstämpelattributet som du vill ändra.
NOTE
Mer information om vattenstämpelattributens namn finns i Skapa vattenstämplar.

Uppdatera vattenstämpeln

När du har ändrat en vattenstämpels attribut måste du uppdatera vattenstämpeln.

Se även

Inkludera AEM Forms Java-biblioteksfiler

Ange anslutningsegenskaper

Skapa vattenstämplar

Ändra vattenstämplar med Java API modify-watermarks-using-the-java-api

Ändra en vattenstämpel med API:t för dokumentsäkerhet (Java):

  1. Inkludera projektfiler.

    Inkludera JAR-klientfiler, t.ex. adobe-rightsmanagement-client.jar, i Java-projektets klassökväg.

  2. Skapa ett API-objekt för Document Security Client.

    • Skapa ett ServiceClientFactory-objekt som innehåller anslutningsegenskaper.
    • Skapa ett DocumentSecurityClient-objekt med hjälp av dess konstruktor och skicka ServiceClientFactory-objektet.

  3. Hämta vattenstämpeln som du vill ändra.

    Skapa ett WatermarkManager-objekt genom att anropa DocumentSecurityClient-objektets getWatermarkManager-metod och skicka ett strängvärde som anger vattenstämpelnamnet. Den här metoden returnerar ett Watermark-objekt som representerar vattenstämpeln som ska ändras.

  4. Ange vattenstämpelattribut.

    Ange vattenstämpelns opacitetsattribut genom att anropa Watermark-objektets setOpacity-metod och skicka ett heltalsvärde som anger opacitetsnivån. Värdet 100 anger att vattenstämpeln är helt ogenomskinlig och värdet 0 anger att vattenstämpeln är helt genomskinlig.

    note note
    NOTE
    I det här exemplet ändras bara opacitetsattributet.

  5. Uppdatera vattenstämpeln.

    • Uppdatera vattenstämpeln genom att anropa WatermarkManager-objektets updateWatermark-metod och skicka det Watermark-objekt vars attribut har ändrats.

Kodexempel

Exempel på kod som använder dokumentsäkerhetstjänsten finns i Snabb start(SOAP): Ändra en vattenstämpel med hjälp av Java API-avsnittet.

Ändra vattenstämplar med webbtjänstens API modify-watermarks-using-the-web-service-api

Ändra en vattenstämpel med hjälp av API:t för dokumentsäkerhet (webbtjänst):

  1. Inkludera projektfiler.

    Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

    note note
    NOTE
    Ersätt localhost med IP-adressen för servern som är värd för AEM Forms.

  2. Skapa ett API-objekt för Document Security Client.

    • Skapa ett DocumentSecurityServiceClient-objekt med hjälp av dess standardkonstruktor.

    • Skapa ett RightsManagementServiceClient.Endpoint.Address-objekt med konstruktorn System.ServiceModel.EndpointAddress. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempel http://localhost:8080/soap/services/DocumentSecurityService?WSDL). Du behöver inte använda attributet lc_version. Detta attribut används när du skapar en tjänstreferens.)

    • Skapa ett System.ServiceModel.BasicHttpBinding-objekt genom att hämta värdet för fältet DocumentSecurityServiceClient.Endpoint.Binding. Skicka returvärdet till BasicHttpBinding.

    • Ställ in System.ServiceModel.BasicHttpBinding-objektets MessageEncoding-fält till WSMessageEncoding.Mtom. Detta värde garanterar att MTOM används.

    • Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:

      • Tilldela användarnamnet för AEM formulär till fältet DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
      • Tilldela motsvarande lösenordsvärde till fältet DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
      • Tilldela konstantvärdet HttpClientCredentialType.Basic till fältet BasicHttpBindingSecurity.Transport.ClientCredentialType.

    • Tilldela konstantvärdet BasicHttpSecurityMode.TransportCredentialOnly till fältet BasicHttpBindingSecurity.Security.Mode.

  3. Hämta vattenstämpeln som du vill ändra.

    Hämta vattenstämpeln som ska ändras genom att anropa DocumentSecurityServiceClient-objektets getWatermarkByName-metod. Skicka ett strängvärde som anger vattenstämpelns namn. Den här metoden returnerar ett WatermarkSpec-objekt som representerar vattenstämpeln som ska ändras.

  4. Ange vattenstämpelattribut.

    • Skapa ett separat MyMapOf_xsd_string_To_xsd_anyType_Item-objekt för varje vattenstämpelegenskap som ska uppdateras.
    • Ange nyckelvärdet genom att tilldela ett värde till MyMapOf_xsd_string_To_xsd_anyType_Item-objektets key-datamedlem (till exempel WaterBackCmd:OPACITY)).
    • Ange värdet genom att tilldela ett värde till MyMapOf_xsd_string_To_xsd_anyType_Item-objektets value-datamedlem (till exempel .50).
    • Skapa ett MyArrayOf_xsd_anyType-objekt. Anropa Add-metoden för varje MyMapOf_xsd_string_To_xsd_anyType_Item-objekt. MyArrayOf_xsd_anyType Skicka objektet MyMapOf_xsd_string_To_xsd_anyType_Item.
    • Tilldela objektet MyArrayOf_xsd_anyType till WatermarkSpec-objektets values-datamedlem.

  5. Uppdatera vattenstämpeln.

    Uppdatera vattenstämpeln genom att anropa DocumentSecurityServiceClient-objektets updateWatermark-metod och skicka WatermarkSpec-objektet som representerar den vattenstämpel som ska ändras.

Kodexempel

Följande snabbstart innehåller kodexempel på hur du använder dokumentsäkerhetstjänsten:

  • "Snabbstart (MTOM): Ändra en vattenstämpel med hjälp av webbtjänstens API"

Söka efter händelser searching-for-events

Tjänsten Rights Management spårar specifika åtgärder när de utförs, t.ex. att tillämpa en profil på ett dokument, öppna ett policyskyddat dokument och återkalla åtkomst till dokument. Händelsegranskning måste aktiveras för tjänsten Rights Management, annars spåras inte händelser.

Händelser faller inom en av följande kategorier:

  • Administratörshändelser är åtgärder som är relaterade till en administratör, till exempel att skapa ett administratörskonto.
  • Dokumenthändelser är åtgärder som är relaterade till ett dokument, t.ex. stängning av ett policyskyddat dokument.
  • Policyhändelser är åtgärder som är relaterade till en profil, till exempel att skapa en profil.
  • Tjänstehändelser är åtgärder som är relaterade till tjänsten Rights Management, t.ex. synkronisering med användarkatalogen.

Du kan söka efter specifika händelser genom att använda Java API:t för Rights Management eller webbtjänstens API. Genom att söka efter händelser kan du utföra åtgärder, till exempel skapa en loggfil med vissa händelser.

NOTE
Mer information om tjänsten Rights Management finns i Tjänstreferens för AEM Forms.

Sammanfattning av steg summary_of_steps-10

Så här söker du efter en Rights Management-händelse:

  1. Inkludera projektfiler.
  2. Skapa ett Rights Management Client API-objekt.
  3. Ange den händelse som du vill söka efter.
  4. Sök efter händelsen.

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.

Skapa ett Rights Management Client API-objekt

Innan du programmässigt kan utföra en Rights Management-tjänståtgärd måste du skapa ett klientobjekt för tjänsten Rights Management. Om du använder Java API skapar du ett DocumentSecurityClient-objekt. Skapa ett DocumentSecurityServiceService-objekt om du använder Rights Management webbtjänste-API.

Ange vilka händelser som ska sökas efter

Ange händelsen som du vill söka efter. Du kan till exempel söka efter händelsen create för principen, som inträffar när en ny princip skapas.

Sök efter händelsen

När du har angett vilken händelse du vill söka efter kan du söka efter händelsen med hjälp av Rights Management Java API eller Rights Management webbtjänstAPI.

Se även

Inkludera AEM Forms Java-biblioteksfiler

Ange anslutningsegenskaper

Söka efter händelser med Java API search-for-events-using-the-java-api

Sök efter händelser med hjälp av Rights Management API (Java):

  1. Inkludera projektfiler

    Inkludera JAR-klientfiler, som adobe-rightsmanagement-client.jar, i Java-projektets klassökväg.

  2. Skapa ett Rights Management Client API-objekt

    Skapa ett DocumentSecurityClient-objekt med hjälp av dess konstruktor och skicka ett ServiceClientFactory-objekt som innehåller anslutningsegenskaper.

  3. Ange vilka händelser som ska sökas efter

    • Skapa ett EventManager-objekt genom att anropa DocumentSecurityClient-objektets getEventManager-metod. Den här metoden returnerar ett EventManager-objekt.
    • Skapa ett EventSearchFilter-objekt genom att anropa dess konstruktor.
    • Ange den händelse som ska sökas igenom genom att anropa EventSearchFilter-objektets setEventCode-metod och skicka en statisk datamedlem som tillhör klassen EventManager som representerar den händelse som ska sökas efter. Om du till exempel vill söka efter principskapningshändelsen skickar du EventManager.POLICY_CREATE_EVENT.
    note note
    NOTE
    Du kan definiera ytterligare sökvillkor genom att anropa objektmetoderna EventSearchFilter. Anropa till exempel metoden setUserName för att ange en användare som är associerad med händelsen.

  4. Sök efter händelsen

    Sök efter händelsen genom att anropa EventManager-objektets searchForEvents-metod och skicka EventSearchFilter-objektet som definierar sökvillkoren för händelsen. Den här metoden returnerar en array med Event objekt.

Kodexempel

Följande snabbstarter innehåller kodexempel på hur du använder tjänsten Rights Management:

  • "Snabbstart (SOAP): Söka efter händelser med Java API"

Sök efter händelser med hjälp av webbtjänstens API search-for-events-using-the-web-service-api

Sök efter händelser med hjälp av Rights Management API (webbtjänst):

  1. Inkludera projektfiler

    Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

    note note
    NOTE
    Ersätt localhost med IP-adressen för servern som är värd för AEM Forms.

  2. Skapa ett Rights Management Client API-objekt

    • Skapa ett DocumentSecurityServiceClient-objekt med hjälp av dess standardkonstruktor.

    • Skapa ett DocumentSecurityServiceClient.Endpoint.Address-objekt med konstruktorn System.ServiceModel.EndpointAddress. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempel http://localhost:8080/soap/services/RightsManagementService?WSDL). Du behöver inte använda attributet lc_version. Detta attribut används när du skapar en tjänstreferens.)

    • Skapa ett System.ServiceModel.BasicHttpBinding-objekt genom att hämta värdet för fältet DocumentSecurityServiceClient.Endpoint.Binding. Skicka returvärdet till BasicHttpBinding.

    • Ställ in System.ServiceModel.BasicHttpBinding-objektets MessageEncoding-fält till WSMessageEncoding.Mtom. Detta värde garanterar att MTOM används.

    • Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:

      • Tilldela användarnamnet för AEM formulär till fältet DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
      • Tilldela motsvarande lösenordsvärde till fältet DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
      • Tilldela konstantvärdet HttpClientCredentialType.Basic till fältet BasicHttpBindingSecurity.Transport.ClientCredentialType.

    • Tilldela konstantvärdet BasicHttpSecurityMode.TransportCredentialOnly till fältet BasicHttpBindingSecurity.Security.Mode.

  3. Ange vilka händelser som ska sökas efter

    • Skapa ett EventSpec-objekt med hjälp av dess konstruktor.
    • Ange början på den tidsperiod under vilken händelsen inträffade genom att ställa in EventSpec-objektets firstTime.date-datamedlem med DataTime-instansen som representerar början på datumintervallet när händelsen inträffade.
    • Tilldela värdet true till EventSpec-objektets firstTime.dateSpecified-datamedlem.
    • Ange slutet på den tidsperiod under vilken händelsen inträffade genom att ställa in EventSpec-objektets lastTime.date-datamedlem med DataTime-instansen som representerar slutet på datumintervallet när händelsen inträffade.
    • Tilldela värdet true till EventSpec-objektets lastTime.dateSpecified-datamedlem.
    • Ange händelsen som ska sökas efter genom att tilldela ett strängvärde till eventCode-objektets EventSpec-datamedlem. I följande tabell visas de numeriska värden som du kan tilldela den här egenskapen:
    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
    Händelsetyp Värde
    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. Sök efter händelsen

    Sök efter händelsen genom att anropa DocumentSecurityServiceClient-objektets searchForEvents-metod och skicka det EventSpec-objekt som representerar händelsen som ska sökas efter och det maximala antalet resultat. Den här metoden returnerar en MyArrayOf_xsd_anyType-samling där varje element är en AuditSpec-instans. Om du använder en AuditSpec-instans kan du få information om händelsen, till exempel när den inträffade. AuditSpec-instansen innehåller en timestamp-datamedlem som anger den här informationen.

Kodexempel

Följande snabbstarter innehåller kodexempel på hur du använder tjänsten Rights Management:

  • "Snabbstart (MTOM): Söka efter händelser med hjälp av webbtjänstens API"
  • "Snabbstart (SwaRef): Söka efter händelser med hjälp av webbtjänstens API"

Se även

Anropa AEM Forms med MTOM

Anropa AEM Forms med SwaRef

Tillämpa profiler på Word-dokument applying-policies-to-word-documents

Utöver PDF-dokument stöder Rights Management-tjänsten även andra dokumentformat som Microsoft Word-dokument (DOC-filer) och andra Microsoft Office-filformat. Du kan till exempel tillämpa en profil på ett Word-dokument för att skydda det. Genom att tillämpa en profil på ett Word-dokument begränsar du åtkomsten till dokumentet. Du kan inte tillämpa en profil på ett dokument om dokumentet redan är skyddat med en profil.

Du kan övervaka användningen av ett policyskyddat Word-dokument när du har distribuerat det. Det innebär att du kan se hur dokumentet används och vem som använder det. Du kan till exempel ta reda på när någon har öppnat dokumentet.

NOTE
Mer information om Document Security-tjänsten finns i Tjänstreferens för AEM Forms.

Sammanfattning av steg summary_of_steps-11

Så här använder du en profil i ett Word-dokument:

  1. Inkludera projektfiler.
  2. Skapa ett API-objekt för Document Security Client.
  3. Hämta ett Word-dokument som en profil tillämpas på.
  4. Använd en befintlig profil i Word-dokumentet.
  5. Spara det principskyddade Word-dokumentet.

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.

Skapa ett API-objekt för dokumentsäkerhetsklienten

Innan du programmässigt kan utföra en dokumentsäkerhetstjänståtgärd måste du skapa ett klientobjekt för dokumentsäkerhetstjänsten.

Hämta ett Word-dokument

Hämta ett Word-dokument om du vill tillämpa en profil. När du har tillämpat en profil på Word-dokumentet är användarna begränsade när de använder dokumentet. Om profilen t.ex. inte aktiverar dokumentet för att öppnas offline måste användarna vara online för att kunna öppna dokumentet.

Använd en befintlig profil i Word-dokumentet

Om du vill tillämpa en profil på ett Word-dokument måste du referera till en befintlig princip och ange vilken principuppsättning som principen tillhör. Användaren som anger anslutningsegenskaperna måste ha tillgång till den angivna principen. Annars inträffar ett undantag.

Spara Word-dokumentet

När dokumentsäkerhetstjänsten har tillämpat en profil på ett Word-dokument kan du spara det principskyddade Word-dokumentet som en DOC-fil.

Se även

Inkludera AEM Forms Java-biblioteksfiler

Ange anslutningsegenskaper

Återkalla åtkomst till dokument

Tillämpa en profil på ett Word-dokument med Java API apply-a-policy-to-a-word-document-using-the-java-api

Tillämpa en profil på ett Word-dokument med hjälp av dokumentets säkerhets-API (Java):

  1. Inkludera projektfiler.

    Inkludera JAR-klientfiler, som adobe-rightsmanagement-client.jar, i Java-projektets klassökväg.

  2. Skapa ett API-objekt för Document Security Client.

    • Skapa ett ServiceClientFactory-objekt som innehåller anslutningsegenskaper.
    • Skapa ett DocumentSecurityClient-objekt med hjälp av dess konstruktor och skicka ServiceClientFactory-objektet.

  3. Hämta ett Word-dokument.

    • Skapa ett java.io.FileInputStream-objekt som representerar Word-dokumentet med hjälp av dess konstruktor och skicka ett strängvärde som anger platsen för Word-dokumentet.
    • Skapa ett com.adobe.idp.Document-objekt med hjälp av dess konstruktor och skicka java.io.FileInputStream-objektet.

  4. Använd en befintlig profil i Word-dokumentet.

    • Skapa ett DocumentManager-objekt genom att anropa DocumentSecurityClient-objektets getDocumentManager-metod.

    • Tillämpa en profil på Word-dokumentet genom att anropa DocumentManager-objektets protectDocument-metod och skicka följande värden:

      • Det com.adobe.idp.Document-objekt som innehåller det Word-dokument som principen tillämpas på.
      • Ett strängvärde som anger dokumentets namn.
      • Ett strängvärde som anger namnet på den principuppsättning som principen tillhör. Du kan ange ett null-värde som resulterar i att principuppsättningen MyPolicies används.
      • Ett strängvärde som anger principnamnet.
      • Ett strängvärde som representerar namnet på användarhanterardomänen för den användare som är dokumentets utgivare. Det här parametervärdet är valfritt och kan vara null (om parametern är null måste nästa parametervärde vara null).
      • Ett strängvärde som representerar namnet på den kanoniska användaren av användarhanteraren som är dokumentets utgivare. Det här parametervärdet är valfritt och kan vara null (om parametern är null måste det föregående parametervärdet vara null).
      • En com.adobe.livecycle.rightsmanagement.Locale som representerar det språkområde som används för att välja MS Office-mallen. Parametervärdet är valfritt och du kan ange null.

      Metoden protectDocument returnerar ett RMSecureDocumentResult-objekt som innehåller det principskyddade Word-dokumentet.

  5. Spara Word-dokumentet.

    • Anropa RMSecureDocumentResult-objektets getProtectedDoc-metod för att hämta det principskyddade Word-dokumentet. Den här metoden returnerar ett com.adobe.idp.Document-objekt.
    • Skapa ett java.io.File-objekt och kontrollera att filtillägget är DOC.
    • Anropa com.adobe.idp.Document-objektets copyToFile-metod för att kopiera innehållet i Document-objektet till filen (se till att du använder det Document-objekt som returnerades av metoden getProtectedDoc).

Kodexempel

Följande snabbstart innehåller kodexempel på hur du använder dokumentsäkerhetstjänsten:

  • "Snabbstart (SOAP läge): Tillämpa en princip på ett Word-dokument med Java API"

Tillämpa en profil på ett Word-dokument med hjälp av webbtjänstens API apply-a-policy-to-a-word-document-using-the-web-service-api

Tillämpa en profil på ett Word-dokument med hjälp av API:t för dokumentsäkerhet (webbtjänsten):

  1. Inkludera projektfiler.

    Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition: http://localhost:8080/soap/services/DocumentSecurityService?WSDL&lc_version=9.0.1.

    note note
    NOTE
    Ersätt localhost med IP-adressen för servern som är värd för AEM Forms.

  2. Skapa ett API-objekt för Document Security Client.

    • Skapa ett DocumentSecurityServiceClient-objekt med hjälp av dess standardkonstruktor.

    • Skapa ett DocumentSecurityServiceClient.Endpoint.Address-objekt med konstruktorn System.ServiceModel.EndpointAddress. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempel http://localhost:8080/soap/services/DocumentSecurityService?WSDL). Du behöver inte använda attributet lc_version. Detta attribut används när du skapar en tjänstreferens.)

    • Skapa ett System.ServiceModel.BasicHttpBinding-objekt genom att hämta värdet för fältet DocumentSecurityServiceClient.Endpoint.Binding. Skicka returvärdet till BasicHttpBinding.

    • Ställ in System.ServiceModel.BasicHttpBinding-objektets MessageEncoding-fält till WSMessageEncoding.Mtom. Detta värde garanterar att MTOM används.

    • Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:

      • Tilldela användarnamnet för AEM formulär till fältet DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
      • Tilldela motsvarande lösenordsvärde till fältet DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
      • Tilldela konstantvärdet HttpClientCredentialType.Basic till fältet BasicHttpBindingSecurity.Transport.ClientCredentialType.

    • Tilldela konstantvärdet BasicHttpSecurityMode.TransportCredentialOnly till fältet BasicHttpBindingSecurity.Security.Mode.

  3. Hämta ett Word-dokument.

    • Skapa ett BLOB-objekt med hjälp av dess konstruktor. Objektet BLOB används för att lagra ett Word-dokument som en profil tillämpas på.
    • Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för Word-dokumentet och läget som filen ska öppnas i.
    • Skapa en bytearray som lagrar innehållet i objektet System.IO.FileStream. Ta reda på bytearraystorleken genom att hämta System.IO.FileStream-objektets Length-egenskap.
    • Fyll i bytearrayen med strömdata genom att anropa System.IO.FileStream-objektets Read-metod. Skicka bytearrayen, startpositionen och strömlängden som ska läsas.
    • Fyll BLOB-objektet genom att tilldela dess MTOM-fält med innehållet i bytearrayen.

  4. Använd en befintlig profil i Word-dokumentet.

    Tillämpa en profil på Word-dokumentet genom att anropa DocumentSecurityServiceClient-objektets protectDocument-metod och skicka följande värden:

    • Det BLOB-objekt som innehåller det Word-dokument som principen tillämpas på.
    • Ett strängvärde som anger dokumentets namn.
    • Ett strängvärde som anger namnet på den principuppsättning som principen tillhör. Du kan ange ett null-värde som resulterar i att principuppsättningen MyPolicies används.
    • Ett strängvärde som anger principnamnet.
    • Ett strängvärde som representerar namnet på användarhanterardomänen för den användare som är dokumentets utgivare. Det här parametervärdet är valfritt och kan vara null (om parametern är null måste nästa parametervärde vara null).
    • Ett strängvärde som representerar namnet på den kanoniska användaren av användarhanteraren som är dokumentets utgivare. Det här parametervärdet är valfritt och kan vara null (om parametern är null måste det föregående parametervärdet vara null).
    • Ett RMLocale-värde som anger språkvärdet (till exempel RMLocale.en).
    • En strängutdataparameter som används för att lagra principens identifierarvärde.
    • En strängutdataparameter som används för att lagra det principskyddade identifierarvärdet.
    • En strängutdataparameter som används för att lagra mime-typen (till exempel application/doc).

    Metoden protectDocument returnerar ett BLOB-objekt som innehåller det principskyddade Word-dokumentet.

  5. Spara Word-dokumentet.

    • Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för det principskyddade Word-dokumentet.
    • Skapa en bytearray som lagrar datainnehållet för objektet BLOB som returnerades av metoden protectDocument. Fyll i bytearrayen genom att hämta värdet för BLOB-objektets MTOM-datamedlem.
    • Skapa ett System.IO.BinaryWriter-objekt genom att anropa dess konstruktor och skicka System.IO.FileStream-objektet.
    • Skriv bytearrayens innehåll till en Word-fil genom att anropa System.IO.BinaryWriter-objektets Write-metod och skicka bytearrayen.

Kodexempel

Följande snabbstart innehåller kodexempel på hur du använder dokumentsäkerhetstjänsten:

  • "Snabbstart (MTOM): Tillämpa en princip på ett Word-dokument med hjälp av webbtjänstens API "

Ta bort profiler från Word-dokument removing-policies-from-word-documents

Du kan ta bort en profil från ett profilskyddat Word-dokument om du vill ta bort skyddet från dokumentet. Det vill säga om du inte längre vill att dokumentet ska skyddas av en profil. Om du vill uppdatera ett principskyddat Word-dokument med en nyare profil är det effektivare att byta profil i stället för att ta bort profilen och lägga till den uppdaterade profilen.

NOTE
Mer information om Document Security-tjänsten finns i Tjänstreferens för AEM Forms.

Sammanfattning av steg summary_of_steps-12

Så här tar du bort en profil från ett profilskyddat Word-dokument:

  1. Inkludera projektfiler
  2. Skapa ett API-objekt för Document Security Client.
  3. Hämta ett policyskyddat Word-dokument.
  4. Ta bort profilen från Word-dokumentet.
  5. Spara oskyddade Word-dokument.s

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.

Skapa ett API-objekt för dokumentsäkerhetsklienten

Skapa ett klientobjekt för tjänsten Dokumentsäkerhet innan du programmässigt utför en åtgärd.

Hämta ett principskyddat Word-dokument

Hämta ett principskyddat Word-dokument om du vill ta bort en profil. Om du försöker ta bort en profil från ett Word-dokument som inte skyddas av en profil genereras ett undantagsfel.

Ta bort profilen från Word-dokumentet

Du kan ta bort en princip från ett principskyddat Word-dokument förutsatt att en administratör har angetts i anslutningsinställningarna. Om inte måste principen som används för att skydda ett dokument innehålla behörigheten SWITCH_POLICY för att ta bort en princip från ett Word-dokument. Dessutom måste den användare som anges i AEM Forms anslutningsinställningar också ha den behörigheten. Annars genereras ett undantag.

Spara det oskyddade Word-dokumentet

När dokumentskyddstjänsten har tagit bort en profil från ett Word-dokument kan du spara det oskyddade Word-dokumentet som en DOC-fil.

Se även

Inkludera AEM Forms Java-biblioteksfiler

Ange anslutningsegenskaper

Tillämpa profiler på Word-dokument

Ta bort en profil från ett Word-dokument med Java API remove-a-policy-from-a-word-document-using-the-java-api

Ta bort en profil från ett principskyddat Word-dokument med hjälp av dokumentets säkerhets-API (Java):

  1. Inkludera projektfiler

    Inkludera JAR-klientfiler, som adobe-rightsmanagement-client.jar, i Java-projektets klassökväg.

  2. Skapa ett API-objekt för Document Security Client

    • Skapa ett ServiceClientFactory-objekt som innehåller anslutningsegenskaper.
    • Skapa ett RightsManagementClient-objekt med hjälp av dess konstruktor och skicka ServiceClientFactory-objektet.

  3. Hämta ett policyskyddat Word-dokument

    • Skapa ett java.io.FileInputStream-objekt som representerar det principskyddade Word-dokumentet genom att använda dess konstruktor och skicka ett strängvärde som anger platsen för Word-dokumentet.
    • Skapa ett com.adobe.idp.Document-objekt med hjälp av dess konstruktor och skicka java.io.FileInputStream-objektet.

  4. Ta bort profilen från Word-dokumentet

    • Skapa ett DocumentManager-objekt genom att anropa RightsManagementClient-objektets getDocumentManager-metod.
    • Ta bort en princip från Word-dokumentet genom att anropa DocumentManager-objektets removeSecurity-metod och skicka det com.adobe.idp.Document-objekt som innehåller det principskyddade Word-dokumentet. Den här metoden returnerar ett com.adobe.idp.Document-objekt som innehåller ett oskyddat Word-dokument.

  5. Spara det oskyddade Word-dokumentet

    • Skapa ett java.io.File-objekt och kontrollera att filtillägget är DOC.
    • Anropa Document-objektets copyToFile-metod för att kopiera innehållet i Document-objektet till filen (se till att du använder det Document-objekt som returnerades av metoden removeSecurity).

Kodexempel

Följande snabbstart innehåller kodexempel på hur du använder dokumentsäkerhetstjänsten:

  • "Snabbstart (SOAP läge): Ta bort en princip från ett Word-dokument med Java API "

Ta bort en profil från ett Word-dokument med hjälp av webbtjänstens API remove-a-policy-from-a-word-document-using-the-web-service-api

Ta bort en profil från ett principskyddat Word-dokument med hjälp av API:t för dokumentsäkerhet (webbtjänsten):

  1. Inkludera projektfiler

    Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

    note note
    NOTE
    Ersätt localhost med IP-adressen för servern som är värd för AEM Forms.

  2. Skapa ett API-objekt för Document Security Client

    • Skapa ett RightsManagementServiceClient-objekt med hjälp av dess standardkonstruktor.

    • Skapa ett RightsManagementServiceClient.Endpoint.Address-objekt med konstruktorn System.ServiceModel.EndpointAddress. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempel http://localhost:8080/soap/services/RightsManagementService?WSDL). Du behöver inte använda attributet lc_version. Detta attribut används när du skapar en tjänstreferens.)

    • Skapa ett System.ServiceModel.BasicHttpBinding-objekt genom att hämta värdet för fältet RightsManagementServiceClient.Endpoint.Binding. Skicka returvärdet till BasicHttpBinding.

    • Ställ in System.ServiceModel.BasicHttpBinding-objektets MessageEncoding-fält till WSMessageEncoding.Mtom. Detta värde garanterar att MTOM används.

    • Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:

      • Tilldela användarnamnet för AEM formulär till fältet RightsManagementServiceClient.ClientCredentials.UserName.UserName.
      • Tilldela motsvarande lösenordsvärde till fältet RightsManagementServiceClient.ClientCredentials.UserName.Password.
      • Tilldela konstantvärdet HttpClientCredentialType.Basic till fältet BasicHttpBindingSecurity.Transport.ClientCredentialType.

    • Tilldela konstantvärdet BasicHttpSecurityMode.TransportCredentialOnly till fältet BasicHttpBindingSecurity.Security.Mode.

  3. Hämta ett policyskyddat Word-dokument

    • Skapa ett BLOB-objekt med hjälp av dess konstruktor. Objektet BLOB används för att lagra det principskyddade Word-dokumentet som principen tas bort från.
    • Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för Word-dokumentet och läget som filen ska öppnas i.
    • Skapa en bytearray som lagrar innehållet i objektet System.IO.FileStream. Du kan bestämma storleken på bytearrayen genom att hämta System.IO.FileStream-objektets Length-egenskap.
    • Fyll i bytearrayen med strömdata genom att anropa System.IO.FileStream-objektets Read-metod och skicka bytearrayen, startpositionen och strömlängden som ska läsas.
    • Fyll BLOB-objektet genom att tilldela dess MTOM-fält med innehållet i bytearrayen.

  4. Ta bort profilen från Word-dokumentet

    Ta bort principen från Word-dokumentet genom att anropa RightsManagementServiceClient-objektets removePolicySecurity-metod och skicka det BLOB-objekt som innehåller det principskyddade Word-dokumentet. Den här metoden returnerar ett BLOB-objekt som innehåller ett oskyddat Word-dokument.

  5. Spara det oskyddade Word-dokumentet

    • Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för det oskyddade Word-dokumentet.
    • Skapa en bytearray som lagrar datainnehållet för objektet BLOB som returnerades av metoden removePolicySecurity. Fyll i bytearrayen genom att hämta värdet för BLOB-objektets MTOM-fält.
    • Skapa ett System.IO.BinaryWriter-objekt genom att anropa dess konstruktor och skicka System.IO.FileStream-objektet.

Kodexempel

Följande snabbstart innehåller kodexempel på hur du använder dokumentsäkerhetstjänsten:

  • "Snabbstart (MTOM): Ta bort en princip från ett Word-dokument med hjälp av webbtjänstens API"

Se även

Anropa AEM Forms med MTOM

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