使用策略保護文檔

撤消對文檔的訪問

使用Java API將策略應用到PDF文檔

使用Document Security API(Java)將原則套用至PDF檔案：

包含專案檔案。

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-rightsmanagement-client.jar。
建立Document Security用戶端API物件。
- 建立包含連接屬性的ServiceClientFactory對象。
- 使用其建構子並傳遞ServiceClientFactory物件，以建立RightsManagementClient物件。
檢索PDF文檔。
- 使用PDF文檔的建構子建立代表PDF文檔的java.io.FileInputStream對象。傳遞指定PDF文檔位置的字串值。
- 使用其建構子並傳遞java.io.FileInputStream物件，以建立com.adobe.idp.Document物件。
將現有策略應用於PDF文檔。
- 調用RightsManagementClient對象的getDocumentManager方法，建立DocumentManager對象。
- 調用DocumentManager對象的protectDocument方法並傳遞以下值，將策略應用於PDF文檔：
  - com.adobe.idp.Document對象，包含應用策略的PDF文檔。
  - 指定文檔名稱的字串值。
  - 一個字串值，它指定策略所屬的策略集的名稱。您可以指定一個null值，該值導致使用MyPolicies策略集。
  - 指定策略名稱的字串值。
  - 一個字串值，它表示作為文檔發佈者的用戶的用戶管理域的名稱。此參數值為可選值，可為null（如果此參數為null，則下一個參數值必須為null）。
  - 一個字串值，它表示作為文檔發佈者的用戶管理器用戶的規範名稱的名稱。此參數值為選用值，可以是null（如果此參數為null，則上一個參數值必須為null）。
  - com.adobe.livecycle.rightsmanagement.Locale，表示用於選擇MS Office模板的區域設定。此參數值為可選值，不用於PDF文檔。要保護PDF文檔，請指定null。
  protectDocument方法返回包含受策略保護的PDF文檔的RMSecureDocumentResult對象。
保存PDF文檔。
- 調用RMSecureDocumentResult對象的getProtectedDoc方法以獲取受策略保護的PDF文檔。此方法會傳回com.adobe.idp.Document物件。
- 建立java.io.File物件，並確定副檔名為PDF。
- 調用com.adobe.idp.Document對象的copyToFile方法，將Document對象的內容複製到檔案（確保使用getProtectedDoc方法返回的Document對象）。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

"快速入門（EJB模式）:使用Java API將原則套用至PDF檔案」
"快速入門（SOAP模式）:使用Java API將原則套用至PDF檔案」

另請參閱

使用Web服務API將策略應用到PDF文檔

使用檔案安全性API（Web服務）將原則套用至PDF檔案：

包含專案檔案。

建立使用MTOM的Microsoft .NET項目。確保使用以下WSDL定義：http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1。

注意

將localhost取代為托管AEM Forms之伺服器的IP位址。
建立Document Security用戶端API物件。
- 使用其預設建構子建立RightsManagementServiceClient物件。
- 使用System.ServiceModel.EndpointAddress建構子建立RightsManagementServiceClient.Endpoint.Address物件。將指定WSDL的字串值傳遞到Forms服務（例如http://localhost:8080/soap/services/RightsManagementService?WSDL）。您不需要使用lc_version屬性。建立服務參考時會使用此屬性。)
- 獲取RightsManagementServiceClient.Endpoint.Binding欄位的值，建立System.ServiceModel.BasicHttpBinding對象。將傳回值轉換為BasicHttpBinding。
- 將System.ServiceModel.BasicHttpBinding物件的MessageEncoding欄位設為WSMessageEncoding.Mtom。此值可確保使用MTOM。
- 通過執行以下任務來啟用基本HTTP身份驗證：
  - 將AEM表單使用者名稱指派給欄位RightsManagementServiceClient.ClientCredentials.UserName.UserName。
  - 將相應的密碼值分配給欄位RightsManagementServiceClient.ClientCredentials.UserName.Password。
  - 將常數值HttpClientCredentialType.Basic指派給欄位BasicHttpBindingSecurity.Transport.ClientCredentialType。
- 將常數值BasicHttpSecurityMode.TransportCredentialOnly指派給欄位BasicHttpBindingSecurity.Security.Mode。
檢索PDF文檔。
- 使用其建構子建立BLOB物件。 BLOB對象用於儲存應用策略的PDF文檔。
- 通過調用其建構子並傳遞一個字串值來建立System.IO.FileStream對象，該字串值表示PDF文檔的檔案位置以及開啟檔案的模式。
- 建立儲存System.IO.FileStream對象內容的位元組陣列。通過獲取System.IO.FileStream對象的Length屬性來確定位元組陣列大小。
- 叫用System.IO.FileStream物件的Read方法，以串流資料填入位元組陣列。傳遞位元組陣列、起始位置和資料流長度以讀取。
- 為MTOM欄位指定位元組陣列的內容，以填入BLOB物件。
將現有策略應用於PDF文檔。

調用RightsManagementServiceClient對象的protectDocument方法並傳遞以下值，將策略應用於PDF文檔：
- BLOB對象，包含應用策略的PDF文檔。
- 指定文檔名稱的字串值。
- 一個字串值，它指定策略所屬的策略集的名稱。您可以指定一個null值，該值導致使用MyPolicies策略集。
- 指定策略名稱的字串值。
- 一個字串值，它表示作為文檔發佈者的用戶的用戶管理域的名稱。此參數值為可選值，可為null（如果此參數為null，則下一個參數值必須為null）。
- 一個字串值，它表示作為文檔發佈者的用戶管理器用戶的規範名稱的名稱。此參數值為可選值，可為null（如果此參數為null，則前一個參數值必須為null）。
- RMLocale值，它指定區域設定值（例如RMLocale.en）。
- 用於儲存策略標識符值的字串輸出參數。
- 用於儲存受策略保護的標識符值的字串輸出參數。
- 用於儲存mime類型的字串輸出參數（例如application/pdf）。
protectDocument方法返回包含受策略保護的PDF文檔的BLOB對象。
保存PDF文檔。
- 調用System.IO.FileStream對象的建構子並傳遞一個字串值，該字串值表示受策略保護的PDF文檔的檔案位置。
- 建立位元組陣列，用於儲存protectDocument方法返回的BLOB對象的資料內容。獲取BLOB對象的MTOM資料成員的值，以填充位元組陣列。
- 通過調用其建構子並傳遞System.IO.FileStream對象來建立System.IO.BinaryWriter對象。
- 調用System.IO.BinaryWriter對象的Write方法並傳遞位元組陣列，將位元組陣列的內容寫入PDF檔案。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

「快速入門(MTOM):使用Web服務API將原則套用至PDF檔案」
「快速入門(SwaRef):使用Web服務API將策略應用到PDF文檔」

從PDF文檔中刪除策略

可以從受策略保護的文檔中刪除策略，以便從文檔中刪除安全性。也就是說，如果您不再希望該文檔受策略保護。如果要使用較新的策略更新受策略保護的文檔，則不刪除該策略並添加更新的策略，切換該策略會更加有效。

注意

有關Document Security服務的詳細資訊，請參閱AEM Forms的服務參考。

步驟的摘要

要從受策略保護的PDF文檔中刪除策略，請執行以下步驟：

包含項目檔案
建立Document Security用戶端API物件。
檢索受策略保護的PDF文檔。
從PDF文檔中刪除策略。
儲存不安全的PDF檔案。

包含項目檔案

在您的開發專案中加入必要的檔案。如果您使用Java建立客戶端應用程式，請包括必要的JAR檔案。如果您使用Web服務，請確定您包含Proxy檔案。

建立Document Security用戶端API物件

在以寫程式方式執行Document Security服務操作之前，請建立Document Security服務客戶端對象。

檢索受策略保護的PDF文檔

您可以檢索受策略保護的PDF文檔以刪除策略。如果嘗試從未受策略保護的PDF文檔中刪除策略，將導致異常。

從PDF文檔中刪除策略

如果在連接設定中指定了管理員，則可以從受策略保護的PDF文檔中刪除策略。否則，用於保護文檔的策略必須包含SWITCH_POLICY權限，才能從PDF文檔中刪除策略。此外，在AEM Forms連線設定中指定的使用者也必須擁有該權限。否則，會擲回例外。

儲存不安全的PDF檔案

檔案安全性服務從PDF檔案移除原則後，您可以將不安全的PDF檔案儲存為PDF檔案。

另請參閱

使用Java API從PDF文檔中刪除策略

使用Document Security API(Java)從受原則保護的PDF檔案中移除原則：

