Schützen von Dokumenten mit Richtlinien

Zugriff auf Dokumente sperren

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

Wenden Sie mithilfe der Document Security-API (Java) eine Richtlinie auf ein PDF-Dokument an:

Projektdateien einschließen.

Schließen Sie Client-JAR-Dateien wie adobe-rightsmanagement-client.jar in den Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein Document 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.
Rufen Sie ein PDF-Dokument ab.
- Erstellen Sie ein java.io.FileInputStream-Objekt, das das PDF-Dokument mithilfe des zugehörigen Konstruktors darstellt. Übergeben Sie einen string -Wert, 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.
Anwenden einer vorhandenen Richtlinie auf das PDF-Dokument.
- Erstellen Sie ein DocumentManager -Objekt, indem Sie die getDocumentManager -Methode des Objekts RightsManagementClient aufrufen.
- Wenden Sie eine Richtlinie auf das PDF-Dokument an, indem Sie die protectDocument -Methode des Objekts DocumentManager 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 string -Wert, der den Namen des Dokuments angibt.
  - Ein string -Wert, 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 string -Wert, der den Richtliniennamen angibt.
  - Ein string -Wert für den Namen der User Manager-Domäne des Benutzers, 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 string -Wert, der den Namen des kanonischen Benutzers des User Manager-Benutzers darstellt, 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 com.adobe.livecycle.rightsmanagement.Locale -Gebietsschema, das für die Auswahl der MS Office-Vorlage verwendet 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.
Speichern Sie das PDF-Dokument.
- Rufen Sie die getProtectedDoc-Methode des Objekts RMSecureDocumentResult auf, um das richtliniengeschützte PDF-Dokument abzurufen. Diese Methode gibt ein com.adobe.idp.Document -Objekt zurück.
- Erstellen Sie ein java.io.File -Objekt und stellen Sie sicher, dass die Dateierweiterung PDF ist.
- Rufen Sie die copyToFile -Methode des com.adobe.idp.Document -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, die den Document Security-Dienst verwenden, finden Sie in den folgenden Schnellstarts:

"Schnellstart (EJB-Modus): Anwenden einer Richtlinie auf ein PDF-Dokument mithilfe der Java-API"
"Schnellstart (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

Wenden Sie mithilfe der Document Security-API (Webdienst) eine Richtlinie auf ein PDF-Dokument an:

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.

HINWEIS

Ersetzen Sie localhost durch die IP-Adresse des Servers, auf dem AEM Forms gehostet wird.
Erstellen Sie ein Document Security Client-API-Objekt.
- Erstellen Sie ein RightsManagementServiceClient -Objekt mithilfe des Standardkonstruktors.
- Erstellen Sie ein RightsManagementServiceClient.Endpoint.Address-Objekt mit dem Konstruktor System.ServiceModel.EndpointAddress . Übergeben Sie einen string -Wert, der die WSDL an den Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/RightsManagementService?WSDL). Sie müssen das Attribut lc_version nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen.)
- Erstellen Sie ein System.ServiceModel.BasicHttpBinding -Objekt, indem Sie den Wert des Felds RightsManagementServiceClient.Endpoint.Binding abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
- Setzen Sie das System.ServiceModel.BasicHttpBinding -Feld des Objekts MessageEncoding auf WSMessageEncoding.Mtom. 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 RightsManagementServiceClient.ClientCredentials.UserName.UserName den Benutzernamen des AEM Formulars zu.
  - Weisen Sie dem Feld RightsManagementServiceClient.ClientCredentials.UserName.Password den entsprechenden Kennwortwert zu.
  - Weisen Sie dem Feld BasicHttpBindingSecurity.Transport.ClientCredentialType den Konstantenwert HttpClientCredentialType.Basic zu.
- Weisen Sie dem Feld BasicHttpBindingSecurity.Security.Mode den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu.
Rufen Sie ein PDF-Dokument ab.
- Erstellen Sie ein Objekt BLOB, indem Sie den Konstruktor verwenden. Das BLOB-Objekt wird zum Speichern eines PDF-Dokuments verwendet, auf das eine Richtlinie angewendet wird.
- Erstellen Sie ein System.IO.FileStream -Objekt, indem Sie seinen Konstruktor aufrufen und einen string -Wert übergeben, der den Dateispeicherort des PDF-Dokuments und den Modus darstellt, in dem die Datei geöffnet werden soll.
- Erstellen Sie ein Byte-Array, das den Inhalt des Objekts System.IO.FileStream speichert. Bestimmen Sie die Größe des Byte-Arrays, indem Sie die Eigenschaft Length des Objekts System.IO.FileStream abrufen.
- Füllen Sie das Byte-Array mit Stream-Daten, indem Sie die Read -Methode des Objekts System.IO.FileStream aufrufen. Übergeben Sie das Byte-Array, die Startposition und die zu lesende Stream-Länge.
- Füllen Sie das BLOB-Objekt, indem Sie sein MTOM-Feld mit dem Inhalt des Byte-Arrays zuweisen.
Anwenden einer vorhandenen Richtlinie auf das PDF-Dokument.

Wenden Sie eine Richtlinie auf das PDF-Dokument an, indem Sie die protectDocument -Methode des Objekts RightsManagementServiceClient aufrufen und die folgenden Werte übergeben:
- Das BLOB-Objekt, das das PDF-Dokument enthält, auf das die Richtlinie angewendet wird.
- Ein string -Wert, der den Namen des Dokuments angibt.
- Ein string -Wert, 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 string -Wert, der den Richtliniennamen angibt.
- Ein string -Wert für den Namen der User Manager-Domäne des Benutzers, 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 string -Wert, der den Namen des kanonischen Benutzers des User Manager-Benutzers darstellt, 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 string -Ausgabeparameter, der zum Speichern des Richtlinienkennungswerts verwendet wird.
- Ein string -Ausgabeparameter, der zum Speichern des richtliniengeschützten Bezeichnerwerts verwendet wird.
- Ein string -Ausgabeparameter, der zum Speichern des MIME-Typs verwendet wird (z. B. application/pdf).
Die protectDocument-Methode gibt ein BLOB-Objekt zurück, das das richtliniengeschützte PDF-Dokument enthält.
Speichern Sie das PDF-Dokument.
- Erstellen Sie ein System.IO.FileStream -Objekt, indem Sie seinen Konstruktor aufrufen und einen string -Wert übergeben, der den Dateispeicherort des richtliniengeschützten PDF-Dokuments darstellt.
- Erstellen Sie ein Byte-Array, 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 Objekts MTOM abrufen.
- Erstellen Sie ein System.IO.BinaryWriter -Objekt, indem Sie seinen Konstruktor aufrufen und das System.IO.FileStream -Objekt übergeben.
- Schreiben Sie den Inhalt des Byte-Arrays in eine PDF-Datei, indem Sie die Write -Methode des Objekts System.IO.BinaryWriter aufrufen und das Byte-Array übergeben.

Codebeispiele

Codebeispiele, die den Document Security-Dienst verwenden, finden Sie in den folgenden Schnellstarts:

"Schnellstart (MTOM): Anwenden einer Richtlinie auf ein PDF-Dokument mithilfe der Webdienst-API"
"Schnellstart (SwaRef): Anwenden einer Richtlinie auf ein PDF-Dokument mithilfe der Webdienst-API"

Entfernen von Richtlinien aus PDF-Dokumenten

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.

HINWEIS

Weitere Informationen zum Document Security-Dienst finden Sie unter Dienstreferenz für AEM Forms.

Zusammenfassung der Schritte

So entfernen Sie eine Richtlinie aus einem richtliniengeschützten PDF-Dokument:

Projektdateien einschließen
Erstellen Sie ein Document Security Client-API-Objekt.
Abrufen eines richtliniengeschützten PDF-Dokuments.
Entfernen Sie die Richtlinie aus dem PDF-Dokument.
Speichern Sie das ungesicherte PDF-Dokument.

Projektdateien einschließen

Erstellen eines Document Security Client-API-Objekts

Bevor Sie einen Document Security-Dienstvorgang programmgesteuert durchführen können, erstellen Sie ein Client-Objekt des Document Security-Dienstes.

Abrufen eines richtliniengeschützten PDF-Dokuments

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

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 Berechtigung SWITCH_POLICY enthalten, damit eine Richtlinie aus einem PDF-Dokument entfernt werden kann. Außerdem 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 Document Security-Dienst eine Richtlinie aus einem PDF-Dokument entfernt hat, können Sie das ungesicherte PDF-Dokument als PDF-Datei speichern.

Siehe auch

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

Entfernen Sie mithilfe der Document Security-API (Java) eine Richtlinie aus einem richtliniengeschützten PDF-Dokument:

Projektdateien einschließen.

Schließen Sie Client-JAR-Dateien wie adobe-rightsmanagement-client.jar in den Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein Document 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.
Abrufen eines richtliniengeschützten PDF-Dokuments.
- Erstellen Sie ein java.io.FileInputStream-Objekt, das das richtliniengeschützte PDF-Dokument darstellt, indem Sie seinen 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.
Entfernen Sie die Richtlinie aus dem PDF-Dokument.
- Erstellen Sie ein DocumentManager -Objekt, indem Sie die getDocumentManager -Methode des Objekts DocumentSecurityClient aufrufen.
- Entfernen Sie eine Richtlinie aus dem PDF-Dokument, indem Sie die removeSecurity-Methode des Objekts DocumentManager aufrufen und das 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 nicht gesichertes PDF-Dokument enthält.
Speichern Sie das ungesicherte PDF-Dokument.
- Erstellen Sie ein java.io.File -Objekt und stellen Sie sicher, dass die Dateierweiterung PDF ist.
- Rufen Sie die copyToFile -Methode des Document -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, die den Document Security-Dienst verwenden, finden Sie in den folgenden Schnellstarts:

"Schnellstart (SOAP-Modus): Entfernen einer Richtlinie aus einem PDF-Dokument mithilfe der Java-API"

