Show Menu
THEMEN×

Schutz von Dokumenten mit Richtlinien

Informationen zum Dokument Security Service
Der Dokument Security-Dienst ermöglicht es Benutzern, Vertraulichkeitseinstellungen dynamisch auf Adobe PDF-Dokumente anzuwenden und die Kontrolle über die Dokumente zu behalten, unabhängig davon, wie weit sie verteilt sind.
Der Dokument Security-Dienst verhindert, dass Informationen über die Benutzerreichweite hinaus verbreitet werden, indem er den Benutzern die Möglichkeit gibt, die Verwendung des richtliniengeschützten PDF-Dokuments durch Empfänger zu steuern. Ein Benutzer kann angeben, wer ein Dokument öffnen kann, seine Verwendung einschränken und das Dokument nach der Verteilung überwachen. Ein Benutzer kann außerdem den Zugriff auf ein richtliniengeschütztes Dokument dynamisch steuern und sogar den Zugriff auf das Dokument dynamisch sperren.
Der Dokument Security-Dienst schützt auch andere Dateitypen wie Microsoft Word-Dateien (DOC-Dateien). Sie können die Dokument Security Client-API verwenden, um mit diesen Dateitypen zu arbeiten. Die folgenden Versionen werden unterstützt:
  • Microsoft Office 2003-Dateien (DOC-, XLS-, PPT-Dateien)
  • Microsoft Office 2007-Dateien (DOCX-, XLSX-, PPTX-Dateien)
  • PTC Pro/E-Dateien
Die beiden folgenden Abschnitte erläutern die Arbeit mit Word-Dokumenten:
Sie können diese Aufgaben mithilfe des Dokument Security-Dienstes ausführen:
  • Erstellen von Richtlinien. Weitere Informationen finden Sie unter Richtlinien erstellen .
  • Richtlinien ändern. Weitere Informationen finden Sie unter Richtlinien ändern .
  • Richtlinien löschen. Weitere Informationen finden Sie unter Richtlinien löschen .
  • Richtlinien auf PDF-Dokumente anwenden Weitere Informationen finden Sie unter Richtlinien auf PDF-Dokumente anwenden.
  • Richtlinien aus PDF-Dokumenten entfernen Weitere Informationen finden Sie unter Richtlinien aus PDF-Dokumenten entfernen .
  • Überprüfen Sie richtliniengeschützte Dokumente. Weitere Informationen finden Sie unter Richtliniengeschützte PDF-Dokumente überprüfen.
  • Zugriff auf PDF-Dokumente sperren Weitere Informationen finden Sie unter Zugriff auf Dokumente sperren.
  • Zugriff auf gesperrte Dokumente neu zuweisen. Weitere Informationen finden Sie unter Zugriff auf gesperrte Dokumente neu aktivieren.
  • Erstellen Sie Wasserzeichen. Weitere Informationen finden Sie unter Wasserzeichen erstellen.
  • Suchen Sie nach Ereignissen. Weitere Informationen finden Sie unter Suchen nach Ereignissen .
For more information about the Document Security service, see Services Reference for AEM Forms .

Richtlinien erstellen

Sie können Richtlinien programmgesteuert mit der Java-API oder der Webdienst-API von Dokument Security erstellen. Eine Richtlinie ist eine Sammlung von Informationen, die Sicherheitseinstellungen, autorisierte Dokument und Verwendungsrechte umfasst. Sie können eine beliebige Anzahl von Richtlinien erstellen und speichern, indem Sie Sicherheitseinstellungen verwenden, die für unterschiedliche Situationen und Benutzer geeignet sind.
Richtlinien ermöglichen Ihnen die Durchführung folgender Aufgaben:
  • Geben Sie die Personen an, die das Dokument öffnen können. Empfänger können Ihrem Unternehmen angehören oder außerhalb des Unternehmens tätig sein.
  • Geben Sie an, wie Empfänger das Dokument verwenden können. Sie können den Zugriff auf verschiedene Acrobat- und Adobe Reader-Funktionen einschränken. Zu diesen Funktionen gehören das Drucken und Kopieren von Text, das Hinzufügen von Unterschriften und das Hinzufügen von Kommentaren zu einem Dokument.
  • Ändern Sie die Zugriffs- und Sicherheitseinstellungen jederzeit, auch nachdem Sie das richtliniengeschützte Dokument verteilt haben.
  • Überwachen Sie die Verwendung des Dokuments, nachdem Sie es verteilt haben. Sie können sehen, wie das Dokument verwendet wird und wer es verwendet. Sie können beispielsweise herausfinden, wann jemand das Dokument geöffnet hat.

Richtlinien mit Webdiensten erstellen

Wenn Sie eine Richtlinie mit der Webdienst-API erstellen, referenzieren Sie eine vorhandene PDRL-XML-Datei (Portable Dokument Rights Language), die die Richtlinie beschreibt. Richtlinienberechtigungen und der Prinzipal werden im PDRL-Dokument definiert. Das folgende XML-Dokument ist ein Beispiel für ein 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>
 

For more information about the Document Security service, see Services Reference for AEM Forms .

Zusammenfassung der Schritte

So erstellen Sie eine Richtlinie:
  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
  3. Legen Sie die Attribute der Richtlinie fest.
  4. Erstellen Sie einen Richtlinieneintrag.
  5. Registrieren Sie die Richtlinie.
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, stellen Sie sicher, dass Sie die Proxydateien einschließen.
Die folgenden JAR-Dateien müssen dem Klassenpfad Ihres Projekts hinzugefügt werden:
  • adobe-rightsmanagement-client.jar
  • namespace.jar (wenn AEM Forms unter JBoss bereitgestellt werden)
  • jaxb-api.jar (wenn AEM Forms auf JBoss bereitgestellt werden)
  • jaxb-impl.jar (wenn AEM Forms auf JBoss bereitgestellt werden)
  • jaxb-libs.jar (wenn AEM Forms auf JBoss bereitgestellt werden)
  • jaxb-xjc.jar (wenn AEM Forms auf JBoss bereitgestellt werden)
  • relaxngDatatype.jar (wenn AEM Forms auf JBoss bereitgestellt werden)
  • xsdlib.jar (wenn AEM Forms unter JBoss bereitgestellt werden)
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar
  • jbossall-client.jar (verwenden Sie eine andere JAR-Datei, wenn AEM Forms nicht auf JBoss bereitgestellt werden)
For information about the location of these JAR files, see Including AEM Forms Java library files .
Dokument Security Client API-Objekt erstellen
Bevor Sie einen Dokument Security-Dienstvorgang programmgesteuert durchführen können, erstellen Sie ein Client-Objekt des Dokument Security-Dienstes.
Attribute der Richtlinie festlegen
Um eine Richtlinie zu erstellen, legen Sie Richtlinienattribute fest. Ein obligatorisches Attribut ist der Richtlinienname. Richtliniennamen müssen für jeden Richtliniensatz eindeutig sein. Ein Richtliniensatz ist einfach eine Sammlung von Richtlinien. Es kann zwei Richtlinien mit demselben Namen geben, wenn die Richtlinien zu separaten Richtliniensätzen gehören. Zwei Richtlinien in einem Richtliniensatz können jedoch nicht denselben Richtliniennamen haben.
Ein weiteres nützliches Attribut, das festgelegt werden soll, ist die Gültigkeitsdauer. Eine Gültigkeitsdauer ist der Zeitraum, in dem autorisierte Empfänger auf ein richtliniengeschütztes Dokument zugreifen können. Wenn Sie dieses Attribut nicht festlegen, ist die Richtlinie immer gültig.
Eine Gültigkeitsdauer kann auf eine der folgenden Optionen eingestellt werden:
  • Eine bestimmte Anzahl von Tagen, ab dem das Dokument veröffentlicht wird
  • Ein Enddatum, nach dem das Dokument nicht mehr verfügbar ist
  • Ein bestimmter Datumsbereich, für den das Dokument verfügbar ist
  • Immer gültig
Sie können nur ein Beginn-Datum angeben, sodass die Richtlinie nach dem Beginn gültig ist. Wenn Sie nur ein Enddatum angeben, ist die Richtlinie bis zum Enddatum gültig. Eine Ausnahme wird jedoch ausgelöst, wenn weder ein Beginn- noch ein Enddatum definiert sind.
Beim Festlegen von Attributen, die zu einer Richtlinie gehören, können Sie auch Verschlüsselungseinstellungen festlegen. Diese Verschlüsselungseinstellungen wirken sich darauf aus, wenn die Richtlinie auf ein Dokument angewendet wird. Sie können die folgenden Verschlüsselungswerte angeben:
  • AES 256 : Stellt den AES-Verschlüsselungsalgorithmus mit einem 256-Bit-Schlüssel dar.
  • AES 128 : Stellt den AES-Verschlüsselungsalgorithmus mit einem 128-Bit-Schlüssel dar.
  • NoEncryption: Stellt keine Verschlüsselung dar.
Beim Festlegen der NoEncryption Option können Sie die PlaintextMetadata Option nicht auf false . Wenn Sie dies versuchen, wird eine Ausnahme ausgelöst.
Weitere Informationen zu anderen Attributen, die Sie festlegen können, finden Sie in der Policy Schnittstellenbeschreibung in der AEM Forms API-Referenz .
Richtlinieneintrag erstellen
Ein Richtlinieneintrag fügt Prinzipale, d. h. Gruppen und Benutzer, und Berechtigungen zu einer Richtlinie hinzu. Eine Richtlinie muss mindestens einen Richtlinieneintrag haben. Nehmen Sie beispielsweise an, dass Sie die folgenden Aufgaben ausführen:
  • Erstellen und registrieren Sie einen Richtlinieneintrag, der es einer Gruppe ermöglicht, ein Dokument nur im Internet Ansicht und es Empfängern untersagt, es zu kopieren.
  • Hängen Sie den Richtlinieneintrag an die Richtlinie an.
  • Sichern Sie ein Dokument mit der Richtlinie mithilfe von Acrobat.
Diese Aktionen führen dazu, dass Empfänger das Dokument nur online Ansicht und nicht kopieren können. Das Dokument bleibt solange geschützt, bis die Sicherheit entfernt ist.
Richtlinie registrieren
Eine neue Richtlinie muss registriert werden, bevor sie verwendet werden kann. Nachdem Sie eine Richtlinie registriert haben, können Sie sie zum Schutz von Dokumenten verwenden.

Eine Richtlinie mit der Java-API erstellen

Erstellen Sie eine Richtlinie mithilfe der Dokument Security API (Java):
  1. Schließen Sie Projektdateien ein.
    Schließen Sie Client-JAR-Dateien wie "adobe-rightsmanagement-client.jar"im Klassenpfad Ihres Java-Projekts ein.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
    • Erstellen Sie ein ServiceClientFactory -" -Objekt, das Verbindungseigenschaften enthält.
    • Erstellen Sie ein DocumentSecurityClient -Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory -Objekt übergeben.
  3. Legen Sie die Attribute der Richtlinie fest.
    • Erstellen Sie ein Policy Objekt, indem Sie die statische InfomodelObjectFactory Objektmethode aufrufen createPolicy . Diese Methode gibt ein Policy Objekt zurück.
    • Legen Sie das Namensattribut der Richtlinie fest, indem Sie die Policy Objektmethode aufrufen und einen Zeichenfolgenwert übergeben, der den Richtliniennamen angibt. setName
    • Legen Sie die Beschreibung der Richtlinie fest, indem Sie die Policy Methode des setDescription Objekts aufrufen und einen Zeichenfolgenwert übergeben, der die Beschreibung der Richtlinie angibt.
    • Legen Sie den Richtliniensatz, zu dem die neue Richtlinie gehört, fest, indem Sie die Policy Objektmethode aufrufen und einen Zeichenfolgenwert übergeben, der den Richtliniensatznamen angibt. setPolicySetName (Sie können null für diesen Parameterwert angeben, dass die Richtlinie dem Richtliniensatz Meine Richtlinien hinzugefügt wird.)
    • Erstellen Sie die Gültigkeitsdauer der Richtlinie, indem Sie die statische InfomodelObjectFactory Methode des Objekts aufrufen createValidityPeriod . Diese Methode gibt ein ValidityPeriod Objekt zurück.
    • Legen Sie die Anzahl der Tage fest, für die auf ein richtliniengeschütztes Dokument zugegriffen werden kann, indem Sie die ValidityPeriod setRelativeExpirationDays Objektmethode aufrufen und einen ganzzahligen Wert übergeben, der die Anzahl der Tage angibt.
    • Legen Sie die Gültigkeitsdauer der Richtlinie fest, indem Sie die Policy Methode des setValidityPeriod Objekts aufrufen und das ValidityPeriod Objekt übergeben.
  4. Erstellen Sie einen Richtlinieneintrag.
    • Erstellen Sie einen Richtlinieneintrag, indem Sie die statische InfomodelObjectFactory Methode des Objekts aufrufen createPolicyEntry . Diese Methode gibt ein PolicyEntry Objekt zurück.
    • Geben Sie die Berechtigungen der Richtlinie an, indem Sie die statische InfomodelObjectFactory Methode des Objekts aufrufen createPermission . Übergeben Sie einen statischen Datenmember, der zur Permission Schnittstelle gehört, die die Berechtigung darstellt. Diese Methode gibt ein Permission Objekt zurück. Um beispielsweise die Berechtigung zum Kopieren von Daten aus einem richtliniengeschützten PDF-Dokument hinzuzufügen, übergeben Sie Permission.COPY . (Wiederholen Sie diesen Schritt für jede hinzuzufügende Berechtigung.)
    • Hinzufügen Sie die Berechtigung für den Richtlinieneintrag, indem Sie die PolicyEntry Methode des addPermission Objekts aufrufen und das Permission Objekt übergeben. (Wiederholen Sie diesen Schritt für jedes erstellte Permission Objekt.)
    • Erstellen Sie den Richtlinienprinzipal, indem Sie die statische InfomodelObjectFactory Methode des Objekts aufrufen createSpecialPrincipal . Übergeben Sie einen Datenmember, der zu dem InfomodelObjectFactory Objekt gehört, das den Prinzipal darstellt. Diese Methode gibt ein Principal Objekt zurück. Um beispielsweise den Herausgeber des Dokuments als Prinzipal hinzuzufügen, übergeben Sie InfomodelObjectFactory.PUBLISHER_PRINCIPAL .
    • Hinzufügen Sie den Prinzipal zum Richtlinieneintrag, indem Sie die PolicyEntry Methode des setPrincipal Objekts aufrufen und das Principal Objekt übergeben.
    • Hinzufügen Sie den Richtlinieneintrag in die Richtlinie, indem Sie die Policy Methode des addPolicyEntry Objekts aufrufen und das PolicyEntry Objekt übergeben.
  5. Registrieren Sie die Richtlinie.
    • Erstellen Sie ein PolicyManager Objekt, indem Sie die DocumentSecurityClient Objektmethode getPolicyManager aufrufen.
    • Registrieren Sie die Richtlinie, indem Sie die PolicyManager Methode des registerPolicy Objekts aufrufen und die folgenden Werte übergeben:
      • Das Policy Objekt, das die zu registrierende Richtlinie darstellt.
    • Ein Zeichenfolgenwert, der den Richtliniensatz darstellt, zu dem die Richtlinie gehört.
    Wenn Sie ein AEM Forms-Administratorkonto in den Verbindungseinstellungen verwenden, um das DocumentSecurityClient Objekt zu erstellen, geben Sie beim Aufrufen der registerPolicy Methode den Richtliniensatznamen an. Wenn Sie einen null Wert für den Richtliniensatz übergeben, wird die Richtlinie im Richtliniensatz Meine Richtlinien für Administratoren erstellt.
    Wenn Sie einen Dokument Security-Benutzer in den Verbindungseinstellungen verwenden, können Sie die Überlastungsmethode aufrufen, die nur die Richtlinie akzeptiert. registerPolicy Das heißt, Sie müssen den Richtliniensatznamen nicht angeben. Die Richtlinie wird jedoch dem Richtliniensatz Meine Richtlinien hinzugefügt. Wenn Sie diesem Richtliniensatz keine neue Richtlinie hinzufügen möchten, geben Sie beim Aufrufen der registerPolicy Methode einen Richtliniensatznamen an.
    Verweisen Sie beim Erstellen einer Richtlinie auf einen vorhandenen Richtliniensatz. Wenn Sie einen Richtliniensatz angeben, der nicht vorhanden ist, wird eine Ausnahme ausgelöst.
Codebeispiele für die Verwendung des Dokument Security-Dienstes finden Sie unter:
  • "Quick Beginn (SOAP-Modus): Richtlinie mit der Java-API erstellen"

Eine Richtlinie mit der Webdienst-API erstellen