包含專案檔案。

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-rightsmanagement-client.jar。
建立Document Security用戶端API物件。
- 建立包含連接屬性的ServiceClientFactory對象。
- 使用其建構子並傳遞ServiceClientFactory物件，以建立DocumentSecurityClient物件。
檢索受策略保護的PDF文檔。
- 使用其建構子並傳遞指定PDF文檔位置的字串值，建立代表受策略保護的PDF文檔的java.io.FileInputStream對象。
- 使用其建構子並傳遞java.io.FileInputStream物件，以建立com.adobe.idp.Document物件。
從PDF文檔中刪除策略。
- 調用DocumentSecurityClient對象的getDocumentManager方法，建立DocumentManager對象。
- 調用DocumentManager對象的removeSecurity方法並傳遞包含受策略保護的PDF文檔的com.adobe.idp.Document對象，從PDF文檔中刪除策略。此方法會傳回com.adobe.idp.Document物件，其中包含不安全的PDF檔案。
儲存不安全的PDF檔案。
- 建立java.io.File物件，並確定副檔名為PDF。
- 調用Document對象的copyToFile方法，將Document對象的內容複製到檔案（確保使用removeSecurity方法返回的Document對象）。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

"快速入門（SOAP模式）:使用Java API從PDF檔案中移除原則」

使用Web服務API刪除策略

使用Document Security API（web服務）從受原則保護的PDF檔案中移除原則：

包含專案檔案。

建立使用MTOM的Microsoft .NET項目。確保使用以下WSDL定義：http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1。

注意

將localhost取代為托管AEM Forms之伺服器的IP位址。
建立Document Security用戶端API物件。
- 使用其預設建構子建立DocumentSecurityServiceClient物件。
- 使用System.ServiceModel.EndpointAddress建構子建立DocumentSecurityServiceClient.Endpoint.Address物件。將指定WSDL的字串值傳遞到AEM Forms服務（例如http://localhost:8080/soap/services/RightsManagementService?WSDL）。您不需要使用lc_version屬性。建立服務參考時會使用此屬性。)
- 獲取DocumentSecurityServiceClient.Endpoint.Binding欄位的值，建立System.ServiceModel.BasicHttpBinding對象。將傳回值轉換為BasicHttpBinding。
- 將System.ServiceModel.BasicHttpBinding物件的MessageEncoding欄位設為WSMessageEncoding.Mtom。此值可確保使用MTOM。
- 通過執行以下任務來啟用基本HTTP身份驗證：
  - 將AEM表單使用者名稱指派給欄位DocumentSecurityServiceClient.ClientCredentials.UserName.UserName。
  - 將相應的密碼值分配給欄位DocumentSecurityServiceClient.ClientCredentials.UserName.Password。
  - 將常數值HttpClientCredentialType.Basic指派給欄位BasicHttpBindingSecurity.Transport.ClientCredentialType。
- 將常數值BasicHttpSecurityMode.TransportCredentialOnly指派給欄位BasicHttpBindingSecurity.Security.Mode。
檢索受策略保護的PDF文檔。
- 使用其建構子建立BLOB物件。 BLOB對象用於儲存從中刪除策略的受策略保護的PDF文檔。
- 通過調用其建構子並傳遞一個字串值來建立System.IO.FileStream對象，該字串值表示PDF文檔的檔案位置以及開啟檔案的模式。
- 建立儲存System.IO.FileStream對象內容的位元組陣列。通過獲取System.IO.FileStream對象的Length屬性，可以確定位元組陣列的大小。
- 調用System.IO.FileStream對象的Read方法並傳遞要讀取的位元組陣列、啟動位置和流長度，以流資料填充位元組陣列。
- 為MTOM欄位指定位元組陣列的內容，以填入BLOB物件。
從PDF文檔中刪除策略。

調用DocumentSecurityServiceClient對象的removePolicySecurity方法並傳遞包含受策略保護的PDF文檔的BLOB對象，從PDF文檔中刪除策略。此方法會傳回BLOB物件，其中包含不安全的PDF檔案。
儲存不安全的PDF檔案。
- 調用System.IO.FileStream對象的建構子並傳遞一個字串值，該字串值表示不安全PDF文檔的檔案位置。
- 建立位元組陣列，用於儲存removePolicySecurity方法返回的BLOB對象的資料內容。獲取BLOB對象的MTOM欄位的值，填入位元組陣列。
- 通過調用其建構子並傳遞System.IO.FileStream對象來建立System.IO.BinaryWriter對象。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

「快速入門(MTOM):使用Web服務API從PDF文檔中刪除策略」
「快速入門(SwaRef):使用Web服務API從PDF檔案中移除原則」

另請參閱

撤消對文檔的訪問

您可以撤消對受策略保護的PDF文檔的訪問，導致用戶無法訪問該文檔的所有副本。當使用者嘗試開啟已撤銷的PDF檔案時，系統會將他們重新導向至指定的URL，以便檢視已修訂的檔案。必須以程式設計方式指定使用者重新導向的URL。當您撤銷對文檔的訪問權時，此更改將在用戶下次通過聯機開啟受策略保護的文檔與文檔安全服務同步時生效。

撤銷對文檔的訪問權的能力提供了額外的安全性。例如，假設文檔有較新版本，並且您不再希望任何人查看過期版本。在這種情況下，可以撤銷對舊文檔的訪問，除非恢復訪問，否則任何人都無法查看該文檔。

注意

有關Document Security服務的詳細資訊，請參閱AEM Forms的服務參考。

步驟的摘要

要撤銷受策略保護的文檔，請執行以下步驟：

包含專案檔案。
建立Document Security用戶端API物件。
檢索受策略保護的PDF文檔。
撤消受策略保護的文檔。

包含項目檔案

在您的開發專案中加入必要的檔案。如果您使用Java建立客戶端應用程式，請包括必要的JAR檔案。如果您使用Web服務，請確定您包含Proxy檔案。

建立Document Security用戶端API物件

在以寫程式方式執行Document Security服務操作之前，必須建立Document Security服務客戶端對象。

檢索受策略保護的PDF文檔

必須檢索受策略保護的PDF文檔才能撤銷它。不能撤消已撤銷或不是受策略保護的文檔。

如果您知道受策略保護文檔的許可證標識符值，則不需要檢索受策略保護的PDF文檔。但是，在大多數情況下，您需要檢索PDF文檔才能獲得許可證標識符值。

撤消受策略保護的文檔

要撤銷受策略保護的文檔，請指定受策略保護文檔的許可證標識符。此外，您還可以指定當用戶嘗試開啟撤消的文檔時可以查看的文檔的URL。也就是說，假設已過時的檔案被撤銷。當用戶嘗試開啟已撤銷的文檔時，他們將看到更新的文檔，而不是已撤銷的文檔。

注意

如果嘗試撤消已撤消的文檔，則會引發異常。

另請參閱

恢復對已撤銷文檔的訪問

使用Java API撤消對文檔的訪問

使用Document Security API(Java)撤銷對受原則保護PDF檔案的存取權：

包含項目檔案

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-rightsmanagement-client.jar。
建立Document Security用戶端API物件
- 建立包含連接屬性的ServiceClientFactory對象。
- 使用其建構子並傳遞ServiceClientFactory物件，以建立DocumentSecurityClient物件。
檢索受策略保護的PDF文檔
- 使用其建構子並傳遞指定PDF文檔位置的字串值，建立java.io.FileInputStream對象，該對象表示受策略保護的PDF文檔。
- 使用其建構子並傳遞java.io.FileInputStream物件，以建立com.adobe.idp.Document物件。
撤消受策略保護的文檔
- 調用DocumentSecurityClient對象的getDocumentManager方法，建立DocumentManager對象。
- 調用DocumentManager對象的getLicenseId方法，檢索受策略保護文檔的許可證標識符值。傳遞代表受策略保護文檔的com.adobe.idp.Document對象。此方法會傳回代表授權識別碼值的字串值。
- 調用DocumentSecurityClient對象的getLicenseManager方法，建立LicenseManager對象。
- 調用LicenseManager對象的revokeLicense方法並傳遞以下值，撤消受策略保護的文檔：
  - 一個字串值，它指定受策略保護文檔的許可證標識符值（指定DocumentManager對象getLicenseId方法的返回值）。
  - License介面的靜態資料成員，它指定撤消文檔的原因。例如，您可以指定License.DOCUMENT_REVISED。
  - java.net.URL值，指定修訂文檔的位置。如果您不想將使用者重新導向至其他URL，則可以傳遞null。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

"快速入門（SOAP模式）:使用Java API撤銷文檔」

使用Web服務API撤消對文檔的訪問

使用Document Security API（web服務）撤銷對受策略保護的PDF文檔的訪問：

包含項目檔案

建立使用MTOM的Microsoft .NET項目。確保使用以下WSDL定義：http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1。

注意