Eine Richtlinie mithilfe der Webdienst-API entfernen

Entfernen Sie mithilfe der Document Security-API (Webdienst) eine Richtlinie aus einem richtliniengeschützten PDF-Dokument:

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.

HINWEIS

Ersetzen Sie localhost durch die IP-Adresse des Servers, auf dem AEM Forms gehostet wird.
Erstellen Sie ein Document Security Client-API-Objekt.
- Erstellen Sie ein DocumentSecurityServiceClient -Objekt mithilfe des Standardkonstruktors.
- Erstellen Sie ein DocumentSecurityServiceClient.Endpoint.Address-Objekt mit dem Konstruktor System.ServiceModel.EndpointAddress . Übergeben Sie einen string -Wert, der die WSDL an den AEM Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/RightsManagementService?WSDL). Sie müssen das Attribut lc_version nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen.)
- Erstellen Sie ein System.ServiceModel.BasicHttpBinding -Objekt, indem Sie den Wert des Felds DocumentSecurityServiceClient.Endpoint.Binding abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
- Setzen Sie das System.ServiceModel.BasicHttpBinding -Feld des Objekts MessageEncoding auf WSMessageEncoding.Mtom. 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 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName den Benutzernamen des AEM Formulars zu.
  - Weisen Sie dem Feld DocumentSecurityServiceClient.ClientCredentials.UserName.Password den entsprechenden Kennwortwert zu.
  - Weisen Sie dem Feld BasicHttpBindingSecurity.Transport.ClientCredentialType den Konstantenwert HttpClientCredentialType.Basic zu.
- Weisen Sie dem Feld BasicHttpBindingSecurity.Security.Mode den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu.
Abrufen eines richtliniengeschützten PDF-Dokuments.
- Erstellen Sie ein Objekt BLOB, indem Sie den Konstruktor verwenden. Das BLOB-Objekt wird zum Speichern des richtliniengeschützten PDF-Dokuments verwendet, aus dem die Richtlinie entfernt wird.
- Erstellen Sie ein System.IO.FileStream -Objekt, indem Sie seinen Konstruktor aufrufen und einen string -Wert übergeben, der den Dateispeicherort des PDF-Dokuments und den Modus darstellt, in dem die Datei geöffnet werden soll.
- Erstellen Sie ein Byte-Array, das den Inhalt des Objekts System.IO.FileStream speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die Length -Eigenschaft des Objekts System.IO.FileStream abrufen.
- Füllen Sie das Byte-Array mit Stream-Daten, indem Sie die Read -Methode des Objekts System.IO.FileStream aufrufen und das Byte-Array, die Startposition und die zu lesende Stream-Länge übergeben.
- Füllen Sie das BLOB-Objekt, indem Sie sein MTOM-Feld mit dem Inhalt des Byte-Arrays zuweisen.
Entfernen Sie die Richtlinie aus dem PDF-Dokument.

Entfernen Sie die Richtlinie aus dem PDF-Dokument, indem Sie die removePolicySecurity-Methode des Objekts DocumentSecurityServiceClient aufrufen und das BLOB-Objekt übergeben, das das richtliniengeschützte PDF-Dokument enthält. Diese Methode gibt ein BLOB -Objekt zurück, das ein nicht gesichertes PDF-Dokument enthält.
Speichern Sie das ungesicherte PDF-Dokument.
- Erstellen Sie ein System.IO.FileStream -Objekt, indem Sie seinen Konstruktor aufrufen und einen string -Wert übergeben, der den Dateispeicherort des ungesicherten PDF-Dokuments darstellt.
- Erstellen Sie ein Byte-Array, 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 Felds BLOB des Objekts MTOM abrufen.
- Erstellen Sie ein System.IO.BinaryWriter -Objekt, indem Sie seinen Konstruktor aufrufen und das System.IO.FileStream -Objekt übergeben.

Codebeispiele

Codebeispiele, die den Document Security-Dienst verwenden, finden Sie in den folgenden Schnellstarts:

"Schnellstart (MTOM): Entfernen einer Richtlinie aus einem PDF-Dokument mithilfe der Webdienst-API"
"Schnellstart (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 alle Kopien des Dokuments für Benutzer nicht zugänglich sind. Wenn ein Benutzer versucht, ein gesperrtes PDF-Dokument zu öffnen, wird er an eine angegebene URL umgeleitet, wo ein überarbeitetes Dokument angezeigt werden kann. Die URL, an die der Benutzer umgeleitet wird, muss programmatisch angegeben werden. Wenn Sie den Zugriff auf ein Dokument sperren, wird die Änderung wirksam, wenn sich der Benutzer das nächste Mal mit dem Document Security-Dienst synchronisiert, indem er das richtliniengeschützte Dokument online öffnet.

Die Möglichkeit, den Zugriff auf ein Dokument zu sperren, bietet zusätzliche Sicherheit. Angenommen, eine neuere Version eines Dokuments ist verfügbar, und Sie möchten nicht mehr, dass jemand die veraltete Version anzeigt. In diesem Fall kann der Zugriff auf das ältere Dokument widerrufen werden und niemand kann das Dokument anzeigen, es sei denn, der Zugriff wird wieder aktiviert.

HINWEIS

Weitere Informationen zum Document Security-Dienst finden Sie unter Dienstreferenz für AEM Forms.

Zusammenfassung der Schritte

Um ein richtliniengeschütztes Dokument zu sperren, führen Sie die folgenden Schritte aus:

Projektdateien einschließen.
Erstellen Sie ein Document Security Client-API-Objekt.
Abrufen eines richtliniengeschützten PDF-Dokuments.
Sperren Sie das richtliniengeschützte Dokument.

Projektdateien einschließen

Erstellen eines Document Security Client-API-Objekts

Bevor Sie einen Document Security-Dienstvorgang programmgesteuert ausführen können, müssen Sie ein Client-Objekt des Document Security-Dienstes erstellen.

Abrufen eines richtliniengeschützten PDF-Dokuments

Sie müssen ein richtliniengeschütztes PDF-Dokument abrufen, um es zu widerrufen. Sie können ein Dokument, das bereits gesperrt wurde oder nicht richtliniengeschützt ist, nicht sperren.

Wenn Sie den Wert der Lizenzkennung 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 zu erhalten.

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 anzeigen kann, wenn er versucht, das gesperrte Dokument zu öffnen. Angenommen, ein veraltetes Dokument wird widerrufen. Wenn ein Benutzer versucht, das gesperrte Dokument zu öffnen, wird ihm anstelle des gesperrten Dokuments ein aktualisiertes Dokument angezeigt.

HINWEIS

Wenn Sie versuchen, ein bereits gesperrtes Dokument zu widerrufen, wird eine Ausnahme ausgelöst.

Siehe auch

Neuer Zugriff auf gesperrte Dokumente

Zugriff auf Dokumente mithilfe der Java-API sperren

Sperren Sie den Zugriff auf ein richtliniengeschütztes PDF-Dokument mithilfe der Document Security-API (Java):

Projektdateien einschließen

Schließen Sie Client-JAR-Dateien wie adobe-rightsmanagement-client.jar in den Klassenpfad Ihres Java-Projekts ein.
Erstellen eines Document Security Client-API-Objekts
- Erstellen Sie ein ServiceClientFactory-" -Objekt, das Verbindungseigenschaften enthält.
- Erstellen Sie ein DocumentSecurityClient-Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory-Objekt übergeben.
Abrufen eines richtliniengeschützten PDF-Dokuments
- Erstellen Sie ein java.io.FileInputStream-Objekt, das das richtliniengeschützte PDF-Dokument darstellt, indem Sie seinen 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.
Richtliniengeschütztes Dokument sperren
- Erstellen Sie ein DocumentManager -Objekt, indem Sie die getDocumentManager -Methode des Objekts DocumentSecurityClient aufrufen.
- Rufen Sie den Wert der Lizenzkennung des richtliniengeschützten Dokuments ab, indem Sie die getLicenseId -Methode des Objekts DocumentManager 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 getLicenseManager -Methode des Objekts DocumentSecurityClient aufrufen.
- Rufen Sie das richtliniengeschützte Dokument auf, indem Sie die revokeLicense -Methode des Objekts LicenseManager aufrufen und die folgenden Werte übergeben:
  - Ein string -Wert, der den Wert der Lizenzkennung des richtliniengeschützten Dokuments angibt (geben Sie den Rückgabewert der DocumentManager -Methode des Objekts getLicenseId an).
  - Ein statisches Datenelement der License-Schnittstelle, das den Grund zum Sperren des Dokuments angibt. Sie können beispielsweise License.DOCUMENT_REVISED angeben.
  - Ein java.net.URL -Wert, der den Speicherort angibt, an dem sich ein überarbeitetes Dokument befindet. Wenn Sie einen Benutzer nicht zu einer anderen URL umleiten möchten, können Sie null übergeben.

Codebeispiele

Codebeispiele, die den Document Security-Dienst verwenden, finden Sie in den folgenden Schnellstarts:

"Schnellstart (SOAP-Modus): Aufrufen eines Dokuments mithilfe der Java-API"

Sperren des Zugriffs auf Dokumente mithilfe der Webdienst-API

Rufen Sie mithilfe der Document Security-API (Webdienst) den Zugriff auf ein richtliniengeschütztes PDF-Dokument auf:

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.

HINWEIS