Erstellen Sie eine Richtlinie mithilfe der Dokument Security API (Webdienst):
  1. Schließen Sie Projektdateien ein.
    Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    Ersetzen Sie localhost dies durch die IP-Adresse des Hosting-AEM Forms.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
    • Create a DocumentSecurityServiceClient object by using its default constructor.
    • Create a DocumentSecurityServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Übergeben Sie einen Zeichenfolgenwert, der die WSDL an den AEM Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/RightsManagementService?WSDL ). Sie müssen das lc_version Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen.)
    • Erstellen Sie ein System.ServiceModel.BasicHttpBinding Objekt, indem Sie den Wert des RightsManagementServiceClient.Endpoint.Binding Felds abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
    • Legen Sie für das System.ServiceModel.BasicHttpBinding Objektfeld MessageEncoding den Wert WSMessageEncoding.Mtom fest. Dieser Wert stellt sicher, dass MTOM verwendet wird.
    • Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Aufgaben ausführen:
      • Weisen Sie dem Feld den AEM Forms-Benutzernamen zu RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • Weisen Sie dem Feld den entsprechenden Kennwortwert zu RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Weisen Sie dem Feld den Konstantenwert HttpClientCredentialType.Basic zu BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Weisen Sie dem Feld den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu BasicHttpBindingSecurity.Security.Mode .
  3. Legen Sie die Attribute der Richtlinie fest.
    • Erstellen Sie ein Objekt PolicySpec , indem Sie den Konstruktor verwenden.
    • Legen Sie den Namen der Richtlinie fest, indem Sie dem Datenmember des PolicySpec Objekts einen Zeichenfolgenwert zuweisen name .
    • Legen Sie die Beschreibung der Richtlinie fest, indem Sie dem Datenmember des PolicySpec Objekts einen Zeichenfolgenwert zuweisen description .
    • Legen Sie den Richtliniensatz fest, zu dem die Richtlinie gehören soll, indem Sie dem PolicySpec Datenmember des policySetName Objekts einen Zeichenfolgenwert zuweisen. Sie müssen einen bestehenden Richtliniensatznamen angeben. (Sie können null für diesen Parameterwert angeben, dass die Richtlinie zu Meine Richtlinien hinzugefügt wird.)
    • Legen Sie die Offline-Nutzungsdauer der Richtlinie fest, indem Sie dem PolicySpec Datenmember des offlineLeasePeriod Objekts einen ganzzahligen Wert zuweisen.
    • Legen Sie den PolicySpec Datenmember des policyXml Objekts mit einem Zeichenfolgenwert fest, der die PDRL-XML-Daten darstellt. Um diese Aufgabe auszuführen, erstellen Sie ein .NET- StreamReader Objekt mit dessen Konstruktor. Übergeben Sie den Speicherort einer PDRL-XML-Datei, die die Richtlinie darstellt, an den StreamReader Konstruktor. Rufen Sie als Nächstes die StreamReader ReadLine Objektmethode auf und weisen Sie der Zeichenfolgen-Variablen den Rückgabewert zu. Durchlaufen des StreamReader Objekts, bis die ReadLine Methode null zurückgibt. Weisen Sie die Zeichenfolgenvariable dem PolicySpec Datenmember des policyXml Objekts zu.
  4. Erstellen Sie einen Richtlinieneintrag.
    Es ist nicht erforderlich, beim Erstellen einer Richtlinie mit der Dokument Security-Webdienst-API einen Richtlinieneintrag zu erstellen. Der Richtlinieneintrag wird im PDRL-Dokument definiert.
  5. Registrieren Sie die Richtlinie.
    Registrieren Sie die Richtlinie, indem Sie die DocumentSecurityServiceClient Methode des registerPolicy Objekts aufrufen und die folgenden Werte übergeben:
    • Das PolicySpec Objekt, das die zu registrierende Richtlinie darstellt.
    • Ein Zeichenfolgenwert, der den Richtliniensatz darstellt, zu dem die Richtlinie gehört. Sie können einen null Wert angeben, der dazu führt, dass die Richtlinie dem Richtliniensatz MeineRichtlinien hinzugefügt wird.
    Wenn Sie ein AEM Forms-Administratorkonto in den Verbindungseinstellungen verwenden, um das DocumentSecurityClient Objekt zu erstellen, geben Sie beim Aufrufen der registerPolicy Methode den Richtliniensatznamen an.
    Wenn Sie einen Dokument SecurityDocument Security-Benutzer in den Verbindungseinstellungen verwenden, können Sie die Überlastungsmethode aufrufen, die nur die Richtlinie akzeptiert. registerPolicy Das heißt, Sie müssen den Richtliniensatznamen nicht angeben. Die Richtlinie wird jedoch dem Richtliniensatz Meine Richtlinien hinzugefügt. Wenn Sie diesem Richtliniensatz keine neue Richtlinie hinzufügen möchten, geben Sie beim Aufrufen der registerPolicy Methode einen Richtliniensatznamen an.
    Wenn Sie eine Richtlinie erstellen und einen Richtliniensatz angeben, stellen Sie sicher, dass Sie einen vorhandenen Richtliniensatz angeben. Wenn Sie einen Richtliniensatz angeben, der nicht vorhanden ist, wird eine Ausnahme ausgelöst.
Codebeispiele für den Dokument Security-Dienst finden Sie in den folgenden Quick-Beginn:
  • "Quick Beginn (MTOM): Erstellen einer Richtlinie mit der Webdienst-API"
  • "Quick Beginn (SwaRef): Erstellen einer Richtlinie mit der Webdienst-API"

Richtlinien ändern

Sie können eine vorhandene Richtlinie mit der Java-API für Dokument-Sicherheit oder der Webdienst-API ändern. Um Änderungen an einer vorhandenen Richtlinie vorzunehmen, rufen Sie sie ab, ändern sie und aktualisieren Sie dann die Richtlinie auf dem Server. Nehmen Sie beispielsweise an, Sie rufen eine vorhandene Richtlinie ab und verlängern die Gültigkeitsdauer. Bevor die Änderung wirksam wird, müssen Sie die Richtlinie aktualisieren.
Sie können eine Richtlinie ändern, wenn sich die Geschäftsanforderungen ändern und die Richtlinie diese Anforderungen nicht mehr widerspiegelt. Anstatt eine neue Richtlinie zu erstellen, können Sie einfach eine vorhandene Richtlinie aktualisieren.
Um Richtlinienattribute mithilfe eines Webdiensts zu ändern (z. B. mithilfe von Java-Proxyklassen, die mit JAX-WS erstellt wurden), müssen Sie sicherstellen, dass die Richtlinie beim Dokument Security-Dienst registriert ist. Sie können dann mithilfe der PolicySpec.getPolicyXml Methode auf die vorhandene Richtlinie verweisen und die Richtlinienattribute mithilfe der entsprechenden Methoden ändern. Sie können beispielsweise die Offline-Nutzungsdauer ändern, indem Sie die PolicySpec.setOfflineLeasePeriod Methode aufrufen.
For more information about the Document Security service, see Services Reference for AEM Forms .

Zusammenfassung der Schritte

So ändern Sie eine vorhandene Richtlinie:
  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
  3. Eine vorhandene Richtlinie abrufen.
  4. Richtlinienattribute ändern
  5. Aktualisieren Sie die Richtlinie.
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, stellen Sie sicher, dass Sie die Proxydateien einschließen.
Dokument Security Client API-Objekt erstellen
Bevor Sie einen Dokument Security-Vorgang programmgesteuert durchführen können, müssen Sie ein Client-Objekt des Dokument Security-Dienstes erstellen. Wenn Sie die Java-API verwenden, erstellen Sie ein RightsManagementClient Objekt. Wenn Sie die Dokument Security-Webdienst-API verwenden, erstellen Sie ein RightsManagementServiceService Objekt.
Eine vorhandene Richtlinie abrufen
Sie müssen eine vorhandene Richtlinie abrufen, um sie zu ändern. Um eine Richtlinie abzurufen, geben Sie den Richtliniennamen und den Richtliniensatz an, zu dem die Richtlinie gehört. Wenn Sie einen null Wert für den Richtliniensatznamen angeben, wird die Richtlinie aus dem Richtliniensatz " Meine Richtlinien "abgerufen.
Attribute der Richtlinie festlegen
Um eine Richtlinie zu ändern, ändern Sie den Wert der Richtlinienattribute. Das einzige Richtlinienattribut, das Sie nicht ändern können, ist das Attribut name. Um beispielsweise die Offline-Nutzungsdauer der Richtlinie zu ändern, können Sie den Wert des Attributs für die Offline-Nutzungsdauer der Richtlinie ändern.
Beim Ändern der Offline-Nutzungsdauer einer Richtlinie mithilfe eines Webdiensts wird das offlineLeasePeriod Feld auf der PolicySpec Oberfläche ignoriert. Um die Offline-Nutzungsdauer zu aktualisieren, ändern Sie das OfflineLeasePeriod Element im PDRL-XML-Dokument. Verweisen Sie dann auf das aktualisierte PDRL XML-Dokument, indem Sie den PolicySpec Datenmember der policyXML Oberfläche verwenden.
Weitere Informationen zu anderen Attributen, die Sie festlegen können, finden Sie in der Policy Schnittstellenbeschreibung in der AEM Forms API-Referenz .
Richtlinie aktualisieren
Bevor die Änderungen, die Sie an einer Richtlinie vornehmen, wirksam werden, müssen Sie die Richtlinie mit dem Dokument Security-Dienst aktualisieren. Änderungen an Richtlinien, die Dokumente schützen, werden aktualisiert, wenn das richtliniengeschützte Dokument das nächste Mal mit dem Dokument Security-Dienst synchronisiert wird.

Vorhandene Richtlinien mit der Java-API ändern

Ändern Sie eine vorhandene Richtlinie mithilfe der Dokument Security API (Java):
  1. Schließen Sie Projektdateien ein.
    Schließen Sie Client-JAR-Dateien wie "adobe-rightsmanagement-client.jar"im Klassenpfad Ihres Java-Projekts ein.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
    • Erstellen Sie ein ServiceClientFactory -" -Objekt, das Verbindungseigenschaften enthält.
    • Erstellen Sie ein RightsManagementClient -Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory -Objekt übergeben.
  3. Eine vorhandene Richtlinie abrufen.
    • Erstellen Sie ein PolicyManager Objekt, indem Sie die RightsManagementClient Objektmethode getPolicyManager aufrufen.
    • Erstellen Sie ein Policy Objekt, das die zu aktualisierende Richtlinie darstellt, indem Sie die PolicyManager Objektmethode aufrufen getPolicy und die folgenden Werte übergeben."
      • Ein Zeichenfolgenwert, der den Richtliniensatznamen darstellt, zu dem die Richtlinie gehört. Sie können festlegen, null dass der Richtliniensatz verwendet werden MyPolicies soll.
      • Ein Zeichenfolgenwert, der den Richtliniennamen darstellt.
  4. Legen Sie die Attribute der Richtlinie fest.
    Ändern Sie die Attribute der Richtlinie entsprechend Ihren Geschäftsanforderungen. Um beispielsweise die Offline-Nutzungsdauer der Richtlinie zu ändern, rufen Sie die Policy Objektmethode setOfflineLeasePeriod auf.
  5. Aktualisieren Sie die Richtlinie.
    Aktualisieren Sie die Richtlinie, indem Sie die PolicyManager Objektmethode updatePolicy aufrufen. Übergeben Sie das Policy Objekt, das die zu aktualisierende Richtlinie darstellt.
Codebeispiele
Codebeispiele, die den Dokument Security-Dienst verwenden, finden Sie im Quick Beginn(SOAP-Modus): Ändern einer Richtlinie mithilfe des Abschnitts "Java-API".

Vorhandene Richtlinien mit der Webdienst-API ändern

Ändern Sie eine vorhandene Richtlinie mithilfe der Dokument Security API (Webdienst):
  1. Schließen Sie Projektdateien ein.
    Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    Ersetzen Sie localhost dies durch die IP-Adresse des Hosting-AEM Forms.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
    • Create a RightsManagementServiceClient object by using its default constructor.
    • Create a RightsManagementServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Übergeben Sie einen Zeichenfolgenwert, der die WSDL an den AEM Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/RightsManagementService?WSDL ). Sie müssen das lc_version Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen.)
    • Erstellen Sie ein System.ServiceModel.BasicHttpBinding Objekt, indem Sie den Wert des RightsManagementServiceClient.Endpoint.Binding Felds abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
    • Legen Sie für das System.ServiceModel.BasicHttpBinding Objektfeld MessageEncoding den Wert WSMessageEncoding.Mtom fest. Dieser Wert stellt sicher, dass MTOM verwendet wird.
    • Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Aufgaben ausführen:
      • Weisen Sie dem Feld den AEM Forms-Benutzernamen zu RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • Weisen Sie dem Feld den entsprechenden Kennwortwert zu RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Weisen Sie dem Feld den Konstantenwert HttpClientCredentialType.Basic zu BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Weisen Sie dem Feld den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu BasicHttpBindingSecurity.Security.Mode .
  3. Eine vorhandene Richtlinie abrufen.
    Erstellen Sie ein PolicySpec Objekt, das die zu ändernde Richtlinie darstellt, indem Sie die RightsManagementServiceClient getPolicy Objektmethode aufrufen und die folgenden Werte übergeben:
    • Ein Zeichenfolgenwert, der den Richtliniensatznamen angibt, zu dem die Richtlinie gehört. Sie können festlegen, null dass der Richtliniensatz verwendet werden MyPolicies soll.
    • Ein Zeichenfolgenwert, der den Namen der Richtlinie angibt.
  4. Legen Sie die Attribute der Richtlinie fest.
    Ändern Sie die Attribute der Richtlinie entsprechend Ihren Geschäftsanforderungen.
  5. Aktualisieren Sie die Richtlinie.
    Aktualisieren Sie die Richtlinie, indem Sie die RightsManagementServiceClient Methode des updatePolicyFromSDK Objekts aufrufen und das PolicySpec Objekt übergeben, das die zu aktualisierende Richtlinie darstellt.
Codebeispiele
Codebeispiele für den Dokument Security-Dienst finden Sie in den folgenden Quick-Beginn:
  • "Quick Beginn (MTOM): Ändern einer Richtlinie mithilfe der Webdienst-API"
  • "Quick Beginn (SwaRef): Ändern einer Richtlinie mithilfe der Webdienst-API"

Löschen von Richtlinien

Sie können eine vorhandene Richtlinie mit der Java-API oder der Webdienst-API von Dokument Security löschen. Nachdem eine Richtlinie gelöscht wurde, kann sie nicht mehr zum Schutz von Dokumenten verwendet werden. Vorhandene richtliniengeschützte Dokumente, die die Richtlinie verwenden, sind jedoch weiterhin geschützt. Sie können eine Richtlinie löschen, wenn eine neuere verfügbar wird.
For more information about the Document Security service, see Services Reference for AEM Forms .

Zusammenfassung der Schritte

So löschen Sie eine vorhandene Richtlinie:
  1. Projektdateien einschließen
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
  3. Löschen Sie die Richtlinie.
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, stellen Sie sicher, dass Sie die Proxydateien einschließen.
Dokument Security Client API-Objekt erstellen
Bevor Sie einen Dokument Security-Dienstvorgang programmgesteuert durchführen können, müssen Sie ein Client-Objekt des Dokument Security-Dienstes erstellen. Wenn Sie die Java-API verwenden, erstellen Sie ein RightsManagementClient Objekt. Wenn Sie die Dokument Security-Webdienst-API verwenden, erstellen Sie ein RightsManagementServiceService Objekt.
Richtlinie löschen
Um eine Richtlinie zu löschen, geben Sie die zu löschende Richtlinie und den Richtliniensatz an, zu dem die Richtlinie gehört. Der Benutzer, dessen Einstellungen zum Aufrufen von AEM Forms verwendet werden, muss berechtigt sein, die Richtlinie zu löschen. andernfalls tritt eine Ausnahme auf. Wenn Sie versuchen, eine Richtlinie zu löschen, die nicht vorhanden ist, tritt eine Ausnahme auf.

Richtlinien mit der Java-API löschen

Eine Richtlinie mithilfe der Dokument Security API (Java) löschen:
  1. Schließen Sie Projektdateien ein.
    Schließen Sie Client-JAR-Dateien wie "adobe-rightsmanagement-client.jar"im Klassenpfad Ihres Java-Projekts ein.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
    • Erstellen Sie ein ServiceClientFactory -" -Objekt, das Verbindungseigenschaften enthält.
    • Erstellen Sie ein RightsManagementClient -Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory -Objekt übergeben.
  3. Löschen Sie die Richtlinie.
    • Erstellen Sie ein PolicyManager Objekt, indem Sie die RightsManagementClient Objektmethode getPolicyManager aufrufen.
    • Löschen Sie die Richtlinie, indem Sie die PolicyManager Methode des deletePolicy Objekts aufrufen und die folgenden Werte übergeben:
      • Ein Zeichenfolgenwert, der den Richtliniensatznamen angibt, zu dem die Richtlinie gehört. Sie können festlegen, null dass der Richtliniensatz verwendet werden MyPolicies soll.
      • Ein Zeichenfolgenwert, der den Namen der zu löschenden Richtlinie angibt.
Codebeispiele
Codebeispiele für den Dokument Security-Dienst finden Sie in den folgenden Quick-Beginn:
  • "Quick Beginn (SOAP-Modus): Löschen einer Richtlinie mit der Java-API"

