使用策略保護文檔

廢止檔案存取權

使用Java API將原則套用至PDF檔案

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

包含專案檔案。

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-rightsmanagement-client.jar。
建立Document Security Client 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檔案：
  - 包含套用原則之PDF檔案的com.adobe.idp.Document物件。
  - 指定文檔名稱的字串值。
  - 一個字串值，它指定策略所屬的策略集的名稱。您可以指定一個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 service API將原則套用至PDF檔案

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

包含專案檔案。

建立使用MTOM的Microsoft .NET專案。請確定您使用下列WSDL定義：http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1。

注意

將localhost取代為代管AEM Forms的伺服器的IP位址。
建立Document Security Client 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檔案：
- 包含套用原則之PDF檔案的BLOB物件。
- 指定文檔名稱的字串值。
- 一個字串值，它指定策略所屬的策略集的名稱。您可以指定一個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.BinaryWriter對象的建構子並傳遞System.IO.FileStream對象，以建立對象。
- 調用System.IO.BinaryWriter物件的Write方法並傳遞位元組陣列，將位元組陣列的內容寫入PDF檔案。

程式碼範例

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

「快速入門(MTOM):使用web service API將原則套用至PDF檔案」
「快速入門(SwaRef):使用web service API將原則套用至PDF檔案」

從PDF文檔中刪除策略

您可以從受原則保護的檔案中移除原則，以便從檔案中移除安全性。也就是說，如果您不想讓檔案受到原則的保護。如果您想要使用較新的原則更新受原則保護的檔案，則切換原則會更有效率，而不是移除原則並新增更新的原則。

注意

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

步驟摘要

若要從受原則保護的PDF檔案移除原則，請執行下列步驟：

包含專案檔案
建立Document Security Client API物件。
擷取受原則保護的PDF檔案。
從PDF檔案移除原則。
儲存不安全的PDF檔案。

包含專案檔案

將必要的檔案加入您的開發專案中。如果使用Java建立客戶端應用程式，則包括必要的JAR檔案。如果您使用web services，請確定您包含proxy檔案。

建立Document Security Client API物件

在以程式設計方式執行Document Security服務操作之前，請先建立Document Security服務用戶端物件。

擷取受原則保護的PDF檔案

您可以擷取受原則保護的PDF檔案，以移除原則。如果您嘗試從未受原則保護的PDF檔案移除原則，將會造成例外。

從PDF檔案移除原則

只要在連線設定中指定管理員，您就可以從受原則保護的PDF檔案中移除原則。否則，用於保護文檔的策略必須包含SWITCH_POLICY權限，才能從PDF文檔中刪除策略。此外，在AEM Forms連接設定中指定的用戶也必須具有該權限。否則，會拋出異常。

儲存不安全的PDF檔案

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

另請參閱

套用原則至PDF檔案

使用Java API從PDF檔案移除原則

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

包含專案檔案。

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-rightsmanagement-client.jar。
建立Document Security Client 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檔案移除原則。此方法傳回包含不安全PDF檔案的com.adobe.idp.Document物件。
儲存不安全的PDF檔案。
- 建立java.io.File物件，並確定副檔名為PDF。
- 叫用Document物件的copyToFile方法，將Document物件的內容複製至檔案（請確定您使用removeSecurity方法傳回的Document物件）。

程式碼範例

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

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

使用web service API刪除策略

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

包含專案檔案。

建立使用MTOM的Microsoft .NET專案。請確定您使用下列WSDL定義：http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1。

注意

將localhost取代為代管AEM Forms的伺服器的IP位址。
建立Document Security Client 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檔案中的原則。此方法傳回包含不安全PDF檔案的BLOB物件。
儲存不安全的PDF檔案。
- 通過調用System.IO.FileStream對象的建構子並傳遞一個字串值來建立對象，該字串值表示不安全PDF文檔的檔案位置。
- 建立一個位元組陣列，用於儲存removePolicySecurity方法返回的BLOB對象的資料內容。取得BLOB物件的MTOM欄位值，以填入位元組陣列。
- 調用System.IO.BinaryWriter對象的建構子並傳遞System.IO.FileStream對象，以建立對象。

程式碼範例

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