將localhost取代為托管AEM Forms之伺服器的IP位址。
建立Document Security用戶端API物件
- 使用其預設建構子建立DocumentSecurityServiceClient物件。
- 使用System.ServiceModel.EndpointAddress建構子建立DocumentSecurityServiceClient.Endpoint.Address物件。將指定WSDL的字串值傳遞到AEM Forms服務（例如http://localhost:8080/soap/services/RightsManagementService?WSDL）。您不需要使用lc_version屬性。建立服務參考時會使用此屬性。)
- 獲取DocumentSecurityServiceClient.Endpoint.Binding欄位的值，建立System.ServiceModel.BasicHttpBinding對象。將傳回值轉換為BasicHttpBinding。
- 將System.ServiceModel.BasicHttpBinding物件的MessageEncoding欄位設為WSMessageEncoding.Mtom。此值可確保使用MTOM。
- 通過執行以下任務來啟用基本HTTP身份驗證：
  - 將AEM表單使用者名稱指派給欄位DocumentSecurityServiceClient.ClientCredentials.UserName.UserName。
  - 將相應的密碼值分配給欄位DocumentSecurityServiceClient.ClientCredentials.UserName.Password。
  - 將常數值HttpClientCredentialType.Basic指派給欄位BasicHttpBindingSecurity.Transport.ClientCredentialType。
- 將常數值BasicHttpSecurityMode.TransportCredentialOnly指派給欄位BasicHttpBindingSecurity.Security.Mode。
檢索受策略保護的PDF文檔
- 使用其建構子建立BLOB物件。 BLOB對象用於儲存被撤銷的受策略保護的PDF文檔。
- 通過調用其建構子並傳遞一個字串值來建立System.IO.FileStream對象，該字串值表示要撤銷的策略保護PDF文檔的檔案位置以及開啟檔案的模式。
- 建立儲存System.IO.FileStream對象內容的位元組陣列。通過獲取System.IO.FileStream對象的Length屬性，可以確定位元組陣列的大小。
- 調用System.IO.FileStream對象的Read方法並傳遞要讀取的位元組陣列、啟動位置和流長度，以流資料填充位元組陣列。
- 為MTOM欄位指定位元組陣列的內容，以填入BLOB物件。
撤消受策略保護的文檔
- 通過調用DocumentSecurityServiceClient對象的getLicenseID方法並傳遞代表受策略保護文檔的BLOB對象來檢索受策略保護文檔的許可證標識符值。此方法會傳回代表授權識別碼的字串值。
- 調用DocumentSecurityServiceClient對象的revokeLicense方法並傳遞以下值，撤消受策略保護的文檔：
  - 一個字串值，它指定受策略保護文檔的許可證標識符值（指定DocumentSecurityServiceService對象getLicenseId方法的返回值）。
  - Reason枚舉的靜態資料成員，它指定撤消文檔的原因。例如，您可以指定Reason.DOCUMENT_REVISED。
  - string值，指定修訂文檔所在的URL位置。如果您不想將使用者重新導向至其他URL，則可以傳遞null。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

「快速入門(MTOM):使用Web服務API撤消文檔」
「快速入門(SwaRef):使用Web服務API撤消文檔」

另請參閱

從Word文檔中刪除策略

恢復對已撤銷文檔的訪問

您可以恢復對已撤銷PDF文檔的訪問權，使用者可以訪問已撤消文檔的所有副本。當用戶開啟被撤消的恢復文檔時，用戶可以查看該文檔。

注意

有關Document Security服務的詳細資訊，請參閱AEM Forms的服務參考。

步驟的摘要

要恢復對已撤銷的PDF文檔的訪問，請執行以下步驟：

包含專案檔案。
建立Document Security用戶端API物件。
檢索已撤銷的PDF文檔的許可證標識符。
恢復對已撤銷PDF文檔的訪問。

包含項目檔案

在您的開發專案中加入必要的檔案。如果您使用Java建立客戶端應用程式，請包括必要的JAR檔案。如果您使用Web服務，請確定您包含Proxy檔案。

建立Document Security用戶端API物件

在以寫程式方式執行Document Security服務操作之前，必須建立Document Security服務客戶端對象。如果您使用Java API，請建立DocumentSecurityClient物件。如果您使用Document Security Web服務API，請建立DocumentSecurityServiceService物件。

檢索已撤銷的PDF文檔的許可證標識符

您必須檢索已撤銷PDF文檔的許可證標識符，才能恢復已撤銷的PDF文檔。獲取許可證標識符值後，可以恢復已撤銷的文檔。如果嘗試恢復未撤銷的文檔，將導致異常。

恢復對已撤銷PDF文檔的訪問

要恢復對已撤銷PDF文檔的訪問，必須指定已撤銷文檔的許可標識符。如果嘗試恢復未撤銷的PDF文檔的訪問權，將導致異常。

另請參閱

撤消對文檔的訪問

使用Java API恢復對已撤銷文檔的訪問

使用文檔安全API(Java)恢復對已撤銷文檔的訪問：

包含專案檔案。

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-rightsmanagement-client.jar。
建立Document Security用戶端API物件。
- 建立包含連接屬性的ServiceClientFactory對象。
- 使用其建構子並傳遞ServiceClientFactory物件，以建立DocumentSecurityClient物件。
檢索已撤銷的PDF文檔的許可證標識符。
- 使用其建構子並傳遞指定PDF文檔位置的字串值，建立代表已撤銷PDF文檔的java.io.FileInputStream對象。
- 使用其建構子並傳遞java.io.FileInputStream物件，以建立com.adobe.idp.Document物件。
- 調用DocumentSecurityClient對象的getDocumentManager方法，建立DocumentManager對象。
- 調用DocumentManager對象的getLicenseId方法並傳遞代表撤銷文檔的com.adobe.idp.Document對象，檢索撤銷文檔的許可標識符值。此方法會傳回代表授權識別碼的字串值。
恢復對已撤銷PDF文檔的訪問。
- 調用DocumentSecurityClient對象的getLicenseManager方法，建立LicenseManager對象。
- 調用LicenseManager對象的unrevokeLicense方法並傳遞已撤銷文檔的許可證標識符值，恢復對已撤銷PDF文檔的訪問。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

"快速入門（SOAP模式）:使用Web服務API恢復對已撤銷文檔的訪問」

使用Web服務API恢復對已撤銷文檔的訪問

使用文檔安全API（Web服務）恢復對已撤銷文檔的訪問：

包含專案檔案。

建立使用MTOM的Microsoft .NET項目。確保使用以下WSDL定義：http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1。

注意

將localhost取代為托管AEM Forms之伺服器的IP位址。
建立Document Security用戶端API物件。
- 使用其預設建構子建立DocumentSecurityServiceClient物件。
- 使用System.ServiceModel.EndpointAddress建構子建立DocumentSecurityServiceClient.Endpoint.Address物件。將指定WSDL的字串值傳遞到AEM Forms服務（例如http://localhost:8080/soap/services/RightsManagementService?WSDL）。您不需要使用lc_version屬性。建立服務參考時會使用此屬性。)
- 獲取DocumentSecurityServiceClient.Endpoint.Binding欄位的值，建立System.ServiceModel.BasicHttpBinding對象。將傳回值轉換為BasicHttpBinding。
- 將System.ServiceModel.BasicHttpBinding物件的MessageEncoding欄位設為WSMessageEncoding.Mtom。此值可確保使用MTOM。
- 通過執行以下任務來啟用基本HTTP身份驗證：
  - 將AEM表單使用者名稱指派給欄位DocumentSecurityServiceClient.ClientCredentials.UserName.UserName。
  - 將相應的密碼值分配給欄位DocumentSecurityServiceClient.ClientCredentials.UserName.Password。
  - 將常數值HttpClientCredentialType.Basic指派給欄位BasicHttpBindingSecurity.Transport.ClientCredentialType。
- 將常數值BasicHttpSecurityMode.TransportCredentialOnly指派給欄位BasicHttpBindingSecurity.Security.Mode。
檢索已撤銷的PDF文檔的許可證標識符。
- 使用其建構子建立BLOB物件。 BLOB對象用於儲存撤消的PDF文檔，該文檔將恢復訪問。
- 通過調用其建構子並傳遞一個字串值來建立System.IO.FileStream對象，該字串值表示已撤銷的PDF文檔的檔案位置以及開啟檔案的模式。
- 建立儲存System.IO.FileStream對象內容的位元組陣列。通過獲取System.IO.FileStream對象的Length屬性，可以確定位元組陣列的大小。
- 調用System.IO.FileStream對象的Read方法並傳遞要讀取的位元組陣列、啟動位置和流長度，以流資料填充位元組陣列。
- 為MTOM欄位指定位元組陣列的內容，以填入BLOB物件。
恢復對已撤銷PDF文檔的訪問。
- 調用DocumentSecurityServiceClient對象的getLicenseID方法並傳遞代表撤銷文檔的BLOB對象，檢索撤銷文檔的許可標識符值。此方法會傳回代表授權識別碼的字串值。
- 調用DocumentSecurityServiceClient對象的unrevokeLicense方法並傳遞一個字串值，該字串值指定已撤銷的PDF文檔的許可證標識符值（傳遞DocumentSecurityServiceClient對象的getLicenseId方法的返回值），以恢復對已撤銷的PDF文檔的訪問。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

「快速入門(MTOM):使用Web服務API恢復對已撤銷文檔的訪問」
「快速入門(SwaRef):使用Web服務API恢復對已撤銷文檔的訪問」