Ersetzen Sie localhost durch die IP-Adresse des Servers, auf dem AEM Forms gehostet wird.
Erstellen eines Document Security Client-API-Objekts
- Erstellen Sie ein DocumentSecurityServiceClient -Objekt mithilfe des Standardkonstruktors.
- Erstellen Sie ein DocumentSecurityServiceClient.Endpoint.Address-Objekt mit dem Konstruktor System.ServiceModel.EndpointAddress . Übergeben Sie einen string -Wert, der die WSDL an den AEM Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/RightsManagementService?WSDL). Sie müssen das Attribut lc_version nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen.)
- Erstellen Sie ein System.ServiceModel.BasicHttpBinding -Objekt, indem Sie den Wert des Felds DocumentSecurityServiceClient.Endpoint.Binding abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
- Setzen Sie das System.ServiceModel.BasicHttpBinding -Feld des Objekts MessageEncoding auf WSMessageEncoding.Mtom. 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 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName den Benutzernamen des AEM Formulars zu.
  - Weisen Sie dem Feld DocumentSecurityServiceClient.ClientCredentials.UserName.Password den entsprechenden Kennwortwert zu.
  - Weisen Sie dem Feld BasicHttpBindingSecurity.Transport.ClientCredentialType den Konstantenwert HttpClientCredentialType.Basic zu.
- Weisen Sie dem Feld BasicHttpBindingSecurity.Security.Mode den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu.
Abrufen eines richtliniengeschützten PDF-Dokuments
- Erstellen Sie ein Objekt BLOB, indem Sie den Konstruktor verwenden. Das BLOB-Objekt wird zum Speichern eines richtliniengeschützten PDF-Dokuments verwendet, das gesperrt ist.
- Erstellen Sie ein System.IO.FileStream -Objekt, indem Sie seinen Konstruktor aufrufen und einen string -Wert übergeben, der den Dateispeicherort des zu widerrufenden richtliniengeschützten PDF-Dokuments und den Modus zum Öffnen der Datei darstellt.
- Erstellen Sie ein Byte-Array, das den Inhalt des Objekts System.IO.FileStream speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die Length -Eigenschaft des Objekts System.IO.FileStream abrufen.
- Füllen Sie das Byte-Array mit Stream-Daten, indem Sie die Read -Methode des Objekts System.IO.FileStream aufrufen und das Byte-Array, die Startposition und die zu lesende Stream-Länge übergeben.
- Füllen Sie das BLOB-Objekt, indem Sie sein MTOM-Feld mit dem Inhalt des Byte-Arrays zuweisen.
Richtliniengeschütztes Dokument sperren
- Rufen Sie den Wert der Lizenzkennung des richtliniengeschützten Dokuments ab, indem Sie die getLicenseID -Methode des Objekts DocumentSecurityServiceClient aufrufen und das BLOB -Objekt übergeben, das das richtliniengeschützte Dokument darstellt. Diese Methode gibt einen Zeichenfolgenwert zurück, der die Lizenzkennung darstellt.
- Rufen Sie das richtliniengeschützte Dokument auf, indem Sie die revokeLicense -Methode des Objekts DocumentSecurityServiceClient aufrufen und die folgenden Werte übergeben:
  - Ein string -Wert, der den Wert der Lizenzkennung des richtliniengeschützten Dokuments angibt (geben Sie den Rückgabewert der DocumentSecurityServiceService -Methode des Objekts getLicenseId an).
  - Ein statisches Datenelement der Enum Reason , das den Grund für das Sperren des Dokuments angibt. Sie können beispielsweise Reason.DOCUMENT_REVISED angeben.
  - Ein string -Wert, der den URL-Speicherort angibt, an dem sich ein überarbeitetes Dokument befindet. Wenn Sie einen Benutzer nicht zu einer anderen URL umleiten möchten, können Sie null übergeben.

Codebeispiele

Codebeispiele, die den Document Security-Dienst verwenden, finden Sie in den folgenden Schnellstarts:

"Schnellstart (MTOM): Sperren eines Dokuments mithilfe der Webdienst-API"
"Schnellstart (SwaRef): Sperren eines Dokuments mithilfe der Webdienst-API"

Siehe auch

Entfernen von Richtlinien aus Word-Dokumenten

Neuer Zugriff auf gesperrte Dokumente

Sie können den Zugriff auf ein gesperrtes PDF-Dokument reaktivieren, sodass alle Kopien des gesperrten Dokuments für Benutzer zugänglich sind. Wenn ein Benutzer ein reaktiviertes Dokument öffnet, das widerrufen wurde, kann er das Dokument anzeigen.

HINWEIS

Weitere Informationen zum Document Security-Dienst finden Sie unter Dienstreferenz für AEM Forms.

Zusammenfassung der Schritte

Führen Sie die folgenden Schritte aus, um den Zugriff auf ein gesperrtes PDF-Dokument wiederherzustellen:

Projektdateien einschließen.
Erstellen Sie ein Document Security Client-API-Objekt.
Rufen Sie die Lizenzkennung des gesperrten PDF-Dokuments ab.
Reaktivieren Sie den Zugriff auf das gesperrte PDF-Dokument.

Projektdateien einschließen

Erstellen eines Document Security Client-API-Objekts

Bevor Sie einen Document Security-Dienstvorgang programmgesteuert ausführen können, müssen Sie ein Client-Objekt des Document Security-Dienstes erstellen. Wenn Sie die Java-API verwenden, erstellen Sie ein DocumentSecurityClient -Objekt. Wenn Sie die Document Security-Webdienst-API verwenden, erstellen Sie ein DocumentSecurityServiceService -Objekt.

Lizenzkennung des gesperrten PDF-Dokuments abrufen

Sie müssen die Lizenzkennung des gesperrten PDF-Dokuments abrufen, um ein gesperrtes PDF-Dokument erneut zu aktivieren. Nachdem Sie den Wert der Lizenzkennung erhalten haben, können Sie ein gesperrtes Dokument erneut aktivieren. Wenn Sie versuchen, ein Dokument erneut zu aktivieren, das nicht gesperrt ist, wird eine Ausnahme verursacht.

Zugriff auf das gesperrte PDF-Dokument reaktivieren

Um den Zugriff auf ein gesperrtes PDF-Dokument erneut zu aktivieren, müssen Sie die Lizenzkennung des gesperrten Dokuments angeben. Wenn Sie versuchen, den Zugriff auf ein nicht widerrufenes PDF-Dokument erneut zu aktivieren, wird eine Ausnahme verursacht.

Siehe auch

Zugriff auf Dokumente sperren

Zugriff auf gesperrte Dokumente mit der Java-API reaktivieren

Reaktivieren Sie den Zugriff auf ein gesperrtes Dokument mithilfe der Document Security-API (Java):

Projektdateien einschließen.

Schließen Sie Client-JAR-Dateien wie adobe-rightsmanagement-client.jar in den Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein Document 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.
Rufen Sie die Lizenzkennung des gesperrten PDF-Dokuments ab.
- Erstellen Sie ein java.io.FileInputStream -Objekt, das das gesperrte PDF-Dokument darstellt, indem Sie seinen Konstruktor verwenden und einen string -Wert ü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 getDocumentManager -Methode des Objekts DocumentSecurityClient aufrufen.
- Rufen Sie den Wert der Lizenzkennung des gesperrten Dokuments ab, indem Sie die getLicenseId -Methode des Objekts DocumentManager aufrufen und das com.adobe.idp.Document -Objekt übergeben, das das gesperrte Dokument darstellt. Diese Methode gibt einen Zeichenfolgenwert zurück, der die Lizenzkennung darstellt.
Reaktivieren Sie den Zugriff auf das gesperrte PDF-Dokument.
- Erstellen Sie ein LicenseManager -Objekt, indem Sie die getLicenseManager -Methode des Objekts DocumentSecurityClient aufrufen.
- Reaktivieren Sie den Zugriff auf das gesperrte PDF-Dokument, indem Sie die unrevokeLicense-Methode des Objekts LicenseManager aufrufen und den Wert der Lizenzkennung des gesperrten Dokuments übergeben.

Codebeispiele

Codebeispiele, die den Document Security-Dienst verwenden, finden Sie in den folgenden Schnellstarts:

"Schnellstart (SOAP-Modus): Zugriff auf ein gesperrtes Dokument mit der Web-Dienst-API reaktivieren"

Zugriff auf gesperrte Dokumente mithilfe der Webdienst-API reaktivieren

Reaktivieren Sie den Zugriff auf ein gesperrtes Dokument mithilfe der Document Security API (Webdienst):

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.

HINWEIS

Ersetzen Sie localhost durch die IP-Adresse des Servers, auf dem AEM Forms gehostet wird.
Erstellen Sie ein Document Security Client-API-Objekt.
- Erstellen Sie ein DocumentSecurityServiceClient -Objekt mithilfe des Standardkonstruktors.
- Erstellen Sie ein DocumentSecurityServiceClient.Endpoint.Address-Objekt mit dem Konstruktor System.ServiceModel.EndpointAddress . Übergeben Sie einen string -Wert, der die WSDL an den AEM Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/RightsManagementService?WSDL). Sie müssen das Attribut lc_version nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen.)
- Erstellen Sie ein System.ServiceModel.BasicHttpBinding -Objekt, indem Sie den Wert des Felds DocumentSecurityServiceClient.Endpoint.Binding abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
- Setzen Sie das System.ServiceModel.BasicHttpBinding -Feld des Objekts MessageEncoding auf WSMessageEncoding.Mtom. 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 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName den Benutzernamen des AEM Formulars zu.
  - Weisen Sie dem Feld DocumentSecurityServiceClient.ClientCredentials.UserName.Password den entsprechenden Kennwortwert zu.
  - Weisen Sie dem Feld BasicHttpBindingSecurity.Transport.ClientCredentialType den Konstantenwert HttpClientCredentialType.Basic zu.