Richtlinien mit der Webdienst-API löschen

Eine Richtlinie mithilfe der Dokument Security API (Webdienst) löschen:
  1. Schließen Sie Projektdateien ein.
    Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    Ersetzen Sie localhost dies durch die IP-Adresse des Hosting-AEM Forms.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
    • Create a RightsManagementServiceClient object by using its default constructor.
    • Create a RightsManagementServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Übergeben Sie einen Zeichenfolgenwert, der die WSDL an den AEM Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/RightsManagementService?WSDL ). Sie müssen das lc_version Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen.)
    • Erstellen Sie ein System.ServiceModel.BasicHttpBinding Objekt, indem Sie den Wert des RightsManagementServiceClient.Endpoint.Binding Felds abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
    • Legen Sie für das System.ServiceModel.BasicHttpBinding Objektfeld MessageEncoding den Wert WSMessageEncoding.Mtom fest. Dieser Wert stellt sicher, dass MTOM verwendet wird.
    • Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Aufgaben ausführen:
      • Weisen Sie dem Feld den AEM Forms-Benutzernamen zu RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • Weisen Sie dem Feld den entsprechenden Kennwortwert zu RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Weisen Sie dem Feld den Konstantenwert HttpClientCredentialType.Basic zu BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Weisen Sie dem Feld den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu BasicHttpBindingSecurity.Security.Mode .
  3. Löschen Sie die Richtlinie.
    Delete a policy by invoking the RightsManagementServiceClient object’s deletePolicy method and passing the following values:
    • Ein Zeichenfolgenwert, der den Richtliniensatznamen angibt, zu dem die Richtlinie gehört. Sie können festlegen, null dass der Richtliniensatz verwendet werden MyPolicies soll.
    • Ein Zeichenfolgenwert, der den Namen der zu löschenden Richtlinie angibt.
Codebeispiele
Codebeispiele für den Dokument Security-Dienst finden Sie in den folgenden Quick-Beginn:
  • "Quick Beginn (MTOM): Löschen einer Richtlinie mithilfe der Webdienst-API"
  • "Quick Beginn (SwaRef): Löschen einer Richtlinie mithilfe der Webdienst-API"

Richtlinien auf PDF-Dokumente anwenden

Sie können eine Richtlinie auf ein PDF-Dokument anwenden, um das Dokument zu schützen. Durch Anwendung einer Richtlinie auf ein PDF-Dokument beschränken Sie den Zugriff auf das Dokument. Sie können eine Richtlinie nicht auf ein Dokument anwenden, wenn das Dokument bereits durch eine Richtlinie gesichert wurde.
Während das Dokument geöffnet ist, können Sie den Zugriff auf Acrobat- und Adobe Reader-Funktionen einschränken, einschließlich der Möglichkeit, Text zu drucken und zu kopieren, Änderungen vorzunehmen und Signaturen und Kommentare zu einem Dokument hinzuzufügen. Darüber hinaus können Sie ein richtliniengeschütztes PDF-Dokument sperren, wenn Sie nicht mehr möchten, dass Benutzer auf das Dokument zugreifen können.
Sie können die Verwendung eines richtliniengeschützten Dokuments überwachen, nachdem Sie es verteilt haben. Das heißt, Sie können sehen, wie das Dokument verwendet wird und wer es verwendet. Sie können beispielsweise herausfinden, wann jemand das Dokument geöffnet hat.
For more information about the Document Security service, see Services Reference for AEM Forms .

Zusammenfassung der Schritte

So wenden Sie eine Richtlinie auf ein PDF-Dokument an:
  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
  3. Rufen Sie ein PDF-Dokument ab, auf das eine Richtlinie angewendet wird.
  4. Eine vorhandene Richtlinie auf das PDF-Dokument anwenden
  5. Speichern Sie das richtliniengeschützte PDF-Dokument.
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, stellen Sie sicher, dass Sie die Proxydateien einschließen.
Erstellen eines Dokument Security Client-API-Objekts
Bevor Sie einen Dokument Security-Dienstvorgang programmgesteuert durchführen können, erstellen Sie ein Client-Objekt des Dokument Security-Dienstes. Wenn Sie die Java-API verwenden, erstellen Sie ein DocumentSecurityClient Objekt. Wenn Sie die Dokument Security-Webdienst-API verwenden, erstellen Sie ein DocumentSecurityServiceService Objekt.
PDF-Dokument abrufen
Sie können ein PDF-Dokument abrufen, um eine Richtlinie anzuwenden. Nachdem Sie eine Richtlinie auf das PDF-Dokument angewendet haben, sind Benutzer bei der Verwendung des Dokuments eingeschränkt. Wenn die Richtlinie beispielsweise nicht das Öffnen des Dokuments im Offlinemodus aktiviert, müssen die Benutzer zum Öffnen des Dokuments online sein.
Vorhandene Richtlinie auf das PDF-Dokument anwenden
Um eine Richtlinie auf ein PDF-Dokument anzuwenden, verweisen Sie auf eine vorhandene Richtlinie und geben Sie an, zu welchem Richtliniensatz die Richtlinie gehört. Der Benutzer, der die Verbindungseigenschaften einstellt, muss Zugriff auf die angegebene Richtlinie haben. Andernfalls tritt eine Ausnahme auf.
PDF-Dokument speichern
Nachdem der Dokument Security-Dienst eine Richtlinie auf ein PDF-Dokument angewendet hat, können Sie das richtliniengeschützte PDF-Dokument als PDF-Datei speichern.
Siehe auch

Anwenden einer Richtlinie auf ein PDF-Dokument mithilfe der Java-API

Anwenden einer Richtlinie auf ein PDF-Dokument mithilfe der Dokument Security API (Java):
  1. Schließen Sie Projektdateien ein.
    Schließen Sie Client-JAR-Dateien wie "adobe-rightsmanagement-client.jar"im Klassenpfad Ihres Java-Projekts ein.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
    • Erstellen Sie ein ServiceClientFactory -" -Objekt, das Verbindungseigenschaften enthält.
    • Erstellen Sie ein RightsManagementClient -Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory -Objekt übergeben.
  3. PDF-Dokument abrufen
    • Erstellen Sie ein java.io.FileInputStream Objekt, das das PDF-Dokument mit dem Konstruktor darstellt. Übergeben Sie einen Zeichenfolgenwert, der den Speicherort des PDF-Dokuments angibt.
    • Erstellen Sie ein com.adobe.idp.Document -Objekt, indem Sie seinen Konstruktor verwenden und das java.io.FileInputStream -Objekt übergeben.
  4. Eine vorhandene Richtlinie auf das PDF-Dokument anwenden
    • Erstellen Sie ein DocumentManager Objekt, indem Sie die RightsManagementClient Objektmethode getDocumentManager aufrufen.
    • Wenden Sie eine Richtlinie auf das PDF-Dokument an, indem Sie die DocumentManager protectDocument Objektmethode aufrufen und die folgenden Werte übergeben:
      • Das com.adobe.idp.Document Objekt, das das PDF-Dokument enthält, auf das die Richtlinie angewendet wird.
      • Ein Zeichenfolgenwert, der den Namen des Dokuments angibt.
      • Ein Zeichenfolgenwert, der den Namen des Richtliniensatzes angibt, zu dem die Richtlinie gehört. Sie können einen null Wert angeben, der dazu führt, dass der MyPolicies Richtliniensatz verwendet wird.
      • Ein Zeichenfolgenwert, der den Richtliniennamen angibt.
      • Ein Zeichenfolgenwert, der den Namen der User Manager-Domäne des Benutzers darstellt, der Herausgeber des Dokuments ist. Dieser Parameterwert ist optional und kann null sein (wenn dieser Parameter null ist, muss der nächste Parameterwert null sein).
      • Ein Zeichenfolgenwert, der den Namen des kanonischen Benutzermanagers darstellt, der der Herausgeber des Dokuments ist. Dieser Parameterwert ist optional und kann null (wenn dieser Parameter null ist, muss der vorherige Parameterwert null sein).
      • Eine com.adobe.livecycle.rightsmanagement.Locale Variable, die das Gebietsschema darstellt, mit dem die MS Office-Vorlage ausgewählt wird. Dieser Parameterwert ist optional und wird nicht für PDF-Dokumente verwendet. Um ein PDF-Dokument zu sichern, geben Sie null an.
      Die protectDocument Methode gibt ein RMSecureDocumentResult Objekt zurück, das das richtliniengeschützte PDF-Dokument enthält.
  5. Speichern Sie das PDF-Dokument.
    • Rufen Sie die RMSecureDocumentResult getProtectedDoc Objektmethode auf, um das richtliniengeschützte PDF-Dokument abzurufen. Diese Methode gibt ein com.adobe.idp.Document Objekt zurück.
    • Create a java.io.File object and ensure that the file extension is PDF.
    • Rufen Sie die com.adobe.idp.Document Methode des copyToFile Objekts auf, um den Inhalt des Document Objekts in die Datei zu kopieren (stellen Sie sicher, dass Sie das Document Objekt verwenden, das von der getProtectedDoc -Methode zurückgegeben wurde).
Codebeispiele
Codebeispiele für den Dokument Security-Dienst finden Sie in den folgenden Quick-Beginn:
  • "Quick Beginn (EJB-Modus): Anwenden einer Richtlinie auf ein PDF-Dokument mithilfe der Java-API"
  • "Quick Beginn (SOAP-Modus): Anwenden einer Richtlinie auf ein PDF-Dokument mithilfe der Java-API"
Siehe auch

Anwenden einer Richtlinie auf ein PDF-Dokument mithilfe der Webdienst-API

Anwenden einer Richtlinie auf ein PDF-Dokument mithilfe der Dokument Security API (Webdienst):
  1. Schließen Sie Projektdateien ein.
    Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    Ersetzen Sie localhost dies durch die IP-Adresse des Hosting-AEM Forms.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
    • Create a RightsManagementServiceClient object by using its default constructor.
    • Create a RightsManagementServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Übergeben Sie einen Zeichenfolgenwert, der die WSDL angibt (z. B. http://localhost:8080/soap/services/RightsManagementService?WSDL ). Sie müssen das lc_version Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen.)
    • Erstellen Sie ein System.ServiceModel.BasicHttpBinding Objekt, indem Sie den Wert des RightsManagementServiceClient.Endpoint.Binding Felds abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
    • Legen Sie für das System.ServiceModel.BasicHttpBinding Objektfeld MessageEncoding den Wert WSMessageEncoding.Mtom fest. Dieser Wert stellt sicher, dass MTOM verwendet wird.
    • Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Aufgaben ausführen:
      • Weisen Sie dem Feld den AEM Forms-Benutzernamen zu RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • Weisen Sie dem Feld den entsprechenden Kennwortwert zu RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Weisen Sie dem Feld den Konstantenwert HttpClientCredentialType.Basic zu BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Weisen Sie dem Feld den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu BasicHttpBindingSecurity.Security.Mode .
  3. PDF-Dokument abrufen
    • Erstellen Sie ein Objekt BLOB , indem Sie den Konstruktor verwenden. Das BLOB Objekt dient zum Speichern eines PDF-Dokuments, auf das eine Richtlinie angewendet wird.
    • Erstellen Sie ein System.IO.FileStream Objekt, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Dateispeicherort des PDF-Dokuments und den Dateimodus darstellt, in dem die Datei geöffnet werden soll.
    • Erstellen Sie ein Bytearray, das den Inhalt des System.IO.FileStream Objekts speichert. Bestimmen Sie die Byte-Array-Größe, indem Sie die System.IO.FileStream Objekteigenschaft Length abrufen.
    • Füllen Sie das Bytearray mit Stream-Daten, indem Sie die System.IO.FileStream Objektmethode Read aufrufen. Übergeben Sie das Bytearray, die Startposition und die zu lesende Stream-Länge.
    • Füllen Sie das BLOB Objekt, indem Sie seinem MTOM Feld den Inhalt des Byte-Arrays zuweisen.
  4. Eine vorhandene Richtlinie auf das PDF-Dokument anwenden
    Wenden Sie eine Richtlinie auf das PDF-Dokument an, indem Sie die RightsManagementServiceClient protectDocument Objektmethode aufrufen und die folgenden Werte übergeben:
    • Das BLOB Objekt, das das PDF-Dokument enthält, auf das die Richtlinie angewendet wird.
    • Ein Zeichenfolgenwert, der den Namen des Dokuments angibt.
    • Ein Zeichenfolgenwert, der den Namen des Richtliniensatzes angibt, zu dem die Richtlinie gehört. Sie können einen null Wert angeben, der dazu führt, dass der MyPolicies Richtliniensatz verwendet wird.
    • Ein Zeichenfolgenwert, der den Richtliniennamen angibt.
    • Ein Zeichenfolgenwert, der den Namen der User Manager-Domäne des Benutzers darstellt, der Herausgeber des Dokuments ist. Dieser Parameterwert ist optional und kann null sein (wenn dieser Parameter null ist, muss der nächste Parameterwert null sein).
    • Ein Zeichenfolgenwert, der den Namen des kanonischen Benutzermanagers darstellt, der der Herausgeber des Dokuments ist. Dieser Parameterwert ist optional und kann null sein (wenn dieser Parameter null ist, muss der vorherige Parameterwert null sein).
    • Ein RMLocale Wert, der den Gebietsschemawert angibt (z. B. RMLocale.en ).
    • Ein Zeichenfolgenausgabeparameter, mit dem der Richtlinienerkennungswert gespeichert wird.
    • Ein Zeichenfolgenausgabeparameter, mit dem der richtliniengeschützte Bezeichnerwert gespeichert wird.
    • Ein Parameter für die Zeichenfolgenausgabe, mit dem der Mime-Typ gespeichert wird (z. B. application/pdf ).
    Die protectDocument Methode gibt ein BLOB Objekt zurück, das das richtliniengeschützte PDF-Dokument enthält.
  5. Speichern Sie das PDF-Dokument.
    • Erstellen Sie ein System.IO.FileStream Objekt, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Dateispeicherort des richtliniengeschützten PDF-Dokuments darstellt.
    • Erstellen Sie ein Bytearray, das den Dateninhalt des BLOB Objekts speichert, das von der protectDocument Methode zurückgegeben wurde. Füllen Sie das Byte-Array, indem Sie den Wert des BLOB Datenelements des MTOM Objekts abrufen.
    • Create a System.IO.BinaryWriter object by invoking its constructor and passing the System.IO.FileStream object.
    • Schreiben Sie den Inhalt des Byte-Arrays in eine PDF-Datei, indem Sie die System.IO.BinaryWriter Objektmethode aufrufen und das Bytearray Write übergeben.
Codebeispiele
Codebeispiele für den Dokument Security-Dienst finden Sie in den folgenden Quick-Beginn:
  • "Quick Beginn (MTOM): Anwenden einer Richtlinie auf ein PDF-Dokument mithilfe der Webdienst-API"
  • "Quick Beginn (SwaRef): Anwenden einer Richtlinie auf ein PDF-Dokument mithilfe der Webdienst-API"

Richtlinien aus PDF-Dokumenten entfernen

Sie können eine Richtlinie aus einem richtliniengeschützten Dokument entfernen, um die Sicherheit aus dem Dokument zu entfernen. Das heißt, wenn das Dokument nicht mehr durch eine Richtlinie geschützt werden soll. Wenn Sie ein richtliniengeschütztes Dokument mit einer neueren Richtlinie aktualisieren möchten, ist es effizienter, die Richtlinie zu wechseln, anstatt die Richtlinie zu entfernen und die aktualisierte Richtlinie hinzuzufügen.
For more information about the Document Security service, see Services Reference for AEM Forms .

Zusammenfassung der Schritte

So entfernen Sie eine Richtlinie aus einem richtliniengeschützten PDF-Dokument:
  1. Projektdateien einschließen
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
  3. Rufen Sie ein richtliniengeschütztes PDF-Dokument ab.
  4. Entfernen Sie die Richtlinie aus dem PDF-Dokument.
  5. Speichern Sie das unbesicherte PDF-Dokument.
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, stellen Sie sicher, dass Sie die Proxydateien einschließen.
Dokument Security Client API-Objekt erstellen
Bevor Sie einen Dokument Security-Dienstvorgang programmgesteuert durchführen können, erstellen Sie ein Client-Objekt des Dokument Security-Dienstes.
Richtliniengeschütztes PDF-Dokument abrufen
Sie können ein richtliniengeschütztes PDF-Dokument abrufen, um eine Richtlinie zu entfernen. Wenn Sie versuchen, eine Richtlinie aus einem PDF-Dokument zu entfernen, das nicht durch eine Richtlinie geschützt ist, wird eine Ausnahme ausgelöst.
Richtlinie aus dem PDF-Dokument entfernen
Sie können eine Richtlinie aus einem richtliniengeschützten PDF-Dokument entfernen, sofern in den Verbindungseinstellungen ein Administrator angegeben ist. Andernfalls muss die zum Schützen eines Dokuments verwendete Richtlinie die SWITCH_POLICY Berechtigung enthalten, um eine Richtlinie aus einem PDF-Dokument zu entfernen. Darüber hinaus muss der in den AEM Forms-Verbindungseinstellungen angegebene Benutzer über diese Berechtigung verfügen. Andernfalls wird eine Ausnahme ausgelöst.
Ungesichertes PDF-Dokument speichern
Nachdem der Dokument Security-Dienst eine Richtlinie aus einem PDF-Dokument entfernt hat, können Sie das unbesicherte PDF-Dokument als PDF-Datei speichern.
Siehe auch

Eine Richtlinie mithilfe der Java-API aus einem PDF-Dokument entfernen

Entfernen Sie eine Richtlinie mithilfe der Dokument Security API (Java) aus einem richtliniengeschützten PDF-Dokument:
  1. Schließen Sie Projektdateien ein.
    Schließen Sie Client-JAR-Dateien wie "adobe-rightsmanagement-client.jar"im Klassenpfad Ihres Java-Projekts ein.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
    • Erstellen Sie ein ServiceClientFactory -" -Objekt, das Verbindungseigenschaften enthält.
    • Erstellen Sie ein DocumentSecurityClient -Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory -Objekt übergeben.
  3. Rufen Sie ein richtliniengeschütztes PDF-Dokument ab.
    • Erstellen Sie ein java.io.FileInputStream Objekt, das das richtliniengeschützte PDF-Dokument darstellt, indem Sie den Konstruktor verwenden und einen Zeichenfolgenwert übergeben, der den Speicherort des PDF-Dokuments angibt.
    • Erstellen Sie ein com.adobe.idp.Document -Objekt, indem Sie seinen Konstruktor verwenden und das java.io.FileInputStream -Objekt übergeben.
  4. Entfernen Sie die Richtlinie aus dem PDF-Dokument.
    • Erstellen Sie ein DocumentManager Objekt, indem Sie die DocumentSecurityClient Objektmethode getDocumentManager aufrufen.
    • Entfernen Sie eine Richtlinie aus dem PDF-Dokument, indem Sie die DocumentManager Objektmethode aufrufen und das removeSecurity com.adobe.idp.Document Objekt übergeben, das das richtliniengeschützte PDF-Dokument enthält. Diese Methode gibt ein com.adobe.idp.Document Objekt zurück, das ein ungesichertes PDF-Dokument enthält.
  5. Speichern Sie das unbesicherte PDF-Dokument.
    • Create a java.io.File object and ensure that the file extension is PDF.
    • Rufen Sie die Document Methode des copyToFile Objekts auf, um den Inhalt des Document Objekts in die Datei zu kopieren (stellen Sie sicher, dass Sie das Document Objekt verwenden, das von der removeSecurity -Methode zurückgegeben wurde).
Codebeispiele
Codebeispiele für den Dokument Security-Dienst finden Sie in den folgenden Quick-Beginn:
  • "Quick Beginn (SOAP-Modus): Eine Richtlinie mithilfe der Java-API aus einem PDF-Dokument entfernen"

Eine Richtlinie mithilfe der Webdienst-API entfernen

Entfernen Sie eine Richtlinie mithilfe der Dokument Security API (Webdienst) aus einem richtliniengeschützten PDF-Dokument:
  1. Schließen Sie Projektdateien ein.
    Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    Ersetzen Sie localhost dies durch die IP-Adresse des Hosting-AEM Forms.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
    • Create a DocumentSecurityServiceClient object by using its default constructor.
    • Create a DocumentSecurityServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Übergeben Sie einen Zeichenfolgenwert, der die WSDL an den AEM Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/RightsManagementService?WSDL ). Sie müssen das lc_version Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen.)
    • Erstellen Sie ein System.ServiceModel.BasicHttpBinding Objekt, indem Sie den Wert des DocumentSecurityServiceClient.Endpoint.Binding Felds abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
    • Legen Sie für das System.ServiceModel.BasicHttpBinding Objektfeld MessageEncoding den Wert WSMessageEncoding.Mtom fest. Dieser Wert stellt sicher, dass MTOM verwendet wird.
    • Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Aufgaben ausführen:
      • Weisen Sie dem Feld den AEM Forms-Benutzernamen zu DocumentSecurityServiceClient.ClientCredentials.UserName.UserName .
      • Weisen Sie dem Feld den entsprechenden Kennwortwert zu DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • Weisen Sie dem Feld den Konstantenwert HttpClientCredentialType.Basic zu BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Weisen Sie dem Feld den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu BasicHttpBindingSecurity.Security.Mode .
  3. Rufen Sie ein richtliniengeschütztes PDF-Dokument ab.
    • Erstellen Sie ein Objekt BLOB , indem Sie den Konstruktor verwenden. Das BLOB Objekt wird zum Speichern des richtliniengeschützten PDF-Dokuments verwendet, von dem die Richtlinie entfernt wird.
    • Erstellen Sie ein System.IO.FileStream Objekt, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Dateispeicherort des PDF-Dokuments und den Dateimodus darstellt, in dem die Datei geöffnet werden soll.
    • Erstellen Sie ein Bytearray, das den Inhalt des System.IO.FileStream Objekts speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die System.IO.FileStream Objekteigenschaft Length abrufen.
    • Füllen Sie das Bytearray mit Stream-Daten, indem Sie die System.IO.FileStream Objektmethode aufrufen und das Bytearray, die Startposition und die zu lesende Stream-Länge übergeben Read .
    • Füllen Sie das BLOB Objekt, indem Sie seinem MTOM Feld den Inhalt des Byte-Arrays zuweisen.
  4. Entfernen Sie die Richtlinie aus dem PDF-Dokument.
    Entfernen Sie die Richtlinie aus dem PDF-Dokument, indem Sie die DocumentSecurityServiceClient Objektmethode aufrufen und das removePolicySecurity BLOB Objekt übergeben, das das richtliniengeschützte PDF-Dokument enthält. Diese Methode gibt ein BLOB Objekt zurück, das ein ungesichertes PDF-Dokument enthält.
  5. Speichern Sie das unbesicherte PDF-Dokument.
    • Erstellen Sie ein System.IO.FileStream Objekt, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der die Dateiposition des nicht geschützten PDF-Dokuments darstellt.
    • Erstellen Sie ein Bytearray, das den Dateninhalt des BLOB Objekts speichert, das von der removePolicySecurity Methode zurückgegeben wurde. Füllen Sie das Byte-Array, indem Sie den Wert des BLOB Objektfelds MTOM abrufen.
    • Create a System.IO.BinaryWriter object by invoking its constructor and passing the System.IO.FileStream object.