另請參閱

檢查受策略保護的PDF文檔

您可以使用Document Security Service API（Java和Web服務）來檢查受原則保護的PDF檔案。檢查受原則保護的PDF檔案時，會傳回受原則保護PDF檔案的相關資訊。例如，您可以確定用於保護文檔的策略以及保護文檔的日期。

如果您的LiveCycle版本為8.x或更早版本，則無法執行此任務。 AEM Forms中新增了檢查受原則保護檔案的支援。如果嘗試使用LiveCycle8.x（或更早版本）檢查受策略保護的文檔，則會引發異常。

注意

有關Document Security服務的詳細資訊，請參閱AEM Forms的服務參考。

步驟的摘要

要檢查受策略保護的PDF文檔，請執行以下步驟：

包含專案檔案。
建立Document Security用戶端API物件。
檢索要檢查的受策略保護的文檔。
獲取有關受策略保護文檔的資訊。

包含項目檔案

在您的開發專案中加入必要的檔案。如果要使用Java建立客戶端應用程式，請包括必要的JAR檔案。如果您使用Web服務，請務必包含Proxy檔案。

建立Document Security用戶端API物件

在以寫程式方式執行Document Security服務操作之前，請建立Document Security服務客戶端對象。如果您使用Java API，請建立RightsManagementClient物件。如果您使用Document Security Web服務API，請建立RightsManagementServiceService物件。

檢索受策略保護的文檔以檢查

要檢查受策略保護的文檔，請檢索它。如果嘗試檢查未通過策略進行保護或被撤銷的文檔，則會引發異常。

Inspect檔案

檢索受策略保護的文檔後，可以檢查它。

獲取有關受策略保護文檔的資訊

檢查受策略保護的PDF文檔後，可以獲取有關該文檔的資訊。例如，您可以確定用於保護文檔的策略。

如果使用屬於「我的策略」的策略保護文檔，然後調用RMInspectResult.getPolicysetName或RMInspectResult.getPolicysetId，則返回null。

如果使用策略集中包含的策略（「我的策略」除外）保護文檔，則RMInspectResult.getPolicysetName和RMInspectResult.getPolicysetId將返回有效的字串。

另請參閱

Inspect使用Java API受原則保護的PDF文檔

Inspect是受原則保護的PDF檔案，使用檔案安全性服務API(Java):

包含專案檔案。

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-rightsmanagement-client.jar。有關這些檔案的位置資訊，請參閱包含AEM Forms Java庫檔案。
建立Document Security用戶端API物件。
- 建立包含連接屬性的ServiceClientFactory對象。（請參閱設定連接屬性。）
- 使用其建構子並傳遞ServiceClientFactory物件，以建立RightsManagementClient物件。
檢索要檢查的受策略保護的文檔。
- 使用其建構子建立java.io.FileInputStream物件，以表示受原則保護的PDF檔案。傳遞指定PDF文檔位置的字串值。
- 使用其建構子並傳遞java.io.FileInputStream物件，以建立com.adobe.idp.Document物件。
Inspect檔案。
- 調用RightsManagementClient對象的getDocumentManager方法，建立DocumentManager對象。
- 通過調用LicenseManager對象的inspectDocument方法來Inspect受策略保護的文檔。傳遞包含受策略保護的PDF文檔的com.adobe.idp.Document對象。此方法返回一個RMInspectResult對象，該對象包含有關受策略保護文檔的資訊。
獲取有關受策略保護文檔的資訊。

要獲取有關受策略保護文檔的資訊，請調用屬於RMInspectResult對象的適當方法。例如，要檢索策略名稱，請調用RMInspectResult對象的getPolicyName方法。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

"快速入門（SOAP模式）:使用Java API檢查受原則保護的PDF檔案」

Inspect使用Web服務API的受策略保護的PDF文檔

Inspect是受原則保護的PDF檔案，使用檔案安全性服務API（網站服務）:

包含專案檔案。

建立使用MTOM的Microsoft .NET項目。確保使用以下WSDL定義：http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1。

注意

將localhost取代為托管AEM Forms之伺服器的IP位址。
建立Document Security用戶端API物件。
- 使用其預設建構子建立RightsManagementServiceClient物件。
- 使用System.ServiceModel.EndpointAddress建構子建立RightsManagementServiceClient.Endpoint.Address物件。將指定WSDL的字串值傳遞到AEM Forms服務（例如http://localhost:8080/soap/services/RightsManagementService?WSDL）。您不需要使用lc_version屬性。建立服務參考時會使用此屬性。)
- 獲取RightsManagementServiceClient.Endpoint.Binding欄位的值，建立System.ServiceModel.BasicHttpBinding對象。將傳回值轉換為BasicHttpBinding。
- 將System.ServiceModel.BasicHttpBinding物件的MessageEncoding欄位設為WSMessageEncoding.Mtom。此值可確保使用MTOM。
- 通過執行以下任務來啟用基本HTTP身份驗證：
  - 將AEM表單使用者名稱指派給欄位RightsManagementServiceClient.ClientCredentials.UserName.UserName。
  - 將相應的密碼值分配給欄位RightsManagementServiceClient.ClientCredentials.UserName.Password。
  - 將常數值HttpClientCredentialType.Basic指派給欄位BasicHttpBindingSecurity.Transport.ClientCredentialType。
- 將常數值BasicHttpSecurityMode.TransportCredentialOnly指派給欄位BasicHttpBindingSecurity.Security.Mode。
檢索要檢查的受策略保護的文檔。
- 使用其建構子建立BLOB物件。 BLOB對象用於儲存要檢查的PDF文檔。
- 調用System.IO.FileStream對象的建構子以建立對象。傳遞一個字串值，該字串值表示PDF文檔的檔案位置，並傳遞在中開啟檔案的模式。
- 建立儲存System.IO.FileStream對象內容的位元組陣列。通過獲取System.IO.FileStream對象的Length屬性，可以確定位元組陣列的大小。
- 叫用System.IO.FileStream物件的Read方法，以串流資料填入位元組陣列。傳遞位元組陣列、起始位置和資料流長度以讀取。
- 為MTOM欄位指定位元組陣列的內容，以填入BLOB物件。
Inspect檔案。

通過調用RightsManagementServiceClient對象的inspectDocument方法來Inspect受策略保護的文檔。傳遞包含受策略保護的PDF文檔的BLOB對象。此方法返回一個RMInspectResult對象，該對象包含有關受策略保護文檔的資訊。
獲取有關受策略保護文檔的資訊。

要獲取有關受策略保護文檔的資訊，請獲取屬於RMInspectResult對象的相應欄位的值。例如，要檢索策略名稱，請獲取RMInspectResult對象的policyName欄位的值。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

「快速入門(MTOM):使用Web服務API檢查受原則保護的PDF文檔」
「快速入門(SwaRef):使用Web服務API檢查受原則保護的PDF文檔」

另請參閱

建立水印

水印通過唯一地識別文檔和控製版權侵權來幫助確保文檔的安全。例如，您可以建立並放置一個水印，該水印在文檔的所有頁面上都指明「機密」。建立浮水印後，您可以將其納入策略。也就是說，可以使用新建立的水印來設定策略的水印屬性。將包含水印的策略應用到文檔後，該水印將出現在受策略保護的文檔中。

注意

只有具有Document Security管理權限的用戶才能建立水印。也就是說，在定義建立Document Security服務客戶端對象所需的連接設定時，必須指定這樣的用戶。

注意

有關Document Security服務的詳細資訊，請參閱AEM Forms的服務參考。

步驟的摘要

要建立水印，請執行以下步驟：

包含專案檔案。
建立Document Security用戶端API物件。
設定水印屬性。
向Document Security服務註冊水印。

包含項目檔案

在您的開發專案中加入必要的檔案。如果您使用Java建立客戶端應用程式，請包括必要的JAR檔案。如果您使用Web服務，請確定您包含Proxy檔案。

建立Document Security用戶端API物件

設定水印屬性

要建立新水印，必須設定水印屬性。必須始終定義name屬性。除了name屬性之外，您至少必須設定以下屬性之一：

自訂文字
DateIncluded
UserIdIncluded
UserNameIncluded

下表列出使用網站服務建立浮水印時所需的索引鍵和值組。