- Weisen Sie dem Feld BasicHttpBindingSecurity.Security.Mode den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu.
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 reaktiviert wird.
- Erstellen Sie ein System.IO.FileStream -Objekt, indem Sie seinen Konstruktor aufrufen und einen string -Wert übergeben, der den Dateispeicherort des gesperrten PDF-Dokuments und den Modus darstellt, in dem die Datei geöffnet werden soll.
- Erstellen Sie ein Byte-Array, das den Inhalt des Objekts System.IO.FileStream speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die Length -Eigenschaft des Objekts System.IO.FileStream abrufen.
- Füllen Sie das Byte-Array mit Stream-Daten, indem Sie die Read -Methode des Objekts System.IO.FileStream aufrufen und das Byte-Array, die Startposition und die zu lesende Stream-Länge übergeben.
- Füllen Sie das BLOB-Objekt, indem Sie sein MTOM-Feld mit dem Inhalt des Byte-Arrays zuweisen.
Reaktivieren Sie den Zugriff auf das gesperrte PDF-Dokument.
- Rufen Sie den Wert der Lizenzkennung des gesperrten Dokuments ab, indem Sie die getLicenseID -Methode des Objekts DocumentSecurityServiceClient aufrufen und das BLOB -Objekt übergeben, das das gesperrte Dokument darstellt. Diese Methode gibt einen Zeichenfolgenwert zurück, der die Lizenzkennung darstellt.
- Reaktivieren Sie den Zugriff auf das gesperrte PDF-Dokument, indem Sie die unrevokeLicense -Methode des Objekts DocumentSecurityServiceClient aufrufen und einen Zeichenfolgenwert übergeben, der den Lizenzkennungswert des gesperrten PDF-Dokuments angibt (übergeben Sie den Rückgabewert der DocumentSecurityServiceClient -Methode des Objekts getLicenseId).

Codebeispiele

Codebeispiele, die den Document Security-Dienst verwenden, finden Sie in den folgenden Schnellstarts:

"Schnellstart (MTOM): Zugriff auf ein gesperrtes Dokument mit der Web-Dienst-API reaktivieren"
"Schnellstart (SwaRef): Zugriff auf ein gesperrtes Dokument mit der Web-Dienst-API reaktivieren"

Siehe auch

Überprüfen von richtliniengeschützten PDF-Dokumenten

Sie können die Document 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 bestimmen, 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. In AEM Forms wird die Überprüfung richtliniengeschützter Dokumente unterstützt. Wenn Sie versuchen, ein richtliniengeschütztes Dokument mit LiveCycle 8.x (oder früher) zu überprüfen, wird eine Ausnahme ausgelöst.

HINWEIS

Weitere Informationen zum Document Security-Dienst finden Sie unter Dienstreferenz für AEM Forms.

Zusammenfassung der Schritte

So prüfen Sie ein richtliniengeschütztes PDF-Dokument:

Projektdateien einschließen.
Erstellen Sie ein Document Security Client-API-Objekt.
Rufen Sie ein richtliniengeschütztes Dokument zum Überprüfen ab.
Erhalten Sie Informationen zum richtliniengeschützten Dokument.

Projektdateien einschließen

Erstellen eines Document Security Client-API-Objekts

Bevor Sie einen Document Security-Dienstvorgang programmgesteuert durchführen können, erstellen Sie ein Client-Objekt des Document Security-Dienstes. Wenn Sie die Java-API verwenden, erstellen Sie ein RightsManagementClient -Objekt. Wenn Sie die Document Security-Webdienst-API verwenden, erstellen Sie ein RightsManagementServiceService -Objekt.

Abrufen eines richtliniengeschützten Dokuments zum Überprüfen

Rufen Sie ein richtliniengeschütztes Dokument ab, um es zu überprüfen. Wenn Sie versuchen, ein Dokument zu überprüfen, das nicht mit einer Richtlinie gesichert ist oder gesperrt ist, wird eine Ausnahme ausgelöst.

Inspect 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 bestimmen, die zum Schützen des Dokuments verwendet wird.

Wenn Sie ein Dokument mit einer Richtlinie sichern, die zu "Meine Richtlinien"gehört, und dann RMInspectResult.getPolicysetName oder RMInspectResult.getPolicysetId aufrufen, wird null zurückgegeben.

Wenn das Dokument mit einer Richtlinie gesichert wird, die in einem Richtliniensatz (außer "Meine Richtlinien") enthalten ist, geben RMInspectResult.getPolicysetName und RMInspectResult.getPolicysetId gültige Zeichenfolgen zurück.

Siehe auch

Inspect Policy Protected PDF Documents using the Java API

Inspect ein richtliniengeschütztes PDF-Dokument mithilfe der Document Security Service-API (Java):

Projektdateien einschließen.

Schließen Sie Client-JAR-Dateien wie die Datei "adobe-rightsmanagement-client.jar"in den Klassenpfad Ihres Java-Projekts ein. Weitere Informationen über den Speicherort dieser Dateien finden Sie unter Einbeziehung von AEM Forms Java-Bibliotheksdateien.
Erstellen Sie ein Document 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.
Rufen Sie ein richtliniengeschütztes Dokument zum Überprüfen ab.
- Erstellen Sie ein java.io.FileInputStream-Objekt, das das richtliniengeschützte PDF-Dokument mithilfe seines Konstruktors darstellt. Übergeben Sie einen string -Wert, 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.
Inspect das Dokument.
- Erstellen Sie ein DocumentManager -Objekt, indem Sie die getDocumentManager -Methode des Objekts RightsManagementClient aufrufen.
- Inspect das richtliniengeschützte Dokument durch Aufrufen der inspectDocument -Methode des Objekts LicenseManager. Ü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.
Erhalten Sie Informationen zum richtliniengeschützten Dokument.

Um Informationen zum richtliniengeschützten Dokument zu erhalten, rufen Sie die entsprechende Methode auf, die zum RMInspectResult -Objekt gehört. Um beispielsweise den Richtliniennamen abzurufen, rufen Sie die getPolicyName -Methode des Objekts RMInspectResult auf.

Codebeispiele

Codebeispiele, die den Document Security-Dienst verwenden, finden Sie in den folgenden Schnellstarts:

"Schnellstart (SOAP-Modus): Überprüfen richtliniengeschützter PDF-Dokumente mit der Java-API"

Inspect Policy Protected PDF Documents using the web service API

Inspect ein richtliniengeschütztes PDF-Dokument mithilfe der Document Security Service-API (Webdienst):

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.

HINWEIS

Ersetzen Sie localhost durch die IP-Adresse des Servers, auf dem AEM Forms gehostet wird.
Erstellen Sie ein Document Security Client-API-Objekt.
- Erstellen Sie ein RightsManagementServiceClient -Objekt mithilfe des Standardkonstruktors.
- Erstellen Sie ein RightsManagementServiceClient.Endpoint.Address-Objekt mit dem Konstruktor System.ServiceModel.EndpointAddress . Übergeben Sie einen string -Wert, der die WSDL an den AEM Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/RightsManagementService?WSDL). Sie müssen das Attribut lc_version nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen.)
- Erstellen Sie ein System.ServiceModel.BasicHttpBinding -Objekt, indem Sie den Wert des Felds RightsManagementServiceClient.Endpoint.Binding abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
- Setzen Sie das System.ServiceModel.BasicHttpBinding -Feld des Objekts MessageEncoding auf WSMessageEncoding.Mtom. 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 RightsManagementServiceClient.ClientCredentials.UserName.UserName den Benutzernamen des AEM Formulars zu.
  - Weisen Sie dem Feld RightsManagementServiceClient.ClientCredentials.UserName.Password den entsprechenden Kennwortwert zu.
  - Weisen Sie dem Feld BasicHttpBindingSecurity.Transport.ClientCredentialType den Konstantenwert HttpClientCredentialType.Basic zu.
- Weisen Sie dem Feld BasicHttpBindingSecurity.Security.Mode den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu.
Rufen Sie ein richtliniengeschütztes Dokument zum Überprüfen ab.
- Erstellen Sie ein Objekt BLOB, indem Sie den Konstruktor verwenden. Das BLOB-Objekt wird zum Speichern eines zu prüfenden PDF-Dokuments verwendet.
- Erstellen Sie ein System.IO.FileStream -Objekt, indem Sie seinen Konstruktor aufrufen. Übergeben Sie einen string -Wert, der den Dateispeicherort des PDF-Dokuments und den Modus zum Öffnen der Datei darstellt.
- Erstellen Sie ein Byte-Array, das den Inhalt des Objekts System.IO.FileStream speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die Length -Eigenschaft des Objekts System.IO.FileStream abrufen.
- Füllen Sie das Byte-Array mit Stream-Daten, indem Sie die Read -Methode des Objekts System.IO.FileStream aufrufen. Übergeben Sie das Byte-Array, die Startposition und die Stream-Länge zum Lesen.
- Füllen Sie das BLOB-Objekt, indem Sie sein MTOM-Feld mit dem Inhalt des Byte-Arrays zuweisen.
Inspect das Dokument.

Inspect das richtliniengeschützte Dokument durch Aufrufen der inspectDocument -Methode des Objekts RightsManagementServiceClient. Ü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.
Erhalten Sie Informationen zum richtliniengeschützten Dokument.

Um Informationen zum richtliniengeschützten Dokument zu erhalten, 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 RMInspectResult des Objekts policyName ab.

Codebeispiele

Codebeispiele, die den Document Security-Dienst verwenden, finden Sie in den folgenden Schnellstarts:

"Schnellstart (MTOM): Untersuchen richtliniengeschützter PDF-Dokumente mit der Webdienst-API"
"Schnellstart (SwaRef): Untersuchen richtliniengeschützter PDF-Dokumente mit der Webdienst-API"

Siehe auch

Erstellen von Wasserzeichen

Wasserzeichen tragen dazu bei, die Sicherheit eines Dokuments zu gewährleisten, indem sie das Dokument eindeutig identifizieren und die Verletzung des Urheberrechts kontrollieren. 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 einbeziehen. 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.

HINWEIS

Nur Benutzer mit Administratorrechten für Document 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 Document Security-Dienstes erforderlich sind.

HINWEIS

Weitere Informationen zum Document Security-Dienst finden Sie unter Dienstreferenz für AEM Forms.

Zusammenfassung der Schritte

Gehen Sie wie folgt vor, um ein Wasserzeichen zu erstellen:

Projektdateien einschließen.
Erstellen Sie ein Document Security Client-API-Objekt.
Legen Sie die Wasserzeichenattribute fest.
Registrieren Sie das Wasserzeichen beim Document Security-Dienst.

Projektdateien einschließen

Erstellen eines Document Security Client-API-Objekts

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 sind Schlüssel-Wert-Paare aufgeführt, die zum 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 Kennung 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 wahr ist, muss der Wert des benutzerdefinierten Texts 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, muss `WaterBackCmd:IS_SIZE_ENABLED` vorhanden sein und der Wert muss "true"lauten. Wenn dieses Attribut nicht angegeben ist, passt das Standardverhalten zur 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 ist. Wenn dieser Wert "true"ist, muss auch "SCALE"angegeben werden. Wenn dieser Wert false ist, passt der Standardwert zur Seite.	„True“ oder „False“
`WaterBackCmd:SRCTEXT`	Gibt den benutzerdefinierten Text für ein Wasserzeichen an. Wenn dieser Wert vorhanden ist, muss `WaterBackCmd:IS_CUSTOMTEXT_ENABLED` ebenfalls vorhanden 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 Document Security-Dienst registriert sein, bevor es verwendet werden kann. Nachdem Sie ein Wasserzeichen registriert haben, können Sie es in Richtlinien verwenden.

Siehe auch

Erstellen von Wasserzeichen mit der Java-API

Erstellen Sie mit der Document Security-API (Java) ein Wasserzeichen:

Projektdateien einschließen.

Schließen Sie Client-JAR-Dateien wie adobe-rightsmanagement-client.jar in den Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein Document 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.
Festlegen der Wasserzeichenattribute
- Erstellen Sie ein Watermark -Objekt, indem Sie die statische createWatermark -Methode des InfomodelObjectFactory -Objekts aufrufen. Diese Methode gibt ein Watermark -Objekt zurück.
- Legen Sie das Attribut name des Wasserzeichens fest, indem Sie die Methode setName des Objekts Watermark aufrufen und einen string -Wert übergeben, der den Richtliniennamen angibt.
- Legen Sie das Hintergrundattribut des Wasserzeichens fest, indem Sie die setBackground -Methode des Objekts Watermark aufrufen und true übergeben. Durch Festlegen dieses Attributs wird das Wasserzeichen im Hintergrund des Dokuments angezeigt.
- Legen Sie das benutzerdefinierte Textattribut des Wasserzeichens fest, indem Sie die setCustomText -Methode des Objekts Watermark aufrufen und einen Zeichenfolgenwert übergeben, der den Text des Wasserzeichens darstellt.
- Legen Sie das Deckkraftattribut des Wasserzeichens fest, indem Sie die setOpacity -Methode des Objekts Watermark aufrufen und einen ganzzahligen Wert übergeben, der den Deckkraftwert angibt. Der Wert 100 zeigt an, dass das Wasserzeichen vollständig undurchsichtig ist, und der Wert 0 zeigt an, dass das Wasserzeichen vollständig transparent ist.
Registrieren Sie das Wasserzeichen.
- Erstellen Sie ein WatermarkManager -Objekt, indem Sie die getWatermarkManager -Methode des Objekts RightsManagementClient aufrufen. Diese Methode gibt ein WatermarkManager -Objekt zurück.
- Registrieren Sie das Wasserzeichen, indem Sie die registerWatermark-Methode des WatermarkManager-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, die den Document Security-Dienst verwenden, finden Sie in den folgenden Schnellstarts:

"Schnellstart (SOAP-Modus): Erstellen eines Wasserzeichens mit der Java-API"

Erstellen von Wasserzeichen mit der Webdienst-API

Erstellen Sie ein Wasserzeichen mithilfe der Document Security-API (Webdienst):

Erstellen Sie ein Document 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.

HINWEIS

Ersetzen Sie localhost durch die IP-Adresse des Servers, auf dem AEM Forms gehostet wird.
Erstellen Sie ein Document Security Client-API-Objekt.
- Erstellen Sie ein RightsManagementServiceClient -Objekt mithilfe des Standardkonstruktors.
- Erstellen Sie ein RightsManagementServiceClient.Endpoint.Address-Objekt mit dem Konstruktor System.ServiceModel.EndpointAddress . Übergeben Sie einen string -Wert, der die WSDL an den AEM Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/RightsManagementService?WSDL). Sie müssen das Attribut lc_version nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen.)
- Erstellen Sie ein System.ServiceModel.BasicHttpBinding -Objekt, indem Sie den Wert des Felds RightsManagementServiceClient.Endpoint.Binding abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
- Setzen Sie das System.ServiceModel.BasicHttpBinding -Feld des Objekts MessageEncoding auf WSMessageEncoding.Mtom. 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 RightsManagementServiceClient.ClientCredentials.UserName.UserName den Benutzernamen des AEM Formulars zu.
  - Weisen Sie dem Feld RightsManagementServiceClient.ClientCredentials.UserName.Password den entsprechenden Kennwortwert zu.
  - Weisen Sie dem Feld BasicHttpBindingSecurity.Transport.ClientCredentialType den Konstantenwert HttpClientCredentialType.Basic zu.
- Weisen Sie dem Feld BasicHttpBindingSecurity.Security.Mode den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu.
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 name-Datenelement des WatermarkSpec-Objekts einen Zeichenfolgenwert zuweisen.
- Legen Sie das Attribut id des Wasserzeichens fest, indem Sie dem id-Datenelement des Objekts WatermarkSpec einen Zeichenfolgenwert zuweisen.
- Erstellen Sie für jede festzulegende Wasserzeicheneigenschaft ein separates MyMapOf_xsd_string_To_xsd_anyType_Item -Objekt.
- Legen Sie den Schlüsselwert fest, indem Sie dem key -Datenelement des Objekts MyMapOf_xsd_string_To_xsd_anyType_Item einen Wert zuweisen (z. B. WaterBackCmd:OPACITY).
- Legen Sie den Wert fest, indem Sie dem value -Datenelement des Objekts MyMapOf_xsd_string_To_xsd_anyType_Item einen Wert zuweisen (z. B. .25).
- Erstellen Sie ein MyArrayOf_xsd_anyType -Objekt. Rufen Sie für jedes MyMapOf_xsd_string_To_xsd_anyType_Item-Objekt die MyArrayOf_xsd_anyType-Methode des Objekts Add auf. Übergeben Sie das MyMapOf_xsd_string_To_xsd_anyType_Item-Objekt.
- Weisen Sie das MyArrayOf_xsd_anyType-Objekt dem WatermarkSpec-Datenelement des values-Objekts zu.
Registrieren Sie das Wasserzeichen.

Registrieren Sie das Wasserzeichen, indem Sie die registerWatermark-Methode des RightsManagementServiceClient-Objekts aufrufen und das WatermarkSpec-Objekt übergeben, das das zu registrierende Wasserzeichen darstellt.

Codebeispiele

Codebeispiele, die den Document Security-Dienst verwenden, finden Sie in den folgenden Schnellstarts:

"Schnellstart (MTOM): Erstellen eines Wasserzeichens mithilfe der Webdienst-API"
"Schnellstart (SwaRef): Erstellen eines Wasserzeichens mithilfe der Webdienst-API"

Siehe auch

Ändern von Wasserzeichen

Sie können ein vorhandenes Wasserzeichen mithilfe der Document Security Java-API oder der Web Service-API ändern. Um Änderungen an einem vorhandenen Wasserzeichen vorzunehmen, rufen Sie es ab, ändern dessen Attribute und aktualisieren Sie es dann auf dem Server. Angenommen, 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 wird. Vorhandene PDF-Dokumente, die das Wasserzeichen enthalten, sind also nicht betroffen.

HINWEIS

Nur Benutzer mit Administratorrechten für Document 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 Document Security-Dienstes erforderlich sind.

HINWEIS

Weitere Informationen zum Document Security-Dienst finden Sie unter Dienstreferenz für AEM Forms.

Zusammenfassung der Schritte

Gehen Sie wie folgt vor, um ein Wasserzeichen zu ändern:

Projektdateien einschließen.
Erstellen Sie ein Document Security Client-API-Objekt.
Rufen Sie das zu ändernde Wasserzeichen ab.
Legen Sie die Wasserzeichenattribute fest.
Aktualisieren Sie das Wasserzeichen.

Projektdateien einschließen

Erstellen eines Document Security Client-API-Objekts

Bevor Sie einen Document Security-Dienstvorgang programmgesteuert ausführen können, müssen Sie ein Client-Objekt des Document Security-Dienstes erstellen. Wenn Sie die Java-API verwenden, erstellen Sie ein DocumentSecurityClient -Objekt. Wenn Sie die Document 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 programmatischen Aktualisieren eines Wasserzeichens mithilfe eines Webdiensts müssen Sie alle ursprünglich festgelegten Attribute festlegen, auch wenn sich der Wert nicht ändert. Angenommen, die folgenden Wasserzeichenattribute sind 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 ist, müssen Sie die anderen Werte festlegen.

HINWEIS

Wenn Sie die Java-API zum Ändern eines Wasserzeichens verwenden, müssen Sie nicht alle Attribute angeben. Legen Sie das Wasserzeichenattribut fest, das Sie ändern möchten.

HINWEIS

Weitere Informationen zu den Namen der Wasserzeichenattribute finden Sie unter Erstellen von Wasserzeichen.

Aktualisieren des Wasserzeichens

Nachdem Sie die Attribute eines Wasserzeichens geändert haben, müssen Sie das Wasserzeichen aktualisieren.

Siehe auch

Wasserzeichen erstellen

Ändern von Wasserzeichen mithilfe der Java-API

Ändern Sie ein Wasserzeichen mithilfe der Document Security-API (Java):

Projektdateien einschließen.

Schließen Sie Client-JAR-Dateien wie die Datei "adobe-rightsmanagement-client.jar"in den Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein Document 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.
Rufen Sie das zu ändernde Wasserzeichen ab.