Codebeispiele
Codebeispiele für den Dokument Security-Dienst finden Sie in den folgenden Quick-Beginn:
  • "Quick Beginn (MTOM): Entfernen einer Richtlinie aus einem PDF-Dokument mithilfe der Webdienst-API"
  • "Quick Beginn (SwaRef): Entfernen einer Richtlinie aus einem PDF-Dokument mithilfe der Webdienst-API"
Siehe auch

Zugriff auf Dokumente sperren

Sie können den Zugriff auf ein richtliniengeschütztes PDF-Dokument sperren, sodass Benutzer nicht auf alle Kopien des Dokuments zugreifen können. Wenn ein Benutzer versucht, ein gesperrtes PDF-Dokument zu öffnen, wird er an eine angegebene URL weitergeleitet, unter der ein überarbeitetes Dokument angezeigt werden kann. Die URL, zu der der Benutzer umgeleitet wird, muss programmgesteuert angegeben werden. Wenn Sie den Zugriff auf ein Dokument sperren, wird die Änderung wirksam, wenn sich der Benutzer das nächste Mal mit dem Dokument Security-Dienst synchronisiert, indem das richtliniengeschützte Dokument online geöffnet wird.
Die Möglichkeit, den Zugriff auf ein Dokument zu sperren, bietet zusätzliche Sicherheit. Nehmen wir beispielsweise an, dass eine neuere Version eines Dokuments verfügbar ist und Sie möchten nicht mehr, dass sich jemand die veraltete Version ansieht. In diesem Fall kann der Zugriff auf das ältere Dokument widerrufen werden, und niemand kann das Dokument Ansicht werden, es sei denn, der Zugriff wird erneut aktiviert.
For more information about the Document Security service, see Services Reference for AEM Forms .

Zusammenfassung der Schritte

So sperren Sie ein richtliniengeschütztes Dokument:
  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
  3. Rufen Sie ein richtliniengeschütztes PDF-Dokument ab.
  4. Sperren Sie das richtliniengeschützte Dokument.
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, stellen Sie sicher, dass Sie die Proxydateien einschließen.
Dokument Security Client API-Objekt erstellen
Bevor Sie einen Dokument Security-Dienstvorgang programmgesteuert durchführen können, müssen Sie ein Client-Objekt des Dokument Security-Dienstes erstellen.
Richtliniengeschütztes PDF-Dokument abrufen
Sie müssen ein richtliniengeschütztes PDF-Dokument abrufen, um es zu sperren. Sie können ein Dokument, das bereits gesperrt wurde oder nicht richtliniengeschützt ist, nicht sperren.
Wenn Sie den Lizenzkennungswert des richtliniengeschützten Dokuments kennen, ist es nicht erforderlich, das richtliniengeschützte PDF-Dokument abzurufen. In den meisten Fällen müssen Sie jedoch das PDF-Dokument abrufen, um den Wert der Lizenzkennung abzurufen.
Richtliniengeschütztes Dokument sperren
Um ein richtliniengeschütztes Dokument zu sperren, geben Sie die Lizenzkennung des richtliniengeschützten Dokuments an. Darüber hinaus können Sie die URL eines Dokuments angeben, das der Benutzer beim Versuch, das gesperrte Dokument zu öffnen, Ansicht haben kann. Angenommen, ein veraltetes Dokument wird widerrufen. Wenn ein Benutzer versucht, das gesperrte Dokument zu öffnen, wird ihm ein aktualisiertes Dokument anstelle des gesperrten Dokuments angezeigt.
Wenn Sie versuchen, ein Dokument zu sperren, das bereits gesperrt ist, wird eine Ausnahme ausgelöst.
Siehe auch

Zugriff auf Dokumente mit der Java-API sperren

Sperren Sie den Zugriff auf ein richtliniengeschütztes PDF-Dokument mithilfe der Dokument Security API (Java):
  1. Projektdateien einschließen
    Schließen Sie Client-JAR-Dateien wie "adobe-rightsmanagement-client.jar"im Klassenpfad Ihres Java-Projekts ein.
  2. Dokument Security Client API-Objekt erstellen
    • Erstellen Sie ein ServiceClientFactory -" -Objekt, das Verbindungseigenschaften enthält.
    • Erstellen Sie ein DocumentSecurityClient -Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory -Objekt übergeben.
  3. Richtliniengeschütztes PDF-Dokument abrufen
    • Erstellen Sie ein java.io.FileInputStream Objekt, das das richtliniengeschützte PDF-Dokument darstellt, indem Sie den Konstruktor verwenden und einen Zeichenfolgenwert übergeben, der den Speicherort des PDF-Dokuments angibt.
    • Erstellen Sie ein com.adobe.idp.Document -Objekt, indem Sie seinen Konstruktor verwenden und das java.io.FileInputStream -Objekt übergeben.
  4. Richtliniengeschütztes Dokument sperren
    • Erstellen Sie ein DocumentManager Objekt, indem Sie die DocumentSecurityClient Objektmethode getDocumentManager aufrufen.
    • Rufen Sie den Lizenzkennungswert des richtliniengeschützten Dokuments ab, indem Sie die DocumentManager Objektmethode getLicenseId aufrufen. Übergeben Sie das com.adobe.idp.Document Objekt, das das richtliniengeschützte Dokument darstellt. Diese Methode gibt einen Zeichenfolgenwert zurück, der den Wert der Lizenzkennung darstellt.
    • Erstellen Sie ein LicenseManager Objekt, indem Sie die DocumentSecurityClient Objektmethode getLicenseManager aufrufen.
    • Rufen Sie das richtliniengeschützte Dokument auf, indem Sie die LicenseManager Objektmethode aufrufen und die folgenden Werte übergeben revokeLicense :
      • Ein Zeichenfolgenwert, der den Lizenzkennungswert des richtliniengeschützten Dokuments angibt (geben Sie den Rückgabewert der DocumentManager Objektmethode getLicenseId an).
      • Ein statisches Datenelement der License Schnittstelle, das den Grund zum Sperren des Dokuments angibt. For example, you can specify License.DOCUMENT_REVISED .
      • Ein java.net.URL Wert, der die Position angibt, an der sich ein überarbeitetes Dokument befindet. Wenn Sie einen Benutzer nicht zu einer anderen URL umleiten möchten, können Sie diese weiterleiten null .
Codebeispiele
Codebeispiele für den Dokument Security-Dienst finden Sie in den folgenden Quick-Beginn:
  • "Quick Beginn (SOAP-Modus): Widerrufen eines Dokuments mit der Java-API"

Zugriff auf Dokumente mit der Webdienst-API sperren

Sperren Sie den Zugriff auf ein richtliniengeschütztes PDF-Dokument mithilfe der Dokument Security API (Webdienst):
  1. Projektdateien einschließen
    Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    Ersetzen Sie localhost dies durch die IP-Adresse des Hosting-AEM Forms.
  2. Dokument Security Client API-Objekt erstellen
    • Create a DocumentSecurityServiceClient object by using its default constructor.
    • Create a DocumentSecurityServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Übergeben Sie einen Zeichenfolgenwert, der die WSDL an den AEM Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/RightsManagementService?WSDL ). Sie müssen das lc_version Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen.)
    • Erstellen Sie ein System.ServiceModel.BasicHttpBinding Objekt, indem Sie den Wert des DocumentSecurityServiceClient.Endpoint.Binding Felds abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
    • Legen Sie für das System.ServiceModel.BasicHttpBinding Objektfeld MessageEncoding den Wert WSMessageEncoding.Mtom fest. Dieser Wert stellt sicher, dass MTOM verwendet wird.
    • Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Aufgaben ausführen:
      • Weisen Sie dem Feld den AEM Forms-Benutzernamen zu DocumentSecurityServiceClient.ClientCredentials.UserName.UserName .
      • Weisen Sie dem Feld den entsprechenden Kennwortwert zu DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • Weisen Sie dem Feld den Konstantenwert HttpClientCredentialType.Basic zu BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Weisen Sie dem Feld den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu BasicHttpBindingSecurity.Security.Mode .
  3. Richtliniengeschütztes PDF-Dokument abrufen
    • Erstellen Sie ein Objekt BLOB , indem Sie den Konstruktor verwenden. Das BLOB Objekt dient zum Speichern eines richtliniengeschützten PDF-Dokuments, das gesperrt wird.
    • Erstellen Sie ein System.IO.FileStream Objekt, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Dateispeicherort des zu widerrufenden richtliniengeschützten PDF-Dokuments und den Dateimodus darstellt, in dem die Datei geöffnet werden soll.
    • Erstellen Sie ein Bytearray, das den Inhalt des System.IO.FileStream Objekts speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die System.IO.FileStream Objekteigenschaft Length abrufen.
    • Füllen Sie das Bytearray mit Stream-Daten, indem Sie die System.IO.FileStream Objektmethode aufrufen und das Bytearray, die Startposition und die zu lesende Stream-Länge übergeben Read .
    • Füllen Sie das BLOB Objekt, indem Sie seinem MTOM Feld den Inhalt des Byte-Arrays zuweisen.
  4. Richtliniengeschütztes Dokument sperren
    • Rufen Sie den Lizenzkennungswert des richtliniengeschützten Dokuments ab, indem Sie die DocumentSecurityServiceClient Objektmethode aufrufen und das Objekt übergeben, das das richtliniengeschützte Dokument getLicenseID BLOB darstellt. Diese Methode gibt einen Zeichenfolgenwert zurück, der die Lizenzkennung darstellt.
    • Rufen Sie das richtliniengeschützte Dokument auf, indem Sie die DocumentSecurityServiceClient Objektmethode aufrufen und die folgenden Werte übergeben revokeLicense :
      • Ein Zeichenfolgenwert, der den Lizenzkennungswert des richtliniengeschützten Dokuments angibt (geben Sie den Rückgabewert der DocumentSecurityServiceService Objektmethode getLicenseId an).
      • Ein statisches Datenelement der Reason Enum, das den Grund zum Sperren des Dokuments angibt. For example, you can specify Reason.DOCUMENT_REVISED .
      • Ein string Wert, der die URL-Position angibt, an der sich ein überarbeitetes Dokument befindet. Wenn Sie einen Benutzer nicht zu einer anderen URL umleiten möchten, können Sie diese weiterleiten null .
Codebeispiele
Codebeispiele für den Dokument Security-Dienst finden Sie in den folgenden Quick-Beginn:
  • "Quick Beginn (MTOM): Widerrufen eines Dokuments mit der Webdienst-API"
  • "Quick Beginn (SwaRef): Widerrufen eines Dokuments mit der Webdienst-API"
Siehe auch

Wiedereinsetzung des Zugriffs auf widerrufene Dokumente

Sie können den Zugriff auf ein gesperrtes PDF-Dokument reaktivieren, sodass alle Exemplare des gesperrten Dokuments für Benutzer zugänglich sind. Wenn ein Benutzer ein neu installiertes Dokument öffnet, das widerrufen wurde, kann er das Dokument Ansicht haben.
For more information about the Document Security service, see Services Reference for AEM Forms .

