PDF 문서 암호화 및 암호 해독

이 문서의 샘플과 예는 JEE 환경의 AEM Forms에만 해당됩니다.

암호화 서비스 정보

암호화 서비스를 사용하여 문서를 암호화하고 해독할 수 있습니다. 문서가 암호화되면 해당 내용이 읽을 수 없게 됩니다. 권한이 있는 사용자는 문서를 해독하여 콘텐트에 액세스할 수 있습니다. PDF 문서가 암호로 암호화되어 있는 경우 Adobe Reader 또는 Adobe Acrobat에서 문서를 보려면 사용자가 열기 암호를 지정해야 합니다. 마찬가지로, PDF 문서가 인증서로 암호화된 경우 사용자는 PDF 문서를 암호화하는 데 사용한 인증서(개인 키)에 해당하는 공개 키로 PDF 문서를 해독해야 합니다.

암호화 서비스를 사용하여 다음 작업을 수행할 수 있습니다.

• 암호로 PDF 문서를 암호화합니다. (암호를 사용하여 PDF 문서 암호화를 참조하십시오.)
• 인증서를 사용하여 PDF 문서를 암호화합니다. (인증서를 사용하여 PDF 문서 암호화를 참조하십시오.)
• PDF 문서에서 암호 기반 암호화를 제거할 수 있습니다. (암호 암호화 제거를 참조하십시오.)
• PDF 문서에서 인증서 기반의 암호화를 제거할 수 있습니다. (인증서 기반 암호화 제거를 참조하십시오.)
• 다른 서비스 작업을 수행할 수 있도록 PDF 문서의 잠금을 해제합니다. 예를 들어 암호로 암호화된 PDF 문서의 잠금을 해제하면 디지털 서명을 적용할 수 있습니다. 자세한 내용은 암호화된 PDF 문서 잠금 해제를 참조하십시오.
• 보안 PDF 문서의 암호화 유형을 결정합니다. (암호화 유형 결정을 참조하십시오.)

암호로 PDF 문서 암호화

암호로 PDF 문서를 암호화할 때 Adobe Reader 또는 Acrobat에서 PDF 문서를 열려면 암호를 지정해야 합니다. 또한 PDF 문서에 디지털 서명을 하는 등 다른 AEM Forms 작업을 수행하려면 먼저 암호로 암호화된 PDF 문서의 잠금을 해제해야 합니다.

단계 요약

암호로 PDF 문서를 암호화하려면 다음 단계를 수행하십시오.

1. 프로젝트 파일 포함
2. 암호화 클라이언트 API 객체를 만듭니다.
3. 암호화할 PDF 문서를 만들 수 있습니다.
4. 암호화 런타임 옵션을 설정합니다.
5. 암호를 추가합니다.
6. 암호화된 PDF 문서를 PDF 파일로 저장할 수 있습니다.

프로젝트 파일 포함

개발 프로젝트에 필요한 파일을 포함할 수 있습니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.

다음 JAR 파일을 프로젝트의 클래스 경로에 추가해야 합니다.

• adobe-livecycle-client.jar
• adobe-usermanager-client.jar
• adobe-encryption-client.jar
• adobe-utilities.jar (AEM Forms이 JBoss에 배포된 경우 필수)
• jbossall-client.jar (AEM Forms이 JBoss에 배포된 경우 필수)

암호화 클라이언트 API 개체 만들기

암호화 서비스 작업을 프로그래밍 방식으로 수행하려면 암호화 서비스 클라이언트를 만들어야 합니다.

암호화할 PDF 문서 받기

암호를 사용하여 문서를 암호화하려면 암호화되지 않은 PDF 문서를 입수해야 합니다. 이미 암호화된 PDF 문서를 보호하려고 하면 예외가 발생합니다.

암호화 런타임 옵션 설정

암호로 PDF 문서를 암호화하려면 2개의 암호 값을 포함하여 4개의 값을 지정합니다. 첫 번째 암호 값은 PDF 문서를 암호화하는 데 사용되며 PDF 문서를 열 때 지정해야 합니다. 마스터 암호 값으로 명명된 두 번째 암호 값은 PDF 문서에서 암호화를 제거하는 데 사용됩니다. 암호 값은 대/소문자를 구분하며, 이 두 암호 값은 동일한 값이 될 수 없습니다.

암호화할 PDF 문서 리소스를 지정해야 합니다. 문서의 메타데이터를 제외한 모든 문서 또는 문서의 첨부 파일을 제외한 모든 PDF 문서를 암호화할 수 있습니다. 문서의 첨부 파일만 암호화하는 경우 첨부 파일에 액세스하려고 하면 암호를 입력하라는 메시지가 표시됩니다.

PDF 문서를 암호화할 때 보안 문서와 연결된 권한을 지정할 수 있습니다. 권한을 지정하여 암호로 암호화된 PDF 문서를 여는 사용자가 수행할 수 있는 작업을 제어할 수 있습니다. 예를 들어 양식 데이터를 성공적으로 추출하려면 다음 권한을 설정해야 합니다.

• PASSWORD_EDIT_ADD
• PASSWORD_EDIT_MODIFY

암호 추가

보안되지 않은 PDF 문서를 검색하고 암호화 실행 시간 값을 설정한 후 PDF 문서에 암호를 추가할 수 있습니다.

암호화된 PDF 문서를 PDF 파일로 저장

암호로 암호화된 PDF 문서를 PDF 파일로 저장할 수 있습니다.

참고 항목

Java API를 사용하여 PDF 문서 암호화

웹 서비스 API를 사용하여 PDF 문서 암호화

AEM Forms Java 라이브러리 파일 포함

연결 속성 설정

암호화 서비스 API 빠른 시작

인증서를 사용하여 PDF 문서 암호화

Java API을 사용하여 PDF 문서 암호화

암호화 API(Java)를 사용하여 암호로 PDF 문서를 암호화합니다.

1. 프로젝트 파일 포함

   Java 프로젝트의 클래스 경로에 adobe-encryption-client.jar 등의 클라이언트 JAR 파일을 포함합니다.

2. 암호화 클라이언트 API 만들기를 참조하십시오.

   • 연결 속성을 포함하는 ServiceClientFactory 개체를 만듭니다.
   • 생성자를 사용하여 EncryptionServiceClient 개체를 만들고 ServiceClientFactory 개체를 전달합니다.

3. 암호화할 PDF 문서를 만들 수 있습니다.

   • 생성자를 사용하고 PDF 문서의 위치를 지정하는 문자열 값을 전달하여 암호화할 PDF 문서를 나타내는 java.io.FileInputStream 객체를 만듭니다.
   • 생성자를 사용하여 com.adobe.idp.Document 개체를 만들고 java.io.FileInputStream 개체를 전달합니다.

4. 암호화 런타임 옵션을 설정합니다.

   • 생성자를 호출하여 PasswordEncryptionOptionSpec 객체를 만듭니다.
   • PasswordEncryptionOptionSpec 개체의 setEncryptOption 메서드를 호출하고 암호화할 문서 리소스를 지정하는 PasswordEncryptionOption 열거형 값을 전달하여 암호화할 PDF 문서 리소스를 지정합니다. 예를 들어 메타데이터와 첨부 파일을 포함하여 전체 PDF 문서를 암호화하려면 PasswordEncryptionOption.ALL을 지정합니다.
   • ArrayList 생성자를 사용하여 암호화 권한을 저장하는 java.util.List 객체를 만듭니다.
   • java.util.List 객체의 add 메서드를 호출하고 설정할 권한에 해당하는 열거형 값을 전달하여 권한을 지정합니다. 예를 들어, 사용자가 PDF 문서에 있는 데이터를 복사할 수 있는 권한을 설정하려면 PasswordEncryptionPermission.PASSWORD_EDIT_COPY을 지정합니다. 설정할 각 권한에 대해 이 단계를 반복합니다.
   • PasswordEncryptionOptionSpec 개체의 setCompatability 메서드를 호출하고 Acrobat 호환성 수준을 지정하는 열거형 값을 전달하여 Acrobat 호환성 옵션을 지정합니다. 예를 들어 PasswordEncryptionCompatability.ACRO_7을(를) 지정할 수 있습니다.
   • 사용자가 PasswordEncryptionOptionSpec 개체의 setDocumentOpenPassword 메서드를 호출하고 열린 암호를 나타내는 문자열 값을 전달하여 암호화된 PDF 문서를 열 수 있도록 하는 암호 값을 지정합니다.
   • 사용자가 PasswordEncryptionOptionSpec 객체의 setPermissionPassword 메서드를 호출하고 마스터 암호를 나타내는 문자열 값을 전달하여 PDF 문서에서 암호화를 제거할 수 있도록 하는 마스터 암호 값을 지정합니다.