Erstellen Sie ein WatermarkManager -Objekt, indem Sie die DocumentSecurityClient -Methode des Objekts getWatermarkManager aufrufen und einen string -Wert übergeben, der den Wasserzeichennamen angibt. Diese Methode gibt ein Watermark -Objekt zurück, das das zu ändernde Wasserzeichen darstellt.
Legen Sie die Wasserzeichenattribute fest.

Legen Sie das Deckkraftattribut des Wasserzeichens fest, indem Sie die setOpacity -Methode des Objekts Watermark aufrufen und einen ganzzahligen Wert übergeben, der den Deckkraftwert angibt. Der Wert 100 zeigt an, dass das Wasserzeichen vollständig undurchsichtig ist, und der Wert 0 zeigt an, dass das Wasserzeichen vollständig transparent ist.

HINWEIS

In diesem Beispiel wird nur das Trübungsattribut geändert.
Aktualisieren Sie das Wasserzeichen.
- Aktualisieren Sie das Wasserzeichen, indem Sie die updateWatermark-Methode des WatermarkManager-Objekts aufrufen und das Watermark-Objekt übergeben, dessen Attribut geändert wurde.

Codebeispiele

Codebeispiele, die den Document Security-Dienst verwenden, finden Sie im Schnellstart-Modus (SOAP-Modus): Ändern eines Wasserzeichens mithilfe des Java-API-Abschnitts.

Ändern von Wasserzeichen mithilfe der Webdienst-API

Ändern Sie ein Wasserzeichen mithilfe der Document Security-API (Webdienst):

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.

HINWEIS

Ersetzen Sie localhost durch die IP-Adresse des Servers, auf dem AEM Forms gehostet wird.
Erstellen Sie ein Document Security Client-API-Objekt.
- Erstellen Sie ein DocumentSecurityServiceClient -Objekt mithilfe des Standardkonstruktors.
- Erstellen Sie ein RightsManagementServiceClient.Endpoint.Address-Objekt mit dem Konstruktor System.ServiceModel.EndpointAddress . Übergeben Sie einen string -Wert, der die WSDL an den AEM Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/DocumentSecurityService?WSDL). Sie müssen das Attribut lc_version nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen.)
- Erstellen Sie ein System.ServiceModel.BasicHttpBinding -Objekt, indem Sie den Wert des Felds DocumentSecurityServiceClient.Endpoint.Binding abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
- Setzen Sie das System.ServiceModel.BasicHttpBinding -Feld des Objekts MessageEncoding auf WSMessageEncoding.Mtom. 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 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName den Benutzernamen des AEM Formulars zu.
  - Weisen Sie dem Feld DocumentSecurityServiceClient.ClientCredentials.UserName.Password den entsprechenden Kennwortwert zu.
  - Weisen Sie dem Feld BasicHttpBindingSecurity.Transport.ClientCredentialType den Konstantenwert HttpClientCredentialType.Basic zu.
- Weisen Sie dem Feld BasicHttpBindingSecurity.Security.Mode den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu.
Rufen Sie das zu ändernde Wasserzeichen ab.

Rufen Sie das zu ändernde Wasserzeichen ab, indem Sie die getWatermarkByName -Methode des Objekts DocumentSecurityServiceClient aufrufen. Übergeben Sie einen string -Wert, der den Namen des Wasserzeichens angibt. Diese Methode gibt ein WatermarkSpec -Objekt zurück, das das zu ändernde Wasserzeichen darstellt.
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 key -Datenelement des Objekts MyMapOf_xsd_string_To_xsd_anyType_Item einen Wert zuweisen (z. B. WaterBackCmd:OPACITY).
- Legen Sie den Wert fest, indem Sie dem value -Datenelement des Objekts MyMapOf_xsd_string_To_xsd_anyType_Item einen Wert zuweisen (z. B. .50).
- Erstellen Sie ein MyArrayOf_xsd_anyType -Objekt. Rufen Sie für jedes MyMapOf_xsd_string_To_xsd_anyType_Item-Objekt die MyArrayOf_xsd_anyType-Methode des Objekts Add auf. Übergeben Sie das MyMapOf_xsd_string_To_xsd_anyType_Item-Objekt.
- Weisen Sie das MyArrayOf_xsd_anyType-Objekt dem WatermarkSpec-Datenelement des values-Objekts zu.
Aktualisieren Sie das Wasserzeichen.

Aktualisieren Sie das Wasserzeichen, indem Sie die updateWatermark-Methode des DocumentSecurityServiceClient-Objekts aufrufen und das WatermarkSpec-Objekt übergeben, das das zu ändernde Wasserzeichen darstellt.

Codebeispiele

Codebeispiele, die den Document Security-Dienst verwenden, finden Sie in der folgenden Kurzanleitung:

"Schnellstart (MTOM): Ändern eines Wasserzeichens mithilfe der Webdienst-API"

Suchen nach Ereignissen

Der Rights Management-Dienst verfolgt bestimmte Aktionen genau nach ihrem Ablauf, z. B. das Anwenden einer Richtlinie auf ein Dokument, das Öffnen eines richtliniengeschützten Dokuments und das Sperren des Dokumentzugriffs. Die Ereignisprüfung muss für den Rights Management-Dienst aktiviert sein, sonst werden Ereignisse nicht verfolgt.

Ereignisse fallen in eine der folgenden Kategorien:

Administrator-Ereignisse sind Aktionen, die sich auf einen Administrator beziehen, z. B. die Erstellung eines neuen Administratorkontos.
Dokumentereignisse sind Aktionen im Zusammenhang mit einem Dokument, z. B. das Schließen eines richtliniengeschützten Dokuments.
Richtlinienereignisse sind Aktionen im Zusammenhang mit einer Richtlinie, z. B. die Erstellung einer neuen Richtlinie.
Dienstereignisse 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 Web Service-API nach bestimmten Ereignissen suchen. Durch die Suche nach Ereignissen können Sie Aufgaben ausführen, z. B. eine Protokolldatei bestimmter Ereignisse erstellen.

HINWEIS

Weitere Informationen zum Rights Management-Dienst finden Sie unter Dienstreferenz für AEM Forms.

Zusammenfassung der Schritte

Um nach einem Rights Management-Ereignis zu suchen, führen Sie die folgenden Schritte aus:

Projektdateien einschließen.
Erstellen Sie ein Rights Management Client-API-Objekt.
Geben Sie das Ereignis an, nach dem gesucht werden soll.
Suchen Sie nach dem Ereignis.

Projektdateien einschließen

Erstellen eines Rights Management Client-API-Objekts

Bevor Sie einen Rights Management-Dienstvorgang programmgesteuert ausführen können, müssen Sie ein Rights Management-Dienst-Client-Objekt 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 Ereignisse an, nach denen gesucht werden soll

Sie müssen das zu suchende Ereignis angeben. Sie können beispielsweise nach dem Richtlinienerstellungsereignis suchen, das beim Erstellen einer neuen Richtlinie auftritt.

Suchen Sie nach dem Ereignis

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 Sie mithilfe der Java-API nach Ereignissen.

Suchen Sie mithilfe der Rights Management-API (Java) nach Ereignissen:

Projektdateien einschließen

Schließen Sie Client-JAR-Dateien wie adobe-rightsmanagement-client.jar in den Klassenpfad Ihres Java-Projekts ein.
Erstellen eines Rights Management Client-API-Objekts

Erstellen Sie ein DocumentSecurityClient -Objekt, indem Sie seinen Konstruktor verwenden und ein ServiceClientFactory -Objekt übergeben, das Verbindungseigenschaften enthält.
Geben Sie die Ereignisse an, nach denen gesucht werden soll
- Erstellen Sie ein EventManager -Objekt, indem Sie die getEventManager -Methode des Objekts DocumentSecurityClient aufrufen. Diese Methode gibt ein EventManager -Objekt zurück.
- Erstellen Sie ein EventSearchFilter -Objekt, indem Sie seinen Konstruktor aufrufen.
- Geben Sie das zu suchende Ereignis an, indem Sie die setEventCode -Methode des Objekts EventSearchFilter aufrufen und ein statisches Datenelement übergeben, das zur EventManager -Klasse gehört, die das zu suchende Ereignis darstellt. Um beispielsweise nach dem Richtlinienerstellungsereignis zu suchen, übergeben Sie EventManager.POLICY_CREATE_EVENT.
HINWEIS

Sie können zusätzliche Suchkriterien definieren, indem Sie EventSearchFilter -Objektmethoden aufrufen. Rufen Sie beispielsweise die Methode setUserName auf, um einen mit dem Ereignis verknüpften Benutzer anzugeben.
Suchen Sie nach dem Ereignis

Suchen Sie nach dem Ereignis, indem Sie die searchForEvents -Methode des Objekts EventManager aufrufen und das EventSearchFilter -Objekt übergeben, das die Ereignissuchkriterien definiert. Diese Methode gibt ein Array von Event -Objekten zurück.

Codebeispiele

Codebeispiele, die den Rights Management-Dienst verwenden, finden Sie in den folgenden Schnellstarts:

"Schnellstart (SOAP): Suchen nach Ereignissen mit der Java-API"

Suchen Sie mithilfe der Webdienst-API nach Ereignissen.

Suchen Sie mithilfe der Rights Management-API (Webdienst) nach Ereignissen:

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.

HINWEIS