「快速入門(MTOM):使用web service API從PDF檔案移除原則」
「快速入門(SwaRef):使用web service API從PDF檔案移除原則」

另請參閱

廢止檔案存取權

您可以撤銷對受原則保護PDF檔案的存取權，使用者無法存取該檔案的所有副本。當使用者嘗試開啟已撤銷的PDF檔案時，會將其重新導向至可檢視修訂檔案的指定URL。必須以程式設計方式指定使用者重新導向的URL。當您廢止檔案的存取權時，這項變更會在使用者下次透過線上開啟受原則保護的檔案與Document Security服務同步時生效。

廢止檔案存取權的能力提供額外的安全性。例如，假設有較新版本的檔案可供使用，而您不再希望任何人檢視過時版本。在這種情況下，對舊文檔的訪問權可以被撤銷，除非恢復訪問權，否則沒有人可以查看該文檔。

注意

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

步驟摘要

要撤銷受原則保護的檔案，請執行下列步驟：

包含專案檔案。
建立Document Security Client API物件。
擷取受原則保護的PDF檔案。
撤銷受原則保護的檔案。

包含專案檔案

將必要的檔案加入您的開發專案中。如果使用Java建立客戶端應用程式，則包括必要的JAR檔案。如果您使用web services，請確定您包含proxy檔案。

建立Document Security Client 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 Client 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物件。此方法會傳回代表授權識別碼值的字串值。
- 調用DocumentSecurityClient物件的getLicenseManager方法，以建立LicenseManager物件。
- 叫用LicenseManager物件的revokeLicense方法並傳遞下列值，以撤銷受原則保護的檔案：
  - 指定受原則保護檔案之授權識別碼值的字串值（指定DocumentManager物件getLicenseId方法的傳回值）。
  - License介面的靜態資料成員，它指定撤銷文檔的原因。例如，您可以指定License.DOCUMENT_REVISED。
  - 一個java.net.URL值，它指定修訂文檔所在的位置。如果您不想將使用者重新導向至其他URL，則可以傳遞null。

程式碼範例

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

"快速啟動（SOAP模式）:使用Java API廢止檔案」

使用web service API撤銷對檔案的存取權

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

包含專案檔案

建立使用MTOM的Microsoft .NET專案。請確定您使用下列WSDL定義：http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1。

注意

將localhost取代為代管AEM Forms的伺服器的IP位址。
建立Document Security Client 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 service API廢止檔案」
「快速入門(SwaRef):使用web service API廢止檔案」

另請參閱

從Word檔案移除原則

恢復對已撤銷文檔的訪問

您可以恢復對已撤銷PDF檔案的存取權，讓使用者可存取已撤銷檔案的所有副本。當使用者開啟已撤銷的復原檔案時，使用者可以檢視該檔案。

注意

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

步驟摘要

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

包含專案檔案。
建立Document Security Client API物件。
擷取已撤銷PDF檔案的授權識別碼。
恢復對已撤銷PDF檔案的存取權。

包含專案檔案

將必要的檔案加入您的開發專案中。如果使用Java建立客戶端應用程式，則包括必要的JAR檔案。如果您使用web services，請確定您包含proxy檔案。

建立Document Security Client API物件

您必須先建立Document Security服務用戶端物件，才能以程式設計方式執行Document Security服務作業。如果您使用Java API，請建立DocumentSecurityClient物件。如果您使用Document Security web service API，請建立DocumentSecurityServiceService物件。

擷取已撤銷PDF檔案的授權識別碼

您必須擷取已撤銷PDF檔案的授權識別碼，才能重新建立已撤銷的PDF檔案。取得授權識別碼值後，您可以重建已撤銷的檔案。如果嘗試恢復未撤銷的文檔，將導致異常。

恢復對已撤銷PDF檔案的存取權

若要恢復對已撤銷PDF檔案的存取權，您必須指定已撤銷檔案的授權識別碼。如果您嘗試重新建立未撤銷的PDF檔案存取權，將會造成例外。

另請參閱

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

使用Document Security API(Java)重新建立對已撤銷檔案的存取權：

包含專案檔案。

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-rightsmanagement-client.jar。
建立Document Security Client 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 service API恢復對已撤銷文檔的訪問權"

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

