AEM Forms Document Security Java SDK は、ユーザーアカウントがドキュメントを編集する権限を取得することなく、別のユーザーの代わりにドキュメントを保護できる API を提供します。 この API は、ワークフロープロセスで使用することも、プログラムによってドキュメントサービスとして使用することもできます。 新しい API は次のとおりです。
protectDocumentUse protectDocument API では、別のユーザーアカウントを使用する代わりに、ポリシーをドキュメントに適用することができます。
別のユーザーアカウント。ポリシーの適用に使用されるユーザーアカウントの権限は、ドキュメントの保護に制限されたままです。 ドキュメントを開いて表示する権限を取得しません。 RMSecureDocumentResult protectDocument(Document inDoc, String documentName, String policySetName, String policyName, RMLocale locale, boolean bExactMatchForNames)
createLicenseUse 別のユーザーアカウントに代わってポリシーのライセンスを作成する CreateLicense API です。 PublishLicenseDTO createLicense(String policyId, String documentName, boolean logSecureDocEvent)
protectDocumentWithCoverPageUse protectDocumentWithCoverPage API では、別のユーザーの代わりにポリシーを適用して、ドキュメントにカバーページを追加することができます。ポリシーの適用に使用されるユーザーアカウントの権限は、ドキュメントの保護に制限されたままです。 ドキュメントを開いて表示する権限を取得しません。 RMSecureDocumentResult protectDocumentWithCoverPage(Document inDoc, String documentName, String policySetName, String policyName, Document coverDoc, boolean bExactMatchForNames)
ドキュメントを編集する権限を取得することなく、別のユーザーの代わりにドキュメントを保護するには、次の手順を実行します。
ポリシーセットを作成します。例えば、PolicySet1 を作成します。
新規作成されたポリシーセットにポリシーを作成します。例えば、PolicySet1 に Policy1 を作成します。
役割 End User を持つRights Managementを作成します。 例:User1 Policy1 を使用して、新しく作成されたユーザーに保護されたドキュメントを表示する権限を付与します。
新しい役割の作成. 例えば、Role1 などです。 新しく作成したロールに対して、サービスの呼び出し権限を付与します。 新しく作成した役割を持つユーザーを作成します。 例えば、User2.User2 または管理者を使用して SDK 接続を作成し、protectDocument サービスを呼び出すことができます。
次のサンプルコードを実行すると、ドキュメントを保護するユーザーにドキュメントを編集する権限を付与することなく、ドキュメントを保護できます。
import java.io.File;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.Properties;
import com.adobe.edc.common.dto.PublishLicenseDTO;
import com.adobe.edc.sdk.SDKException;
import com.adobe.idp.Document;
import com.adobe.idp.dsc.clientsdk.ServiceClientFactory;
import com.adobe.idp.dsc.clientsdk.ServiceClientFactoryProperties;
import com.adobe.livecycle.rightsmanagement.RMSecureDocumentResult;
import com.adobe.livecycle.rightsmanagement.client.DocumentManager;
import com.adobe.livecycle.rightsmanagement.client.RightsManagementClient;
import com.adobe.livecycle.rightsmanagement.client.RightsManagementClient2;
public class PublishAsProtectAPI {
private static final String unprotectedFileName = "C:\\unprotected.pdf";
private static final String protectedFileName = "C:\\protect.pdf";
private static final String coverFileName = "C:\\CoverPage.pdf";
private static final String POLICY_ID = "2EF66008-5E2D-1034-9B06-00000A292C18";
public static void main(String[] args) {
try {
Properties connectionProps = new Properties();
connectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_SOAP_ENDPOINT,"http://localhost:8080");
connectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_SOAP_PROTOCOL);
connectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "JBoss");
connectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME,"administrator");
connectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD,"password");
// Create a ServiceClientFactory instance
ServiceClientFactory factory = ServiceClientFactory.createInstance(connectionProps);
testProtectDocument(factory);
testProtectDocumentWithCoverPage(factory);
testProtectDocumentJavaPPL(factory);
}
catch (Exception ex) {
ex.printStackTrace(); }
}
private static void testProtectDocument(ServiceClientFactory factory) throws FileNotFoundException, SDKException {
// Create a RightsManagementClient object
RightsManagementClient rmClient = new RightsManagementClient(factory);
// Create a Document Manager object
DocumentManager documentManager = rmClient.getDocumentManager();
//Reference a policy-protected PDF document from which to remove a policy
FileInputStream is = new FileInputStream(unprotectedFileName);
Document inPDF = new Document(is);
long startTime = System.currentTimeMillis();
//Remove a policy from the policy-protected PDF document
RMSecureDocumentResult securePDF = documentManager.protectDocument(inPDF, "test", "newPolicySet", "latest", "DefaultDom", "administrator", null, true);
System.out.println("Total Time taken for protectDocument = " + (System.currentTimeMillis() - startTime));
//Save the unsecured PDF document
File myFile = new File(protectedFileName);
securePDF.getProtectedDoc().copyToFile(myFile);
}
private static void testProtectDocumentWithCoverPage(ServiceClientFactory factory) throws FileNotFoundException, SDKException {
// Create a RightsManagementClient object
RightsManagementClient rmClient = new RightsManagementClient(factory);
// Create a Document Manager object
DocumentManager documentManager = rmClient.getDocumentManager();
//Reference a policy-protected PDF document from which to remove a policy
FileInputStream is = new FileInputStream(unprotectedFileName);
Document inPDF = new Document(is);
FileInputStream coverIS = new FileInputStream(coverFileName);
Document inCoverPDF = new Document(coverIS);
long startTime = System.currentTimeMillis();
//Remove a policy from the policy-protected PDF document
RMSecureDocumentResult securePDF = documentManager.protectDocumentWithCoverPage(inPDF, "test", "newPolicySet", "latestPolicy", inCoverPDF, true);
System.out.println("Total Time taken for Page0ProtectDocument = " + (System.currentTimeMillis() - startTime));
//Save the unsecured PDF document
File myFile = new File(protectedFileName);
securePDF.getProtectedDoc().copyToFile(myFile);
}
private static PublishLicenseDTO testProtectDocumentJavaPPL (ServiceClientFactory factory) throws SDKException, FileNotFoundException, IOException {
// Create a RightsManagementClient object
RightsManagementClient2 rmClient2 = new RightsManagementClient2(factory);
// Create a Document Manager object
DocumentManager documentManager = rmClient2.getDocumentManager();
long startTime = System.currentTimeMillis();
PublishLicenseDTO license = documentManager.createLicense(POLICY_ID, "Out.pdf", true);
System.out.println("Create License totalTime = " + (System.currentTimeMillis() - startTime));
startTime = System.currentTimeMillis();
// Reference a PDF document to which a policy is applied
InputStream inputFileStream = new FileInputStream(unprotectedFileName);
// Apply a policy to the PDF document
InputStream protectPDF = rmClient2.getRightsManagementEncryptionService().protectDocument(inputFileStream, license);
// Save the policy-protected PDF document
File myFile = new File(protectedFileName);
// write the inputStream to a FileOutputStream
FileOutputStream outputStream = new FileOutputStream(myFile);
int read = 0;
byte[] bytes = new byte[1024];
while ((read = protectPDF.read(bytes)) != -1) {
outputStream.write(bytes, 0, read);
}
System.out.println("protectPDFDocument totalTime = " + (System.currentTimeMillis() - startTime));
outputStream.close();
inputFileStream.close();
System.out.println("Document Protected Successfully");
return license;
}
}