5. 암호를 추가합니다.

   EncryptionServiceClient 개체의 encryptPDFUsingPassword 메서드를 호출하고 다음 값을 전달하여 PDF 문서를 암호화합니다.

   • 암호로 암호화할 PDF 문서를 포함하는 com.adobe.idp.Document 객체입니다.
   • 암호화 런타임 옵션이 포함된 PasswordEncryptionOptionSpec 객체입니다.

   encryptPDFUsingPassword 메서드는 암호로 암호화된 PDF 문서를 포함하는 com.adobe.idp.Document 개체를 반환합니다.

6. 암호화된 PDF 문서를 PDF 파일로 저장할 수 있습니다.

   • java.io.File 개체를 만들고 파일 확장자가 .pdf인지 확인합니다.
   • com.adobe.idp.Document 객체의 copyToFile 메서드를 호출하여 com.adobe.idp.Document 객체의 내용을 파일에 복사합니다. encryptPDFUsingPassword 메서드에서 반환된 com.adobe.idp.Document 개체를 사용해야 합니다.

참고 항목

단계 요약

빠른 시작(SOAP 모드):Java API를 사용하여 PDF 문서 암호화

AEM Forms Java 라이브러리 파일 포함

연결 속성 설정

웹 서비스 API을(를) 사용하여 PDF 문서 암호화

암호화 API(웹 서비스)를 사용하여 암호로 PDF 문서를 암호화합니다.

1. 프로젝트 파일 포함

   MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다.http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1.

   노트

   localhost을(를) AEM Forms을 호스팅하는 서버의 IP 주소로 바꿉니다.

2. 암호화 클라이언트 API 객체를 만듭니다.

   • 기본 생성자를 사용하여 EncryptionServiceClient 객체를 만듭니다.

   • System.ServiceModel.EndpointAddress 생성자를 사용하여 EncryptionServiceClient.Endpoint.Address 객체를 만듭니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예: http://localhost:8080/soap/services/EncryptionService?WSDL). lc_version 특성을 사용할 필요가 없습니다. 이 속성은 서비스 참조를 만들 때 사용됩니다.)

   • EncryptionServiceClient.Endpoint.Binding 필드의 값을 가져와서 System.ServiceModel.BasicHttpBinding 개체를 만듭니다. 반환 값을 BasicHttpBinding으로 캐스팅합니다.

   • System.ServiceModel.BasicHttpBinding 개체의 MessageEncoding 필드를 WSMessageEncoding.Mtom로 설정합니다. 이 값을 사용하면 MTOM이 사용됩니다.

   • 다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.

     • AEM 양식 사용자 이름을 EncryptionServiceClient.ClientCredentials.UserName.UserName 필드에 지정합니다.
     • 해당 암호 값을 EncryptionServiceClient.ClientCredentials.UserName.Password 필드에 지정합니다.
     • BasicHttpBindingSecurity.Transport.ClientCredentialType 필드에 상수 값 HttpClientCredentialType.Basic을 할당합니다.
     • BasicHttpBindingSecurity.Security.Mode 필드에 상수 값 BasicHttpSecurityMode.TransportCredentialOnly을 할당합니다.

3. 암호화할 PDF 문서를 만들 수 있습니다.

   • 생성자를 사용하여 BLOB 객체를 만듭니다. BLOB 개체는 암호로 암호화된 PDF 문서를 저장하는 데 사용됩니다.
   • 생성자를 호출하고 암호화할 PDF 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달하여 System.IO.FileStream 객체를 만듭니다.
   • System.IO.FileStream 객체의 내용을 저장하는 바이트 배열을 만듭니다. System.IO.FileStream 객체의 Length 속성을 가져와 바이트 배열의 크기를 결정할 수 있습니다.
   • System.IO.FileStream 객체의 Read 메서드를 호출하고 바이트 배열, 시작 위치 및 읽을 스트림 길이를 전달하여 바이트 배열을 스트림 데이터로 채웁니다.
   • 바이트 배열의 내용을 BLOB 객체의 MTOM 데이터 멤버에 할당하여 BLOB 객체를 채웁니다.

4. 암호화 런타임 옵션을 설정합니다.

   • 생성자를 사용하여 PasswordEncryptionOptionSpec 객체를 만듭니다.
   • PasswordEncryptionOptionSpec 개체의 encryptOption 데이터 멤버에 PasswordEncryptionOption 열거형 값을 할당하여 암호화할 PDF 문서 리소스를 지정합니다. 메타데이터와 첨부 파일을 포함하여 전체 PDF를 암호화하려면 이 데이터 멤버에 PasswordEncryptionOption.ALL을(를) 할당합니다.
   • PasswordEncryptionCompatability 열거형 값을 PasswordEncryptionOptionSpec 개체의 compatability 데이터 멤버에 할당하여 Acrobat 호환성 옵션을 지정합니다. 예를 들어 이 데이터 멤버에 PasswordEncryptionCompatability.ACRO_7을(를) 할당합니다.
   • 사용자가 PasswordEncryptionOptionSpec 개체의 documentOpenPassword 데이터 멤버에 열린 암호를 나타내는 문자열 값을 할당하여 암호화된 PDF 문서를 열 수 있도록 암호 값을 지정합니다.
   • 마스터 암호를 나타내는 문자열 값을 PasswordEncryptionOptionSpec 개체의 permissionPassword 데이터 멤버에 할당하여 사용자가 PDF 문서에서 암호화를 제거할 수 있도록 암호 값을 지정합니다.

5. 암호를 추가합니다.

   EncryptionServiceClient 개체의 encryptPDFUsingPassword 메서드를 호출하고 다음 값을 전달하여 PDF 문서를 암호화합니다.

   • 암호로 암호화할 PDF 문서를 포함하는 BLOB 객체입니다.
   • 암호화 런타임 옵션이 포함된 PasswordEncryptionOptionSpec 객체입니다.

   encryptPDFUsingPassword 메서드는 암호로 암호화된 PDF 문서를 포함하는 BLOB 개체를 반환합니다.

6. 암호화된 PDF 문서를 PDF 파일로 저장할 수 있습니다.

   • 생성자를 호출하고 보안 PDF 문서의 파일 위치를 나타내는 문자열 값을 전달하여 System.IO.FileStream 객체를 만듭니다.
   • encryptPDFUsingPassword 메서드에서 반환된 BLOB 객체의 데이터 내용을 저장하는 바이트 배열을 만듭니다. BLOB 객체의 MTOM 데이터 멤버 값을 가져와 바이트 배열을 채웁니다.
   • 생성자를 호출하고 System.IO.FileStream 객체를 전달하여 System.IO.BinaryWriter 객체를 만듭니다.
   • System.IO.BinaryWriter 객체의 Write 메서드를 호출하고 바이트 배열을 전달하여 바이트 배열의 내용을 PDF 파일에 기록합니다.

참고 항목

단계 요약

MTOM을 사용하여 AEM Forms 호출

SwaRef를 사용하여 AEM Forms 호출

인증서를 사용하여 PDF 문서 암호화

인증서 기반의 암호화를 사용하면 공개 키 기술을 통해 특정 수신자의 문서를 암호화할 수 있습니다. 문서에 대해 서로 다른 권한을 여러 받는 사람에게 부여할 수 있습니다. 암호화의 많은 측면들은 공개 키 기술로 가능하다. 알고리즘은 다음 속성이 있는 keys​이라는 두 개의 큰 숫자를 생성하는 데 사용됩니다.

• 하나의 키는 데이터 집합을 암호화하는 데 사용됩니다. 그 다음에는 다른 키만 데이터를 해독하는 데 사용할 수 있습니다.
• 하나의 키를 다른 키와 구별하는 것은 불가능하다.

키 중 하나가 사용자의 개인 키 역할을 합니다. 이 키에 대한 액세스 권한은 사용자에게만 있는 것이 중요합니다. 다른 키는 다른 사람과 공유할 수 있는 사용자의 공개 키입니다.

공개 키 인증서에는 사용자의 공개 키와 식별 정보가 들어 있습니다. X.509 형식은 인증서를 저장하는 데 사용됩니다. 인증서는 일반적으로 인증서 유효성에 대한 신뢰도를 측정하는 인식된 실체인 인증 기관(CA)을 통해 발행되고 디지털 서명을 합니다. 인증서는 만료 날짜가 있으며 만료 날짜는 더 이상 유효하지 않습니다. 또한 CRL(인증서 해지 목록)은 만료 날짜 이전에 해지된 인증서에 대한 정보를 제공합니다. CRL은 인증서 당국에 의해 정기적으로 게시됩니다. 인증서의 해지 상태는 네트워크를 통해 OCSP(Online Certificate Status Protocol)를 통해 검색할 수도 있습니다.

단계 요약

인증서를 사용하여 PDF 문서를 암호화하려면 다음 단계를 수행하십시오.

1. 프로젝트 파일 포함
2. 암호화 클라이언트 API 객체를 만듭니다.
3. 암호화할 PDF 문서를 만들 수 있습니다.
4. 인증서를 참조합니다.
5. 암호화 런타임 옵션을 설정합니다.
6. 인증서로 암호화된 PDF 문서를 만듭니다.
7. 암호화된 PDF 문서를 PDF 파일로 저장할 수 있습니다.