金鑰名稱	說明	值
`WaterBackCmd:IS_USERNAME_ENABLED`	指定開啟文檔的用戶的用戶名是否屬於水印的一部分。	True或False
`WaterBackCmd:IS_USERID_ENABLED`	指定開啟文檔的用戶的標識是否屬於水印的一部分。	True或False
`WaterBackCmd:IS_CURRENTDATE_ENABLED`	指定當前日期是否是水印的一部分。	True或False
`WaterBackCmd:IS_CUSTOMTEXT_ENABLED`	如果此值為true，則必須使用`WaterBackCmd:SRCTEXT`指定自訂文字的值。	True或False
`WaterBackCmd:OPACITY`	指定水印的不透明度。如果未指定，則預設值為0.5。	介於0.0和1.0之間的值。
`WaterBackCmd:ROTATION`	指定水印的旋轉。預設值為0度。	介於0到359之間的值。
`WaterBackCmd:SCALE`	如果指定了此值，則`WaterBackCmd:IS_SIZE_ENABLED`必須存在，且值必須為true。如果未指定此屬性，則預設行為適合頁面。	大於0.0且小於或等於1.0的值。
`WaterBackCmd:HORIZ_ALIGN`	指定水印的水準對齊方式。預設值為中心。	左、中或右
`WaterBackCmd:VERT_ALIGN`	指定水印的垂直對齊方式。預設值為中心。	頂部、中間或底部
`WaterBackCmd:IS_USE_BACKGROUND`	指定水印是否為背景。預設值為false。	True或False
`WaterBackCmd:IS_SIZE_ENABLED`	如果指定自訂比例，則為true。如果此值為true，則還必須指定SCALE。如果此值為false，則預設值適合頁面大小。	True或False
`WaterBackCmd:SRCTEXT`	指定浮水印的自定義文本。如果此值存在，則`WaterBackCmd:IS_CUSTOMTEXT_ENABLED`也必須存在，並設為true。	True或False

所有水印都必須定義以下屬性之一：

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

所有其他屬性均為選用。

註冊水印

必須先向Document Security服務註冊新水印，才能使用。註冊水印後，可以在策略中使用它。

另請參閱

使用Java API建立水印

使用Document Security API(Java)建立浮水印：

包含專案檔案。

在Java項目的類路徑中包含客戶端JAR檔案，如adobe-rightsmanagement-client.jar。
建立Document Security用戶端API物件。
- 建立包含連接屬性的ServiceClientFactory對象。
- 使用其建構子並傳遞ServiceClientFactory物件，以建立RightsManagementClient物件。
設定浮水印屬性
- 調用InfomodelObjectFactory對象的靜態createWatermark方法，建立Watermark對象。此方法會傳回Watermark物件。
- 調用Watermark對象的setName方法並傳遞指定策略名稱的字串值，以設定水印的名稱屬性。
- 調用Watermark對象的setBackground方法並傳遞true來設定水印的背景屬性。通過設定此屬性，水印將出現在文檔的背景中。
- 調用Watermark對象的setCustomText方法並傳遞表示水印文本的字串值，以設定水印的自定義文本屬性。
- 調用Watermark對象的setOpacity方法並傳遞指定不透明度級別的整數值，以設定水印的不透明度屬性。值100表示水印完全不透明，值0表示水印完全透明。
註冊水印。
- 調用RightsManagementClient對象的getWatermarkManager方法，建立WatermarkManager對象。此方法會傳回WatermarkManager物件。
- 通過調用WatermarkManager對象的registerWatermark方法並傳遞表示要註冊的水印的Watermark對象來註冊水印。此方法會傳回一個字串值，代表浮水印的識別值。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

"快速入門（SOAP模式）:使用Java API建立浮水印"

使用Web服務API建立水印

使用Document Security API（web服務）建立浮水印：

建立Document Security用戶端API物件。

建立使用MTOM的Microsoft .NET項目。確保使用以下WSDL定義：http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1。

注意

將localhost取代為托管AEM Forms之伺服器的IP位址。
建立Document Security用戶端API物件。
- 使用其預設建構子建立RightsManagementServiceClient物件。
- 使用System.ServiceModel.EndpointAddress建構子建立RightsManagementServiceClient.Endpoint.Address物件。將指定WSDL的字串值傳遞到AEM Forms服務（例如http://localhost:8080/soap/services/RightsManagementService?WSDL）。您不需要使用lc_version屬性。建立服務參考時會使用此屬性。)
- 獲取RightsManagementServiceClient.Endpoint.Binding欄位的值，建立System.ServiceModel.BasicHttpBinding對象。將傳回值轉換為BasicHttpBinding。
- 將System.ServiceModel.BasicHttpBinding物件的MessageEncoding欄位設為WSMessageEncoding.Mtom。此值可確保使用MTOM。
- 通過執行以下任務來啟用基本HTTP身份驗證：
  - 將AEM表單使用者名稱指派給欄位RightsManagementServiceClient.ClientCredentials.UserName.UserName。
  - 將相應的密碼值分配給欄位RightsManagementServiceClient.ClientCredentials.UserName.Password。
  - 將常數值HttpClientCredentialType.Basic指派給欄位BasicHttpBindingSecurity.Transport.ClientCredentialType。
- 將常數值BasicHttpSecurityMode.TransportCredentialOnly指派給欄位BasicHttpBindingSecurity.Security.Mode。
設定浮水印屬性。
- 調用WatermarkSpec建構子以建立WatermarkSpec對象。
- 通過為WatermarkSpec對象的name資料成員分配字串值來設定水印的名稱。
- 通過為WatermarkSpec對象的id資料成員分配字串值來設定水印的id屬性。
- 對於要設定的每個水印屬性，建立一個單獨的MyMapOf_xsd_string_To_xsd_anyType_Item對象。
- 通過為MyMapOf_xsd_string_To_xsd_anyType_Item對象的key資料成員（例如WaterBackCmd:OPACITY)）分配值來設定鍵值。
- 通過為MyMapOf_xsd_string_To_xsd_anyType_Item對象的value資料成員（例如.25）分配值來設定值。
- 建立MyArrayOf_xsd_anyType物件。對於每個MyMapOf_xsd_string_To_xsd_anyType_Item對象，調用MyArrayOf_xsd_anyType對象的Add方法。傳遞MyMapOf_xsd_string_To_xsd_anyType_Item物件。
- 將MyArrayOf_xsd_anyType對象分配給WatermarkSpec對象的values資料成員。
註冊水印。

通過調用RightsManagementServiceClient對象的registerWatermark方法並傳遞表示要註冊的水印的WatermarkSpec對象來註冊水印。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

「快速入門(MTOM):使用網站服務API建立浮水印」
「快速入門(SwaRef):使用網站服務API建立浮水印」

另請參閱

修改水印

您可以使用Document Security Java API或Web服務API修改現有水印。要對現有水印進行更改，可以檢索水印，修改其屬性，然後在伺服器上更新它。例如，假設您檢索水印並修改其不透明度屬性。在更改生效之前，必須更新水印。

當您修改水印時，此更改將影響應用了水印的將來文檔。也就是說，包含浮水印的現有PDF文檔不受影響。

注意

只有具有Document Security管理權限的用戶才能修改水印。也就是說，在定義建立Document Security服務客戶端對象所需的連接設定時，必須指定這樣的用戶。

注意

有關Document Security服務的詳細資訊，請參閱AEM Forms的服務參考。

步驟的摘要

要修改水印，請執行以下步驟：

包含專案檔案。
建立Document Security用戶端API物件。
檢索要修改的水印。
設定水印屬性。
更新浮水印。

包含項目檔案

在您的開發專案中加入必要的檔案。如果您使用Java建立客戶端應用程式，請包括必要的JAR檔案。如果您使用Web服務，請確定您包含Proxy檔案。

建立Document Security用戶端API物件

檢索要修改的水印

要修改水印，必須檢索現有水印。可以通過指定水印的名稱或通過指定水印的標識符值來檢索水印。

設定水印屬性

要修改現有水印，請更改一個或多個水印屬性的值。當使用Web服務以寫程式方式更新水印時，必須設定最初設定的所有屬性，即使值未更改。例如，假設已設定以下水印屬性：WaterBackCmd:IS_USERID_ENABLED、WaterBackCmd:IS_CUSTOMTEXT_ENABLED、WaterBackCmd:OPACITY和WaterBackCmd:SRCTEXT。雖然您要修改的唯一屬性是WaterBackCmd:OPACITY，但您必須將其他值設定得良好。

注意

使用Java API修改浮水印時，不需要指定所有屬性。設定要修改的水印屬性。

注意

有關水印屬性名稱的資訊，請參閱建立水印。

更新浮水印

修改水印的屬性後，必須更新水印。

另請參閱

建立水印

使用Java API修改水印

使用Document Security API(Java)修改浮水印：

包含專案檔案。

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-rightsmanagement-client.jar。
建立Document Security用戶端API物件。
- 建立包含連接屬性的ServiceClientFactory對象。
- 使用其建構子並傳遞ServiceClientFactory物件，以建立DocumentSecurityClient物件。
檢索要修改的水印。

通過調用DocumentSecurityClient對象的getWatermarkManager方法建立WatermarkManager對象，並傳遞指定水印名稱的字串值。此方法會傳回一個Watermark物件，代表要修改的浮水印。
設定浮水印屬性。

調用Watermark對象的setOpacity方法並傳遞指定不透明度級別的整數值，以設定水印的不透明度屬性。值100表示水印完全不透明，值0表示水印完全透明。

注意