使用Document Security API(web service)重新建立對已撤銷檔案的存取權：

包含專案檔案。

建立使用MTOM的Microsoft .NET專案。請確定您使用下列WSDL定義：http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1。

注意

將localhost取代為代管AEM Forms的伺服器的IP位址。
建立Document Security Client 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檔案之授權識別碼值的字串值，以重新建立對已撤銷PDF檔案的存取權（傳遞DocumentSecurityServiceClient物件getLicenseId方法的傳回值）。

程式碼範例

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

「快速入門(MTOM):使用web service API恢復對已撤銷文檔的訪問權"
「快速入門(SwaRef):使用web service API恢復對已撤銷文檔的訪問權"

另請參閱

檢查受原則保護的PDF檔案

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

如果您的LiveCycle版本為8.x或更早版本，則無法執行此任務。 AEM Forms增加了對檢查受原則保護檔案的支援。如果您嘗試使用LiveCycle8.x（或更舊版本）檢查受原則保護的檔案，則會擲回例外。

注意

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

步驟摘要

若要檢查受原則保護的PDF檔案，請執行下列步驟：

包含專案檔案。
建立Document Security Client API物件。
擷取受原則保護的檔案以進行檢查。
取得受原則保護檔案的相關資訊。

包含專案檔案

將必要的檔案加入您的開發專案中。如果要使用Java建立客戶端應用程式，請包括必要的JAR檔案。如果您使用web services，請確定您包含proxy檔案。

建立Document Security Client API物件

在以程式設計方式執行Document Security服務操作之前，請先建立Document Security服務用戶端物件。如果您使用Java API，請建立RightsManagementClient物件。如果您使用Document Security web service API，請建立RightsManagementServiceService物件。

擷取受原則保護的檔案以進行檢查

若要檢查受原則保護的檔案，請擷取它。如果您嘗試檢查未使用策略保護或已撤銷的文檔，則會拋出例外。

Inspect檔案

擷取受原則保護的檔案後，即可加以檢查。

取得受原則保護檔案的相關資訊

在檢查受原則保護的PDF檔案後，您可以取得相關資訊。例如，您可以決定用於保護檔案的原則。

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

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

另請參閱

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

Inspect使用Document Security Service API(Java)提供受原則保護的PDF檔案：

包含專案檔案。

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-rightsmanagement-client.jar。有關這些檔案位置的資訊，請參見包括AEM FormsJava庫檔案。
建立Document Security Client API物件。
- 建立包含連接屬性的ServiceClientFactory對象。（請參閱設定連接屬性。）
- 使用其建構子並傳遞ServiceClientFactory對象，建立RightsManagementClient對象。
擷取受原則保護的檔案以進行檢查。
- 使用其建構函式建立java.io.FileInputStream物件，以代表受原則保護的PDF檔案。傳遞指定PDF檔案位置的字串值。
- 使用其建構子並傳遞java.io.FileInputStream對象，建立com.adobe.idp.Document對象。
Inspect。
- 調用RightsManagementClient物件的getDocumentManager方法，以建立DocumentManager物件。
- Inspect透過叫用LicenseManager物件的inspectDocument方法，來保護原則檔案。傳遞包含受原則保護PDF檔案的com.adobe.idp.Document物件。此方法傳回包含受原則保護檔案相關資訊的RMInspectResult物件。
取得受原則保護檔案的相關資訊。

若要取得受原則保護檔案的相關資訊，請叫用屬於RMInspectResult物件的適當方法。例如，若要擷取原則名稱，請叫用RMInspectResult物件的getPolicyName方法。

程式碼範例

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

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

Inspect使用web service API的受原則保護PDF檔案

Inspect使用Document Security Service API(web service)提供受原則保護的PDF檔案：

包含專案檔案。

建立使用MTOM的Microsoft .NET專案。請確定您使用下列WSDL定義：http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1。

注意

將localhost取代為代管AEM Forms的伺服器的IP位址。
建立Document Security Client 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。

Inspect透過叫用RightsManagementServiceClient物件的inspectDocument方法，來保護原則檔案。傳遞包含受原則保護PDF檔案的BLOB物件。此方法傳回包含受原則保護檔案相關資訊的RMInspectResult物件。
取得受原則保護檔案的相關資訊。