프로젝트 파일 포함

개발 프로젝트에 필요한 파일을 포함합니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.

다음 JAR 파일을 프로젝트의 클래스 경로에 추가해야 합니다.

• adobe-livecycle-client.jar
• adobe-usermanager-client.jar
• adobe-encryption-client.jar
• adobe-utilities.jar (AEM Forms이 JBoss Application Server에 배포된 경우 필수)
• jbossall-client.jar (AEM Forms이 JBoss Application Server에 배포된 경우 필수)

암호화 클라이언트 API 개체 만들기

암호화 서비스 작업을 프로그래밍 방식으로 수행하려면 암호화 서비스 클라이언트를 만들어야 합니다. Java 암호화 서비스 API를 사용하는 경우 EncrytionServiceClient 개체를 만듭니다. 웹 서비스 암호화 서비스 API를 사용하는 경우 EncryptionServiceService 개체를 만듭니다.

암호화할 PDF 문서 받기

암호화하려면 암호화되지 않은 PDF 문서를 가져와야 합니다. 이미 암호화된 PDF 문서를 보호하려고 하면 예외가 발생합니다.

인증서 참조

인증서를 사용하여 PDF 문서를 암호화하려면 PDF 문서를 암호화하는 데 사용되는 인증서를 참조합니다. 인증서는 .cer 파일, .crt 파일 또는 .pem 파일입니다. PKCS#12 파일은 해당 인증서가 있는 개인 키를 저장하는 데 사용됩니다.

인증서를 사용하여 PDF 문서를 암호화할 때 보안 문서와 연결된 권한을 지정합니다. 권한을 지정하여 인증서로 암호화된 PDF 문서를 여는 사용자가 수행할 수 있는 작업을 제어할 수 있습니다.

암호화 런타임 옵션 설정

암호화할 PDF 문서 리소스를 지정합니다. 문서의 메타데이터를 제외한 모든 문서 또는 문서의 첨부 파일만 암호화할 수 있습니다.

인증서로 암호화된 PDF 문서 만들기

보안되지 않은 PDF 문서를 검색하고, 인증서를 참조하고, 실행 시간 옵션을 설정한 후, 인증서로 암호화된 PDF 문서를 만들 수 있습니다. PDF 문서가 암호화되면 암호를 해독하려면 해당 공개 키가 필요합니다.

암호화된 PDF 문서를 PDF 파일로 저장

암호화된 PDF 문서를 PDF 파일로 저장할 수 있습니다.

참고 항목

Java API를 사용하여 인증서로 PDF 문서 암호화

웹 서비스 API를 사용하여 인증서를 사용하여 PDF 문서 암호화

AEM Forms Java 라이브러리 파일 포함

연결 속성 설정

암호화 서비스 API 빠른 시작

암호로 PDF 문서 암호화

Java API를 사용하여 인증서로 PDF 문서를 암호화합니다.

암호화 API(Java)를 사용하여 인증서를 사용하여 PDF 문서를 암호화합니다.

1. 프로젝트 파일 포함

   Java 프로젝트의 클래스 경로에 adobe-encryption-client.jar 등의 클라이언트 JAR 파일을 포함합니다.

2. 암호화 클라이언트 API 객체를 만듭니다.

   • 연결 속성을 포함하는 ServiceClientFactory 개체를 만듭니다.
   • 생성자를 사용하여 EncryptionServiceClient 개체를 만들고 ServiceClientFactory 개체를 전달합니다.

3. 암호화할 PDF 문서를 만들 수 있습니다.

   • 생성자를 사용하고 PDF 문서의 위치를 지정하는 문자열 값을 전달하여 암호화할 PDF 문서를 나타내는 java.io.FileInputStream 객체를 만듭니다.
   • 생성자를 사용하여 com.adobe.idp.Document 개체를 만들고 java.io.FileInputStream 개체를 전달합니다.

4. 인증서를 참조합니다.

   • 생성자를 사용하여 권한 정보를 저장하는 java.util.List 개체를 만듭니다.
   • java.util.List 개체의 add 메서드를 호출하고 보안 PDF 문서를 여는 사용자에게 부여된 권한을 나타내는 CertificateEncryptionPermissions 열거형 값을 전달하여 암호화된 문서와 관련된 권한을 지정합니다. 예를 들어 모든 권한을 지정하려면 CertificateEncryptionPermissions.PKI_ALL_PERM을 전달합니다.
   • 생성자를 사용하여 Recipient 객체를 만듭니다.
   • 생성자를 사용하고 인증서의 위치를 지정하는 문자열 값을 전달하여 PDF 문서를 암호화하는 데 사용되는 인증서를 나타내는 java.io.FileInputStream 객체를 만듭니다.
   • 생성자를 사용하여 com.adobe.idp.Document 객체를 만들고 인증서를 나타내는 java.io.FileInputStream 객체를 전달합니다.
   • Recipient 객체의 setX509Cert 메서드를 호출하고 인증서가 포함된 com.adobe.idp.Document 객체를 전달합니다. 또한 Recipient 개체는 Truststore 인증서 별칭 또는 LDAP URL을 인증서 소스로 사용할 수 있습니다.
   • 생성자를 사용하여 권한 및 인증서 정보를 저장하는 CertificateEncryptionIdentity 객체를 만듭니다.
   • CertificateEncryptionIdentity 개체의 setPerms 메서드를 호출하고 권한 정보를 저장하는 java.util.List 개체를 전달합니다.
   • CertificateEncryptionIdentity 객체의 setRecipient 메서드를 호출하고 인증서 정보를 저장하는 Recipient 객체를 전달합니다.
   • 생성자를 사용하여 인증서 정보를 저장하는 java.util.List 객체를 만듭니다.
   • java.util.List 객체의 add 메서드를 호출하고 CertificateEncryptionIdentity 객체를 전달합니다. 이 java.util.List 개체는 encryptPDFUsingCertificates 메서드에 매개 변수로 전달됩니다.

5. 암호화 런타임 옵션을 설정합니다.

   • 생성자를 호출하여 CertificateEncryptionOptionSpec 객체를 만듭니다.
   • CertificateEncryptionOptionSpec 개체의 setOption 메서드를 호출하고 암호화할 문서 리소스를 지정하는 CertificateEncryptionOption 열거형 값을 전달하여 암호화할 PDF 문서 리소스를 지정합니다. 예를 들어 메타데이터와 첨부 파일을 포함하여 전체 PDF 문서를 암호화하려면 CertificateEncryptionOption.ALL을 지정합니다.
   • CertificateEncryptionOptionSpec 개체의 setCompat 메서드를 호출하고 Acrobat 호환성 수준을 지정하는 CertificateEncryptionCompatibility 열거형 값을 전달하여 Acrobat 호환성 옵션을 지정합니다. 예를 들어 CertificateEncryptionCompatibility.ACRO_7을(를) 지정할 수 있습니다.

6. 인증서로 암호화된 PDF 문서를 만듭니다.

   EncryptionServiceClient 개체의 encryptPDFUsingCertificates 메서드를 호출하고 다음 값을 전달하여 인증서로 PDF 문서를 암호화합니다.

   • 암호화할 PDF 문서를 포함하는 com.adobe.idp.Document 객체입니다.
   • 인증서 정보를 저장하는 java.util.List 객체입니다.
   • 암호화 런타임 옵션이 포함된 CertificateEncryptionOptionSpec 객체입니다.

   encryptPDFUsingCertificates 메서드는 인증서로 암호화된 PDF 문서를 포함하는 com.adobe.idp.Document 개체를 반환합니다.

7. 암호화된 PDF 문서를 PDF 파일로 저장할 수 있습니다.

   • java.io.File 개체를 만들고 파일 이름 확장자가 .pdf인지 확인합니다.
   • com.adobe.idp.Document 객체의 copyToFile 메서드를 호출하여 com.adobe.idp.Document 객체의 내용을 파일에 복사합니다. encryptPDFUsingCertificates 메서드에서 반환된 com.adobe.idp.Document 개체를 사용해야 합니다.

참고 항목

단계 요약

빠른 시작(SOAP 모드):Java API를 사용하여 인증서를 사용하여 PDF 문서 암호화

AEM Forms Java 라이브러리 파일 포함

연결 속성 설정

웹 서비스 API를 사용하여 인증서로 PDF 문서를 암호화합니다.

암호화 API(웹 서비스)를 사용하여 인증서를 사용하여 PDF 문서를 암호화합니다.

1. 프로젝트 파일 포함

   MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다.http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1.

   노트

   localhost을(를) AEM Forms을 호스팅하는 서버의 IP 주소로 바꿉니다.