此示例僅修改不透明度屬性。
更新浮水印。
- 調用WatermarkManager對象的updateWatermark方法並傳遞其屬性已修改的Watermark對象，以更新水印。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱快速入門（SOAP模式）:使用Java API部分修改水印。

使用Web服務API修改水印

使用Document Security API（web服務）修改浮水印：

包含專案檔案。

建立使用MTOM的Microsoft .NET項目。確保使用以下WSDL定義：http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1。

注意

將localhost取代為托管AEM Forms之伺服器的IP位址。
建立Document Security用戶端API物件。
- 使用其預設建構子建立DocumentSecurityServiceClient物件。
- 使用System.ServiceModel.EndpointAddress建構子建立RightsManagementServiceClient.Endpoint.Address物件。將指定WSDL的字串值傳遞到AEM Forms服務（例如http://localhost:8080/soap/services/DocumentSecurityService?WSDL）。您不需要使用lc_version屬性。建立服務參考時會使用此屬性。)
- 獲取DocumentSecurityServiceClient.Endpoint.Binding欄位的值，建立System.ServiceModel.BasicHttpBinding對象。將傳回值轉換為BasicHttpBinding。
- 將System.ServiceModel.BasicHttpBinding物件的MessageEncoding欄位設為WSMessageEncoding.Mtom。此值可確保使用MTOM。
- 通過執行以下任務來啟用基本HTTP身份驗證：
  - 將AEM表單使用者名稱指派給欄位DocumentSecurityServiceClient.ClientCredentials.UserName.UserName。
  - 將相應的密碼值分配給欄位DocumentSecurityServiceClient.ClientCredentials.UserName.Password。
  - 將常數值HttpClientCredentialType.Basic指派給欄位BasicHttpBindingSecurity.Transport.ClientCredentialType。
- 將常數值BasicHttpSecurityMode.TransportCredentialOnly指派給欄位BasicHttpBindingSecurity.Security.Mode。
檢索要修改的水印。

調用DocumentSecurityServiceClient對象的getWatermarkByName方法來檢索要修改的水印。傳遞指定浮水印名稱的字串值。此方法會傳回一個WatermarkSpec物件，代表要修改的浮水印。
設定浮水印屬性。
- 對於要更新的每個水印屬性，建立一個單獨的MyMapOf_xsd_string_To_xsd_anyType_Item對象。
- 通過為MyMapOf_xsd_string_To_xsd_anyType_Item對象的key資料成員（例如WaterBackCmd:OPACITY)）分配值來設定鍵值。
- 通過為MyMapOf_xsd_string_To_xsd_anyType_Item對象的value資料成員（例如.50）分配值來設定值。
- 建立MyArrayOf_xsd_anyType物件。對於每個MyMapOf_xsd_string_To_xsd_anyType_Item對象，調用MyArrayOf_xsd_anyType對象的Add方法。傳遞MyMapOf_xsd_string_To_xsd_anyType_Item物件。
- 將MyArrayOf_xsd_anyType對象分配給WatermarkSpec對象的values資料成員。
更新浮水印。

通過調用DocumentSecurityServiceClient對象的updateWatermark方法並傳遞表示要修改的水印的WatermarkSpec對象來更新水印。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

「快速入門(MTOM):使用Web服務API修改水印"

搜索事件

Rights Management服務會在發生特定操作時跟蹤這些操作，例如將策略應用到文檔、開啟受策略保護的文檔以及撤消對文檔的訪問。必須為Rights Management服務啟用事件審核，否則不會追蹤事件。

事件分為下列其中一類：

管理員事件是與管理員相關的操作，如建立新的管理員帳戶。
文檔事件是與文檔相關的操作，如關閉受策略保護的文檔。
策略事件是與策略相關的操作，如建立新策略。
服務事件是與Rights Management服務相關的操作，如與用戶目錄同步。

您可以使用Rights ManagementJava API或網站服務API來搜尋指定的事件。通過搜索事件，您可以執行任務，例如建立某些事件的日誌檔案。

注意

如需Rights Management服務的詳細資訊，請參閱AEM Forms的服務參考。

步驟的摘要

要搜索Rights Management事件，請執行以下步驟：

包含專案檔案。
建立Rights Management用戶端API物件。
指定要搜尋的事件。
搜尋事件。

包含項目檔案

在您的開發專案中加入必要的檔案。如果您使用Java建立客戶端應用程式，請包括必要的JAR檔案。如果您使用Web服務，請確定您包含Proxy檔案。

建立Rights Management用戶端API物件

在以寫程式方式執行Rights Management服務操作之前，必須建立Rights Management服務客戶端對象。如果您使用Java API，請建立DocumentSecurityClient物件。如果您使用Rights ManagementWeb服務API，請建立DocumentSecurityServiceService物件。

指定要搜尋的事件

必須指定要搜索的事件。例如，可以搜索策略建立事件，該事件在建立新策略時發生。

搜尋事件

指定要搜尋的事件後，您可以使用Rights ManagementJava API或Rights Management網站服務API來搜尋事件。

另請參閱

使用Java API搜尋事件

使用Rights ManagementAPI(Java)搜尋事件：

包含項目檔案

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-rightsmanagement-client.jar。
建立Rights Management用戶端API物件

使用其建構子並傳遞包含連線屬性的ServiceClientFactory物件，以建立DocumentSecurityClient物件。
指定要搜尋的事件
- 調用DocumentSecurityClient對象的getEventManager方法，建立EventManager對象。此方法會傳回EventManager物件。
- 調用EventSearchFilter對象的建構子以建立對象。
- 通過調用EventSearchFilter對象的setEventCode方法並傳遞屬於EventManager類（表示要搜索的事件）的靜態資料成員，指定要搜索的事件。例如，要搜索策略建立事件，請傳遞EventManager.POLICY_CREATE_EVENT。
注意

您可以叫用EventSearchFilter物件方法來定義其他搜尋准則。例如，調用setUserName方法以指定與事件關聯的用戶。
搜尋事件

叫用EventManager物件的searchForEvents方法並傳遞定義事件搜尋准則的EventSearchFilter物件，以搜尋事件。此方法會傳回Event物件的陣列。

程式碼範例

如需使用Rights Management服務的程式碼範例，請參閱下列快速入門：

"快速入門(SOAP):使用Java API搜尋事件」

使用Web服務API搜索事件

使用Rights ManagementAPI（網站服務）搜尋事件：

包含項目檔案

建立使用MTOM的Microsoft .NET項目。確保使用以下WSDL定義：http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1。

注意

將localhost取代為托管AEM Forms之伺服器的IP位址。
建立Rights Management用戶端API物件
- 使用其預設建構子建立DocumentSecurityServiceClient物件。
- 使用System.ServiceModel.EndpointAddress建構子建立DocumentSecurityServiceClient.Endpoint.Address物件。將指定WSDL的字串值傳遞到AEM Forms服務（例如http://localhost:8080/soap/services/RightsManagementService?WSDL）。您不需要使用lc_version屬性。建立服務參考時會使用此屬性。)
- 獲取DocumentSecurityServiceClient.Endpoint.Binding欄位的值，建立System.ServiceModel.BasicHttpBinding對象。將傳回值轉換為BasicHttpBinding。
- 將System.ServiceModel.BasicHttpBinding物件的MessageEncoding欄位設為WSMessageEncoding.Mtom。此值可確保使用MTOM。
- 通過執行以下任務來啟用基本HTTP身份驗證：
  - 將AEM表單使用者名稱指派給欄位DocumentSecurityServiceClient.ClientCredentials.UserName.UserName。
  - 將相應的密碼值分配給欄位DocumentSecurityServiceClient.ClientCredentials.UserName.Password。
  - 將常數值HttpClientCredentialType.Basic指派給欄位BasicHttpBindingSecurity.Transport.ClientCredentialType。
- 將常數值BasicHttpSecurityMode.TransportCredentialOnly指派給欄位BasicHttpBindingSecurity.Security.Mode。

指定要搜尋的事件

使用其建構子建立EventSpec物件。
通過設定EventSpec對象的firstTime.date資料成員，以及表示發生事件時日期範圍開始的DataTime實例，指定事件發生期間的開始。
將值true分配給EventSpec對象的firstTime.dateSpecified資料成員。
通過設定EventSpec對象的lastTime.date資料成員（實例表示發生事件時的日期範圍結束），指定事件發生期間的結束。DataTime
將值true分配給EventSpec對象的lastTime.dateSpecified資料成員。
為EventSpec對象的eventCode資料成員分配字串值，以設定要搜索的事件。下表列出您可指派給此屬性的數值：