Zusammenfassung der Schritte

So reaktivieren Sie den Zugriff auf ein gesperrtes PDF-Dokument:
  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
  3. Rufen Sie die Lizenzkennung des gesperrten PDF-Dokuments ab.
  4. Zugriff auf das gesperrte PDF-Dokument neu zuweisen.
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, stellen Sie sicher, dass Sie die Proxydateien einschließen.
Dokument Security Client API-Objekt erstellen
Bevor Sie einen Dokument Security-Dienstvorgang programmgesteuert durchführen können, müssen Sie ein Client-Objekt des Dokument Security-Dienstes erstellen. Wenn Sie die Java-API verwenden, erstellen Sie ein DocumentSecurityClient Objekt. Wenn Sie die Dokument Security-Webdienst-API verwenden, erstellen Sie ein DocumentSecurityServiceService Objekt.
Abrufen der Lizenzkennung des gesperrten PDF-Dokuments
Sie müssen die Lizenzkennung des gesperrten PDF-Dokuments abrufen, um ein gesperrtes PDF-Dokument erneut zu installieren. Nachdem Sie den Wert für die Lizenzkennung erhalten haben, können Sie ein gesperrtes Dokument erneut installieren. Wenn Sie versuchen, ein Dokument, das nicht widerrufen wird, erneut zu installieren, wird eine Ausnahme ausgelöst.
Zugriff auf das gesperrte PDF-Dokument neu zuweisen
Um den Zugriff auf ein gesperrtes PDF-Dokument wieder zu aktivieren, müssen Sie die Lizenzkennung des gesperrten Dokuments angeben. Wenn Sie versuchen, den Zugriff auf ein PDF-Dokument, das nicht gesperrt wird, erneut zu aktivieren, wird eine Ausnahme ausgelöst.
Siehe auch

Zugriff auf widerrufene Dokumente mit der Java-API neu zuweisen

Richten Sie den Zugriff auf ein gesperrtes Dokument mithilfe der Dokument Security API (Java) neu ein:
  1. Schließen Sie Projektdateien ein.
    Schließen Sie Client-JAR-Dateien wie "adobe-rightsmanagement-client.jar"im Klassenpfad Ihres Java-Projekts ein.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
    • Erstellen Sie ein ServiceClientFactory -" -Objekt, das Verbindungseigenschaften enthält.
    • Erstellen Sie ein DocumentSecurityClient -Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory -Objekt übergeben.
  3. Rufen Sie die Lizenzkennung des gesperrten PDF-Dokuments ab.
    • Erstellen Sie ein java.io.FileInputStream Objekt, das das gesperrte PDF-Dokument darstellt, indem Sie den Konstruktor verwenden und einen Zeichenfolgenwert übergeben, der den Speicherort des PDF-Dokuments angibt.
    • Erstellen Sie ein com.adobe.idp.Document -Objekt, indem Sie seinen Konstruktor verwenden und das java.io.FileInputStream -Objekt übergeben.
    • Erstellen Sie ein DocumentManager Objekt, indem Sie die DocumentSecurityClient Objektmethode getDocumentManager aufrufen.
    • Rufen Sie den Lizenzkennungswert des gesperrten Dokuments ab, indem Sie die DocumentManager Objektmethode aufrufen und das Objekt übergeben, das das widerrufene Dokument darstellt getLicenseId com.adobe.idp.Document . Diese Methode gibt einen Zeichenfolgenwert zurück, der die Lizenzkennung darstellt.
  4. Zugriff auf das gesperrte PDF-Dokument neu zuweisen.
    • Erstellen Sie ein LicenseManager Objekt, indem Sie die DocumentSecurityClient Objektmethode getLicenseManager aufrufen.
    • Stellen Sie den Zugriff auf das gesperrte PDF-Dokument wieder her, indem Sie die LicenseManager Objektmethode aufrufen unrevokeLicense und den Lizenzkennungswert des gesperrten Dokuments übergeben.
Codebeispiele
Codebeispiele für den Dokument Security-Dienst finden Sie in den folgenden Quick-Beginn:
  • "Quick Beginn (SOAP-Modus): Zugriff auf ein gesperrtes Dokument mit der Webdienst-API erneut aktivieren"

Zugriff auf gesperrte Dokumente mit der Webdienst-API neu zuweisen

Erneutes Zuweisen des Zugriffs auf ein gesperrtes Dokument mithilfe der Dokument Security API (Webdienst):
  1. Schließen Sie Projektdateien ein.
    Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    Ersetzen Sie localhost dies durch die IP-Adresse des Hosting-AEM Forms.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
    • Create a DocumentSecurityServiceClient object by using its default constructor.
    • Create a DocumentSecurityServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Übergeben Sie einen Zeichenfolgenwert, der die WSDL an den AEM Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/RightsManagementService?WSDL ). Sie müssen das lc_version Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen.)
    • Erstellen Sie ein System.ServiceModel.BasicHttpBinding Objekt, indem Sie den Wert des DocumentSecurityServiceClient.Endpoint.Binding Felds abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
    • Legen Sie für das System.ServiceModel.BasicHttpBinding Objektfeld MessageEncoding den Wert WSMessageEncoding.Mtom fest. Dieser Wert stellt sicher, dass MTOM verwendet wird.
    • Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Aufgaben ausführen:
      • Weisen Sie dem Feld den AEM Forms-Benutzernamen zu DocumentSecurityServiceClient.ClientCredentials.UserName.UserName .
      • Weisen Sie dem Feld den entsprechenden Kennwortwert zu DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • Weisen Sie dem Feld den Konstantenwert HttpClientCredentialType.Basic zu BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Weisen Sie dem Feld den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu BasicHttpBindingSecurity.Security.Mode .
  3. Rufen Sie die Lizenzkennung des gesperrten PDF-Dokuments ab.
    • Erstellen Sie ein Objekt BLOB , indem Sie den Konstruktor verwenden. Das BLOB Objekt wird zum Speichern eines gesperrten PDF-Dokuments verwendet, auf das der Zugriff erneut aktiviert wird.
    • Erstellen Sie ein System.IO.FileStream Objekt, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Dateispeicherort des gesperrten PDF-Dokuments und den Dateimodus darstellt, in dem die Datei geöffnet werden soll.
    • Erstellen Sie ein Bytearray, das den Inhalt des System.IO.FileStream Objekts speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die System.IO.FileStream Objekteigenschaft Length abrufen.
    • Füllen Sie das Bytearray mit Stream-Daten, indem Sie die System.IO.FileStream Objektmethode aufrufen und das Bytearray, die Startposition und die zu lesende Stream-Länge übergeben Read .
    • Füllen Sie das BLOB Objekt, indem Sie seinem MTOM Feld den Inhalt des Byte-Arrays zuweisen.
  4. Zugriff auf das gesperrte PDF-Dokument neu zuweisen.
    • Rufen Sie den Lizenzkennungswert des gesperrten Dokuments ab, indem Sie die DocumentSecurityServiceClient Objektmethode aufrufen und das Objekt übergeben, das das widerrufene Dokument darstellt getLicenseID BLOB . Diese Methode gibt einen Zeichenfolgenwert zurück, der die Lizenzkennung darstellt.
    • Erneutes Zuweisen des Zugriffs auf das gesperrte PDF-Dokument durch Aufrufen der DocumentSecurityServiceClient Objektmethode und Übergeben eines Zeichenfolgenwerts, der den Lizenzkennungswert des gesperrten PDF-Dokuments angibt (Übergeben des Rückgabewerts der unrevokeLicense Objektmethode DocumentSecurityServiceClient getLicenseId ).
Codebeispiele
Codebeispiele für den Dokument Security-Dienst finden Sie in den folgenden Quick-Beginn:
  • "Quick Beginn (MTOM): Zugriff auf ein gesperrtes Dokument mit der Webdienst-API erneut aktivieren"
  • "Quick Beginn (SwaRef): Zugriff auf ein gesperrtes Dokument mit der Webdienst-API erneut aktivieren"
Siehe auch

Überprüfen richtliniengeschützter PDF-Dokumente

Sie können die Dokument Security Service API (Java und Webdienst) verwenden, um richtliniengeschützte PDF-Dokumente zu überprüfen. Beim Überprüfen richtliniengeschützter PDF-Dokumente werden Informationen zum richtliniengeschützten PDF-Dokument zurückgegeben. Sie können beispielsweise die Richtlinie festlegen, die zum Schützen des Dokuments verwendet wurde, sowie das Datum, an dem das Dokument gesichert wurde.
Sie können diese Aufgabe nicht ausführen, wenn Ihre LiveCycle-Version 8.x oder eine frühere Version ist. Die Überprüfung richtliniengeschützter Dokumente wird in AEM Forms unterstützt. Wenn Sie versuchen, ein richtliniengeschütztes Dokument mit LiveCycle 8.x (oder früher) zu überprüfen, wird eine Ausnahme ausgelöst.
For more information about the Document Security service, see Services Reference for AEM Forms .

Zusammenfassung der Schritte

So prüfen Sie ein richtliniengeschütztes PDF-Dokument:
  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
  3. Rufen Sie ein richtliniengeschütztes Dokument zur Überprüfung ab.
  4. Informationen zum richtliniengeschützten Dokument abrufen.
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, stellen Sie sicher, dass Sie die Proxydateien einschließen.
Dokument Security Client API-Objekt erstellen
Bevor Sie einen Dokument Security-Dienstvorgang programmgesteuert durchführen können, erstellen Sie ein Client-Objekt des Dokument Security-Dienstes. Wenn Sie die Java-API verwenden, erstellen Sie ein RightsManagementClient Objekt. Wenn Sie die Dokument Security-Webdienst-API verwenden, erstellen Sie ein RightsManagementServiceService Objekt.
Abrufen eines richtliniengeschützten Dokuments zur Überprüfung
Um ein richtliniengeschütztes Dokument zu überprüfen, rufen Sie es ab. Wenn Sie versuchen, ein Dokument zu überprüfen, das nicht durch eine Richtlinie gesichert ist oder gesperrt wird, wird eine Ausnahme ausgelöst.
Überprüfen des Dokuments
Nachdem Sie ein richtliniengeschütztes Dokument abgerufen haben, können Sie es überprüfen.
Informationen zum richtliniengeschützten Dokument abrufen
Nachdem Sie ein richtliniengeschütztes PDF-Dokument geprüft haben, können Sie Informationen dazu abrufen. Sie können beispielsweise die Richtlinie festlegen, die zum Schützen des Dokuments verwendet wird.
Wenn Sie ein Dokument mit einer Richtlinie sichern, die zu "Meine Richtlinien"gehört, und dann aufrufen RMInspectResult.getPolicysetName oder RMInspectResult.getPolicysetId , wird null zurückgegeben.
Wenn das Dokument mit einer Richtlinie gesichert wird, die in einem Richtliniensatz enthalten ist (außer "Meine Richtlinien"), geben Sie gültige Zeichenfolgen zurück RMInspectResult.getPolicysetName und geben Sie RMInspectResult.getPolicysetId diese zurück.
Siehe auch

Richtliniengeschützte PDF-Dokumente mit der Java-API überprüfen

Überprüfen Sie ein richtliniengeschütztes PDF-Dokument mithilfe der Dokument Security Service API (Java):
  1. Schließen Sie Projektdateien ein.
    Schließen Sie Client-JAR-Dateien wie "adobe-rightsmanagement-client.jar"im Klassenpfad Ihres Java-Projekts ein. Weitere Informationen über den Speicherort dieser Dateien finden Sie unter Einbeziehung von AEM Forms Java-Bibliotheksdateien .
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
    • Erstellen Sie ein ServiceClientFactory -" -Objekt, das Verbindungseigenschaften enthält. (Siehe Einstellung von Verbindungseigenschaften .)
    • Erstellen Sie ein RightsManagementClient -Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory -Objekt übergeben.
  3. Rufen Sie ein richtliniengeschütztes Dokument zur Überprüfung ab.
    • Erstellen Sie ein java.io.FileInputStream Objekt, das das richtliniengeschützte PDF-Dokument mit seinem Konstruktor darstellt. Übergeben Sie einen Zeichenfolgenwert, der den Speicherort des PDF-Dokuments angibt.
    • Erstellen Sie ein com.adobe.idp.Document -Objekt, indem Sie seinen Konstruktor verwenden und das java.io.FileInputStream -Objekt übergeben.
  4. Überprüfen Sie das Dokument.
    • Erstellen Sie ein DocumentManager Objekt, indem Sie die RightsManagementClient Objektmethode getDocumentManager aufrufen.
    • Überprüfen Sie das richtliniengeschützte Dokument, indem Sie die LicenseManager Objektmethode inspectDocument aufrufen. Übergeben Sie das com.adobe.idp.Document Objekt, das das richtliniengeschützte PDF-Dokument enthält. Diese Methode gibt ein RMInspectResult Objekt zurück, das Informationen zum richtliniengeschützten Dokument enthält.
  5. Informationen zum richtliniengeschützten Dokument abrufen.
    Um Informationen zum richtliniengeschützten Dokument abzurufen, rufen Sie die entsprechende Methode auf, die zum RMInspectResult Objekt gehört. Um beispielsweise den Richtliniennamen abzurufen, rufen Sie die RMInspectResult Methode des getPolicyName Objekts auf.
Codebeispiele
Codebeispiele für den Dokument Security-Dienst finden Sie in den folgenden Quick-Beginn:
  • "Quick Beginn (SOAP-Modus): Richtliniengeschützte PDF-Dokumente mit der Java-API überprüfen"

Richtliniengeschützte PDF-Dokumente mit der Webdienst-API überprüfen

Überprüfen Sie ein richtliniengeschütztes PDF-Dokument mithilfe der Dokument Security Service API (Webdienst):
  1. Schließen Sie Projektdateien ein.
    Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    Ersetzen Sie localhost dies durch die IP-Adresse des Hosting-AEM Forms.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
    • Create a RightsManagementServiceClient object by using its default constructor.
    • Create a RightsManagementServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Übergeben Sie einen Zeichenfolgenwert, der die WSDL an den AEM Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/RightsManagementService?WSDL ). Sie müssen das lc_version Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen.)
    • Erstellen Sie ein System.ServiceModel.BasicHttpBinding Objekt, indem Sie den Wert des RightsManagementServiceClient.Endpoint.Binding Felds abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
    • Legen Sie für das System.ServiceModel.BasicHttpBinding Objektfeld MessageEncoding den Wert WSMessageEncoding.Mtom fest. Dieser Wert stellt sicher, dass MTOM verwendet wird.
    • Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Aufgaben ausführen:
      • Weisen Sie dem Feld den AEM Forms-Benutzernamen zu RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • Weisen Sie dem Feld den entsprechenden Kennwortwert zu RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Weisen Sie dem Feld den Konstantenwert HttpClientCredentialType.Basic zu BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Weisen Sie dem Feld den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu BasicHttpBindingSecurity.Security.Mode .
  3. Rufen Sie ein richtliniengeschütztes Dokument zur Überprüfung ab.
    • Erstellen Sie ein Objekt BLOB , indem Sie den Konstruktor verwenden. Das BLOB Objekt dient zum Speichern eines zu prüfenden PDF-Dokuments.
    • Create a System.IO.FileStream object by invoking its constructor. Übergeben Sie einen Zeichenfolgenwert, der den Dateispeicherort des PDF-Dokuments und den Modus zum Öffnen der Datei darstellt.
    • Erstellen Sie ein Bytearray, das den Inhalt des System.IO.FileStream Objekts speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die System.IO.FileStream Objekteigenschaft Length abrufen.
    • Füllen Sie das Bytearray mit Stream-Daten, indem Sie die System.IO.FileStream Objektmethode Read aufrufen. Übergeben Sie das Bytearray, die Startposition und die Stream-Länge zum Lesen.
    • Füllen Sie das BLOB Objekt, indem Sie seinem MTOM Feld den Inhalt des Byte-Arrays zuweisen.
  4. Überprüfen Sie das Dokument.
    Überprüfen Sie das richtliniengeschützte Dokument, indem Sie die RightsManagementServiceClient Objektmethode inspectDocument aufrufen. Übergeben Sie das BLOB Objekt, das das richtliniengeschützte PDF-Dokument enthält. Diese Methode gibt ein RMInspectResult Objekt zurück, das Informationen zum richtliniengeschützten Dokument enthält.
  5. Informationen zum richtliniengeschützten Dokument abrufen.
    Um Informationen zum richtliniengeschützten Dokument abzurufen, rufen Sie den Wert des entsprechenden Felds ab, das zum RMInspectResult Objekt gehört. Um beispielsweise den Richtliniennamen abzurufen, rufen Sie den Wert des Felds des RMInspectResult Objekts policyName ab.
Codebeispiele
Codebeispiele für den Dokument Security-Dienst finden Sie in den folgenden Quick-Beginn:
  • "Quick Beginn (MTOM): Untersuchen richtliniengeschützter PDF-Dokumente mithilfe der Webdienst-API"
  • "Quick Beginn (SwaRef): Untersuchen richtliniengeschützter PDF-Dokumente mithilfe der Webdienst-API"