2. 암호화 클라이언트 API 객체를 만듭니다.

   • 기본 생성자를 사용하여 EncryptionServiceClient 객체를 만듭니다.

   • System.ServiceModel.EndpointAddress 생성자를 사용하여 EncryptionServiceClient.Endpoint.Address 객체를 만듭니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예: http://localhost:8080/soap/services/EncryptionService?WSDL). lc_version 특성을 사용할 필요가 없습니다. 이 속성은 서비스 참조를 만들 때 사용됩니다.)

   • EncryptionServiceClient.Endpoint.Binding 필드의 값을 가져와서 System.ServiceModel.BasicHttpBinding 개체를 만듭니다. 반환 값을 BasicHttpBinding으로 캐스팅합니다.

   • System.ServiceModel.BasicHttpBinding 개체의 MessageEncoding 필드를 WSMessageEncoding.Mtom로 설정합니다. 이 값을 사용하면 MTOM이 사용됩니다.

   • 다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.

     • AEM 양식 사용자 이름을 EncryptionServiceClient.ClientCredentials.UserName.UserName 필드에 지정합니다.
     • 해당 암호 값을 EncryptionServiceClient.ClientCredentials.UserName.Password 필드에 지정합니다.
     • BasicHttpBindingSecurity.Transport.ClientCredentialType 필드에 상수 값 HttpClientCredentialType.Basic을 할당합니다.
     • BasicHttpBindingSecurity.Security.Mode 필드에 상수 값 BasicHttpSecurityMode.TransportCredentialOnly을 할당합니다.

3. 암호화할 PDF 문서를 만들 수 있습니다.

   • 생성자를 사용하여 BLOB 객체를 만듭니다. BLOB 개체는 인증서로 암호화된 PDF 문서를 저장하는 데 사용됩니다.
   • 생성자를 호출하고 암호화할 PDF 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달하여 System.IO.FileStream 객체를 만듭니다.
   • System.IO.FileStream 객체의 내용을 저장하는 바이트 배열을 만듭니다. System.IO.FileStream 객체의 Length 속성을 가져와 바이트 배열의 크기를 결정할 수 있습니다.
   • System.IO.FileStream 객체의 Read 메서드를 호출하고 바이트 배열, 시작 위치 및 읽을 스트림 길이를 전달하여 바이트 배열을 스트림 데이터로 채웁니다.
   • 바이트 배열의 내용으로 MTOM 속성을 할당하여 BLOB 객체를 채웁니다.

4. 인증서를 참조합니다.

   • 생성자를 사용하여 Recipient 객체를 만듭니다. 이 개체는 인증서 정보를 저장합니다.
   • 생성자를 사용하여 BLOB 객체를 만듭니다. 이 BLOB 개체는 PDF 문서를 암호화하는 인증서를 저장합니다.
   • 생성자를 호출하고 인증서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달하여 System.IO.FileStream 객체를 만듭니다.
   • System.IO.FileStream 객체의 내용을 저장하는 바이트 배열을 만듭니다. System.IO.FileStream 객체의 Length 속성을 가져와 바이트 배열의 크기를 결정할 수 있습니다.
   • System.IO.FileStream 객체의 Read 메서드를 호출하고 바이트 배열, 시작 위치 및 읽을 스트림 길이를 전달하여 바이트 배열을 스트림 데이터로 채웁니다.
   • 바이트 배열의 내용을 BLOB 객체의 MTOM 데이터 멤버에 할당하여 BLOB 객체를 채웁니다.
   • 인증서를 저장하는 BLOB 개체를 Recipient 개체의 x509Cert 데이터 멤버에 할당합니다.
   • 생성자를 사용하여 인증서 정보를 저장하는 CertificateEncryptionIdentity 객체를 만듭니다.
   • 인증서를 저장하는 Recipient 개체를 CertificateEncryptionIdentity 개체의 받는 데이터 멤버에 할당합니다.
   • Object 배열을 만들고 CertificateEncryptionIdentity 개체를 Object 배열의 첫 번째 요소에 할당합니다. 이 Object 배열은 매개 변수로 encryptPDFUsingCertificates 메서드에 전달됩니다.

5. 암호화 런타임 옵션을 설정합니다.

   • 생성자를 사용하여 CertificateEncryptionOptionSpec 객체를 만듭니다.
   • CertificateEncryptionOptionSpec 개체의 option 데이터 멤버에 CertificateEncryptionOption 열거형 값을 할당하여 암호화할 PDF 문서 리소스를 지정합니다. 메타데이터와 첨부 파일을 포함하여 전체 PDF 문서를 암호화하려면 이 데이터 멤버에 CertificateEncryptionOption.ALL을(를) 할당합니다.
   • CertificateEncryptionCompatibility 열거형 값을 CertificateEncryptionOptionSpec 개체의 compat 데이터 멤버에 할당하여 Acrobat 호환성 옵션을 지정합니다. 예를 들어 이 데이터 멤버에 CertificateEncryptionCompatibility.ACRO_7을(를) 할당합니다.

6. 인증서로 암호화된 PDF 문서를 만듭니다.

   EncryptionServiceService 개체의 encryptPDFUsingCertificates 메서드를 호출하고 다음 값을 전달하여 인증서로 PDF 문서를 암호화합니다.

   • 암호화할 PDF 문서를 포함하는 BLOB 객체입니다.
   • 인증서 정보를 저장하는 Object 배열입니다.
   • 암호화 런타임 옵션이 포함된 CertificateEncryptionOptionSpec 객체입니다.

   encryptPDFUsingCertificates 메서드는 인증서로 암호화된 PDF 문서를 포함하는 BLOB 개체를 반환합니다.

7. 암호화된 PDF 문서를 PDF 파일로 저장할 수 있습니다.

   • 생성자를 호출하고 보안 PDF 문서의 파일 위치를 나타내는 문자열 값을 전달하여 System.IO.FileStream 객체를 만듭니다.
   • encryptPDFUsingCertificates 메서드에서 반환된 BLOB 객체의 데이터 내용을 저장하는 바이트 배열을 만듭니다. BLOB 객체의 binaryData 데이터 멤버 값을 가져와 바이트 배열을 채웁니다.
   • 생성자를 호출하고 System.IO.FileStream 객체를 전달하여 System.IO.BinaryWriter 객체를 만듭니다.
   • System.IO.BinaryWriter 객체의 Write 메서드를 호출하고 바이트 배열을 전달하여 바이트 배열의 내용을 PDF 파일에 기록합니다.

참고 항목

단계 요약

MTOM을 사용하여 AEM Forms 호출

SwaRef를 사용하여 AEM Forms 호출

인증서 기반 암호화 제거 중

PDF 문서에서 인증서 기반 암호화를 제거하여 사용자가 Adobe Reader 또는 Acrobat에서 PDF 문서를 열 수 있도록 할 수 있습니다. 인증서로 암호화된 PDF 문서에서 암호화를 제거하려면 공개 키를 참조해야 합니다. PDF 문서에서 암호화를 제거한 후에는 더 이상 안전하지 않습니다.

단계 요약

PDF 문서에서 인증서 기반 암호화를 제거하려면 다음 단계를 수행합니다.

1. 프로젝트 파일 포함
2. 암호화 서비스 클라이언트를 만듭니다.
3. 암호화된 PDF 문서를 가져올 수 있습니다.
4. 암호화 제거
5. PDF 문서를 PDF 파일로 저장합니다.

프로젝트 파일 포함

개발 프로젝트에 필요한 파일을 포함할 수 있습니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.

다음 JAR 파일을 프로젝트의 클래스 경로에 추가해야 합니다.

• adobe-livecycle-client.jar
• adobe-usermanager-client.jar
• adobe-encryption-client.jar
• adobe-utilities.jar (AEM Forms이 JBoss Application Server에 배포된 경우 필수)
• jbossall-client.jar (AEM Forms이 JBoss Application Server에 배포된 경우 필수)

암호화 서비스 클라이언트 만들기

암호화 서비스 작업을 프로그래밍 방식으로 수행하려면 암호화 서비스 클라이언트를 만들어야 합니다. Java 암호화 서비스 API를 사용하는 경우 EncrytionServiceClient 개체를 만듭니다. 웹 서비스 암호화 서비스 API를 사용하는 경우 EncryptionServiceService 개체를 만듭니다.

암호화된 PDF 문서 가져오기

인증서 기반 암호화를 제거하려면 암호화된 PDF 문서를 얻어야 합니다. 암호화되지 않은 PDF 문서에서 암호화를 제거하려고 하면 예외가 발생합니다. 마찬가지로 암호로 암호화된 문서에서 인증서 기반 암호화를 제거하려고 하면 예외가 발생합니다.

암호화 제거

암호화된 PDF 문서에서 인증서 기반 암호화를 제거하려면 암호화된 PDF 문서와 PDF 문서 암호화에 사용된 키에 해당하는 개인 키가 모두 필요합니다. 암호화된 PDF 문서에서 인증서 기반 암호화를 제거할 때 개인 키의 별칭 값이 지정됩니다. 공개 키에 대한 자세한 내용은 인증서를 사용하여 PDF 문서 암호화를 참조하십시오.