Ersetzen Sie localhost durch die IP-Adresse des Servers, auf dem AEM Forms gehostet wird.
Erstellen eines Rights Management Client-API-Objekts
- Erstellen Sie ein DocumentSecurityServiceClient -Objekt mithilfe des Standardkonstruktors.
- Erstellen Sie ein DocumentSecurityServiceClient.Endpoint.Address-Objekt mit dem Konstruktor System.ServiceModel.EndpointAddress . Übergeben Sie einen string -Wert, der die WSDL an den AEM Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/RightsManagementService?WSDL). Sie müssen das Attribut lc_version nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen.)
- Erstellen Sie ein System.ServiceModel.BasicHttpBinding -Objekt, indem Sie den Wert des Felds DocumentSecurityServiceClient.Endpoint.Binding abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
- Setzen Sie das System.ServiceModel.BasicHttpBinding -Feld des Objekts MessageEncoding auf WSMessageEncoding.Mtom. 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 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName den Benutzernamen des AEM Formulars zu.
  - Weisen Sie dem Feld DocumentSecurityServiceClient.ClientCredentials.UserName.Password den entsprechenden Kennwortwert zu.
  - Weisen Sie dem Feld BasicHttpBindingSecurity.Transport.ClientCredentialType den Konstantenwert HttpClientCredentialType.Basic zu.
- Weisen Sie dem Feld BasicHttpBindingSecurity.Security.Mode den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu.

Geben Sie die Ereignisse an, nach denen gesucht werden soll

Erstellen Sie ein EventSpec -Objekt mithilfe des zugehörigen Konstruktors.
Geben Sie den Beginn des Zeitraums an, in dem das Ereignis auftrat, indem Sie das firstTime.date -Datenelement des EventSpec -Objekts mit der DataTime -Instanz festlegen, die den Beginn des Datumsbereichs zum Zeitpunkt des Ereignisses darstellt.
Weisen Sie den Wert true dem EventSpec-Datenelement des firstTime.dateSpecified-Objekts zu.
Geben Sie das Ende des Zeitraums an, in dem das Ereignis auftrat, indem Sie das lastTime.date -Datenelement des EventSpec -Objekts mit der DataTime -Instanz festlegen, die das Ende des Datumsbereichs zum Zeitpunkt des Ereignisses darstellt.
Weisen Sie den Wert true dem EventSpec-Datenelement des lastTime.dateSpecified-Objekts zu.
Legen Sie das zu suchende Ereignis fest, indem Sie dem eventCode-Datenelement des EventSpec-Objekts einen Zeichenfolgenwert zuweisen. In der folgenden Tabelle sind die numerischen Werte aufgeführt, 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

Suchen Sie nach dem Ereignis

Suchen Sie nach dem Ereignis, indem Sie die searchForEvents -Methode des Objekts DocumentSecurityServiceClient aufrufen und das EventSpec -Objekt übergeben, das das zu suchende Ereignis und die maximale Anzahl der Ergebnisse darstellt. 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 ein timestamp -Datenelement, das diese Informationen angibt.

Codebeispiele

Codebeispiele, die den Rights Management-Dienst verwenden, finden Sie in den folgenden Schnellstarts:

"Schnellstart (MTOM): Suchen nach Ereignissen mithilfe der Webdienst-API"
"Schnellstart (SwaRef): Suchen nach Ereignissen mithilfe der Webdienst-API"

Siehe auch

Anwenden von Richtlinien auf Word-Dokumente

Zusätzlich zu PDF-Dokumenten unterstützt der Rights Management-Dienst zusätzliche Dokumentenformate wie Microsoft Word-Dokumente (DOC-Dateien) und andere Microsoft Office-Dateiformate. Sie können beispielsweise eine Richtlinie auf ein Word-Dokument anwenden, um es zu schützen. Durch Anwendung einer Richtlinie auf ein Word-Dokument können Sie den Zugriff auf das Dokument einschränken. Sie können eine Richtlinie nicht auf ein Dokument anwenden, wenn das Dokument bereits mit einer Richtlinie gesichert ist.

Sie können die Verwendung eines richtliniengeschützten Word-Dokuments nach dessen Verteilung überwachen. Das heißt, Sie können sehen, wie das Dokument verwendet wird und wer es verwendet. Sie können zum Beispiel herausfinden, wann jemand das Dokument geöffnet hat.

HINWEIS

Weitere Informationen zum Document Security-Dienst finden Sie unter Dienstreferenz für AEM Forms.

Zusammenfassung der Schritte

So wenden Sie eine Richtlinie auf ein Word-Dokument an:

Projektdateien einschließen.
Erstellen Sie ein Document Security Client-API-Objekt.
Rufen Sie ein Word-Dokument ab, auf das eine Richtlinie angewendet wird.
Wenden Sie eine vorhandene Richtlinie auf das Word-Dokument an.
Speichern Sie das richtliniengeschützte Word-Dokument.

Projektdateien einschließen

Erstellen eines Document Security Client-API-Objekts

Bevor Sie einen Document Security-Dienstvorgang programmgesteuert ausführen können, müssen Sie ein Client-Objekt des Document Security-Dienstes erstellen.

Abrufen eines Word-Dokuments

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 Offline-Modus aktiviert, müssen die Benutzer online sein, um das Dokument zu öffnen.

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 festlegt, muss Zugriff auf die angegebene Richtlinie haben. Wenn nicht, tritt eine Ausnahme auf.

Word-Dokument speichern

Nachdem der Document Security-Dienst eine Richtlinie auf ein Word-Dokument angewendet hat, können Sie das richtliniengeschützte Word-Dokument als DOC-Datei speichern.

Siehe auch

Zugriff auf Dokumente sperren

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

Wenden Sie mithilfe der Document Security-API (Java) eine Richtlinie auf ein Word-Dokument an:

Projektdateien einschließen.

Schließen Sie Client-JAR-Dateien wie adobe-rightsmanagement-client.jar in den Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein Document 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.
Rufen Sie ein Word-Dokument ab.
- Erstellen Sie ein java.io.FileInputStream -Objekt, das das Word-Dokument darstellt, indem Sie seinen Konstruktor verwenden und einen string -Wert übergeben, der den Speicherort des Word-Dokuments angibt.
- Erstellen Sie ein com.adobe.idp.Document-Objekt, indem Sie seinen Konstruktor verwenden und das java.io.FileInputStream-Objekt übergeben.
Wenden Sie eine vorhandene Richtlinie auf das Word-Dokument an.
- Erstellen Sie ein DocumentManager -Objekt, indem Sie die getDocumentManager -Methode des Objekts DocumentSecurityClient aufrufen.
- Wenden Sie eine Richtlinie auf das Word-Dokument an, indem Sie die protectDocument -Methode des Objekts DocumentManager 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 string -Wert, der den Namen des Dokuments angibt.
  - Ein string -Wert, 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 string -Wert, der den Richtliniennamen angibt.
  - Ein string -Wert für den Namen der User Manager-Domäne des Benutzers, 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 string -Wert, der den Namen des kanonischen Benutzers des User Manager-Benutzers darstellt, 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 com.adobe.livecycle.rightsmanagement.Locale -Gebietsschema, das für die Auswahl der MS Office-Vorlage verwendet wird. Dieser Parameterwert ist optional und Sie können null angeben.
  Die protectDocument-Methode gibt ein RMSecureDocumentResult-Objekt zurück, das das richtliniengeschützte Word-Dokument enthält.
Speichern Sie das Word-Dokument.
- Rufen Sie die getProtectedDoc -Methode des Objekts RMSecureDocumentResult auf, um das richtliniengeschützte Word-Dokument abzurufen. Diese Methode gibt ein com.adobe.idp.Document -Objekt zurück.
- Erstellen Sie ein java.io.File -Objekt und stellen Sie sicher, dass die Dateierweiterung DOC ist.
- Rufen Sie die copyToFile -Methode des com.adobe.idp.Document -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, die den Document Security-Dienst verwenden, finden Sie in der folgenden Kurzanleitung:

"Schnellstart (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 mithilfe der Document Security-API (Webdienst) eine Richtlinie auf ein Word-Dokument an:

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/DocumentSecurityService?WSDL&lc_version=9.0.1.

HINWEIS

Ersetzen Sie localhost durch die IP-Adresse des Servers, auf dem AEM Forms gehostet wird.
Erstellen Sie ein Document Security Client-API-Objekt.
- Erstellen Sie ein DocumentSecurityServiceClient -Objekt mithilfe des Standardkonstruktors.
- Erstellen Sie ein DocumentSecurityServiceClient.Endpoint.Address-Objekt mit dem Konstruktor System.ServiceModel.EndpointAddress . Übergeben Sie einen string -Wert, der die WSDL an den AEM Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/DocumentSecurityService?WSDL). Sie müssen das Attribut lc_version nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen.)
- Erstellen Sie ein System.ServiceModel.BasicHttpBinding -Objekt, indem Sie den Wert des Felds DocumentSecurityServiceClient.Endpoint.Binding abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
- Setzen Sie das System.ServiceModel.BasicHttpBinding -Feld des Objekts MessageEncoding auf WSMessageEncoding.Mtom. 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 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName den Benutzernamen des AEM Formulars zu.
  - Weisen Sie dem Feld DocumentSecurityServiceClient.ClientCredentials.UserName.Password den entsprechenden Kennwortwert zu.
  - Weisen Sie dem Feld BasicHttpBindingSecurity.Transport.ClientCredentialType den Konstantenwert HttpClientCredentialType.Basic zu.
- Weisen Sie dem Feld BasicHttpBindingSecurity.Security.Mode den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu.
Rufen Sie ein Word-Dokument ab.
- Erstellen Sie ein Objekt BLOB, indem Sie den Konstruktor verwenden. Das BLOB-Objekt wird zum Speichern eines Word-Dokuments verwendet, auf das eine Richtlinie angewendet wird.
- Erstellen Sie ein System.IO.FileStream -Objekt, indem Sie seinen Konstruktor aufrufen und einen string -Wert übergeben, der den Dateispeicherort des Word-Dokuments und den Modus darstellt, in dem die Datei geöffnet werden soll.
- Erstellen Sie ein Byte-Array, das den Inhalt des Objekts System.IO.FileStream speichert. Bestimmen Sie die Größe des Byte-Arrays, indem Sie die Eigenschaft Length des Objekts System.IO.FileStream abrufen.
- Füllen Sie das Byte-Array mit Stream-Daten, indem Sie die Read -Methode des Objekts System.IO.FileStream aufrufen. Übergeben Sie das Byte-Array, die Startposition und die zu lesende Stream-Länge.
- Füllen Sie das BLOB-Objekt, indem Sie sein MTOM-Feld mit dem Inhalt des Byte-Arrays zuweisen.
Wenden Sie eine vorhandene Richtlinie auf das Word-Dokument an.