Siehe auch

Wasserzeichen erstellen

Wasserzeichen tragen dazu bei, die Sicherheit eines Dokuments zu gewährleisten, indem das Dokument eindeutig identifiziert und die Urheberrechtsverletzung kontrolliert wird. Sie können beispielsweise ein Wasserzeichen mit dem Status "Vertraulich"auf allen Seiten eines Dokuments erstellen und platzieren. Nachdem ein Wasserzeichen erstellt wurde, können Sie es als Teil einer Richtlinie einschließen. Das heißt, Sie können das Wasserzeichenattribut der Richtlinie mit dem neu erstellten Wasserzeichen festlegen. Nachdem eine Richtlinie, die ein Wasserzeichen enthält, auf ein Dokument angewendet wurde, wird das Wasserzeichen im richtliniengeschützten Dokument angezeigt.
Nur Benutzer mit Administratorrechten für Dokument Security können Wasserzeichen erstellen. Das heißt, Sie müssen einen solchen Benutzer angeben, wenn Sie Verbindungseinstellungen definieren, die zum Erstellen eines Client-Objekts des Dokument Security-Dienstes erforderlich sind.
For more information about the Document Security service, see Services Reference for AEM Forms .

Zusammenfassung der Schritte

So erstellen Sie ein Wasserzeichen:
  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
  3. Legen Sie die Wasserzeichenattribute fest.
  4. Registrieren Sie das Wasserzeichen beim Dokument Security-Dienst.
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, stellen Sie sicher, dass Sie die Proxydateien einschließen.
Dokument Security Client API-Objekt erstellen
Bevor Sie einen Dokument Security-Dienstvorgang programmgesteuert durchführen können, müssen Sie ein Client-Objekt des Dokument Security-Dienstes erstellen. Wenn Sie die Java-API verwenden, erstellen Sie ein RightsManagementClient Objekt. Wenn Sie die Dokument Security-Webdienst-API verwenden, erstellen Sie ein RightsManagementServiceService Objekt.
Festlegen der Wasserzeichenattribute
Um ein neues Wasserzeichen zu erstellen, müssen Sie Wasserzeichenattribute festlegen. Das Attribut name muss immer definiert sein. Zusätzlich zum Attribut name müssen Sie mindestens eines der folgenden Attribute festlegen:
  • Benutzerdefinierter Text
  • DateIncluded
  • UserIdIncluded
  • UserNameIncluded
In der folgenden Tabelle werden Schlüssel- und Wertpaare Liste, die beim Erstellen eines Wasserzeichens mit Webdiensten erforderlich sind.
Schlüsselname
Beschreibung
Wert
WaterBackCmd:IS_USERNAME_ENABLED
Gibt an, ob der Benutzername des Benutzers, der das Dokument öffnet, Teil des Wasserzeichens ist.
„True“ oder „False“
WaterBackCmd:IS_USERID_ENABLED
Gibt an, ob die Identifizierung des Benutzers, der das Dokument öffnet, Teil des Wasserzeichens ist.
„True“ oder „False“
WaterBackCmd:IS_CURRENTDATE_ENABLED
Gibt an, ob das aktuelle Datum Teil des Wasserzeichens ist.
„True“ oder „False“
WaterBackCmd:IS_CUSTOMTEXT_ENABLED
Wenn dieser Wert "true"ist, muss der Wert des benutzerdefinierten Textes mit WaterBackCmd:SRCTEXT angegeben werden.
„True“ oder „False“
WaterBackCmd:OPACITY
Gibt die Deckkraft des Wasserzeichens an. Der Standardwert ist 0,5, wenn er nicht angegeben ist.
Ein Wert zwischen 0,0 und 1,0.
WaterBackCmd:ROTATION
Gibt die Drehung des Wasserzeichens an. Der Standardwert ist 0 Grad.
Ein Wert zwischen 0 und 359.
WaterBackCmd:SCALE
Wenn dieser Wert angegeben ist, WaterBackCmd:IS_SIZE_ENABLED muss er vorhanden sein und der Wert muss "true"sein. Wenn dieses Attribut nicht angegeben ist, passt das Standardverhalten auf die Seite.
Ein Wert größer als 0.0 und kleiner gleich 1.0.
WaterBackCmd:HORIZ_ALIGN
Gibt die horizontale Ausrichtung des Wasserzeichens an. Der Standardwert ist center.
links, zentriert oder rechts
WaterBackCmd:VERT_ALIGN
Gibt die vertikale Ausrichtung des Wasserzeichens an. Der Standardwert ist center.
oben, zentriert oder unten
WaterBackCmd:IS_USE_BACKGROUND
Gibt an, ob das Wasserzeichen ein Hintergrund ist. Der Standardwert lautet false.
„True“ oder „False“
WaterBackCmd:IS_SIZE_ENABLED
True, wenn eine benutzerdefinierte Skala angegeben wurde. Wenn dieser Wert true ist, muss auch SCALE angegeben werden. Wenn dieser Wert "false"ist, passt der Standardwert auf die Seite.
„True“ oder „False“
WaterBackCmd:SRCTEXT
Gibt den benutzerdefinierten Text für ein Wasserzeichen an. Wenn dieser Wert vorhanden ist, WaterBackCmd:IS_CUSTOMTEXT_ENABLED muss er ebenfalls vorhanden sein und auf "true"gesetzt sein.
„True“ oder „False“
Für alle Wasserzeichen muss eines der folgenden Attribute definiert sein:
  • WaterBackCmd:IS_USERNAME_ENABLED
  • WaterBackCmd:IS_USERID_ENABLED
  • WaterBackCmd:IS_CURRENTDATE_ENABLED
  • WaterBackCmd:IS_CUSTOMTEXT_ENABLED
Alle anderen Attribute sind optional.
Wasserzeichen registrieren
Ein neues Wasserzeichen muss beim Dokument Security Service registriert sein, bevor es verwendet werden kann. Nachdem Sie ein Wasserzeichen registriert haben, können Sie es innerhalb von Richtlinien verwenden.
Siehe auch

Erstellen von Wasserzeichen mit der Java-API

Erstellen Sie ein Wasserzeichen mit der Dokument Security API (Java):
  1. Schließen Sie Projektdateien ein.
    Include client JAR files, such as the adobe-rightsmanagement-client.jar , in your Java project’s class path.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
    • Erstellen Sie ein ServiceClientFactory -" -Objekt, das Verbindungseigenschaften enthält.
    • Erstellen Sie ein RightsManagementClient -Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory -Objekt übergeben.
  3. Festlegen der Wasserzeichenattribute
    • Erstellen Sie ein Watermark Objekt, indem Sie die statische InfomodelObjectFactory Objektmethode aufrufen createWatermark . Diese Methode gibt ein Watermark Objekt zurück.
    • Legen Sie das Namensattribut des Wasserzeichens fest, indem Sie die Watermark Objektmethode aufrufen und einen Zeichenfolgenwert übergeben, der den Richtliniennamen angibt. setName
    • Legen Sie das Hintergrundattribut des Wasserzeichens fest, indem Sie die Watermark Methode des setBackground Objekts aufrufen und weitergeben true . Durch Festlegen dieses Attributs wird das Wasserzeichen im Hintergrund des Dokuments angezeigt.
    • Legen Sie das benutzerdefinierte Textattribut des Wasserzeichens fest, indem Sie die Watermark Objektmethode aufrufen und einen Zeichenfolgenwert übergeben, der den Text des Wasserzeichens darstellt. setCustomText
    • Legen Sie das Deckkraftattribut des Wasserzeichens fest, indem Sie die Watermark Objektmethode aufrufen und einen ganzzahligen Wert übergeben, der die Deckkraft angibt, setOpacity um den Wert festzulegen. Der Wert 100 gibt an, dass das Wasserzeichen vollständig undurchsichtig ist, und der Wert 0 bedeutet, dass das Wasserzeichen vollständig transparent ist.
  4. Registrieren Sie das Wasserzeichen.
    • Erstellen Sie ein WatermarkManager Objekt, indem Sie die RightsManagementClient Objektmethode getWatermarkManager aufrufen. Diese Methode gibt ein WatermarkManager Objekt zurück.
    • Registrieren Sie das Wasserzeichen, indem Sie die WatermarkManager Methode des registerWatermark Objekts aufrufen und das Watermark Objekt übergeben, das das zu registrierende Wasserzeichen darstellt. Diese Methode gibt einen Zeichenfolgenwert zurück, der den Identifizierungswert des Wasserzeichens darstellt.
Codebeispiele
Codebeispiele für den Dokument Security-Dienst finden Sie in den folgenden Quick-Beginn:
  • "Quick Beginn (SOAP-Modus): Erstellen eines Wasserzeichens mit der Java-API"

Erstellen von Wasserzeichen mit der Webdienst-API

Erstellen Sie ein Wasserzeichen mithilfe der Dokument Security API (Webdienst):
  1. Erstellen Sie ein Dokument Security Client API-Objekt.
    Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    Ersetzen Sie localhost dies durch die IP-Adresse des Hosting-AEM Forms.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
    • Create a RightsManagementServiceClient object by using its default constructor.
    • Create a RightsManagementServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Übergeben Sie einen Zeichenfolgenwert, der die WSDL an den AEM Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/RightsManagementService?WSDL ). Sie müssen das lc_version Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen.)
    • Erstellen Sie ein System.ServiceModel.BasicHttpBinding Objekt, indem Sie den Wert des RightsManagementServiceClient.Endpoint.Binding Felds abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
    • Legen Sie für das System.ServiceModel.BasicHttpBinding Objektfeld MessageEncoding den Wert WSMessageEncoding.Mtom fest. Dieser Wert stellt sicher, dass MTOM verwendet wird.
    • Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Aufgaben ausführen:
      • Weisen Sie dem Feld den AEM Forms-Benutzernamen zu RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • Weisen Sie dem Feld den entsprechenden Kennwortwert zu RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Weisen Sie dem Feld den Konstantenwert HttpClientCredentialType.Basic zu BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Weisen Sie dem Feld den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu BasicHttpBindingSecurity.Security.Mode .
  3. Legen Sie die Wasserzeichenattribute fest.
    • Erstellen Sie ein WatermarkSpec Objekt, indem Sie den WatermarkSpec Konstruktor aufrufen.
    • Legen Sie den Namen des Wasserzeichens fest, indem Sie dem Datenmember des WatermarkSpec Objekts einen Zeichenfolgenwert zuweisen name .
    • Legen Sie das id Attribut des Wasserzeichens fest, indem Sie dem WatermarkSpec - id Datenmember des Objekts einen Zeichenfolgenwert zuweisen.
    • Erstellen Sie für jede Wasserzeicheneigenschaft ein separates MyMapOf_xsd_string_To_xsd_anyType_Item Objekt.
    • Legen Sie den Schlüsselwert fest, indem Sie dem MyMapOf_xsd_string_To_xsd_anyType_Item Datenmember des key Objekts einen Wert zuweisen (z. B. WaterBackCmd:OPACITY) ).
    • Legen Sie den Wert fest, indem Sie dem MyMapOf_xsd_string_To_xsd_anyType_Item Datenmember des value Objekts einen Wert zuweisen (z. B. .25 ).
    • Create a MyArrayOf_xsd_anyType object. Rufen Sie für jedes MyMapOf_xsd_string_To_xsd_anyType_Item Objekt die MyArrayOf_xsd_anyType Objektmethode Add auf. Pass the MyMapOf_xsd_string_To_xsd_anyType_Item object.
    • Weisen Sie das MyArrayOf_xsd_anyType Objekt dem WatermarkSpec Datenmember des Objekts zu values .
  4. Registrieren Sie das Wasserzeichen.
    Registrieren Sie das Wasserzeichen, indem Sie die RightsManagementServiceClient Methode des registerWatermark Objekts aufrufen und das WatermarkSpec Objekt übergeben, das das zu registrierende Wasserzeichen darstellt.
Codebeispiele
Codebeispiele für den Dokument Security-Dienst finden Sie in den folgenden Quick-Beginn:
  • "Quick Beginn (MTOM): Erstellen eines Wasserzeichens mit der Webdienst-API"
  • "Quick Beginn (SwaRef): Erstellen eines Wasserzeichens mit der Webdienst-API"
Siehe auch

Wasserzeichen ändern

Sie können ein vorhandenes Wasserzeichen mit der Java-API für Dokument-Sicherheit oder der Webdienst-API ändern. Um Änderungen an einem vorhandenen Wasserzeichen vorzunehmen, rufen Sie es ab, ändern dessen Attribute und aktualisieren Sie es dann auf dem Server. Nehmen Sie beispielsweise an, Sie rufen ein Wasserzeichen ab und ändern dessen Deckkraftattribut. Bevor die Änderung wirksam wird, müssen Sie das Wasserzeichen aktualisieren.
Wenn Sie ein Wasserzeichen ändern, wirkt sich die Änderung auf zukünftige Dokumente aus, auf die das Wasserzeichen angewendet wurde. Das bedeutet, dass vorhandene PDF-Dokumente, die das Wasserzeichen enthalten, nicht betroffen sind.
Nur Benutzer mit Administratorrechten für Dokument Security können Wasserzeichen ändern. Das heißt, Sie müssen einen solchen Benutzer angeben, wenn Sie Verbindungseinstellungen definieren, die zum Erstellen eines Client-Objekts des Dokument Security-Dienstes erforderlich sind.
For more information about the Document Security service, see Services Reference for AEM Forms .

Zusammenfassung der Schritte

So ändern Sie ein Wasserzeichen:
  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
  3. Rufen Sie das zu ändernde Wasserzeichen ab.
  4. Legen Sie die Wasserzeichenattribute fest.
  5. Aktualisieren Sie das Wasserzeichen.
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, stellen Sie sicher, dass Sie die Proxydateien einschließen.
Dokument Security Client API-Objekt erstellen
Bevor Sie einen Dokument Security-Dienstvorgang programmgesteuert durchführen können, müssen Sie ein Client-Objekt des Dokument Security-Dienstes erstellen. Wenn Sie die Java-API verwenden, erstellen Sie ein DocumentSecurityClient Objekt. Wenn Sie die Dokument Security-Webdienst-API verwenden, erstellen Sie ein DocumentSecurityServiceService Objekt.
Abrufen des zu ändernden Wasserzeichens
Um ein Wasserzeichen zu ändern, müssen Sie ein vorhandenes Wasserzeichen abrufen. Sie können ein Wasserzeichen abrufen, indem Sie dessen Namen angeben oder dessen Bezeichnerwert angeben.
Festlegen der Wasserzeichenattribute
Um ein vorhandenes Wasserzeichen zu ändern, ändern Sie den Wert eines oder mehrerer Wasserzeichenattribute. Beim programmgesteuerten Aktualisieren eines Wasserzeichens mit einem Webdienst müssen Sie alle ursprünglich festgelegten Attribute einstellen, auch wenn sich der Wert nicht ändert. Angenommen, die folgenden Wasserzeichenattribute werden festgelegt: WaterBackCmd:IS_USERID_ENABLED , WaterBackCmd:IS_CUSTOMTEXT_ENABLED , WaterBackCmd:OPACITY und WaterBackCmd:SRCTEXT . Obwohl das einzige Attribut, das Sie ändern möchten, WaterBackCmd:OPACITY müssen Sie die anderen Werte gut einstellen.
Wenn Sie ein Wasserzeichen mit der Java-API ändern, müssen Sie nicht alle Attribute angeben. Legen Sie das Wasserzeichenattribut fest, das Sie ändern möchten.
Informationen zu den Namen der Wasserzeichenattribute finden Sie unter Wasserzeichen erstellen .
Wasserzeichen aktualisieren
Nachdem Sie die Attribute eines Wasserzeichens geändert haben, müssen Sie das Wasserzeichen aktualisieren.
Siehe auch

Wasserzeichen mithilfe der Java-API ändern

Ändern Sie ein Wasserzeichen mithilfe der Dokument Security API (Java):
  1. Schließen Sie Projektdateien ein.
    Schließen Sie Client-JAR-Dateien wie "adobe-rightsmanagement-client.jar"im Klassenpfad Ihres Java-Projekts ein.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
    • Erstellen Sie ein ServiceClientFactory -" -Objekt, das Verbindungseigenschaften enthält.
    • Erstellen Sie ein DocumentSecurityClient -Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory -Objekt übergeben.
  3. Rufen Sie das zu ändernde Wasserzeichen ab.
    Erstellen Sie ein WatermarkManager Objekt, indem Sie die DocumentSecurityClient Methode des getWatermarkManager Objekts aufrufen und einen Zeichenfolgenwert übergeben, der den Wasserzeichennamen angibt. Diese Methode gibt ein Watermark Objekt zurück, das das zu ändernde Wasserzeichen darstellt.
  4. Legen Sie die Wasserzeichenattribute fest.
    Legen Sie das Deckkraftattribut des Wasserzeichens fest, indem Sie die Watermark Objektmethode aufrufen und einen ganzzahligen Wert übergeben, der die Deckkraft angibt, setOpacity um den Wert festzulegen. Der Wert 100 gibt an, dass das Wasserzeichen vollständig undurchsichtig ist, und der Wert 0 bedeutet, dass das Wasserzeichen vollständig transparent ist.
    In diesem Beispiel wird nur das Attribut "Deckkraft"geändert.
  5. Aktualisieren Sie das Wasserzeichen.
    • Aktualisieren Sie das Wasserzeichen, indem Sie die WatermarkManager Methode des updateWatermark Objekts aufrufen und das Watermark Objekt übergeben, dessen Attribut geändert wurde.