若要取得受原則保護檔案的相關資訊，請取得屬於RMInspectResult物件的適當欄位值。例如，若要擷取原則名稱，請取得RMInspectResult物件的policyName欄位值。

程式碼範例

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

「快速入門(MTOM):使用web service API檢查受原則保護的PDF檔案」
「快速入門(SwaRef):使用web service API檢查受原則保護的PDF檔案」

另請參閱

建立水印

浮水印可以透過唯一識別檔案並控製版權侵權來確保檔案的安全性。例如，您可以建立水印，並將該水印標示為檔案所有頁面上的機密。在建立浮水印後，您可以將它加入原則中。也就是說，您可以使用新建立的浮水印來設定原則的浮水印屬性。將包含浮水印的原則套用至檔案後，浮水印就會出現在受原則保護的檔案中。

注意

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

注意

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

步驟摘要

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

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

包含專案檔案

將必要的檔案加入您的開發專案中。如果使用Java建立客戶端應用程式，則包括必要的JAR檔案。如果您使用web services，請確定您包含proxy檔案。

建立Document Security Client API物件

設定浮水印屬性

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

自訂文字
DateIncluded
UserIdIncluded
UserNameIncluded

下表列出使用web services建立浮水印時所需的索引鍵和值配對。

金鑰名稱	說明	值
`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服務中註冊新的浮水印，才能使用。在註冊水印後，您可以在原則中使用水印。

另請參閱

套用原則至PDF檔案

使用Java API建立浮水印

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

包含專案檔案。

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-rightsmanagement-client.jar。
建立Document Security Client 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 service API建立浮水印

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

建立Document Security Client API物件。

建立使用MTOM的Microsoft .NET專案。請確定您使用下列WSDL定義：http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1。

注意

將localhost取代為代管AEM Forms的伺服器的IP位址。
建立Document Security Client 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):使用web service API建立浮水印"
「快速入門(SwaRef):使用web service API建立浮水印"

另請參閱

修改水印

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

當您修改水印時，此變更會影響套用水印的未來檔案。也就是說，包含浮水印的現有PDF檔案不受影響。

注意

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

注意

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

步驟摘要

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

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

包含專案檔案

將必要的檔案加入您的開發專案中。如果使用Java建立客戶端應用程式，則包括必要的JAR檔案。如果您使用web services，請確定您包含proxy檔案。

建立Document Security Client 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 Client API物件。
- 建立包含連接屬性的ServiceClientFactory對象。
- 使用其建構子並傳遞ServiceClientFactory對象，建立DocumentSecurityClient對象。
檢索要修改的水印。

調用DocumentSecurityClient對象的getWatermarkManager方法並傳遞指定水印名稱的字串值，以建立WatermarkManager對象。此方法返回一個Watermark對象，該對象表示要修改的水印。
設定水印屬性。

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

注意

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

程式碼範例

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

使用web service API修改浮水印

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

包含專案檔案。

建立使用MTOM的Microsoft .NET專案。請確定您使用下列WSDL定義：http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1。

注意

將localhost取代為代管AEM Forms的伺服器的IP位址。
建立Document Security Client 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 service API修改水印"

搜索事件

Rights Management服務會在特定動作發生時追蹤這些動作，例如將原則套用至檔案、開啟受原則保護的檔案，以及廢止檔案存取權。必須為Rights Management服務啟用事件審計，否則不跟蹤事件。

事件分為下列類別：

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

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

注意

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

步驟摘要

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

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

包含專案檔案

將必要的檔案加入您的開發專案中。如果使用Java建立客戶端應用程式，則包括必要的JAR檔案。如果您使用web services，請確定您包含proxy檔案。

建立Rights Management用戶端API物件

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

指定要搜尋的事件

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

搜尋事件

指定要搜尋的事件後，您可以使用Rights ManagementJava API或Rights Managementweb服務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 service API搜尋事件

使用Rights ManagementAPI(web service)搜尋事件：

包含專案檔案

建立使用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對象。
使用DataTime例項設定EventSpec物件的firstTime.date資料成員，以指定事件發生的時段開始，該例項代表事件發生時的日期範圍開始。
將值true指派給EventSpec物件的firstTime.dateSpecified資料成員。
使用DataTime例項設定EventSpec物件的lastTime.date資料成員，以指定事件發生的時段結束時間，該例項代表事件發生時的日期範圍結束時間。
將值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`	二〇〇一年
`POLICY_DISABLE_EVENT`	三零零二年
`POLICY_CREATE_EVENT`	三零零三年
`POLICY_DELETE_EVENT`	三零零四年
`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 service API搜尋事件"
「快速入門(SwaRef):使用web service API搜尋事件"

另請參閱

將原則套用至Word檔案

除了PDF檔案外，Rights Management服務還支援其他檔案格式，例如Microsoft Word檔案（DOC檔案）和其他Microsoft Office檔案格式。例如，您可以將原則套用至Word檔案，以保護其安全。將原則套用至Word檔案，即可限制對檔案的存取。如果文檔已使用策略保護，則不能將策略應用於文檔。

您可以在分發受原則保護的Word檔案後，監控檔案的使用情況。也就是說，您可以看到檔案的使用方式以及使用者。例如，您可以瞭解某人何時開啟檔案。

注意

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

步驟摘要

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

包含專案檔案。
建立Document Security Client API物件。
擷取套用原則的Word檔案。
將現有原則套用至Word檔案。
儲存受原則保護的Word檔案。

包含專案檔案

將必要的檔案加入您的開發專案中。如果使用Java建立客戶端應用程式，則包括必要的JAR檔案。如果您使用web services，請確定您包含proxy檔案。

建立Document Security用戶端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 Client 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檔案：
  - 包含套用原則之Word檔案的com.adobe.idp.Document物件。
  - 指定文檔名稱的字串值。
  - 一個字串值，它指定策略所屬的策略集的名稱。您可以指定一個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 service API將原則套用至Word檔案

使用Document Security API(web service)將原則套用至Word檔案：

包含專案檔案。

建立使用MTOM的Microsoft .NET專案。請確定您使用下列WSDL定義：http://localhost:8080/soap/services/DocumentSecurityService?WSDL&lc_version=9.0.1。

注意

將localhost取代為代管AEM Forms的伺服器的IP位址。
建立Document Security Client 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檔案：
- 包含套用原則之Word檔案的BLOB物件。
- 指定文檔名稱的字串值。
- 一個字串值，它指定策略所屬的策略集的名稱。您可以指定一個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.BinaryWriter對象的建構子並傳遞System.IO.FileStream對象，以建立對象。
- 調用System.IO.BinaryWriter物件的Write方法並傳遞位元組陣列，將位元組陣列的內容寫入Word檔案。

程式碼範例

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

「快速入門(MTOM):使用web service API將原則套用至Word檔案」

從Word文檔中刪除策略

您可以從受原則保護的Word檔案移除原則，以移除檔案的安全性。也就是說，如果您不想讓檔案受到原則的保護。如果您想要使用較新的原則更新受原則保護的Word檔案，則切換原則會更有效率，而不是移除原則並新增更新的原則。

注意

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

步驟摘要

若要從受原則保護的Word檔案移除原則，請執行下列步驟：

包含專案檔案
建立Document Security Client API物件。
擷取受原則保護的Word檔案。
從Word檔案移除原則。
儲存不安全的Word檔案。

包含專案檔案

將必要的檔案加入您的開發專案中。如果使用Java建立客戶端應用程式，則包括必要的JAR檔案。如果您使用web services，請確定您包含proxy檔案。

建立Document Security Client API物件

在以程式設計方式執行Document Security服務操作之前，請先建立Document Security服務用戶端物件。

擷取受原則保護的Word檔案

您必須擷取受原則保護的Word檔案，才能移除原則。如果您嘗試從未受原則保護的Word檔案移除原則，將會造成例外。

從Word檔案移除原則

只要在連線設定中指定管理員，您就可以從受原則保護的Word檔案移除原則。否則，用於保護文檔的策略必須包含SWITCH_POLICY權限，才能從Word文檔中刪除策略。此外，在AEM Forms連接設定中指定的用戶也必須具有該權限。否則，會拋出異常。

儲存不安全的Word檔案

在Document Security服務從Word檔案移除原則後，您可以將不安全的Word檔案儲存為DOC檔案。

另請參閱