事件類型	值
`ALL_EVENTS`	999
`USER_CHANGE_PASSWORD_EVENT`	1000
`USER_REGISTER_EVENT`	1001
`USER_PREREGISTER_EVENT`	1002
`USER_ACTIVATE_EVENT`	1003
`USER_DEACTIVATE_EVENT`	1004
`USER_AUTHENTICATE_EVENT`	1005
`USER_AUTHENTICATE_DENY_EVENT`	1006
`USER_ACCOUNT_LOCK_EVENT`	1007
`USER_DELETE_EVENT`	1008
`USER_UPDATE_PROFILE_EVENT`	1009
`DOCUMENT_VIEW_EVENT`	2000年
`DOCUMENT_PRINT_LOW_EVENT`	2001年
`DOCUMENT_PRINT_HIGH_EVENT`	2002年
`DOCUMENT_SIGN_EVENT`	2003年
`DOCUMENT_ADD_ANNOTATION_EVENT`	2004年
`DOCUMENT_FORM_FILL_EVENT`	2005年
`DOCUMENT_CLOSE_EVENT`	2006年
`DOCUMENT_MODIFY_EVENT`	2007年
`DOCUMENT_CHANGE_SECURITY_HANDLER_EVENT`	2008年
`DOCUMENT_SWITCH_POLICY_EVENT`	2009年
`DOCUMENT_REVOKE_EVENT`	2010年
`$1`	2011年
`DOCUMENT_SECURE_EVENT`	2012年
`DOCUMENT_UNKNOWN_CLIENT_EVENT`	2013年
`DOCUMENT_CHANGE_REVOKE_URL_EVENT`	2014年
`POLICY_CHANGE_EVENT`	3000
`POLICY_ENABLE_EVENT`	3001
`POLICY_DISABLE_EVENT`	3002
`POLICY_CREATE_EVENT`	3003
`POLICY_DELETE_EVENT`	3004
`POLICY_CHANGE_OWNER_EVENT`	3005
`SERVER_CLIENT_SYNC_EVENT`	4000
`SERVER_SYNC_DIR_INFO_EVENT`	4001
`SERVER_SYNC_DIR_COMPLETE_EVENT`	4002
`SERVER_VERSION_MISMATCH_EVENT`	4003
`SERVER_CONFIG_CHANGE_EVENT`	4004
`SERVER_ENABLE_OFFLINE_ACCESS_EVENT`	4005
`ADMIN_ADD_EVENT`	5000
`ADMIN_DELETE_EVENT`	5001
`ADMIN_EDIT_EVENT`	5002
`ADMIN_ACTIVATE_EVENT`	5003
`ADMIN_DEACTIVATE_EVENT`	5004
`ERROR_DIRECTORY_SERVICE_EVENT`	6000
`CREATED_POLICYSET_EVENT`	7000
`DELETED_POLICYSET_EVENT`	7001
`MODIFIED_POLICYSET_EVENT`	7002

搜尋事件

叫用DocumentSecurityServiceClient物件的searchForEvents方法並傳遞EventSpec物件以搜尋要搜尋的事件和結果數上限，借此搜尋事件。此方法會傳回MyArrayOf_xsd_anyType集合，其中每個元素都是AuditSpec例項。使用AuditSpec例項，您可以取得事件的相關資訊，例如發生的時間。 AuditSpec實例包含指定此資訊的timestamp資料成員。

程式碼範例

如需使用Rights Management服務的程式碼範例，請參閱下列快速入門：

「快速入門(MTOM):使用Web服務API搜索事件」
「快速入門(SwaRef):使用Web服務API搜索事件」

另請參閱

對Word文檔應用策略

除了PDF文檔外，權限管理服務還支援其他文檔格式，如Microsoft Word文檔（DOC檔案）和其他Microsoft Office檔案格式。例如，您可以將策略應用於Word文檔以保護它。通過將策略應用於Word文檔，可以限制對文檔的訪問。如果文檔已使用策略進行了保護，則無法將策略應用到文檔。

在分發受策略保護的Word文檔後，可以監視其使用情況。也就是說，您可以看到檔案的使用方式，以及使用者。例如，您可以找出有人何時開啟檔案。

注意

有關Document Security服務的詳細資訊，請參閱AEM Forms的服務參考。

步驟的摘要

要將策略應用於Word文檔，請執行以下步驟：

包含專案檔案。
建立Document Security用戶端API物件。
檢索應用策略的Word文檔。
將現有策略應用於Word文檔。
保存受策略保護的Word文檔。

包含項目檔案

在您的開發專案中加入必要的檔案。如果您使用Java建立客戶端應用程式，請包括必要的JAR檔案。如果您使用Web服務，請確定您包含Proxy檔案。

建立Document Security Client API對象

在以寫程式方式執行Document Security服務操作之前，必須建立Document Security服務客戶端對象。

檢索Word文檔

必須檢索Word文檔才能應用策略。將策略應用到Word文檔後，在使用該文檔時，用戶將受到限制。例如，如果策略不允許離線時開啟文檔，則用戶必須聯機才能開啟文檔。

將現有策略應用於Word文檔

要將策略應用於Word文檔，必須引用現有策略並指定該策略所屬的策略集。設定連接屬性的用戶必須具有對指定策略的訪問權限。否則會發生例外。

保存Word文檔

在Document Security服務將策略應用到Word文檔後，可以將受策略保護的Word文檔另存為DOC檔案。

另請參閱

撤消對文檔的訪問

使用Java API將策略應用到Word文檔

使用Document Security API(Java)將策略應用到Word文檔：

包含專案檔案。

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-rightsmanagement-client.jar。
建立Document Security用戶端API物件。
- 建立包含連接屬性的ServiceClientFactory對象。
- 使用其建構子並傳遞ServiceClientFactory物件，以建立DocumentSecurityClient物件。
檢索Word文檔。
- 使用Word文檔的建構子並傳遞指定Word文檔位置的字串值，建立代表Word文檔的java.io.FileInputStream對象。
- 使用其建構子並傳遞java.io.FileInputStream物件，以建立com.adobe.idp.Document物件。
將現有策略應用於Word文檔。
- 調用DocumentSecurityClient對象的getDocumentManager方法，建立DocumentManager對象。
- 調用DocumentManager對象的protectDocument方法並傳遞以下值，將策略應用於Word文檔：
  - com.adobe.idp.Document對象，包含應用策略的Word文檔。
  - 指定文檔名稱的字串值。
  - 一個字串值，它指定策略所屬的策略集的名稱。您可以指定一個null值，該值導致使用MyPolicies策略集。
  - 指定策略名稱的字串值。
  - 一個字串值，它表示作為文檔發佈者的用戶的用戶管理域的名稱。此參數值為可選值，可為null（如果此參數為null，則下一個參數值必須為null）。
  - 一個字串值，它表示作為文檔發佈者的用戶管理器用戶的規範名稱的名稱。此參數值為選用值，可以是null（如果此參數為null，則上一個參數值必須為null）。
  - com.adobe.livecycle.rightsmanagement.Locale，表示用於選擇MS Office模板的區域設定。此參數值為可選值，您可以指定null。
  protectDocument方法返回包含受策略保護的Word文檔的RMSecureDocumentResult對象。
保存Word文檔。
- 調用RMSecureDocumentResult對象的getProtectedDoc方法以獲取受策略保護的Word文檔。此方法會傳回com.adobe.idp.Document物件。
- 建立java.io.File對象，並確保檔案副檔名為DOC。
- 調用com.adobe.idp.Document對象的copyToFile方法，將Document對象的內容複製到檔案（確保使用getProtectedDoc方法返回的Document對象）。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

"快速入門（SOAP模式）:使用Java API將策略應用到Word文檔」

使用Web服務API將策略應用到Word文檔

使用Document Security API（web服務）將策略應用到Word文檔：

包含專案檔案。

建立使用MTOM的Microsoft .NET項目。確保使用以下WSDL定義：http://localhost:8080/soap/services/DocumentSecurityService?WSDL&lc_version=9.0.1。

注意

將localhost取代為托管AEM Forms之伺服器的IP位址。
建立Document Security用戶端API物件。
- 使用其預設建構子建立DocumentSecurityServiceClient物件。
- 使用System.ServiceModel.EndpointAddress建構子建立DocumentSecurityServiceClient.Endpoint.Address物件。將指定WSDL的字串值傳遞到AEM Forms服務（例如http://localhost:8080/soap/services/DocumentSecurityService?WSDL）。您不需要使用lc_version屬性。建立服務參考時會使用此屬性。)
- 獲取DocumentSecurityServiceClient.Endpoint.Binding欄位的值，建立System.ServiceModel.BasicHttpBinding對象。將傳回值轉換為BasicHttpBinding。
- 將System.ServiceModel.BasicHttpBinding物件的MessageEncoding欄位設為WSMessageEncoding.Mtom。此值可確保使用MTOM。
- 通過執行以下任務來啟用基本HTTP身份驗證：
  - 將AEM表單使用者名稱指派給欄位DocumentSecurityServiceClient.ClientCredentials.UserName.UserName。
  - 將相應的密碼值分配給欄位DocumentSecurityServiceClient.ClientCredentials.UserName.Password。
  - 將常數值HttpClientCredentialType.Basic指派給欄位BasicHttpBindingSecurity.Transport.ClientCredentialType。