Wenden Sie eine Richtlinie auf das Word-Dokument an, indem Sie die protectDocument -Methode des Objekts DocumentSecurityServiceClient aufrufen und die folgenden Werte übergeben:
- Das BLOB-Objekt, das das Word-Dokument enthält, auf das die Richtlinie angewendet wird.
- Ein string -Wert, der den Namen des Dokuments angibt.
- Ein string -Wert, 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 string -Wert, der den Richtliniennamen angibt.
- Ein string -Wert für den Namen der User Manager-Domäne des Benutzers, 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 string -Wert, der den Namen des kanonischen Benutzers des User Manager-Benutzers darstellt, 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 string -Ausgabeparameter, der zum Speichern des Richtlinienkennungswerts verwendet wird.
- Ein string -Ausgabeparameter, der zum Speichern des richtliniengeschützten Bezeichnerwerts verwendet wird.
- Ein string -Ausgabeparameter, der zum Speichern des MIME-Typs verwendet wird (z. B. application/doc).
Die protectDocument-Methode gibt ein BLOB-Objekt zurück, das das richtliniengeschützte Word-Dokument enthält.
Speichern Sie das Word-Dokument.
- Erstellen Sie ein System.IO.FileStream -Objekt, indem Sie seinen Konstruktor aufrufen und einen string -Wert übergeben, der den Dateispeicherort des richtliniengeschützten Word-Dokuments darstellt.
- Erstellen Sie ein Byte-Array, 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 Objekts MTOM abrufen.
- Erstellen Sie ein System.IO.BinaryWriter -Objekt, indem Sie seinen Konstruktor aufrufen und das System.IO.FileStream -Objekt übergeben.
- Schreiben Sie den Inhalt des Byte-Arrays in eine Word-Datei, indem Sie die Write -Methode des Objekts System.IO.BinaryWriter aufrufen und das Byte-Array übergeben.

Codebeispiele

Codebeispiele, die den Document Security-Dienst verwenden, finden Sie in der folgenden Kurzanleitung:

"Schnellstart (MTOM): Anwenden einer Richtlinie auf ein Word-Dokument mithilfe der Webdienst-API"

Entfernen von Richtlinien aus Word-Dokumenten

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, ist es effizienter, die Richtlinie zu wechseln, anstatt die Richtlinie zu entfernen und die aktualisierte Richtlinie hinzuzufügen.

HINWEIS

Weitere Informationen zum Document Security-Dienst finden Sie unter Dienstreferenz für AEM Forms.

Zusammenfassung der Schritte

So entfernen Sie eine Richtlinie aus einem richtliniengeschützten Word-Dokument:

Projektdateien einschließen
Erstellen Sie ein Document Security Client-API-Objekt.
Rufen Sie ein richtliniengeschütztes Word-Dokument ab.
Entfernen Sie die Richtlinie aus dem Word-Dokument.
Speichern Sie die nicht gesicherten Word-Dokumente.

Projektdateien einschließen

Erstellen eines Document Security Client-API-Objekts

Bevor Sie einen Document Security-Dienstvorgang programmgesteuert durchführen können, erstellen Sie ein Client-Objekt des Document 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 verursacht.

Richtlinie aus 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 Berechtigung SWITCH_POLICY enthalten, damit eine Richtlinie aus einem Word-Dokument entfernt werden kann. Außerdem muss der in den AEM Forms-Verbindungseinstellungen angegebene Benutzer über diese Berechtigung verfügen. Andernfalls wird eine Ausnahme ausgelöst.

Ungesichertes Word-Dokument speichern

Nachdem der Document Security-Dienst eine Richtlinie aus einem Word-Dokument entfernt hat, können Sie das ungesicherte Word-Dokument als DOC-Datei speichern.

Siehe auch

Anwenden von Richtlinien auf Word-Dokumente

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

Entfernen Sie mithilfe der Document Security-API (Java) eine Richtlinie aus einem richtliniengeschützten Word-Dokument:

Projektdateien einschließen

Schließen Sie Client-JAR-Dateien wie adobe-rightsmanagement-client.jar in den Klassenpfad Ihres Java-Projekts ein.
Erstellen eines Document Security Client-API-Objekts
- Erstellen Sie ein ServiceClientFactory-" -Objekt, das Verbindungseigenschaften enthält.
- Erstellen Sie ein RightsManagementClient-Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory-Objekt übergeben.
Abrufen eines richtliniengeschützten Word-Dokuments
- Erstellen Sie ein java.io.FileInputStream-Objekt, das das richtliniengeschützte Word-Dokument darstellt, indem Sie seinen Konstruktor verwenden und einen Zeichenfolgenwert übergeben, der den Speicherort des Word-Dokuments angibt.
- Erstellen Sie ein com.adobe.idp.Document-Objekt, indem Sie seinen Konstruktor verwenden und das java.io.FileInputStream-Objekt übergeben.
Richtlinie aus Word-Dokument entfernen
- Erstellen Sie ein DocumentManager -Objekt, indem Sie die getDocumentManager -Methode des Objekts RightsManagementClient aufrufen.
- Entfernen Sie eine Richtlinie aus dem Word-Dokument, indem Sie die removeSecurity -Methode des Objekts DocumentManager aufrufen und das 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 nicht gesichertes Word-Dokument enthält.
Ungesichertes Word-Dokument speichern
- Erstellen Sie ein java.io.File -Objekt und stellen Sie sicher, dass die Dateierweiterung DOC ist.
- Rufen Sie die copyToFile -Methode des Document -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, die den Document Security-Dienst verwenden, finden Sie in der folgenden Kurzanleitung:

"Schnellstart (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 mithilfe der Document Security-API (Webdienst) eine Richtlinie aus einem richtliniengeschützten Word-Dokument:

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.

HINWEIS

Ersetzen Sie localhost durch die IP-Adresse des Servers, auf dem AEM Forms gehostet wird.
Erstellen eines Document Security Client-API-Objekts
- Erstellen Sie ein RightsManagementServiceClient -Objekt mithilfe des Standardkonstruktors.
- Erstellen Sie ein RightsManagementServiceClient.Endpoint.Address-Objekt mit dem Konstruktor System.ServiceModel.EndpointAddress . Übergeben Sie einen string -Wert, der die WSDL an den AEM Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/RightsManagementService?WSDL). Sie müssen das Attribut lc_version nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen.)
- Erstellen Sie ein System.ServiceModel.BasicHttpBinding -Objekt, indem Sie den Wert des Felds RightsManagementServiceClient.Endpoint.Binding abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
- Setzen Sie das System.ServiceModel.BasicHttpBinding -Feld des Objekts MessageEncoding auf WSMessageEncoding.Mtom. 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 RightsManagementServiceClient.ClientCredentials.UserName.UserName den Benutzernamen des AEM Formulars zu.
  - Weisen Sie dem Feld RightsManagementServiceClient.ClientCredentials.UserName.Password den entsprechenden Kennwortwert zu.
  - Weisen Sie dem Feld BasicHttpBindingSecurity.Transport.ClientCredentialType den Konstantenwert HttpClientCredentialType.Basic zu.
- Weisen Sie dem Feld BasicHttpBindingSecurity.Security.Mode den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu.
Abrufen eines richtliniengeschützten Word-Dokuments
- Erstellen Sie ein Objekt BLOB, indem Sie den Konstruktor verwenden. Das BLOB-Objekt wird zum Speichern des richtliniengeschützten Word-Dokuments verwendet, aus dem die Richtlinie entfernt wird.
- Erstellen Sie ein System.IO.FileStream -Objekt, indem Sie seinen Konstruktor aufrufen und einen string -Wert übergeben, der den Dateispeicherort des Word-Dokuments und den Modus darstellt, in dem die Datei geöffnet werden soll.
- Erstellen Sie ein Byte-Array, das den Inhalt des Objekts System.IO.FileStream speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die Length -Eigenschaft des Objekts System.IO.FileStream abrufen.
- Füllen Sie das Byte-Array mit Stream-Daten, indem Sie die Read -Methode des Objekts System.IO.FileStream aufrufen und das Byte-Array, die Startposition und die zu lesende Stream-Länge übergeben.
- Füllen Sie das BLOB-Objekt, indem Sie sein MTOM-Feld mit dem Inhalt des Byte-Arrays zuweisen.
Richtlinie aus Word-Dokument entfernen

Entfernen Sie die Richtlinie aus dem Word-Dokument, indem Sie die removePolicySecurity-Methode des Objekts RightsManagementServiceClient aufrufen und das BLOB-Objekt übergeben, das das richtliniengeschützte Word-Dokument enthält. Diese Methode gibt ein BLOB -Objekt zurück, das ein nicht gesichertes Word-Dokument enthält.
Ungesichertes Word-Dokument speichern
- Erstellen Sie ein System.IO.FileStream -Objekt, indem Sie seinen Konstruktor aufrufen und einen string -Wert übergeben, der den Dateispeicherort des ungesicherten Word-Dokuments darstellt.
- Erstellen Sie ein Byte-Array, 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 Felds BLOB des Objekts MTOM abrufen.
- Erstellen Sie ein System.IO.BinaryWriter -Objekt, indem Sie seinen Konstruktor aufrufen und das System.IO.FileStream -Objekt übergeben.

Codebeispiele

Codebeispiele, die den Document Security-Dienst verwenden, finden Sie in der folgenden Kurzanleitung:

"Schnellstart (MTOM): Entfernen einer Richtlinie aus einem Word-Dokument mithilfe der Webdienst-API"

Siehe auch