PDF 문서 저장

암호화된 PDF 문서에서 인증서 기반 암호화를 제거한 후 PDF 문서를 PDF 파일로 저장할 수 있습니다. 사용자는 Adobe Reader 또는 Acrobat에서 PDF 문서를 열 수 있습니다.

참고 항목

Java API를 사용하여 인증서 기반 암호화 제거

웹 서비스 API를 사용하여 인증서 기반의 암호화 제거

AEM Forms Java 라이브러리 파일 포함

연결 속성 설정

암호화 서비스 API 빠른 시작

Java API를 사용하여 인증서 기반 암호화 제거

암호화 API(Java)를 사용하여 PDF 문서에서 인증서 기반 암호화를 제거합니다.

1. 프로젝트 파일 포함

   Java 프로젝트의 클래스 경로에 adobe-encryption-client.jar 등의 클라이언트 JAR 파일을 포함합니다.

2. 암호화 서비스 클라이언트를 만듭니다.

   • 연결 속성을 포함하는 ServiceClientFactory 개체를 만듭니다.
   • 생성자를 사용하여 EncryptionServiceClient 개체를 만들고 ServiceClientFactory 개체를 전달합니다.

3. 암호화된 PDF 문서를 가져올 수 있습니다.

   • 생성자를 사용하여 암호화된 PDF 문서의 위치를 지정하는 문자열 값을 전달하여 암호화된 PDF 문서를 나타내는 java.io.FileInputStream 객체를 만듭니다.
   • 생성자를 사용하여 com.adobe.idp.Document 개체를 만들고 java.io.FileInputStream 개체를 전달합니다.

4. 암호화 제거

   EncryptionServiceClient 개체의 removePDFCertificateSecurity 메서드를 호출하고 다음 값을 전달하여 PDF 문서에서 인증서 기반 암호화를 제거합니다.

   • 암호화된 PDF 문서를 포함하는 com.adobe.idp.Document 객체입니다.
   • PDF 문서를 암호화하는 데 사용되는 키에 해당하는 개인 키의 별칭 이름을 지정하는 문자열 값입니다.

   removePDFCertificateSecurity 메서드는 보안되지 않은 PDF 문서를 포함하는 com.adobe.idp.Document 개체를 반환합니다.

5. PDF 문서를 저장합니다.

   • java.io.File 개체를 만들고 파일 확장자가 .pdf인지 확인합니다.
   • com.adobe.idp.Document 객체의 copyToFile 메서드를 호출하여 Document 객체의 내용을 파일에 복사합니다. removePDFCredentialSecurity 메서드에서 반환된 com.adobe.idp.Document 개체를 사용해야 합니다.

참고 항목

단계 요약

빠른 시작(SOAP 모드):Java API를 사용하여 인증서 기반 암호화 제거

AEM Forms Java 라이브러리 파일 포함

연결 속성 설정

웹 서비스 API를 사용하여 인증서 기반 암호화 제거

암호화 API(웹 서비스)를 사용하여 인증서 기반 암호화를 제거합니다.

1. 프로젝트 파일 포함

   MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다.http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1.

   노트

   localhost을(를) AEM Forms을 호스팅하는 서버의 IP 주소로 바꿉니다.

2. 암호화 서비스 클라이언트를 만듭니다.

   • 기본 생성자를 사용하여 EncryptionServiceClient 객체를 만듭니다.

   • System.ServiceModel.EndpointAddress 생성자를 사용하여 EncryptionServiceClient.Endpoint.Address 객체를 만듭니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예: http://localhost:8080/soap/services/EncryptionService?WSDL). lc_version 특성을 사용할 필요가 없습니다. 이 속성은 서비스 참조를 만들 때 사용됩니다.)

   • EncryptionServiceClient.Endpoint.Binding 필드의 값을 가져와서 System.ServiceModel.BasicHttpBinding 개체를 만듭니다. 반환 값을 BasicHttpBinding으로 캐스팅합니다.

   • System.ServiceModel.BasicHttpBinding 개체의 MessageEncoding 필드를 WSMessageEncoding.Mtom로 설정합니다. 이 값을 사용하면 MTOM이 사용됩니다.

   • 다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.

     • AEM 양식 사용자 이름을 EncryptionServiceClient.ClientCredentials.UserName.UserName 필드에 지정합니다.
     • 해당 암호 값을 EncryptionServiceClient.ClientCredentials.UserName.Password 필드에 지정합니다.
     • BasicHttpBindingSecurity.Transport.ClientCredentialType 필드에 상수 값 HttpClientCredentialType.Basic을 할당합니다.
     • BasicHttpBindingSecurity.Security.Mode 필드에 상수 값 BasicHttpSecurityMode.TransportCredentialOnly을 할당합니다.

3. 암호화된 PDF 문서를 가져올 수 있습니다.

   • 생성자를 사용하여 BLOB 객체를 만듭니다. BLOB 개체는 암호화된 PDF 문서를 저장하는 데 사용됩니다.
   • 생성자를 호출하고 암호화된 PDF 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달하여 System.IO.FileStream 객체를 만듭니다.
   • System.IO.FileStream 객체의 내용을 저장하는 바이트 배열을 만듭니다. System.IO.FileStream 객체의 Length 속성을 가져와 바이트 배열의 크기를 결정할 수 있습니다.
   • System.IO.FileStream 객체의 Read 메서드를 호출하고 바이트 배열, 시작 위치 및 읽을 스트림 길이를 전달하여 바이트 배열을 스트림 데이터로 채웁니다.
   • 바이트 배열의 내용을 BLOB 객체의 MTOM 데이터 멤버에 할당하여 BLOB 객체를 채웁니다.

4. 암호화 제거

   EncryptionServiceClient 객체의 removePDFCertificateSecurity 메서드를 호출하고 다음 값을 전달합니다.

   • 암호화된 PDF 문서를 나타내는 파일 스트림 데이터가 포함된 BLOB 객체입니다.
   • PDF 문서를 암호화하는 데 사용되는 개인 키에 해당하는 공개 키의 별칭 이름을 지정하는 문자열 값입니다.

   removePDFCredentialSecurity 메서드는 보안되지 않은 PDF 문서를 포함하는 BLOB 개체를 반환합니다.

5. PDF 문서를 저장합니다.

   • 생성자를 호출하고 보안되지 않은 PDF 문서의 파일 위치를 나타내는 문자열 값을 전달하여 System.IO.FileStream 객체를 만듭니다.
   • removePDFPasswordSecurity 메서드에서 반환된 BLOB 객체의 내용을 저장하는 바이트 배열을 만듭니다. BLOB 객체의 MTOM 데이터 멤버 값을 가져와 바이트 배열을 채웁니다.
   • 생성자를 호출하고 System.IO.FileStream 객체를 전달하여 System.IO.BinaryWriter 객체를 만듭니다.
   • System.IO.BinaryWriter 객체의 Write 메서드를 호출하고 바이트 배열을 전달하여 바이트 배열의 내용을 PDF 파일에 기록합니다.

참고 항목

단계 요약

MTOM을 사용하여 AEM Forms 호출

SwaRef를 사용하여 AEM Forms 호출

암호 암호화 제거 중

암호 기반 암호화를 PDF 문서에서 제거하여 사용자가 암호를 지정하지 않고도 Adobe Reader 또는 Acrobat에서 PDF 문서를 열 수 있도록 할 수 있습니다. 암호 기반 암호화를 PDF 문서에서 제거한 후에는 문서가 더 이상 안전하지 않습니다.

단계 요약

PDF 문서에서 암호 기반 암호화를 제거하려면 다음 단계를 수행합니다.

1. 프로젝트 파일 포함
2. 암호화 서비스 클라이언트를 만듭니다.
3. 암호화된 PDF 문서를 가져올 수 있습니다.
4. 암호를 제거합니다.
5. PDF 문서를 PDF 파일로 저장합니다.

프로젝트 파일 포함

개발 프로젝트에 필요한 파일을 포함합니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.

다음 JAR 파일을 프로젝트의 클래스 경로에 추가해야 합니다.

• adobe-livecycle-client.jar
• adobe-usermanager-client.jar
• adobe-encryption-client.jar
• adobe-utilities.jar (AEM Forms이 JBoss에 배포된 경우 필수)
• jbossall-client.jar (AEM Forms이 JBoss에 배포된 경우 필수)

암호화 서비스 클라이언트 만들기

암호화 서비스 작업을 프로그래밍 방식으로 수행하려면 암호화 서비스 클라이언트를 만들어야 합니다. Java 암호화 서비스 API를 사용하는 경우 EncrytionServiceClient 개체를 만듭니다. 웹 서비스 암호화 서비스 API를 사용하는 경우 EncryptionServiceService 개체를 만듭니다.

암호화된 PDF 문서 가져오기