- 將常數值BasicHttpSecurityMode.TransportCredentialOnly指派給欄位BasicHttpBindingSecurity.Security.Mode。
檢索Word文檔。
- 使用其建構子建立BLOB物件。 BLOB對象用於儲存應用策略的Word文檔。
- 通過調用其建構子並傳遞一個字串值來建立System.IO.FileStream對象，該字串值表示Word文檔的檔案位置以及開啟檔案的模式。
- 建立儲存System.IO.FileStream對象內容的位元組陣列。通過獲取System.IO.FileStream對象的Length屬性來確定位元組陣列大小。
- 叫用System.IO.FileStream物件的Read方法，以串流資料填入位元組陣列。傳遞位元組陣列、起始位置和資料流長度以讀取。
- 為MTOM欄位指定位元組陣列的內容，以填入BLOB物件。
將現有策略應用於Word文檔。

調用DocumentSecurityServiceClient對象的protectDocument方法並傳遞以下值，將策略應用於Word文檔：
- BLOB對象，包含應用策略的Word文檔。
- 指定文檔名稱的字串值。
- 一個字串值，它指定策略所屬的策略集的名稱。您可以指定一個null值，該值導致使用MyPolicies策略集。
- 指定策略名稱的字串值。
- 一個字串值，它表示作為文檔發佈者的用戶的用戶管理域的名稱。此參數值為可選值，可為null（如果此參數為null，則下一個參數值必須為null）。
- 一個字串值，它表示作為文檔發佈者的用戶管理器用戶的規範名稱的名稱。此參數值為可選值，可為null（如果此參數為null，則前一個參數值必須為null）。
- RMLocale值，它指定區域設定值（例如RMLocale.en）。
- 用於儲存策略標識符值的字串輸出參數。
- 用於儲存受策略保護的標識符值的字串輸出參數。
- 用於儲存mime類型的字串輸出參數（例如application/doc）。
protectDocument方法返回包含受策略保護的Word文檔的BLOB對象。
保存Word文檔。
- 通過調用其建構子並傳遞一個字串值來建立System.IO.FileStream對象，該字串值表示受策略保護的Word文檔的檔案位置。
- 建立位元組陣列，用於儲存protectDocument方法返回的BLOB對象的資料內容。獲取BLOB對象的MTOM資料成員的值，以填充位元組陣列。
- 通過調用其建構子並傳遞System.IO.FileStream對象來建立System.IO.BinaryWriter對象。
- 調用System.IO.BinaryWriter對象的Write方法並傳遞位元組陣列，將位元組陣列的內容寫入Word檔案。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

「快速入門(MTOM):使用Web服務API將策略應用到Word文檔「

從Word文檔中刪除策略

可以從受策略保護的Word文檔中刪除策略，以便從文檔中刪除安全性。也就是說，如果您不再希望該文檔受策略保護。如果要使用較新的策略更新受策略保護的Word文檔，則切換該策略比刪除該策略和添加更新的策略更有效。

注意

有關Document Security服務的詳細資訊，請參閱AEM Forms的服務參考。

步驟的摘要

要從受策略保護的Word文檔中刪除策略，請執行以下步驟：

包含項目檔案
建立Document Security用戶端API物件。
檢索受策略保護的Word文檔。
從Word文檔中刪除策略。
保存不安全的Word文檔。

包含項目檔案

在您的開發專案中加入必要的檔案。如果您使用Java建立客戶端應用程式，請包括必要的JAR檔案。如果您使用Web服務，請確定您包含Proxy檔案。

建立Document Security用戶端API物件

在以寫程式方式執行Document Security服務操作之前，請建立Document Security服務客戶端對象。

檢索受策略保護的Word文檔

必須檢索受策略保護的Word文檔才能刪除策略。如果嘗試從未受策略保護的Word文檔中刪除策略，將導致異常。

從Word文檔中刪除策略

如果在連接設定中指定了管理員，則可以從受策略保護的Word文檔中刪除策略。否則，用於保護文檔的策略必須包含SWITCH_POLICY權限，才能從Word文檔中刪除策略。此外，在AEM Forms連線設定中指定的使用者也必須擁有該權限。否則，會擲回例外。

保存不安全的Word文檔

在Document Security服務從Word文檔中刪除策略後，可以將不安全的Word文檔另存為DOC檔案。

另請參閱

對Word文檔應用策略

使用Java API從Word文檔中刪除策略

使用Document Security API(Java)從受策略保護的Word文檔中刪除策略：

包含項目檔案

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-rightsmanagement-client.jar。
建立Document Security用戶端API物件
- 建立包含連接屬性的ServiceClientFactory對象。
- 使用其建構子並傳遞ServiceClientFactory物件，以建立RightsManagementClient物件。
檢索受策略保護的Word文檔
- 通過使用其建構子並傳遞指定Word文檔位置的字串值，建立代表受策略保護的Word文檔的java.io.FileInputStream對象。
- 使用其建構子並傳遞java.io.FileInputStream物件，以建立com.adobe.idp.Document物件。
從Word文檔中刪除策略
- 調用RightsManagementClient對象的getDocumentManager方法，建立DocumentManager對象。
- 調用DocumentManager對象的removeSecurity方法並傳遞包含受策略保護的Word文檔的com.adobe.idp.Document對象，從Word文檔中刪除策略。此方法會傳回com.adobe.idp.Document物件，其中包含不安全的Word檔案。
保存不安全的Word文檔
- 建立java.io.File對象，並確保檔案副檔名為DOC。
- 調用Document對象的copyToFile方法，將Document對象的內容複製到檔案（確保使用removeSecurity方法返回的Document對象）。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

"快速入門（SOAP模式）:使用Java API從Word文檔中刪除策略「

使用Web服務API從Word文檔中刪除策略

使用Document Security API（Web服務）從受策略保護的Word文檔中刪除策略：

包含項目檔案

建立使用MTOM的Microsoft .NET項目。確保使用以下WSDL定義：http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1。

注意

將localhost取代為托管AEM Forms之伺服器的IP位址。
建立Document Security用戶端API物件
- 使用其預設建構子建立RightsManagementServiceClient物件。
- 使用System.ServiceModel.EndpointAddress建構子建立RightsManagementServiceClient.Endpoint.Address物件。將指定WSDL的字串值傳遞到AEM Forms服務（例如http://localhost:8080/soap/services/RightsManagementService?WSDL）。您不需要使用lc_version屬性。建立服務參考時會使用此屬性。)
- 獲取RightsManagementServiceClient.Endpoint.Binding欄位的值，建立System.ServiceModel.BasicHttpBinding對象。將傳回值轉換為BasicHttpBinding。
- 將System.ServiceModel.BasicHttpBinding物件的MessageEncoding欄位設為WSMessageEncoding.Mtom。此值可確保使用MTOM。
- 通過執行以下任務來啟用基本HTTP身份驗證：
  - 將AEM表單使用者名稱指派給欄位RightsManagementServiceClient.ClientCredentials.UserName.UserName。
  - 將相應的密碼值分配給欄位RightsManagementServiceClient.ClientCredentials.UserName.Password。
  - 將常數值HttpClientCredentialType.Basic指派給欄位BasicHttpBindingSecurity.Transport.ClientCredentialType。
- 將常數值BasicHttpSecurityMode.TransportCredentialOnly指派給欄位BasicHttpBindingSecurity.Security.Mode。
檢索受策略保護的Word文檔
- 使用其建構子建立BLOB物件。 BLOB對象用於儲存從中刪除策略的受策略保護的Word文檔。
- 通過調用其建構子並傳遞一個字串值來建立System.IO.FileStream對象，該字串值表示Word文檔的檔案位置以及開啟檔案的模式。
- 建立儲存System.IO.FileStream對象內容的位元組陣列。通過獲取System.IO.FileStream對象的Length屬性，可以確定位元組陣列的大小。
- 調用System.IO.FileStream對象的Read方法並傳遞要讀取的位元組陣列、啟動位置和流長度，以流資料填充位元組陣列。
- 為MTOM欄位指定位元組陣列的內容，以填入BLOB物件。
從Word文檔中刪除策略

調用RightsManagementServiceClient對象的removePolicySecurity方法並傳遞包含受策略保護的Word文檔的BLOB對象，從Word文檔中刪除策略。此方法會傳回BLOB物件，其中包含不安全的Word檔案。
保存不安全的Word文檔
- 通過調用其建構子並傳遞一個字串值來建立System.IO.FileStream對象，該字串值表示不安全Word文檔的檔案位置。
- 建立位元組陣列，用於儲存removePolicySecurity方法返回的BLOB對象的資料內容。獲取BLOB對象的MTOM欄位的值，填入位元組陣列。
- 通過調用其建構子並傳遞System.IO.FileStream對象來建立System.IO.BinaryWriter對象。

程式碼範例

有關使用Document Security服務的代碼示例，請參閱以下快速入門：

「快速入門(MTOM):使用Web服務API從Word文檔中刪除策略」

另請參閱