Codebeispiele
Codebeispiele, die den Dokument Security-Dienst verwenden, finden Sie im Quick Beginn(SOAP-Modus): Ändern eines Wasserzeichens mithilfe des Java-API-Abschnitts

Wasserzeichen mithilfe der Webdienst-API ändern

Ändern Sie ein Wasserzeichen mithilfe der Dokument Security API (Webdienst):
  1. Schließen Sie Projektdateien ein.
    Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    Ersetzen Sie localhost dies durch die IP-Adresse des Hosting-AEM Forms.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
    • Create a DocumentSecurityServiceClient object by using its default constructor.
    • Create a RightsManagementServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Übergeben Sie einen Zeichenfolgenwert, der die WSDL an den AEM Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/DocumentSecurityService?WSDL ). Sie müssen das lc_version Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen.)
    • Erstellen Sie ein System.ServiceModel.BasicHttpBinding Objekt, indem Sie den Wert des DocumentSecurityServiceClient.Endpoint.Binding Felds abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
    • Legen Sie für das System.ServiceModel.BasicHttpBinding Objektfeld MessageEncoding den Wert WSMessageEncoding.Mtom fest. Dieser Wert stellt sicher, dass MTOM verwendet wird.
    • Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Aufgaben ausführen:
      • Weisen Sie dem Feld den AEM Forms-Benutzernamen zu DocumentSecurityServiceClient.ClientCredentials.UserName.UserName .
      • Weisen Sie dem Feld den entsprechenden Kennwortwert zu DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • Weisen Sie dem Feld den Konstantenwert HttpClientCredentialType.Basic zu BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Weisen Sie dem Feld den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu BasicHttpBindingSecurity.Security.Mode .
  3. Rufen Sie das zu ändernde Wasserzeichen ab.
    Rufen Sie das zu ändernde Wasserzeichen ab, indem Sie die DocumentSecurityServiceClient Objektmethode getWatermarkByName aufrufen. Übergeben Sie einen Zeichenfolgenwert, der den Wasserzeichennamen angibt. Diese Methode gibt ein WatermarkSpec Objekt zurück, das das zu ändernde Wasserzeichen darstellt.
  4. Legen Sie die Wasserzeichenattribute fest.
    • Erstellen Sie für jede zu aktualisierende Wasserzeicheneigenschaft ein separates MyMapOf_xsd_string_To_xsd_anyType_Item Objekt.
    • Legen Sie den Schlüsselwert fest, indem Sie dem MyMapOf_xsd_string_To_xsd_anyType_Item Datenmember des key Objekts einen Wert zuweisen (z. B. WaterBackCmd:OPACITY) ).
    • Legen Sie den Wert fest, indem Sie dem MyMapOf_xsd_string_To_xsd_anyType_Item Datenmember des value Objekts einen Wert zuweisen (z. B. .50 ).
    • Create a MyArrayOf_xsd_anyType object. Rufen Sie für jedes MyMapOf_xsd_string_To_xsd_anyType_Item Objekt die MyArrayOf_xsd_anyType Objektmethode Add auf. Pass the MyMapOf_xsd_string_To_xsd_anyType_Item object.
    • Weisen Sie das MyArrayOf_xsd_anyType Objekt dem WatermarkSpec Datenmember des Objekts zu values .
  5. Aktualisieren Sie das Wasserzeichen.
    Aktualisieren Sie das Wasserzeichen, indem Sie die DocumentSecurityServiceClient Methode des updateWatermark Objekts aufrufen und das zu ändernde WatermarkSpec Objekt übergeben.
Codebeispiele
Codebeispiele für die Verwendung des Dokument Security-Dienstes finden Sie im folgenden Quick Beginn:
  • "Quick Beginn (MTOM): Ändern eines Wasserzeichens mit der Webdienst-API"

Nach Ereignissen suchen

Der Rights Management-Dienst verfolgt spezifische Aktionen wie das Anwenden einer Richtlinie auf ein Dokument, das Öffnen eines richtliniengeschützten Dokuments und das Sperren des Zugriffs auf Dokumente. Die Ereignis-Prüfung muss für den Rights Management-Dienst aktiviert sein, sonst werden Ereignis nicht verfolgt.
Ereignis fallen in eine der folgenden Kategorien:
  • Administrator-Ereignis sind Aktionen, die mit einem Administrator zusammenhängen, z. B. das Erstellen eines neuen Administratorkontos.
  • Dokument-Ereignis sind Aktionen im Zusammenhang mit einem Dokument, z. B. das Schließen eines richtliniengeschützten Dokuments.
  • Policy-Ereignis sind Aktionen im Zusammenhang mit einer Richtlinie, z. B. das Erstellen einer neuen Richtlinie.
  • Dienst-Ereignis sind Aktionen im Zusammenhang mit dem Rights Management-Dienst, z. B. die Synchronisierung mit dem Benutzerordner.
Sie können mit der Rights Management Java-API oder der Webdienst-API nach bestimmten Ereignissen suchen. Durch die Suche nach Ereignissen können Sie Aufgaben durchführen, z. B. eine Protokolldatei mit bestimmten Ereignissen.
For more information about the Rights Management service, see Services Reference for AEM Forms .

Zusammenfassung der Schritte

So suchen Sie nach einem Rights Management-Ereignis:
  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie ein Rights Management Client-API-Objekt.
  3. Geben Sie das Ereignis an, nach dem gesucht werden soll.
  4. Suchen Sie nach dem Ereignis.
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, stellen Sie sicher, dass Sie die Proxydateien einschließen.
Rights Management Client-API-Objekt erstellen
Bevor Sie einen Rights Management-Dienstvorgang programmgesteuert durchführen können, müssen Sie ein Client-Objekt des Rights Management-Dienstes erstellen. Wenn Sie die Java-API verwenden, erstellen Sie ein DocumentSecurityClient Objekt. Wenn Sie die Rights Management-Webdienst-API verwenden, erstellen Sie ein DocumentSecurityServiceService Objekt.
Geben Sie die zu suchenden Ereignis an
Sie müssen das zu suchende Ereignis angeben. Sie können beispielsweise nach dem Ereignis zum Erstellen einer Richtlinie suchen, das beim Erstellen einer neuen Richtlinie auftritt.
Nach dem Ereignis suchen
Nachdem Sie das zu suchende Ereignis angegeben haben, können Sie entweder die Rights Management Java-API oder die Rights Management-Webdienst-API verwenden, um nach dem Ereignis zu suchen.
Siehe auch

Suchen nach Ereignissen mit der Java-API

Suchen Sie mithilfe der Rights Management API (Java) nach Ereignissen:
  1. Projektdateien einschließen
    Schließen Sie Client-JAR-Dateien wie "adobe-rightsmanagement-client.jar"im Klassenpfad Ihres Java-Projekts ein.
  2. Rights Management Client-API-Objekt erstellen
    Erstellen Sie ein DocumentSecurityClient Objekt, indem Sie dessen Konstruktor verwenden und ein ServiceClientFactory Objekt übergeben, das Verbindungseigenschaften enthält.
  3. Geben Sie die zu suchenden Ereignis an
    • Erstellen Sie ein EventManager Objekt, indem Sie die DocumentSecurityClient Objektmethode getEventManager aufrufen. Diese Methode gibt ein EventManager Objekt zurück.
    • Erstellen Sie ein EventSearchFilter Objekt, indem Sie den Konstruktor aufrufen.
    • Geben Sie das Ereignis an, nach dem gesucht werden soll, indem Sie die EventSearchFilter Objektmethode aufrufen und ein statisches Datenelement übergeben, das der Klasse angehört, die das Ereignis darstellt, für das gesucht werden soll. setEventCode EventManager Übergeben Sie dieses an. Um beispielsweise nach dem Ereignis zum Erstellen der Richtlinie zu suchen, übergeben Sie EventManager.POLICY_CREATE_EVENT .
    Sie können zusätzliche Suchkriterien definieren, indem Sie EventSearchFilter Objektmethoden aufrufen. Rufen Sie beispielsweise die setUserName Methode auf, um einen Benutzer anzugeben, der mit dem Ereignis verknüpft ist.
  4. Nach dem Ereignis suchen
    Suchen Sie nach dem Ereignis, indem Sie die EventManager Objektmethode aufrufen und das Objekt übergeben, das die Suchkriterien des Ereignisses definiert searchForEvents EventSearchFilter . Diese Methode gibt ein Array von Event Objekten zurück.
Codebeispiele
Codebeispiele für die Verwendung des Rights Management-Dienstes finden Sie in den folgenden Quick-Beginn:
  • "Quick Beginn (SOAP): Suchen nach Ereignissen mit der Java-API"

Suchen nach Ereignissen mit der Webdienst-API

Suchen Sie mithilfe der Rights Management API (Webdienst) nach Ereignissen:
  1. Projektdateien einschließen
    Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    Ersetzen Sie localhost dies durch die IP-Adresse des Hosting-AEM Forms.
  2. Rights Management Client-API-Objekt erstellen
    • Create a DocumentSecurityServiceClient object by using its default constructor.
    • Create a DocumentSecurityServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Übergeben Sie einen Zeichenfolgenwert, der die WSDL an den AEM Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/RightsManagementService?WSDL ). Sie müssen das lc_version Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen.)
    • Erstellen Sie ein System.ServiceModel.BasicHttpBinding Objekt, indem Sie den Wert des DocumentSecurityServiceClient.Endpoint.Binding Felds abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
    • Legen Sie für das System.ServiceModel.BasicHttpBinding Objektfeld MessageEncoding den Wert WSMessageEncoding.Mtom fest. Dieser Wert stellt sicher, dass MTOM verwendet wird.
    • Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Aufgaben ausführen:
      • Weisen Sie dem Feld den AEM Forms-Benutzernamen zu DocumentSecurityServiceClient.ClientCredentials.UserName.UserName .
      • Weisen Sie dem Feld den entsprechenden Kennwortwert zu DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • Weisen Sie dem Feld den Konstantenwert HttpClientCredentialType.Basic zu BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Weisen Sie dem Feld den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu BasicHttpBindingSecurity.Security.Mode .
  3. Geben Sie die zu suchenden Ereignis an
    • Create an EventSpec object by using its constructor.
    • Geben Sie den Beginn des Zeitraums an, in dem das Ereignis auftrat, indem Sie den EventSpec Datenmember des firstTime.date DataTime Objekts mit einer Instanz festlegen, die den Beginn des Datumsbereichs zum Zeitpunkt des Ereignisses darstellt.
    • Weisen Sie den Wert true dem EventSpec Datenmember des Objekts zu firstTime.dateSpecified .
    • Geben Sie das Ende des Zeitraums an, in dem das Ereignis auftrat, indem Sie den EventSpec Datenmember des lastTime.date DataTime Objekts mit einer Instanz festlegen, die das Ende des Datumsbereichs zum Zeitpunkt des Ereignisses darstellt.
    • Weisen Sie den Wert true dem EventSpec Datenmember des Objekts zu lastTime.dateSpecified .
    • Stellen Sie das zu suchende Ereignis ein, indem Sie dem EventSpec Datenmember des Objekts einen Zeichenfolgenwert zuweisen eventCode . In der folgenden Tabelle werden die numerischen Werte Liste, die Sie dieser Eigenschaft zuweisen können:
    Ereignistyp
    Wert
    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
    2.000
    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
    5.000
    ADMIN_DELETE_EVENT
    5001
    ADMIN_EDIT_EVENT
    5002
    ADMIN_ACTIVATE_EVENT
    5003
    ADMIN_DEACTIVATE_EVENT
    5004
    ERROR_DIRECTORY_SERVICE_EVENT
    6.000
    CREATED_POLICYSET_EVENT
    7000
    DELETED_POLICYSET_EVENT
    7001
    MODIFIED_POLICYSET_EVENT
    7002
  4. Nach dem Ereignis suchen
    Suchen Sie nach dem Ereignis, indem Sie die DocumentSecurityServiceClient Objektmethode aufrufen und das searchForEvents EventSpec Objekt übergeben, das das Ereignis darstellt, für das gesucht werden soll, sowie die maximale Anzahl von Ergebnissen. Diese Methode gibt eine MyArrayOf_xsd_anyType Sammlung zurück, bei der jedes Element eine AuditSpec Instanz ist. Mithilfe einer AuditSpec Instanz können Sie Informationen zum Ereignis abrufen, z. B. zu dem Zeitpunkt, zu dem es aufgetreten ist. Die AuditSpec Instanz enthält einen timestamp Datenmember, der diese Informationen angibt.
Codebeispiele
Codebeispiele für die Verwendung des Rights Management-Dienstes finden Sie in den folgenden Quick-Beginn:
  • "Quick Beginn (MTOM): Suchen nach Ereignissen mit der Webdienst-API"
  • "Quick Beginn (SwaRef): Suchen nach Ereignissen mit der Webdienst-API"
Siehe auch

Richtlinien auf Word-Dokumente anwenden

Zusätzlich zu PDF-Dokumenten unterstützt der Rights Management-Dienst zusätzliche Dateiformate wie ein Microsoft Word-Dokument (DOC-Datei) und andere Microsoft Office-Dateiformate. Sie können beispielsweise eine Richtlinie auf ein Word-Dokument anwenden, um es zu sichern. Durch Anwendung einer Richtlinie auf ein Word-Dokument beschränken Sie den Zugriff auf das Dokument. Sie können eine Richtlinie nicht auf ein Dokument anwenden, wenn das Dokument bereits durch eine Richtlinie gesichert wurde.
Sie können die Verwendung eines richtliniengeschützten Word-Dokuments nach der Verteilung überwachen. Das heißt, Sie können sehen, wie das Dokument verwendet wird und wer es verwendet. Sie können beispielsweise herausfinden, wann jemand das Dokument geöffnet hat.
For more information about the Document Security service, see Services Reference for AEM Forms .

Zusammenfassung der Schritte

So wenden Sie eine Richtlinie auf ein Word-Dokument an:
  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
  3. Rufen Sie ein Word-Dokument ab, auf das eine Richtlinie angewendet wird.
  4. Wenden Sie eine vorhandene Richtlinie auf das Word-Dokument an.
  5. Speichern Sie das richtliniengeschützte Word-Dokument.
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, stellen Sie sicher, dass Sie die Proxydateien einschließen.
Erstellen eines Dokument Security Client-API-Objekts
Bevor Sie einen Dokument Security-Dienstvorgang programmgesteuert durchführen können, müssen Sie ein Client-Objekt des Dokument Security-Dienstes erstellen.
Word-Dokument abrufen
Sie müssen ein Word-Dokument abrufen, um eine Richtlinie anwenden zu können. Nachdem Sie eine Richtlinie auf das Word-Dokument angewendet haben, sind Benutzer bei der Verwendung des Dokuments eingeschränkt. Wenn die Richtlinie beispielsweise nicht das Öffnen des Dokuments im Offlinemodus aktiviert, müssen die Benutzer zum Öffnen des Dokuments online sein.
Vorhandene Richtlinie auf das Word-Dokument anwenden
Um eine Richtlinie auf ein Word-Dokument anzuwenden, müssen Sie auf eine vorhandene Richtlinie verweisen und angeben, zu welchem Richtliniensatz die Richtlinie gehört. Der Benutzer, der die Verbindungseigenschaften einstellt, muss Zugriff auf die angegebene Richtlinie haben. Andernfalls tritt eine Ausnahme auf.
Word-Dokument speichern
Nachdem der Dokument Security-Dienst eine Richtlinie auf ein Word-Dokument angewendet hat, können Sie das richtliniengeschützte Word-Dokument als DOC-Datei speichern.
Siehe auch

Anwenden einer Richtlinie auf ein Word-Dokument mithilfe der Java-API