암호 기반 암호화를 제거하려면 암호화된 PDF 문서를 얻어야 합니다. 암호화되지 않은 PDF 문서에서 암호화를 제거하려고 하면 예외가 발생합니다.

암호 제거

암호화된 PDF 문서에서 암호 기반 암호화를 제거하려면 암호화된 PDF 문서와 PDF 문서에서 암호화를 제거하는 데 사용되는 마스터 암호 값이 모두 필요합니다. 암호로 암호화된 PDF 문서를 여는 데 사용되는 암호는 암호화 제거 시 사용할 수 없습니다. PDF 문서가 암호로 암호화될 때 마스터 암호가 지정됩니다. (암호를 사용하여 PDF 문서 암호화를 참조하십시오.)

PDF 문서 저장

암호화 서비스가 PDF 문서에서 암호 기반 암호화를 제거한 후 PDF 문서를 PDF 파일로 저장할 수 있습니다. 사용자는 암호를 지정하지 않고도 Adobe Reader 또는 Acrobat에서 PDF 문서를 열 수 있습니다.

참고 항목

AEM Forms Java 라이브러리 파일 포함

연결 속성 설정

암호화 서비스 API 빠른 시작

암호로 PDF 문서 암호화

Java API를 사용하여 암호 기반 암호화 제거

암호화 API(Java)를 사용하여 PDF 문서에서 암호 기반 암호화를 제거합니다.

1. 프로젝트 파일 포함

   Java 프로젝트의 클래스 경로에 adobe-encryption-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.

2. 암호화 서비스 클라이언트를 만듭니다.

   • 연결 속성을 포함하는 ServiceClientFactory 개체를 만듭니다.
   • 생성자를 사용하여 EncryptionServiceClient 개체를 만들고 ServiceClientFactory 개체를 전달합니다.

3. 암호화된 PDF 문서를 가져올 수 있습니다.

   • 생성자를 사용하고 PDF 문서의 위치를 지정하는 문자열 값을 전달하여 암호화된 PDF 문서를 나타내는 java.io.FileInputStream 객체를 만듭니다.
   • 생성자를 사용하여 com.adobe.idp.Document 개체를 만들고 java.io.FileInputStream 개체를 전달합니다.

4. 암호를 제거합니다.

   EncryptionServiceClient 개체의 removePDFPasswordSecurity 메서드를 호출하고 다음 값을 전달하여 PDF 문서에서 암호 기반 암호화를 제거합니다.

   • 암호화된 PDF 문서를 포함하는 com.adobe.idp.Document 객체입니다.
   • PDF 문서에서 암호화를 제거하는 데 사용되는 마스터 암호 값을 지정하는 문자열 값입니다.

   removePDFPasswordSecurity 메서드는 보안되지 않은 PDF 문서를 포함하는 com.adobe.idp.Document 개체를 반환합니다.

5. PDF 문서를 저장합니다.

   • java.io.File 개체를 만들고 파일 이름 확장자가 .pdf인지 확인합니다.
   • com.adobe.idp.Document 객체의 copyToFile 메서드를 호출하여 Document 객체의 내용을 파일에 복사합니다. removePDFPasswordSecurity 메서드에서 반환된 Document 개체를 사용해야 합니다.

참고 항목

빠른 시작(SOAP 모드):Java API를 사용하여 암호 기반 암호화 제거

웹 서비스 API를 사용하여 암호 기반 암호화 제거

암호화 API(웹 서비스)를 사용하여 암호 기반 암호화를 제거합니다.

1. 프로젝트 파일 포함

   MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다.http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1.

   노트

   localhost을(를) AEM Forms을 호스팅하는 서버의 IP 주소로 바꿉니다.

2. 암호화 서비스 클라이언트를 만듭니다.

   • 기본 생성자를 사용하여 EncryptionServiceClient 객체를 만듭니다.

   • System.ServiceModel.EndpointAddress 생성자를 사용하여 EncryptionServiceClient.Endpoint.Address 객체를 만듭니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예: http://localhost:8080/soap/services/EncryptionService?WSDL). lc_version 특성을 사용할 필요가 없습니다. 이 속성은 서비스 참조를 만들 때 사용됩니다.)

   • EncryptionServiceClient.Endpoint.Binding 필드의 값을 가져와서 System.ServiceModel.BasicHttpBinding 개체를 만듭니다. 반환 값을 BasicHttpBinding으로 캐스팅합니다.

   • System.ServiceModel.BasicHttpBinding 개체의 MessageEncoding 필드를 WSMessageEncoding.Mtom로 설정합니다. 이 값을 사용하면 MTOM이 사용됩니다.

   • 다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.

     • AEM 양식 사용자 이름을 EncryptionServiceClient.ClientCredentials.UserName.UserName 필드에 지정합니다.
     • 해당 암호 값을 EncryptionServiceClient.ClientCredentials.UserName.Password 필드에 지정합니다.
     • BasicHttpBindingSecurity.Transport.ClientCredentialType 필드에 상수 값 HttpClientCredentialType.Basic을 할당합니다.
     • BasicHttpBindingSecurity.Security.Mode 필드에 상수 값 BasicHttpSecurityMode.TransportCredentialOnly을 할당합니다.

3. 암호화된 PDF 문서를 가져올 수 있습니다.

   • 생성자를 사용하여 BLOB 객체를 만듭니다. BLOB 개체는 암호로 암호화된 PDF 문서를 저장하는 데 사용됩니다.
   • 생성자를 호출하고 암호화된 PDF 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달하여 System.IO.FileStream 객체를 만듭니다.
   • System.IO.FileStream 객체의 내용을 저장하는 바이트 배열을 만듭니다. System.IO.FileStream 객체의 Length 속성을 가져와 바이트 배열의 크기를 결정할 수 있습니다.
   • System.IO.FileStream 객체의 Read 메서드를 호출하고 바이트 배열, 시작 위치 및 읽을 스트림 길이를 전달하여 바이트 배열을 스트림 데이터로 채웁니다.
   • 바이트 배열의 내용을 BLOB 객체의 MTOM 데이터 멤버에 할당하여 BLOB 객체를 채웁니다.

4. 암호를 제거합니다.

   EncryptionServiceService 객체의 removePDFPasswordSecurity 메서드를 호출하고 다음 값을 전달합니다.

   • 암호화된 PDF 문서를 나타내는 파일 스트림 데이터가 포함된 BLOB 객체입니다.
   • PDF 문서에서 암호화를 제거하는 데 사용되는 암호 값을 지정하는 문자열 값입니다. 이 값은 암호로 PDF 문서를 암호화할 때 지정됩니다.

   removePDFPasswordSecurity 메서드는 보안되지 않은 PDF 문서를 포함하는 BLOB 개체를 반환합니다.

5. PDF 문서를 저장합니다.

   • 생성자를 호출하고 보안되지 않은 PDF 문서의 파일 위치를 나타내는 문자열 값을 전달하여 System.IO.FileStream 객체를 만듭니다.
   • removePDFPasswordSecurity 메서드에서 반환된 BLOB 객체의 내용을 저장하는 바이트 배열을 만듭니다. BLOB 객체의 MTOM 데이터 멤버 값을 가져와 바이트 배열을 채웁니다.
   • 생성자를 호출하고 System.IO.FileStream 객체를 전달하여 System.IO.BinaryWriter 객체를 만듭니다.
   • System.IO.BinaryWriter 객체의 Write 메서드를 호출하고 바이트 배열을 전달하여 바이트 배열의 내용을 PDF 파일에 기록합니다.

참고 항목

MTOM을 사용하여 AEM Forms 호출

SwaRef를 사용하여 AEM Forms 호출

암호화된 PDF 문서 잠금 해제

암호 암호화 또는 인증서 암호화 PDF 문서를 잠금 해제해야 다른 AEM Forms 작업을 수행할 수 있습니다. 암호화된 PDF 문서에서 작업을 수행하려고 하면 예외가 생성됩니다. 암호화된 PDF 문서의 잠금을 해제하면 해당 문서에 대해 하나 이상의 작업을 수행할 수 있습니다. 이러한 작업은 Acrobat Reader DC 확장 서비스와 같은 다른 서비스에 속할 수 있습니다.

단계 요약

암호화된 PDF 문서의 잠금을 해제하려면 다음 단계를 수행합니다.

1. 프로젝트 파일 포함
2. 암호화 서비스 클라이언트를 만듭니다.
3. 암호화된 PDF 문서를 가져올 수 있습니다.
4. 문서의 잠금을 해제합니다.
5. AEM Forms 작업을 수행합니다.

프로젝트 파일 포함

개발 프로젝트에 필요한 파일을 포함할 수 있습니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.

다음 JAR 파일을 프로젝트의 클래스 경로에 추가해야 합니다.

• adobe-livecycle-client.jar
• adobe-usermanager-client.jar
• adobe-encryption-client.jar
• adobe-utilities.jar (AEM Forms이 JBoss Application Server에 배포된 경우 필수)
• jbossall-client.jar (AEM Forms이 JBoss Application Server에 배포된 경우 필수)

암호화 서비스 클라이언트 만들기

암호화 서비스 작업을 프로그래밍 방식으로 수행하려면 암호화 서비스 클라이언트를 만들어야 합니다. Java 암호화 서비스 API를 사용하는 경우 EncrytionServiceClient 개체를 만듭니다. 웹 서비스 암호화 서비스 API를 사용하는 경우 EncryptionServiceService 개체를 만듭니다.

암호화된 PDF 문서 가져오기

잠금을 해제하려면 암호화된 PDF 문서를 입수해야 합니다. 암호화되지 않은 PDF 문서의 잠금을 해제하려고 하면 예외가 발생합니다.

문서 잠금 해제

암호로 암호화된 PDF 문서의 잠금을 해제하려면 암호화된 PDF 문서와 암호로 암호화된 PDF 문서를 여는 데 사용되는 암호 값이 모두 필요합니다. 이 값은 암호로 PDF 문서를 암호화할 때 지정됩니다. (암호를 사용하여 PDF 문서 암호화를 참조하십시오.)

인증서로 암호화된 PDF 문서의 잠금을 해제하려면 암호화된 PDF 문서와 PDF 문서를 암호화하는 데 사용한 개인 키에 해당하는 공개 키의 별칭 값이 모두 필요합니다.

AEM Forms 작업 수행

암호화된 PDF 문서의 잠금을 해제하면 해당 문서에 사용 권한을 적용하는 등의 다른 서비스 작업을 수행할 수 있습니다. 이 작업은 Acrobat Reader DC Extensions 서비스에 속합니다.

참고 항목

Java API를 사용하여 암호화된 PDF 문서 잠금 해제

웹 서비스 API를 사용하여 암호화된 PDF 문서 잠금 해제

AEM Forms Java 라이브러리 파일 포함

연결 속성 설정

암호화 서비스 API 빠른 시작

Java API를 사용하여 암호화된 PDF 문서 잠금 해제

암호화 API(Java)를 사용하여 암호화된 PDF 문서의 잠금을 해제합니다.

1. 프로젝트 파일 포함

   Java 프로젝트의 클래스 경로에 adobe-encryption-client.jar 등의 클라이언트 JAR 파일을 포함합니다.

2. 암호화 서비스 클라이언트를 만듭니다.

   • 연결 속성을 포함하는 ServiceClientFactory 개체를 만듭니다.
   • 생성자를 사용하여 EncryptionServiceClient 개체를 만들고 ServiceClientFactory 개체를 전달합니다.

3. 암호화된 PDF 문서를 가져올 수 있습니다.

   • 생성자를 사용하여 암호화된 PDF 문서의 위치를 지정하는 문자열 값을 전달하여 암호화된 PDF 문서를 나타내는 java.io.FileInputStream 객체를 만듭니다.
   • 생성자를 사용하여 com.adobe.idp.Document 개체를 만들고 java.io.FileInputStream 개체를 전달합니다.

4. 문서의 잠금을 해제합니다.

   EncryptionServiceClient 개체의 unlockPDFUsingPassword 또는 unlockPDFUsingCredential 메서드를 호출하여 암호화된 PDF 문서의 잠금을 해제합니다.

   암호로 암호화된 PDF 문서의 잠금을 해제하려면 unlockPDFUsingPassword 메서드를 호출하고 다음 값을 전달합니다.

   • 암호로 암호화된 PDF 문서를 포함하는 com.adobe.idp.Document 객체입니다.
   • 암호로 암호화된 PDF 문서를 여는 데 사용되는 암호 값을 지정하는 문자열 값입니다. 이 값은 암호로 PDF 문서를 암호화할 때 지정됩니다.

   인증서로 암호화된 PDF 문서의 잠금을 해제하려면 unlockPDFUsingCredential 메서드를 호출하고 다음 값을 전달합니다.

   • 인증서로 암호화된 PDF 문서를 포함하는 com.adobe.idp.Document 객체입니다.
   • PDF 문서를 암호화하는 데 사용되는 개인 키에 해당하는 공개 키의 별칭 이름을 지정하는 문자열 값입니다.

   unlockPDFUsingPassword 및 unlockPDFUsingCredential 메서드는 모두 작업을 수행하기 위해 다른 AEM Forms Java 메서드에 전달하는 com.adobe.idp.Document 개체를 반환합니다.

5. AEM Forms 작업을 수행합니다.

   비즈니스 요구 사항에 맞게 잠금 해제된 PDF 문서에 AEM Forms 작업을 수행할 수 있습니다. 예를 들어 잠금 해제된 PDF 문서에 사용 권한을 적용하려면 unlockPDFUsingPassword 또는 unlockPDFUsingCredential 메서드에서 반환한 com.adobe.idp.Document 개체를 ReaderExtensionsServiceClient 개체의 applyUsageRights 메서드에 전달합니다.

참고 항목

단계 요약

빠른 시작(SOAP 모드):Java API (SOAP 모드)를 사용하여 암호화된 PDF 문서 잠금 해제

PDF 문서에 사용 권한 적용

AEM Forms Java 라이브러리 파일 포함

연결 속성 설정

웹 서비스 API를 사용하여 암호화된 PDF 문서 잠금 해제

암호화 API(웹 서비스)를 사용하여 암호화된 PDF 문서의 잠금을 해제합니다.

1. 프로젝트 파일 포함

   MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다.http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1.

   노트

   localhost을(를) AEM Forms을 호스팅하는 서버의 IP 주소로 바꿉니다.

2. 암호화 서비스 클라이언트를 만듭니다.

   • 기본 생성자를 사용하여 EncryptionServiceClient 객체를 만듭니다.

   • System.ServiceModel.EndpointAddress 생성자를 사용하여 EncryptionServiceClient.Endpoint.Address 객체를 만듭니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예: http://localhost:8080/soap/services/EncryptionService?WSDL). lc_version 특성을 사용할 필요가 없습니다. 이 속성은 서비스 참조를 만들 때 사용됩니다.)

   • EncryptionServiceClient.Endpoint.Binding 필드의 값을 가져와서 System.ServiceModel.BasicHttpBinding 개체를 만듭니다. 반환 값을 BasicHttpBinding으로 캐스팅합니다.

   • System.ServiceModel.BasicHttpBinding 개체의 MessageEncoding 필드를 WSMessageEncoding.Mtom로 설정합니다. 이 값을 사용하면 MTOM이 사용됩니다.

   • 다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.

     • AEM 양식 사용자 이름을 EncryptionServiceClient.ClientCredentials.UserName.UserName 필드에 지정합니다.
     • 해당 암호 값을 EncryptionServiceClient.ClientCredentials.UserName.Password 필드에 지정합니다.
     • BasicHttpBindingSecurity.Transport.ClientCredentialType 필드에 상수 값 HttpClientCredentialType.Basic을 할당합니다.
     • BasicHttpBindingSecurity.Security.Mode 필드에 상수 값 BasicHttpSecurityMode.TransportCredentialOnly을 할당합니다.

3. 암호화된 PDF 문서를 가져올 수 있습니다.

   • 생성자를 사용하여 BLOB 객체를 만듭니다.
   • 생성자를 호출하고 암호화된 PDF 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달하여 System.IO.FileStream 객체를 만듭니다.
   • System.IO.FileStream 객체의 내용을 저장하는 바이트 배열을 만듭니다. System.IO.FileStream 객체의 Length 속성을 가져와 바이트 배열의 크기를 결정할 수 있습니다.
   • System.IO.FileStream 객체의 Read 메서드를 호출하고 바이트 배열, 시작 위치 및 읽을 스트림 길이를 전달하여 바이트 배열을 스트림 데이터로 채웁니다.
   • 바이트 배열의 내용을 BLOB 객체의 MTOM 데이터 멤버에 할당하여 BLOB 객체를 채웁니다.

4. 문서의 잠금을 해제합니다.

   EncryptionServiceClient 개체의 unlockPDFUsingPassword 또는 unlockPDFUsingCredential 메서드를 호출하여 암호화된 PDF 문서의 잠금을 해제합니다.

   암호로 암호화된 PDF 문서의 잠금을 해제하려면 unlockPDFUsingPassword 메서드를 호출하고 다음 값을 전달합니다.

   • 암호로 암호화된 PDF 문서를 포함하는 BLOB 객체입니다.
   • 암호로 암호화된 PDF 문서를 여는 데 사용되는 암호 값을 지정하는 문자열 값입니다. 이 값은 암호로 PDF 문서를 암호화할 때 지정됩니다.

   인증서로 암호화된 PDF 문서의 잠금을 해제하려면 unlockPDFUsingCredential 메서드를 호출하고 다음 값을 전달합니다.

   • 인증서로 암호화된 PDF 문서를 포함하는 BLOB 객체입니다.
   • PDF 문서를 암호화하는 데 사용되는 개인 키에 해당하는 공개 키의 별칭 이름을 지정하는 문자열 값입니다.

   unlockPDFUsingPassword 및 unlockPDFUsingCredential 메서드는 모두 작업을 수행하기 위해 다른 AEM Forms 메서드에 전달하는 com.adobe.idp.Document 개체를 반환합니다.