Wenden Sie eine Richtlinie mithilfe der Dokument Security API (Java) auf ein Word-Dokument an:
  1. Schließen Sie Projektdateien ein.
    Schließen Sie Client-JAR-Dateien wie "adobe-rightsmanagement-client.jar"im Klassenpfad Ihres Java-Projekts ein.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
    • Erstellen Sie ein ServiceClientFactory -" -Objekt, das Verbindungseigenschaften enthält.
    • Erstellen Sie ein DocumentSecurityClient -Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory -Objekt übergeben.
  3. Word-Dokument abrufen
    • Erstellen Sie ein java.io.FileInputStream Objekt, das das Word-Dokument darstellt, indem Sie den Konstruktor verwenden und einen Zeichenfolgenwert übergeben, der die Position des Word-Dokuments angibt.
    • Erstellen Sie ein com.adobe.idp.Document -Objekt, indem Sie seinen Konstruktor verwenden und das java.io.FileInputStream -Objekt übergeben.
  4. Wenden Sie eine vorhandene Richtlinie auf das Word-Dokument an.
    • Erstellen Sie ein DocumentManager Objekt, indem Sie die DocumentSecurityClient Objektmethode getDocumentManager aufrufen.
    • Wenden Sie eine Richtlinie auf das Word-Dokument an, indem Sie die DocumentManager protectDocument Objektmethode aufrufen und die folgenden Werte übergeben:
      • Das com.adobe.idp.Document Objekt, das das Word-Dokument enthält, auf das die Richtlinie angewendet wird.
      • Ein Zeichenfolgenwert, der den Namen des Dokuments angibt.
      • Ein Zeichenfolgenwert, der den Namen des Richtliniensatzes angibt, zu dem die Richtlinie gehört. Sie können einen null Wert angeben, der dazu führt, dass der MyPolicies Richtliniensatz verwendet wird.
      • Ein Zeichenfolgenwert, der den Richtliniennamen angibt.
      • Ein Zeichenfolgenwert, der den Namen der User Manager-Domäne des Benutzers darstellt, der Herausgeber des Dokuments ist. Dieser Parameterwert ist optional und kann null sein (wenn dieser Parameter null ist, muss der nächste Parameterwert null sein).
      • Ein Zeichenfolgenwert, der den Namen des kanonischen Benutzermanagers darstellt, der der Herausgeber des Dokuments ist. Dieser Parameterwert ist optional und kann null (wenn dieser Parameter null ist, muss der vorherige Parameterwert null sein).
      • Eine com.adobe.livecycle.rightsmanagement.Locale Variable, die das Gebietsschema darstellt, mit dem die MS Office-Vorlage ausgewählt wird. Dieser Parameterwert ist optional und Sie können ihn angeben null .
      Die protectDocument Methode gibt ein RMSecureDocumentResult Objekt zurück, das das richtliniengeschützte Word-Dokument enthält.
  5. Speichern Sie das Word-Dokument.
    • Rufen Sie die RMSecureDocumentResult getProtectedDoc Objektmethode auf, um das richtliniengeschützte Word-Dokument abzurufen. Diese Methode gibt ein com.adobe.idp.Document Objekt zurück.
    • Create a java.io.File object and ensure that the file extension is DOC.
    • Rufen Sie die com.adobe.idp.Document Methode des copyToFile Objekts auf, um den Inhalt des Document Objekts in die Datei zu kopieren (stellen Sie sicher, dass Sie das Document Objekt verwenden, das von der getProtectedDoc -Methode zurückgegeben wurde).
Codebeispiele
Codebeispiele für die Verwendung des Dokument Security-Dienstes finden Sie im folgenden Quick Beginn:
  • "Quick Beginn (SOAP-Modus): Anwenden einer Richtlinie auf ein Word-Dokument mithilfe der Java-API"

Anwenden einer Richtlinie auf ein Word-Dokument mithilfe der Webdienst-API

Wenden Sie eine Richtlinie mithilfe der Dokument Security API (Webdienst) auf ein Word-Dokument an:
  1. Schließen Sie Projektdateien ein.
    Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden: http://localhost:8080/soap/services/DocumentSecurityService?WSDL&lc_version=9.0.1 .
    Ersetzen Sie localhost dies durch die IP-Adresse des Hosting-AEM Forms.
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
    • Create a DocumentSecurityServiceClient object by using its default constructor.
    • Create a DocumentSecurityServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Übergeben Sie einen Zeichenfolgenwert, der die WSDL an den AEM Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/DocumentSecurityService?WSDL ). Sie müssen das lc_version Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen.)
    • Erstellen Sie ein System.ServiceModel.BasicHttpBinding Objekt, indem Sie den Wert des DocumentSecurityServiceClient.Endpoint.Binding Felds abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
    • Legen Sie für das System.ServiceModel.BasicHttpBinding Objektfeld MessageEncoding den Wert WSMessageEncoding.Mtom fest. Dieser Wert stellt sicher, dass MTOM verwendet wird.
    • Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Aufgaben ausführen:
      • Weisen Sie dem Feld den AEM Forms-Benutzernamen zu DocumentSecurityServiceClient.ClientCredentials.UserName.UserName .
      • Weisen Sie dem Feld den entsprechenden Kennwortwert zu DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • Weisen Sie dem Feld den Konstantenwert HttpClientCredentialType.Basic zu BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Weisen Sie dem Feld den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu BasicHttpBindingSecurity.Security.Mode .
  3. Word-Dokument abrufen
    • Erstellen Sie ein Objekt BLOB , indem Sie den Konstruktor verwenden. Das BLOB Objekt dient zum Speichern eines Word-Dokuments, auf das eine Richtlinie angewendet wird.
    • Erstellen Sie ein System.IO.FileStream Objekt, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Dateispeicherort des Word-Dokuments und den Dateimodus darstellt, in dem die Datei geöffnet werden soll.
    • Erstellen Sie ein Bytearray, das den Inhalt des System.IO.FileStream Objekts speichert. Bestimmen Sie die Byte-Array-Größe, indem Sie die System.IO.FileStream Objekteigenschaft Length abrufen.
    • Füllen Sie das Bytearray mit Stream-Daten, indem Sie die System.IO.FileStream Objektmethode Read aufrufen. Übergeben Sie das Bytearray, die Startposition und die zu lesende Stream-Länge.
    • Füllen Sie das BLOB Objekt, indem Sie seinem MTOM Feld den Inhalt des Byte-Arrays zuweisen.
  4. Wenden Sie eine vorhandene Richtlinie auf das Word-Dokument an.
    Wenden Sie eine Richtlinie auf das Word-Dokument an, indem Sie die DocumentSecurityServiceClient protectDocument Objektmethode aufrufen und die folgenden Werte übergeben:
    • Das BLOB Objekt, das das Word-Dokument enthält, auf das die Richtlinie angewendet wird.
    • Ein Zeichenfolgenwert, der den Namen des Dokuments angibt.
    • Ein Zeichenfolgenwert, der den Namen des Richtliniensatzes angibt, zu dem die Richtlinie gehört. Sie können einen null Wert angeben, der dazu führt, dass der MyPolicies Richtliniensatz verwendet wird.
    • Ein Zeichenfolgenwert, der den Richtliniennamen angibt.
    • Ein Zeichenfolgenwert, der den Namen der User Manager-Domäne des Benutzers darstellt, der Herausgeber des Dokuments ist. Dieser Parameterwert ist optional und kann null sein (wenn dieser Parameter null ist, muss der nächste Parameterwert null sein).
    • Ein Zeichenfolgenwert, der den Namen des kanonischen Benutzermanagers darstellt, der der Herausgeber des Dokuments ist. Dieser Parameterwert ist optional und kann null sein (wenn dieser Parameter null ist, muss der vorherige Parameterwert null sein).
    • Ein RMLocale Wert, der den Gebietsschemawert angibt (z. B. RMLocale.en ).
    • Ein Zeichenfolgenausgabeparameter, mit dem der Richtlinienerkennungswert gespeichert wird.
    • Ein Zeichenfolgenausgabeparameter, mit dem der richtliniengeschützte Bezeichnerwert gespeichert wird.
    • Ein Parameter für die Zeichenfolgenausgabe, mit dem der Mime-Typ gespeichert wird (z. B. application/doc ).
    Die protectDocument Methode gibt ein BLOB Objekt zurück, das das richtliniengeschützte Word-Dokument enthält.
  5. Speichern Sie das Word-Dokument.
    • Erstellen Sie ein System.IO.FileStream Objekt, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Dateispeicherort des richtliniengeschützten Word-Dokuments darstellt.
    • Erstellen Sie ein Bytearray, das den Dateninhalt des BLOB Objekts speichert, das von der protectDocument Methode zurückgegeben wurde. Füllen Sie das Byte-Array, indem Sie den Wert des BLOB Datenelements des MTOM Objekts abrufen.
    • Create a System.IO.BinaryWriter object by invoking its constructor and passing the System.IO.FileStream object.
    • Schreiben Sie den Inhalt des Byte-Arrays in eine Word-Datei, indem Sie die System.IO.BinaryWriter Objektmethode aufrufen und das Bytearray Write übergeben.
Codebeispiele
Codebeispiele für die Verwendung des Dokument Security-Dienstes finden Sie im folgenden Quick Beginn:
  • "Quick Beginn (MTOM): Anwenden einer Richtlinie auf ein Word-Dokument mithilfe der Webdienst-API"

Richtlinien aus Word-Dokumenten entfernen

Sie können eine Richtlinie aus einem richtliniengeschützten Word-Dokument entfernen, um die Sicherheit aus dem Dokument zu entfernen. Das heißt, wenn das Dokument nicht mehr durch eine Richtlinie geschützt werden soll. Wenn Sie ein richtliniengeschütztes Word-Dokument mit einer neueren Richtlinie aktualisieren möchten, wird es effizienter, die Richtlinie zu wechseln, anstatt die Richtlinie zu entfernen und die aktualisierte Richtlinie hinzuzufügen.
For more information about the Document Security service, see Services Reference for AEM Forms .

Zusammenfassung der Schritte

So entfernen Sie eine Richtlinie aus einem richtliniengeschützten Word-Dokument:
  1. Projektdateien einschließen
  2. Erstellen Sie ein Dokument Security Client API-Objekt.
  3. Rufen Sie ein richtliniengeschütztes Word-Dokument ab.
  4. Entfernen Sie die Richtlinie aus dem Word-Dokument.
  5. Ungesicherte Word-Dokumente speichern
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, stellen Sie sicher, dass Sie die Proxydateien einschließen.
Dokument Security Client API-Objekt erstellen
Bevor Sie einen Dokument Security-Dienstvorgang programmgesteuert durchführen können, erstellen Sie ein Client-Objekt des Dokument Security-Dienstes.
Abrufen eines richtliniengeschützten Word-Dokuments
Sie müssen ein richtliniengeschütztes Word-Dokument abrufen, um eine Richtlinie zu entfernen. Wenn Sie versuchen, eine Richtlinie aus einem Word-Dokument zu entfernen, das nicht durch eine Richtlinie geschützt ist, wird eine Ausnahme ausgelöst.
Richtlinie aus dem Word-Dokument entfernen
Sie können eine Richtlinie aus einem richtliniengeschützten Word-Dokument entfernen, sofern in den Verbindungseinstellungen ein Administrator angegeben ist. Andernfalls muss die zum Schützen eines Dokuments verwendete Richtlinie die SWITCH_POLICY Berechtigung enthalten, um eine Richtlinie aus einem Word-Dokument zu entfernen. Darüber hinaus muss der in den AEM Forms-Verbindungseinstellungen angegebene Benutzer über diese Berechtigung verfügen. Andernfalls wird eine Ausnahme ausgelöst.
Das ungesicherte Word-Dokument speichern
Nachdem der Dokument Security-Dienst eine Richtlinie aus einem Word-Dokument entfernt hat, können Sie das nicht geschützte Word-Dokument als DOC-Datei speichern.
Siehe auch

Eine Richtlinie mithilfe der Java-API aus einem Word-Dokument entfernen

Entfernen Sie eine Richtlinie mithilfe der Dokument Security API (Java) aus einem richtliniengeschützten Word-Dokument:
  1. Projektdateien einschließen
    Schließen Sie Client-JAR-Dateien wie "adobe-rightsmanagement-client.jar"im Klassenpfad Ihres Java-Projekts ein.
  2. Dokument Security Client API-Objekt erstellen
    • Erstellen Sie ein ServiceClientFactory -" -Objekt, das Verbindungseigenschaften enthält.
    • Erstellen Sie ein RightsManagementClient -Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory -Objekt übergeben.
  3. Abrufen eines richtliniengeschützten Word-Dokuments
    • Erstellen Sie ein java.io.FileInputStream Objekt, das das richtliniengeschützte Word-Dokument darstellt, indem Sie den Konstruktor verwenden und einen Zeichenfolgenwert übergeben, der die Position des Word-Dokuments angibt.
    • Erstellen Sie ein com.adobe.idp.Document -Objekt, indem Sie seinen Konstruktor verwenden und das java.io.FileInputStream -Objekt übergeben.
  4. Richtlinie aus dem Word-Dokument entfernen
    • Erstellen Sie ein DocumentManager Objekt, indem Sie die RightsManagementClient Objektmethode getDocumentManager aufrufen.
    • Entfernen Sie eine Richtlinie aus dem Word-Dokument, indem Sie die DocumentManager Objektmethode aufrufen und das removeSecurity com.adobe.idp.Document Objekt übergeben, das das richtliniengeschützte Word-Dokument enthält. Diese Methode gibt ein com.adobe.idp.Document Objekt zurück, das ein ungesichertes Word-Dokument enthält.
  5. Das ungesicherte Word-Dokument speichern
    • Create a java.io.File object and ensure that the file extension is DOC.
    • Rufen Sie die Document Methode des copyToFile Objekts auf, um den Inhalt des Document Objekts in die Datei zu kopieren (stellen Sie sicher, dass Sie das Document Objekt verwenden, das von der removeSecurity -Methode zurückgegeben wurde).
Codebeispiele
Codebeispiele für die Verwendung des Dokument Security-Dienstes finden Sie im folgenden Quick Beginn:
  • "Quick Beginn (SOAP-Modus): Entfernen einer Richtlinie aus einem Word-Dokument mithilfe der Java-API"

Eine Richtlinie mithilfe der Webdienst-API aus einem Word-Dokument entfernen

Entfernen Sie eine Richtlinie mithilfe der Dokument Security API (Webdienst) aus einem richtliniengeschützten Word-Dokument:
  1. Projektdateien einschließen
    Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    Ersetzen Sie localhost dies durch die IP-Adresse des Hosting-AEM Forms.
  2. Dokument Security Client API-Objekt erstellen
    • Create a RightsManagementServiceClient object by using its default constructor.
    • Create a RightsManagementServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Übergeben Sie einen Zeichenfolgenwert, der die WSDL an den AEM Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/RightsManagementService?WSDL ). Sie müssen das lc_version Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen.)
    • Erstellen Sie ein System.ServiceModel.BasicHttpBinding Objekt, indem Sie den Wert des RightsManagementServiceClient.Endpoint.Binding Felds abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
    • Legen Sie für das System.ServiceModel.BasicHttpBinding Objektfeld MessageEncoding den Wert WSMessageEncoding.Mtom fest. Dieser Wert stellt sicher, dass MTOM verwendet wird.
    • Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Aufgaben ausführen:
      • Weisen Sie dem Feld den AEM Forms-Benutzernamen zu RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • Weisen Sie dem Feld den entsprechenden Kennwortwert zu RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Weisen Sie dem Feld den Konstantenwert HttpClientCredentialType.Basic zu BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Weisen Sie dem Feld den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu BasicHttpBindingSecurity.Security.Mode .
  3. Abrufen eines richtliniengeschützten Word-Dokuments
    • Erstellen Sie ein Objekt BLOB , indem Sie den Konstruktor verwenden. Das BLOB Objekt dient zum Speichern des richtliniengeschützten Word-Dokuments, aus dem die Richtlinie entfernt wird.
    • Erstellen Sie ein System.IO.FileStream Objekt, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Dateispeicherort des Word-Dokuments und den Dateimodus darstellt, in dem die Datei geöffnet werden soll.
    • Erstellen Sie ein Bytearray, das den Inhalt des System.IO.FileStream Objekts speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die System.IO.FileStream Objekteigenschaft Length abrufen.
    • Füllen Sie das Bytearray mit Stream-Daten, indem Sie die System.IO.FileStream Objektmethode aufrufen und das Bytearray, die Startposition und die zu lesende Stream-Länge übergeben Read .
    • Füllen Sie das BLOB Objekt, indem Sie seinem MTOM Feld den Inhalt des Byte-Arrays zuweisen.
  4. Richtlinie aus dem Word-Dokument entfernen
    Entfernen Sie die Richtlinie aus dem Word-Dokument, indem Sie die RightsManagementServiceClient Objektmethode aufrufen und das removePolicySecurity BLOB Objekt übergeben, das das richtliniengeschützte Word-Dokument enthält. Diese Methode gibt ein BLOB Objekt zurück, das ein ungesichertes Word-Dokument enthält.
  5. Das ungesicherte Word-Dokument speichern
    • Erstellen Sie ein System.IO.FileStream Objekt, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der die Dateiposition des nicht geschützten Word-Dokuments darstellt.
    • Erstellen Sie ein Bytearray, das den Dateninhalt des BLOB Objekts speichert, das von der removePolicySecurity Methode zurückgegeben wurde. Füllen Sie das Byte-Array, indem Sie den Wert des BLOB Objektfelds MTOM abrufen.
    • Create a System.IO.BinaryWriter object by invoking its constructor and passing the System.IO.FileStream object.
Codebeispiele
Codebeispiele für die Verwendung des Dokument Security-Dienstes finden Sie im folgenden Quick Beginn:
  • "Quick Beginn (MTOM): Entfernen einer Richtlinie aus einem Word-Dokument mithilfe der Webdienst-API"
Siehe auch