5. AEM Forms 작업을 수행합니다.

   비즈니스 요구 사항에 맞게 잠금 해제된 PDF 문서에 AEM Forms 작업을 수행할 수 있습니다. 예를 들어 잠금 해제된 PDF 문서에 사용 권한을 적용하려면 unlockPDFUsingPassword 또는 unlockPDFUsingCredential 메서드에서 반환한 BLOB 개체를 ReaderExtensionsServiceClient 개체의 applyUsageRights 메서드에 전달합니다.

참고 항목

단계 요약

MTOM을 사용하여 AEM Forms 호출

SwaRef를 사용하여 AEM Forms 호출

암호화 유형 확인 중

Java 암호화 서비스 API 또는 웹 서비스 암호화 서비스 API를 사용하여 PDF 문서를 보호하는 암호화 유형을 프로그래밍 방식으로 결정할 수 있습니다. 경우에 따라 PDF 문서의 암호화 여부 및 암호화 유형을 동적으로 결정해야 합니다. 예를 들어 PDF 문서가 암호 기반 암호화로 보호되는지 아니면 Rights Management 정책으로 보호되는지를 결정할 수 있습니다.

PDF 문서는 다음과 같은 암호화 유형을 통해 보호할 수 있습니다.

• 암호 기반 암호화
• 인증서 기반의 암호화
• Rights Management 서비스에서 만든 정책
• 다른 유형의 암호화

단계 요약

PDF 문서를 보호하는 암호화 유형을 결정하려면 다음 단계를 수행합니다.

1. 프로젝트 파일 포함
2. 암호화 서비스 클라이언트를 만듭니다.
3. 암호화된 PDF 문서를 가져올 수 있습니다.
4. 암호화 유형을 결정합니다.

프로젝트 파일 포함

개발 프로젝트에 필요한 파일을 포함할 수 있습니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.

다음 JAR 파일을 프로젝트의 클래스 경로에 추가해야 합니다.

• adobe-livecycle-client.jar
• adobe-usermanager-client.jar
• adobe-encryption-client.jar
• adobe-utilities.jar (AEM Forms이 JBoss Application Server에 배포된 경우 필수)
• jbossall-client.jar (AEM Forms이 JBoss Application Server에 배포된 경우 필수)

서비스 클라이언트 만들기

암호화 서비스 작업을 프로그래밍 방식으로 수행하려면 암호화 서비스 클라이언트를 만들어야 합니다. Java 암호화 서비스 API를 사용하는 경우 EncrytionServiceClient 개체를 만듭니다. 웹 서비스 암호화 서비스 API를 사용하는 경우 EncryptionServiceService 개체를 만듭니다.

암호화된 PDF 문서 가져오기

PDF 문서를 보호하려는 암호화 유형을 결정하려면 PDF 문서를 받아야 합니다.

암호화 유형 확인

PDF 문서를 보호하는 암호화 유형을 결정할 수 있습니다. PDF 문서가 보호되지 않은 경우 암호화 서비스는 PDF 문서의 보안이 해제되었음을 알려줍니다.

참고 항목

Java API를 사용하여 암호화 유형을 결정합니다.

웹 서비스 API를 사용하여 암호화 유형을 결정합니다.

AEM Forms Java 라이브러리 파일 포함

연결 속성 설정

암호화 서비스 API 빠른 시작

정책으로 문서 보호

Java API을 사용하여 암호화 유형을 결정합니다.

암호화 API(Java)를 사용하여 PDF 문서를 보호하는 암호화 유형을 결정합니다.

1. 프로젝트 파일 포함

   Java 프로젝트의 클래스 경로에 adobe-encryption-client.jar 등의 클라이언트 JAR 파일을 포함합니다.

2. 서비스 클라이언트를 만듭니다.

   • 연결 속성을 포함하는 ServiceClientFactory 개체를 만듭니다.
   • 생성자를 사용하여 EncryptionServiceClient 개체를 만들고 ServiceClientFactory 개체를 전달합니다.

3. 암호화된 PDF 문서를 가져올 수 있습니다.

   • 생성자를 사용하여 PDF 문서의 위치를 지정하는 문자열 값을 전달하여 PDF 문서를 나타내는 java.io.FileInputStream 객체를 만듭니다.
   • 생성자를 사용하여 com.adobe.idp.Document 개체를 만들고 java.io.FileInputStream 개체를 전달합니다.

4. 암호화 유형을 결정합니다.

   • EncryptionServiceClient 개체의 getPDFEncryption 메서드를 호출하고 PDF 문서를 포함하는 com.adobe.idp.Document 개체를 전달하여 암호화 유형을 결정합니다. 이 메서드는 EncryptionTypeResult 객체를 반환합니다.
   • EncryptionTypeResult 객체의 getEncryptionType 메서드를 호출합니다. 이 메서드는 암호화 유형을 지정하는 EncryptionType 열거형 값을 반환합니다. 예를 들어 PDF 문서가 암호 기반 암호화로 보호되는 경우 이 메서드는 EncryptionType.PASSWORD을 반환합니다.

참고 항목

단계 요약

빠른 시작(SOAP 모드):Java API를 사용하여 암호화 유형 확인

AEM Forms Java 라이브러리 파일 포함

연결 속성 설정

웹 서비스 API를 사용하여 암호화 유형을 결정합니다.

암호화 API(웹 서비스)를 사용하여 PDF 문서를 보호하는 암호화 유형을 결정합니다.

1. 프로젝트 파일 포함

   MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다.http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1.

   노트

   localhost을(를) AEM Forms을 호스팅하는 서버의 IP 주소로 바꿉니다.

2. 서비스 클라이언트를 만듭니다.

   • 기본 생성자를 사용하여 EncryptionServiceClient 객체를 만듭니다.

   • System.ServiceModel.EndpointAddress 생성자를 사용하여 EncryptionServiceClient.Endpoint.Address 객체를 만듭니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예: http://localhost:8080/soap/services/EncryptionService?WSDL). lc_version 특성을 사용할 필요가 없습니다. 이 속성은 서비스 참조를 만들 때 사용됩니다.)

   • EncryptionServiceClient.Endpoint.Binding 필드의 값을 가져와서 System.ServiceModel.BasicHttpBinding 개체를 만듭니다. 반환 값을 BasicHttpBinding으로 캐스팅합니다.

   • System.ServiceModel.BasicHttpBinding 개체의 MessageEncoding 필드를 WSMessageEncoding.Mtom로 설정합니다. 이 값을 사용하면 MTOM이 사용됩니다.

   • 다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.

     • AEM 양식 사용자 이름을 EncryptionServiceClient.ClientCredentials.UserName.UserName 필드에 지정합니다.
     • 해당 암호 값을 EncryptionServiceClient.ClientCredentials.UserName.Password 필드에 지정합니다.
     • BasicHttpBindingSecurity.Transport.ClientCredentialType 필드에 상수 값 HttpClientCredentialType.Basic을 할당합니다.
     • BasicHttpBindingSecurity.Security.Mode 필드에 상수 값 BasicHttpSecurityMode.TransportCredentialOnly을 할당합니다.

3. 암호화된 PDF 문서를 가져올 수 있습니다.

   • 생성자를 사용하여 BLOB 객체를 만듭니다.
   • 생성자를 호출하고 암호화된 PDF 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달하여 System.IO.FileStream 객체를 만듭니다.
   • System.IO.FileStream 객체의 내용을 저장하는 바이트 배열을 만듭니다. System.IO.FileStream 객체의 Length 속성을 가져와 바이트 배열의 크기를 결정할 수 있습니다.
   • System.IO.FileStream 객체의 Read 메서드를 호출하고 바이트 배열, 시작 위치 및 읽을 스트림 길이를 전달하여 바이트 배열을 스트림 데이터로 채웁니다.
   • 바이트 배열의 내용을 BLOB 객체의 MTOM 데이터 멤버에 할당하여 BLOB 객체를 채웁니다.

4. 암호화 유형을 결정합니다.

   • EncryptionServiceClient 개체의 getPDFEncryption 메서드를 호출하고 PDF 문서가 포함된 BLOB 개체를 전달합니다. 이 메서드는 EncryptionTypeResult 객체를 반환합니다.
   • EncryptionTypeResult 개체의 encryptionType 데이터 메서드의 값을 가져옵니다. 예를 들어 PDF 문서가 암호 기반 암호화로 보호되는 경우 이 데이터 멤버의 값은 EncryptionType.PASSWORD입니다.

참고 항목

단계 요약

MTOM을 사용하여 AEM Forms 호출

SwaRef를 사용하여 AEM Forms 호출