문서 디지털 서명 및 인증 digitally-signing-and-certifying-documents
서명 서비스 정보
서명 서비스를 사용하면 조직에서 배포하고 받는 Adobe PDF 문서의 보안 및 개인 정보를 보호할 수 있습니다. 이 서비스는 디지털 서명 및 인증을 사용하여 의도한 수신자만 문서를 변경할 수 있도록 합니다. 문서 자체에 보안 기능이 적용되므로 문서의 전체 라이프 사이클에 대해 보안 및 제어 상태가 유지됩니다. 문서는 오프라인으로 다운로드될 때, 조직에 다시 제출될 때 방화벽을 넘어 안전하게 유지됩니다.
서명 필드 이름
일부 서명 서비스 작업에서는 작업이 수행되는 서명 필드의 이름을 지정해야 합니다. 예를 들어 PDF 문서에 서명할 때 서명할 서명 필드의 이름을 지정합니다. 서명 필드의 전체 이름이 form1[0].Form1[0].SignatureField1[0]
. 다음을 지정할 수 있습니다 SignatureField1[0]
대신 form1[0].Form1[0].SignatureField1[0]
.
충돌이 발생하면 서명 서비스가 잘못된 필드에 서명하거나 서명 필드 이름이 필요한 다른 작업을 수행합니다. 이 충돌은 이름의 결과입니다 SignatureField1[0]
동일한 PDF 문서에 둘 이상의 위치에 표시됩니다. 예를 들어 이름이 인 두 개의 서명 필드가 포함된 PDF 문서를 생각해 보십시오 form1[0].Form1[0].SignatureField1[0]
및 form1[0].Form1[0].SubForm1[0].SignatureField1[0]
그리고 SignatureField1[0]
. 이 경우 서명 서비스는 문서의 모든 서명 필드를 반복하면서 찾은 첫 번째 서명 필드에 서명합니다.
PDF 문서 내에 여러 개의 서명 필드가 있는 경우 서명 필드의 전체 이름을 지정하는 것이 좋습니다. 즉, 다음을 지정합니다 form1[0].Form1[0].SignatureField1[0]
대신 SignatureField1[0]
.
서명 서비스를 사용하여 다음 작업을 수행할 수 있습니다.
- PDF 문서에 디지털 서명 필드를 추가하고 삭제합니다. (자세한 내용은 서명 필드 추가)
- PDF 문서에 있는 서명 필드의 이름을 검색합니다. (자세한 내용은 서명 필드 이름 검색)
- 서명 필드를 수정합니다. (자세한 내용은 서명 필드 수정)
- PDF 문서에 디지털 서명을 합니다. (자세한 내용은 디지털 서명 PDF 문서)
- PDF 문서를 인증합니다. (자세한 내용은 PDF 문서 인증)
- PDF 문서에 있는 디지털 서명을 확인합니다. (자세한 내용은 디지털 서명 확인)
- PDF 문서에 있는 모든 디지털 서명의 유효성을 검사합니다. (자세한 내용은 여러 디지털 서명 확인)
- 서명 필드에서 디지털 서명을 제거합니다. (자세한 내용은 디지털 서명 제거)
서명 필드 추가 adding-signature-fields
서명의 그래픽 표현이 포함된 양식 필드인 서명 필드에 디지털 서명이 나타납니다. 서명 필드는 보거나 볼 수 있습니다. 서명자는 기존 서명 필드를 사용하거나 서명 필드를 프로그래밍 방식으로 추가할 수 있습니다. 두 경우 모두 서명 필드가 있어야 PDF 문서에 서명할 수 있습니다.
서명 서비스 Java API 또는 서명 웹 서비스 API를 사용하여 서명 필드를 프로그래밍 방식으로 추가할 수 있습니다. PDF 문서에 두 개 이상의 서명 필드를 추가할 수 있습니다. 그러나 각 서명 필드 이름은 고유해야 합니다.
단계 요약 summary-of-steps
PDF 문서에 서명 필드를 추가하려면 다음 작업을 수행합니다.
- 프로젝트 파일을 포함합니다.
- 서명 클라이언트를 만듭니다.
- 서명 필드가 추가된 PDF 문서를 가져옵니다.
- 서명 필드를 추가합니다.
- PDF 문서를 PDF 파일로 저장합니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함합니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함하십시오. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
다음 JAR 파일을 프로젝트의 클래스 경로에 추가해야 합니다.
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-signatures-client.jar
- adobe-utilities.jar(AEM Forms이 JBoss에 배포된 경우 필수)
- jbossall-client.jar(AEM Forms이 JBoss에 배포되는 경우 필요)
서명 클라이언트 만들기
서명 서비스 작업을 프로그래밍 방식으로 수행하려면 먼저 서명 서비스 클라이언트를 만들어야 합니다.
서명 필드가 추가된 PDF 문서 가져오기
서명 필드가 추가된 PDF 문서를 가져와야 합니다.
서명 필드 추가
서명 필드를 PDF 문서에 성공적으로 추가하려면 서명 필드의 위치를 식별하는 좌표 값을 지정합니다. 보이지 않는 서명 필드를 추가하는 경우 이러한 값은 필요하지 않습니다. 서명 필드에 서명을 적용한 후 PDF 문서의 어떤 필드를 잠글 것인지 지정할 수도 있습니다.
PDF 문서를 PDF 파일로 저장
서명 서비스가 PDF 문서에 서명 필드를 추가한 후 사용자가 Acrobat 또는 Adobe Reader에서 문서를 열 수 있도록 문서를 PDF 파일로 저장할 수 있습니다.
추가 참조
Java API를 사용하여 서명 필드 추가 add-signature-fields-using-the-java-api
서명 API(Java)를 사용하여 서명 필드를 추가합니다.
-
프로젝트 파일 포함
Java 프로젝트의 클래스 경로에 adobe-signatures-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
-
서명 클라이언트 만들기
- 만들기
ServiceClientFactory
연결 속성을 포함하는 객체입니다. - 만들기
SignatureServiceClient
생성자를 사용하여 객체를 전달하고ServiceClientFactory
개체.
- 만들기
-
서명 필드가 추가된 PDF 문서 가져오기
- 만들기
java.io.FileInputStream
생성자를 사용하여 서명 필드가 추가되는 PDF 문서를 나타내고 PDF 문서의 위치를 지정하는 문자열 값을 전달하는 개체입니다. - 만들기
com.adobe.idp.Document
생성자를 사용하여 객체를 전달하고java.io.FileInputStream
개체.
- 만들기
-
서명 필드 추가
-
만들기
PositionRectangle
생성자를 사용하여 서명 필드 위치를 지정하는 개체입니다. 생성자 내에서 좌표 값을 지정합니다. -
원하는 경우 을(를) 만듭니다
FieldMDPOptions
서명 필드에 디지털 서명을 적용할 때 잠긴 필드를 지정하는 개체입니다. -
를 호출하여 PDF 문서에 서명 필드를 추가합니다
SignatureServiceClient
개체addSignatureField
메서드 및 다음 값 전달:- A
com.adobe.idp
.Document
서명 필드가 추가된 PDF 문서를 나타내는 객체입니다. - 서명 필드의 이름을 지정하는 문자열 값입니다.
- A
java.lang.Integer
서명 필드가 추가되는 페이지 번호를 나타내는 값입니다. - A
PositionRectangle
서명 필드의 위치를 지정하는 개체입니다. - A
FieldMDPOptions
서명 필드에 디지털 서명이 적용된 후 잠긴 PDF 문서의 필드를 지정하는 개체입니다. 이 매개 변수 값은 선택 사항이며 다음을 전달할 수 있습니다null
.
- A
-
A
PDFSeedValueOptions
다양한 런타임 값을 지정하는 개체입니다. 이 매개 변수 값은 선택 사항이며 다음을 전달할 수 있습니다null
.다음
addSignatureField
메서드 반환com.adobe.idp
.Document
서명 필드를 포함하는 PDF 문서를 나타내는 객체입니다.
note note NOTE 를 호출할 수 있습니다 SignatureServiceClient
개체addInvisibleSignatureField
보이지 않는 서명 필드를 추가하는 방법 -
-
PDF 문서를 PDF 파일로 저장
- 만들기
java.io.File
개체 및 파일 확장명이 .pdf인지 확인합니다. - 를 호출합니다
com.adobe.idp
.Document
개체copyToFile
컨텐츠의 내용 복사 방법Document
개체를 파일로 가져올 수 있습니다. 를 사용해야 합니다com.adobe.idp
.Document
반환되는 개체addSignatureField
메서드를 사용합니다.
- 만들기
추가 참조
웹 서비스 API를 사용하여 서명 필드 추가 add-signature-fields-using-the-web-service-api
서명 API(웹 서비스)를 사용하여 서명 필드를 추가하려면 다음을 수행합니다.
-
프로젝트 파일 포함
MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다.
http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1
.note note NOTE 바꾸기 localhost
(AEM Forms을 호스팅하는 서버의 IP 주소 사용) -
서명 클라이언트 만들기
-
만들기
SignatureServiceClient
기본 생성자를 사용하여 개체를 만듭니다. -
만들기
SignatureServiceClient.Endpoint.Address
개체를System.ServiceModel.EndpointAddress
생성자입니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예:http://localhost:8080/soap/services/SignatureService?WSDL
). 를 사용할 필요가 없습니다lc_version
속성을 사용합니다. 이 속성은 서비스 참조를 생성할 때 사용됩니다.) -
만들기
System.ServiceModel.BasicHttpBinding
개체의 값을 가져와서SignatureServiceClient.Endpoint.Binding
필드. 반환 값을 다음으로 캐스팅합니다.BasicHttpBinding
. -
설정
System.ServiceModel.BasicHttpBinding
개체MessageEncoding
필드 대상WSMessageEncoding.Mtom
. 이 값은 MTOM이 사용되도록 합니다. -
다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
- 필드에 AEM Forms 사용자 이름을 지정합니다
SignatureServiceClient.ClientCredentials.UserName.UserName
. - 필드에 해당 암호 값을 지정합니다
SignatureServiceClient.ClientCredentials.UserName.Password
. - 상수 값 할당
HttpClientCredentialType.Basic
아래와 같이 변경하는 것을 의미합니다BasicHttpBindingSecurity.Transport.ClientCredentialType
. - 상수 값 할당
BasicHttpSecurityMode.TransportCredentialOnly
아래와 같이 변경하는 것을 의미합니다BasicHttpBindingSecurity.Security.Mode
.
- 필드에 AEM Forms 사용자 이름을 지정합니다
-
-
서명 필드가 추가된 PDF 문서 가져오기
- 만들기
BLOB
생성자를 사용하여 개체를 작성합니다. 다음BLOB
서명 필드를 포함할 PDF 문서를 저장하는 데 사용됩니다. - 만들기
System.IO.FileStream
객체를 사용하여 해당 생성자를 호출하고 PDF 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달합니다. - 의 내용을 저장하는 바이트 배열을 만듭니다
System.IO.FileStream
개체. 를 가져와서 바이트 배열의 크기를 결정할 수 있습니다System.IO.FileStream
개체Length
속성을 사용합니다. - 를 호출하여 바이트 배열을 스트림 데이터로 채웁니다
System.IO.FileStream
개체Read
바이트 배열, 시작 위치 및 읽을 스트림 길이를 전달하는 메서드와 전달 - 을(를) 채우기
BLOB
개체를 할당하여 개체를 개체 개체MTOM
바이트 배열의 내용을 포함하는 속성입니다.
- 만들기
-
서명 필드 추가
를 호출하여 PDF 문서에 서명 필드를 추가합니다
SignatureServiceClient
개체addSignatureField
메서드 및 다음 값 전달:- A
BLOB
서명 필드가 추가된 PDF 문서를 나타내는 객체입니다. - 서명 필드 이름을 지정하는 문자열 값입니다.
- 서명 필드가 추가되는 페이지 번호를 나타내는 정수 값입니다.
- A
PositionRect
서명 필드의 위치를 지정하는 개체입니다. - A
FieldMDPOptions
서명 필드에 디지털 서명이 적용된 후 잠긴 PDF 문서의 필드를 지정하는 개체입니다. 이 매개 변수 값은 선택 사항이며 다음을 전달할 수 있습니다null
. - A
PDFSeedValueOptions
다양한 런타임 값을 지정하는 개체입니다. 이 매개 변수 값은 선택 사항이며 다음을 전달할 수 있습니다null
.
다음
addSignatureField
메서드 반환BLOB
서명 필드를 포함하는 PDF 문서를 나타내는 객체입니다. - A
-
PDF 문서를 PDF 파일로 저장
- 만들기
System.IO.FileStream
객체를 사용하여 해당 생성자를 호출하고 서명 필드를 포함할 PDF 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달합니다. - 의 내용을 저장하는 바이트 배열을 만듭니다
BLOB
반환되는 개체addSignatureField
메서드를 사용합니다. 의 값을 가져와서 바이트 배열을 채웁니다BLOB
개체binaryData
데이터 멤버. - 만들기
System.IO.BinaryWriter
생성자를 호출하고 전달하여 개체를System.IO.FileStream
개체. - 를 호출하여 PDF 파일에 바이트 배열의 내용을 씁니다.
System.IO.BinaryWriter
개체Write
메서드를 사용하여 바이트 배열을 전달합니다.
- 만들기
추가 참조
서명 필드 이름 검색 retrieving-signature-field-names
서명하거나 인증하려는 PDF 문서에 있는 모든 서명 필드의 이름을 검색할 수 있습니다. PDF 문서에 있는 서명 필드 이름을 잘 모르거나 이름을 확인하려는 경우 프로그래밍 방식으로 검색할 수 있습니다. 서명 서비스는 다음과 같이 서명 필드의 정규화된 이름을 반환합니다 form1[0].grantApplication[0].page1[0].SignatureField1[0]
.
단계 요약 summary_of_steps-1
서명 필드 이름을 검색하려면 다음 작업을 수행하십시오.
- 프로젝트 파일을 포함합니다.
- 서명 클라이언트를 만듭니다.
- 서명 필드가 포함된 PDF 문서를 가져옵니다.
- 서명 필드 이름을 검색합니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함합니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함하십시오. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
다음 JAR 파일을 프로젝트의 클래스 경로에 추가해야 합니다.
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-signatures-client.jar
- adobe-utilities.jar(AEM Forms이 JBoss에 배포된 경우 필수)
- jbossall-client.jar(AEM Forms이 JBoss에 배포되는 경우 필요)
이러한 JAR 파일의 위치에 대한 자세한 내용은 AEM Forms Java 라이브러리 파일 포함.
서명 클라이언트 만들기
서명 서비스 작업을 프로그래밍 방식으로 수행하려면 먼저 서명 서비스 클라이언트를 만들어야 합니다.
서명 필드가 포함된 PDF 문서 가져오기
서명 필드가 포함된 PDF 문서를 검색합니다.
서명 필드 이름을 검색합니다
하나 이상의 서명 필드가 포함된 PDF 문서를 검색한 후 서명 필드 이름을 검색할 수 있습니다.
추가 참조
Java API를 사용하여 서명 필드 이름을 검색합니다
Java API를 사용하여 서명 필드 이름을 검색합니다 retrieve-signature-field-names-using-the-java-api
서명 API(Java)를 사용하여 서명 필드 이름을 검색합니다.
-
프로젝트 파일 포함
Java 프로젝트의 클래스 경로에 adobe-signatures-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
-
서명 클라이언트 만들기
- 만들기
ServiceClientFactory
연결 속성을 포함하는 객체입니다. - 만들기
SignatureServiceClient
생성자를 사용하여 객체를 전달하고ServiceClientFactory
개체.
- 만들기
-
서명 필드가 포함된 PDF 문서 가져오기
- 만들기
java.io.FileInputStream
생성자를 사용하고 PDF 문서의 위치를 지정하는 문자열 값을 전달하여 서명 필드가 포함된 PDF 문서를 나타내는 개체입니다. - 만들기
com.adobe.idp.Document
생성자를 사용하여 객체를 전달하고java.io.FileInputStream
개체.
- 만들기
-
서명 필드 이름을 검색합니다
- 를 호출하여 서명 필드 이름을 검색합니다.
SignatureServiceClient
개체getSignatureFieldList
메서드 및 전달com.adobe.idp.Document
서명 필드를 포함하는 PDF 문서를 포함하는 객체입니다. 이 메서드는java.util.List
각 요소에 포함되는 개체PDFSignatureField
개체. 이 개체를 사용하면 표시 여부 등 서명 필드에 대한 추가 정보를 얻을 수 있습니다. - 를 통해 반복
java.util.List
서명 필드 이름이 있는지 확인하는 개체입니다. PDF 문서의 각 서명 필드에 대해 별도의PDFSignatureField
개체. 서명 필드의 이름을 가져오려면PDFSignatureField
개체getName
메서드를 사용합니다. 이 메서드는 서명 필드 이름을 지정하는 문자열 값을 반환합니다.
- 를 호출하여 서명 필드 이름을 검색합니다.
추가 참조
빠른 시작(SOAP 모드): Java API를 사용하여 서명 필드 이름 검색
웹 서비스 API를 사용하여 서명 필드 검색 retrieve-signature-field-using-the-web-service-api
서명 API(웹 서비스)를 사용하여 서명 필드 이름을 검색합니다.
-
프로젝트 파일 포함
MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다.
http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1
.note note NOTE 바꾸기 localhost
(AEM Forms을 호스팅하는 서버의 IP 주소 사용) -
서명 클라이언트 만들기
-
만들기
SignatureServiceClient
기본 생성자를 사용하여 개체를 만듭니다. -
만들기
SignatureServiceClient.Endpoint.Address
개체를System.ServiceModel.EndpointAddress
생성자입니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예:http://localhost:8080/soap/services/SignatureService?WSDL
). 를 사용할 필요가 없습니다lc_version
속성을 사용합니다. 이 속성은 서비스 참조를 생성할 때 사용됩니다.) -
만들기
System.ServiceModel.BasicHttpBinding
개체의 값을 가져와서SignatureServiceClient.Endpoint.Binding
필드. 반환 값을 다음으로 캐스팅합니다.BasicHttpBinding
. -
설정
System.ServiceModel.BasicHttpBinding
개체MessageEncoding
필드 대상WSMessageEncoding.Mtom
. 이 값은 MTOM이 사용되도록 합니다. -
다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
- 필드에 AEM Forms 사용자 이름을 지정합니다
SignatureServiceClient.ClientCredentials.UserName.UserName
. - 필드에 해당 암호 값을 지정합니다
SignatureServiceClient.ClientCredentials.UserName.Password
. - 상수 값 할당
HttpClientCredentialType.Basic
아래와 같이 변경하는 것을 의미합니다BasicHttpBindingSecurity.Transport.ClientCredentialType
. - 상수 값 할당
BasicHttpSecurityMode.TransportCredentialOnly
아래와 같이 변경하는 것을 의미합니다BasicHttpBindingSecurity.Security.Mode
.
- 필드에 AEM Forms 사용자 이름을 지정합니다
-
-
서명 필드가 포함된 PDF 문서 가져오기
- 만들기
BLOB
생성자를 사용하여 개체를 작성합니다. 다음BLOB
서명 필드가 포함된 PDF 문서를 저장하는 데 사용됩니다. - 만들기
System.IO.FileStream
객체를 사용하여 해당 생성자를 호출하고 PDF 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달합니다. - 의 내용을 저장하는 바이트 배열을 만듭니다
System.IO.FileStream
개체. 를 가져와서 바이트 배열의 크기를 결정할 수 있습니다System.IO.FileStream
개체Length
속성을 사용합니다. - 를 호출하여 바이트 배열을 스트림 데이터로 채웁니다
System.IO.FileStream
개체Read
바이트 배열, 시작 위치 및 읽을 스트림 길이를 전달하는 메서드와 전달 - 을(를) 채우기
BLOB
개체를 할당하여 개체를 개체 개체MTOM
바이트 배열 내용을 입력합니다.
- 만들기
-
서명 필드 이름을 검색합니다
- 를 호출하여 서명 필드 이름을 검색합니다
SignatureServiceClient
개체getSignatureFieldList
메서드 및 전달BLOB
서명 필드를 포함하는 PDF 문서를 포함하는 객체입니다. 이 메서드는MyArrayOfPDFSignatureField
각 요소에 포함되는 컬렉션 개체PDFSignatureField
개체. - 를 통해 반복
MyArrayOfPDFSignatureField
서명 필드 이름이 있는지 여부를 확인하는 개체입니다. PDF 문서의 각 서명 필드에 대해PDFSignatureField
개체. 서명 필드의 이름을 가져오려면PDFSignatureField
개체getName
메서드를 사용합니다. 이 메서드는 서명 필드 이름을 지정하는 문자열 값을 반환합니다.
- 를 호출하여 서명 필드 이름을 검색합니다
추가 참조
서명 필드 수정 modifying-signature-fields
Java API 및 웹 서비스 API를 사용하여 PDF 문서에 있는 서명 필드를 수정할 수 있습니다. 서명 필드 수정에는 서명 필드 잠금 사전 값 또는 시드 값 사전 값을 조작하는 작업이 포함됩니다.
A 필드 잠금 사전 서명 필드에 서명할 때 잠긴 필드 목록을 지정합니다. 잠긴 필드를 사용하면 사용자가 필드를 변경할 수 없습니다. A 시드 값 사전 서명이 적용될 때 사용되는 제한 정보를 포함합니다. 예를 들어 서명을 무효화하지 않고 발생할 수 있는 작업을 제어하는 권한을 변경할 수 있습니다.
기존 서명 필드를 수정하여 변경된 비즈니스 요구 사항을 반영하도록 PDF 문서를 변경할 수 있습니다. 예를 들어, 새로운 비즈니스 요구 사항에 따라 문서가 서명된 후에는 모든 문서 필드를 잠가야 할 수 있습니다.
이 섹션에서는 필드 잠금 사전과 시드 값 사전 값을 모두 수정하여 서명 필드를 수정하는 방법에 대해 설명합니다. 서명 필드 잠금 사전을 변경하면 서명 필드에 서명할 때 PDF 문서의 모든 필드가 잠깁니다. 시드 값 사전을 변경하면 특정 유형의 문서 변경이 금지됩니다.
단계 요약 summary_of_steps-2
PDF 문서에 있는 서명 필드를 수정하려면 다음 작업을 수행합니다.
- 프로젝트 파일을 포함합니다.
- 서명 클라이언트를 만듭니다.
- 수정할 서명 필드가 포함된 PDF 문서를 가져옵니다.
- 사전 값을 설정합니다.
- 서명 필드를 수정합니다.
- PDF 문서를 PDF 파일로 저장합니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함합니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함하십시오. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
다음 JAR 파일을 프로젝트의 클래스 경로에 추가해야 합니다.
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-signatures-client.jar
- adobe-utilities.jar(AEM Forms이 JBoss에 배포된 경우 필수)
- jbossall-client.jar(AEM Forms이 JBoss에 배포되는 경우 필요)
이러한 JAR 파일의 위치에 대한 자세한 내용은 LiveCycle Java 라이브러리 파일 포함.
서명 클라이언트 만들기
서명 서비스 작업을 프로그래밍 방식으로 수행하려면 먼저 서명 서비스 클라이언트를 만들어야 합니다.
수정할 서명 필드가 포함된 PDF 문서 가져오기
수정할 서명 필드가 포함된 PDF 문서를 검색합니다.
사전 값 설정
서명 필드를 수정하려면 해당 필드 잠금 사전 또는 시드 값 사전에 값을 할당합니다. 서명 필드 잠금 사전 값을 지정하면 서명 필드가 서명될 때 잠긴 PDF 문서 필드를 지정할 수 있습니다. (이 섹션에서는 모든 필드를 잠그는 방법을 설명합니다.)
다음 시드 값 사전 값을 설정할 수 있습니다.
-
개정 확인: 서명 필드에 서명을 적용할 때 해지 확인을 수행할지 여부를 지정합니다.
-
인증서 옵션: 인증서 시드 값 사전에 값을 할당합니다. 인증서 옵션을 지정하기 전에 인증서 시드 값 사전을 사용하는 것이 좋습니다. (자세한 내용은 PDF 참조)
-
다이제스트 옵션: 서명에 사용되는 다이제스트 알고리즘을 할당합니다. 유효한 값은 SHA1, SHA256, SHA384, SHA512 및 RIPEMD160입니다.
-
필터: 서명 필드에 사용되는 필터를 지정합니다. 예를 들어 Adobe.PPKLite 필터를 사용할 수 있습니다. (자세한 내용은 PDF 참조)
-
플래그 옵션: 이 서명 필드와 연결된 플래그 값을 지정합니다. 값이 1이면 서명자는 항목에 대해 지정된 값만 사용해야 합니다. 값이 0이면 다른 값이 허용됩니다. 비트 위치는 다음과 같습니다.
- 1(필터): 서명 필드에 서명하는 데 사용할 서명 처리기입니다
- 2(SubFilter): 서명 시 사용할 수 있는 인코딩을 나타내는 이름 배열입니다
- 3 (5): 서명 필드에 서명하는 데 사용할 서명 처리기의 최소 필수 버전 번호입니다
- 4(사유): 문서에 서명하는 가능한 이유를 지정하는 문자열의 배열입니다
- 5(PDFLegalWarnings): 가능한 법적 입증인을 지정하는 문자열의 배열입니다
-
법적 증명: 문서가 인증되면 문서의 표시 내용이 모호하거나 오해의 소지가 있는 특정 유형의 내용을 자동으로 스캔합니다. 예를 들어, 주석에서는 인증되는 내용을 이해하는 데 중요한 텍스트를 알 수 있습니다. 검색 프로세스는 이 유형의 컨텐츠가 있음을 나타내는 경고를 생성합니다. 또한 경고를 생성한 컨텐츠에 대한 추가 설명도 제공합니다.
-
권한: 서명을 무효화하지 않고 PDF 문서에 사용할 수 있는 권한을 지정합니다.
-
이유: 이 문서에 서명해야 하는 이유를 지정합니다.
-
타임스탬프: 시간 스탬핑 옵션을 지정합니다. 예를 들어, 사용되는 타임스탬프 서버의 URL을 설정할 수 있습니다.
-
버전: 서명 필드에 서명하는 데 사용할 서명 처리기의 최소 버전 번호를 지정합니다.
서명 필드 수정
서명 서비스 클라이언트를 만든 후 수정할 서명 필드가 포함된 PDF 문서를 검색하고 사전 값을 설정하면 서명 서비스에 서명 필드를 수정하도록 지시할 수 있습니다. 그런 다음 서명 서비스는 수정된 서명 필드가 포함된 PDF 문서를 반환합니다. 원본 PDF 문서는 영향을 받지 않습니다.
PDF 문서를 PDF 파일로 저장
수정된 서명 필드가 포함된 PDF 문서를 PDF 파일로 저장하여 사용자가 Acrobat 또는 Adobe Reader에서 열 수 있도록 합니다.
추가 참조
Java API를 사용하여 서명 필드 수정 modify-signature-fields-using-the-java-api
서명 API(Java)를 사용하여 서명 필드를 수정합니다.
-
프로젝트 파일 포함
Java 프로젝트의 클래스 경로에 adobe-signatures-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
-
서명 클라이언트 만들기
- 만들기
ServiceClientFactory
연결 속성을 포함하는 객체입니다. - 만들기
SignatureServiceClient
생성자를 사용하여 객체를 전달하고ServiceClientFactory
개체.
- 만들기
-
수정할 서명 필드가 포함된 PDF 문서 가져오기
- 만들기
java.io.FileInputStream
생성자를 사용하고 PDF 문서의 위치를 지정하는 문자열 값을 전달하여 수정할 서명 필드가 포함된 PDF 문서를 나타내는 개체입니다. - 만들기
com.adobe.idp.Document
생성자를 사용하여 객체를 전달하고java.io.FileInputStream
개체.
- 만들기
-
사전 값 설정
- 만들기
PDFSignatureFieldProperties
생성자를 사용하여 개체를 작성합니다. APDFSignatureFieldProperties
객체에는 서명 필드 잠금 사전 및 시드 값 사전 정보가 저장됩니다. - 만들기
PDFSeedValueOptionSpec
생성자를 사용하여 개체를 작성합니다. 이 개체를 사용하면 시드 값 사전 값을 설정할 수 있습니다. - 를 호출하여 PDF 문서에 대한 변경 내용 허용 안 함
PDFSeedValueOptionSpec
개체setMdpValue
메서드 및 전달MDPPermissions.NoChanges
열거형 값. - 만들기
FieldMDPOptionSpec
생성자를 사용하여 개체를 작성합니다. 이 개체를 사용하면 서명 필드 잠금 사전 값을 설정할 수 있습니다. - 를 호출하여 PDF 문서의 모든 필드 잠금
FieldMDPOptionSpec
개체setMdpValue
메서드 및 전달FieldMDPAction.ALL
열거형 값. - 를 호출하여 시드 값 사전 정보 설정
PDFSignatureFieldProperties
개체setSeedValue
메서드 및 전달PDFSeedValueOptionSpec
개체. - 를 호출하여 서명 필드 잠금 사전 정보를 설정합니다
PDFSignatureFieldProperties
개체setFieldMDP
메서드 및 전달FieldMDPOptionSpec
개체.
note note NOTE 설정할 수 있는 모든 시드 값 사전 값을 보려면 PDFSeedValueOptionSpec
클래스 참조. (자세한 내용은 AEM Forms API 참조) - 만들기
-
서명 필드 수정
를 호출하여 서명 필드를 수정합니다
SignatureServiceClient
개체modifySignatureField
메서드 및 다음 값 전달:- 다음
com.adobe.idp.Document
수정할 서명 필드가 포함된 PDF 문서를 저장하는 객체 - 서명 필드의 이름을 지정하는 문자열 값입니다
- 다음
PDFSignatureFieldProperties
서명 필드 잠금 사전 및 시드 값 사전 정보를 저장하는 개체
다음
modifySignatureField
메서드 반환com.adobe.idp.Document
수정된 서명 필드를 포함하는 PDF 문서를 저장하는 개체입니다. - 다음
-
PDF 문서를 PDF 파일로 저장
- 만들기
java.io.File
개체 및 파일 이름 확장명이 .pdf인지 확인합니다. - 를 호출합니다
com.adobe.idp.Document
개체copyToFile
컨텐츠의 내용 복사 방법com.adobe.idp.Document
개체를 파일로 가져올 수 있습니다. 를 사용해야 합니다com.adobe.idp.Document
개체를modifySignatureField
메서드가 반환되었습니다.
- 만들기
웹 서비스 API를 사용하여 서명 필드 수정 modify-signature-fields-using-the-web-service-api
서명 API(웹 서비스)를 사용하여 서명 필드를 수정합니다.
-
프로젝트 파일 포함
MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다.
http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1
.note note NOTE 바꾸기 localhost
(AEM Forms을 호스팅하는 서버의 IP 주소 사용) -
서명 클라이언트 만들기
-
만들기
SignatureServiceClient
기본 생성자를 사용하여 개체를 만듭니다. -
만들기
SignatureServiceClient.Endpoint.Address
개체를System.ServiceModel.EndpointAddress
생성자입니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예:http://localhost:8080/soap/services/SignatureService?WSDL
). 를 사용할 필요가 없습니다lc_version
속성을 사용합니다. 이 속성은 서비스 참조를 생성할 때 사용됩니다.) -
만들기
System.ServiceModel.BasicHttpBinding
개체의 값을 가져와서SignatureServiceClient.Endpoint.Binding
필드. 반환 값을 다음으로 캐스팅합니다.BasicHttpBinding
. -
설정
System.ServiceModel.BasicHttpBinding
개체MessageEncoding
필드 대상WSMessageEncoding.Mtom
. 이 값은 MTOM이 사용되도록 합니다. -
다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
- 필드에 AEM Forms 사용자 이름을 지정합니다
SignatureServiceClient.ClientCredentials.UserName.UserName
. - 필드에 해당 암호 값을 지정합니다
SignatureServiceClient.ClientCredentials.UserName.Password
. - 상수 값 할당
HttpClientCredentialType.Basic
아래와 같이 변경하는 것을 의미합니다BasicHttpBindingSecurity.Transport.ClientCredentialType
. - 상수 값 할당
BasicHttpSecurityMode.TransportCredentialOnly
아래와 같이 변경하는 것을 의미합니다BasicHttpBindingSecurity.Security.Mode
.
- 필드에 AEM Forms 사용자 이름을 지정합니다
-
-
수정할 서명 필드가 포함된 PDF 문서 가져오기
- 만들기
BLOB
생성자를 사용하여 개체를 작성합니다. 다음BLOB
객체는 수정할 서명 필드가 포함된 PDF 문서를 저장하는 데 사용됩니다. - 만들기
System.IO.FileStream
객체를 사용하여 해당 생성자를 호출하고 PDF 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달합니다. - 의 내용을 저장하는 바이트 배열을 만듭니다
System.IO.FileStream
개체. 를 가져와서 바이트 배열의 크기를 결정할 수 있습니다System.IO.FileStream
개체Length
속성을 사용합니다. - 를 호출하여 바이트 배열을 스트림 데이터로 채웁니다
System.IO.FileStream
개체Read
바이트 배열, 시작 위치 및 읽을 스트림 길이를 전달하는 메서드와 전달 - 을(를) 채우기
BLOB
개체를 할당하여 개체를 개체 개체MTOM
속성은 바이트 배열의 내용을 나타냅니다.
- 만들기
-
사전 값 설정
- 만들기
PDFSignatureFieldProperties
생성자를 사용하여 개체를 작성합니다. 이 개체는 서명 필드 잠금 사전 및 시드 값 사전 정보를 저장합니다. - 만들기
PDFSeedValueOptionSpec
생성자를 사용하여 개체를 작성합니다. 이 개체를 사용하면 시드 값 사전 값을 설정할 수 있습니다. - 를 지정하여 PDF 문서에 대한 변경 허용 안 함
MDPPermissions.NoChanges
열거형 값PDFSeedValueOptionSpec
개체mdpValue
데이터 멤버. - 만들기
FieldMDPOptionSpec
생성자를 사용하여 개체를 작성합니다. 이 개체를 사용하면 서명 필드 잠금 사전 값을 설정할 수 있습니다. - PDF 문서에 있는 모든 필드를
FieldMDPAction.ALL
열거형 값FieldMDPOptionSpec
개체mdpValue
데이터 멤버. - 를 할당하여 시드 값 사전 정보를 설정합니다.
PDFSeedValueOptionSpec
개체PDFSignatureFieldProperties
개체seedValue
데이터 멤버. - 서명 필드 잠금 사전 정보를 할당하여 설정합니다.
FieldMDPOptionSpec
개체PDFSignatureFieldProperties
개체fieldMDP
데이터 멤버.
note note NOTE 설정할 수 있는 모든 시드 값 사전 값을 보려면 PDFSeedValueOptionSpec
클래스 참조. (자세한 내용은 AEM Forms API 참조). - 만들기
-
서명 필드 수정
를 호출하여 서명 필드를 수정합니다
SignatureServiceClient
개체modifySignatureField
메서드 및 다음 값 전달:- 다음
BLOB
수정할 서명 필드가 포함된 PDF 문서를 저장하는 객체 - 서명 필드의 이름을 지정하는 문자열 값입니다
- 다음
PDFSignatureFieldProperties
서명 필드 잠금 사전 및 시드 값 사전 정보를 저장하는 개체
다음
modifySignatureField
메서드 반환BLOB
수정된 서명 필드를 포함하는 PDF 문서를 저장하는 개체입니다. - 다음
-
PDF 문서를 PDF 파일로 저장
- 만들기
System.IO.FileStream
객체를 사용하여 해당 생성자를 호출하고 서명 필드를 포함할 PDF 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달합니다. - 의 내용을 저장하는 바이트 배열을 만듭니다
BLOB
개체를addSignatureField
메서드가 을 반환합니다. 의 값을 가져와서 바이트 배열을 채웁니다BLOB
개체MTOM
데이터 멤버. - 만들기
System.IO.BinaryWriter
생성자를 호출하고 전달하여 개체를System.IO.FileStream
개체. - 를 호출하여 PDF 파일에 바이트 배열의 내용을 씁니다.
System.IO.BinaryWriter
개체Write
메서드를 사용하여 바이트 배열을 전달합니다.
- 만들기
추가 참조
디지털 서명 PDF 문서 digitally-signing-pdf-documents
디지털 서명을 PDF 문서에 적용하여 보안 수준을 제공할 수 있습니다. 자필 서명과 같은 디지털 서명은 서명자가 자신을 식별하고 문서에 대한 진술을 하는 수단을 제공합니다. 문서에 디지털 서명을 하는 데 사용되는 기술은 서명자와 수신자 모두 서명된 내용이 무엇인지 명확하게 하고, 서명된 이후 문서가 변경되지 않았다고 확신하는 데 도움이 됩니다.
PDF 문서는 공개 키 기술로 서명됩니다. 서명자에게 두 개의 키가 있습니다. 공개 키와 개인 키. 개인 키는 서명 시 사용할 수 있어야 하는 사용자의 자격 증명에 저장됩니다. 공개 키는 수신자가 서명을 확인하기 위해 사용할 수 있어야 하는 사용자의 인증서에 저장됩니다. 해지된 인증서에 대한 정보는 CA(인증서 해지 목록)에서 배포되는 CRL 및 OCSP(온라인 인증서 상태 프로토콜) 응답에서 찾을 수 있습니다. 서명 시간은 Timestaming Authority라는 신뢰할 수 있는 소스에서 얻을 수 있습니다.
프로그래밍 방식으로 PDF 문서에 디지털 서명을 할 수 있습니다. PDF 문서에 디지털 서명을 할 때는 AEM Forms에 있는 보안 자격 증명을 참조해야 합니다. 자격 증명은 서명에 사용되는 개인 키입니다.
서명 서비스는 PDF 문서에 서명할 때 다음 단계를 수행합니다.
- 서명 서비스는 요청에 지정된 별칭을 전달하여 Truststore에서 자격 증명을 검색합니다.
- Truststore가 지정된 자격 증명을 검색합니다.
- 자격 증명이 서명 서비스에 반환되고 문서에 서명하는 데 사용됩니다. 또한 자격 증명은 향후 요청에 대해 별칭에 대해 캐시됩니다.
보안 자격 증명 처리에 대한 자세한 내용은 응용 프로그램 서버의 AEM Forms 설치 및 배포* 안내서를 참조하십시오.
PDFOperationException
. 이 문제를 해결하려면 PDF 유틸리티 서비스를 사용하여 XDP 파일을 PDF 파일로 변환한 다음 변환된 PDF 파일을 서명 서비스 작업에 전달합니다. (자세한 내용은 PDF 유틸리티 작업)nCipher nShield HSM 자격 증명
nCipher nShield HSM 자격 증명을 사용하여 PDF 문서에 서명하거나 인증하는 경우 AEM Forms이 배포된 J2EE 응용 프로그램 서버를 다시 시작할 때까지 새 자격 증명을 사용할 수 없습니다. 그러나 구성 값을 설정하면 J2EE 응용 프로그램 서버를 다시 시작하지 않고 서명 또는 인증 작업이 작동합니다.
/opt/nfast/cknfstrc(또는 c:\nfast\cknfastrc)에 있는 cknfstrc 파일에 다음 구성 값을 추가할 수 있습니다.
CKNFAST_ASSUME_SINGLE_PROCESS=0
이 구성 값을 cknfac 파일에 추가한 후 J2EE 응용 프로그램 서버를 다시 시작하지 않고 새 자격 증명을 사용할 수 있습니다.
서명을 신뢰할 수 없습니다.
동일한 PDF 문서를 인증하고 서명할 때 인증 서명을 신뢰할 수 없으면 Acrobat 또는 Adobe Reader에서 PDF 문서를 열 때 첫 번째 서명에 대해 노란색 삼각형이 나타납니다. 이러한 상황을 피하기 위해서는 인증 서명을 신뢰할 수 있어야 합니다.
XFA 기반 양식인 서명 문서
서명 서비스 API를 사용하여 XFA 기반 양식에 서명하려고 하면 View
Signed
Version
Acrobat에 있습니다. 예를 들어 다음 워크플로우를 고려해 보십시오.
- 디자이너를 사용하여 만든 XDP 파일을 사용하면 서명 필드와 양식 데이터가 포함된 XML 데이터가 포함된 양식 디자인을 병합합니다. Forms 서비스를 사용하여 대화형 PDF 문서를 생성합니다.
- 서명 서비스 API를 사용하여 PDF 문서에 서명합니다.
단계 요약 summary_of_steps-3
PDF 문서에 디지털 서명을 하려면 다음 작업을 수행합니다.
- 프로젝트 파일을 포함합니다.
- 서명 서비스 클라이언트를 만듭니다.
- 서명할 PDF 문서를 가져옵니다.
- PDF 문서에 서명합니다.
- 서명된 PDF 문서를 PDF 파일로 저장합니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함합니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함하십시오. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
다음 JAR 파일을 프로젝트의 클래스 경로에 추가해야 합니다.
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-signatures-client.jar
- adobe-utilities.jar(AEM Forms이 JBoss에 배포된 경우 필수)
- jbossall-client.jar(AEM Forms이 JBoss에 배포되는 경우 필요)
서명 클라이언트 만들기
서명 서비스 작업을 프로그래밍 방식으로 수행하려면 먼저 서명 서비스 클라이언트를 만들어야 합니다.
서명할 PDF 문서 가져오기
PDF 문서에 서명하려면 서명 필드가 포함된 PDF 문서를 가져와야 합니다. PDF 문서에 서명 필드가 없으면 서명할 수 없습니다. 디자이너를 사용하거나 프로그래밍 방식으로 서명 필드를 추가할 수 있습니다.
PDF 문서에 서명
PDF 문서에 서명할 때 서명 서비스에서 사용하는 런타임 옵션을 설정할 수 있습니다. 다음 옵션을 설정할 수 있습니다.
- 모양 옵션
- 해지 확인
- 시간 스탬핑 값
를 사용하여 모양새 옵션을 설정합니다 PDFSignatureAppearanceOptionSpec
개체. 예를 들어 PDFSignatureAppearanceOptionSpec
개체 setShowDate
방법 및 전달 true
.
PDF 문서에 디지털 서명하는 데 사용되는 인증서가 해지되었는지 여부를 결정하는 해지 확인을 수행할지 여부를 지정할 수도 있습니다. 해지 확인을 수행하려면 다음 값 중 하나를 지정할 수 있습니다.
- NoCheck: 해지 확인을 수행하지 마십시오.
- 최상의 작업: 체인에 있는 모든 인증서의 취소를 항상 확인하십시오. 확인 중에 문제가 발생하면 해제가 유효하다고 가정합니다. 오류가 발생하면 인증서가 해지되지 않았다고 가정합니다.
- CheckIfAvailable: 해지 정보를 사용할 수 있는 경우 체인에서 모든 인증서의 취소를 확인하십시오. 체크 시 문제가 발생하면 해제가 잘못된 것으로 간주됩니다. 오류가 발생하면 인증서가 취소되고 유효하지 않다고 가정합니다. (이 값은 기본값입니다.)
- AlwaysCheck: 체인에 있는 모든 인증서의 취소를 확인하십시오. 인증서에 해지 정보가 없는 경우 취소는 잘못된 것으로 간주됩니다.
인증서에 대해 해지 확인을 수행하려면 다음을 사용하여 CRL(인증서 해지 목록) 서버의 URL을 지정할 수 있습니다 CRLOptionSpec
개체. 그러나 해지 확인을 수행하려고 하며 CRL 서버에 URL을 지정하지 않으면 서명 서비스는 인증서에서 URL을 가져옵니다.
CRL 서버를 사용하는 대신 해지 확인을 수행할 때 OCSP(온라인 인증서 상태 프로토콜) 서버를 사용할 수 있습니다. 일반적으로 CRL 서버와 반대로 OCSP 서버를 사용할 경우 해지 확인이 더 빨리 수행됩니다. ("온라인 인증서 상태 프로토콜"을 참조하십시오.) https://tools.ietf.org/html/rfc2560)
Adobe 응용 프로그램 및 서비스를 사용하여 서명 서비스에서 사용하는 CRL 및 OCSP 서버 순서를 설정할 수 있습니다. 예를 들어, OCSP 서버가 Adobe 응용 프로그램 및 서비스에서 먼저 설정된 경우 OCSP 서버가 선택된 후 CRL 서버가 실행됩니다. (AAC 도움말에서 "신뢰 저장소를 사용하여 인증서 및 자격 증명 관리"를 참조하십시오.)
해지 확인을 수행하지 않도록 지정하면 서명 서비스는 문서에 서명하거나 인증하는 데 사용된 인증서가 해지되었는지 확인하지 않습니다. 즉, CRL 및 OCSP 서버 정보는 무시됩니다.
CRLOptionSpec
그리고 OCSPOptionSpec
개체. 예를 들어 CRL 서버를 재정의하려면 CRLOptionSpec
개체 setLocalURI
메서드를 사용합니다.타임스탬프는 서명 또는 인증된 문서를 수정한 시간을 추적하는 프로세스를 의미합니다. 문서에 서명하면 문서 소유자가 문서를 수정해서는 안 됩니다. 서명 또는 인증된 문서의 유효성을 검사하는 데 도움이 됩니다. 를 사용하여 타임스탬프 옵션을 설정할 수 있습니다 TSPOptionSpec
개체. 예를 들어 TSP(Time Staming Provider) 서버의 URL을 지정할 수 있습니다.
PDF 문서에 성공적으로 서명하려면 디지털 서명이 포함될 서명 필드의 정규화된 이름을 지정할 수 있습니다. form1[0].#subform[1].SignatureField3[3]
. XFA 양식 필드를 사용할 때 서명 필드의 부분 이름을 사용할 수도 있습니다. SignatureField3[3]
.
PDF 문서에 디지털 서명을 하려면 보안 자격 증명을 참조해야 합니다. 보안 자격 증명을 참조하려면 별칭을 지정합니다. 별칭은 PKCS#12 파일(.pfx 확장명 사용) 또는 HSM(하드웨어 보안 모듈)에 있을 수 있는 실제 자격 증명의 참조입니다. 보안 자격 증명에 대한 자세한 내용은 응용 프로그램 서버의 AEM Forms 설치 및 배포* 안내서를 참조하십시오.
서명된 PDF 문서를 저장합니다
서명 서비스가 PDF 문서에 디지털 서명을 한 후 사용자가 Acrobat 또는 Adobe Reader에서 열 수 있도록 PDF 파일로 저장할 수 있습니다.
추가 참조
웹 서비스 API를 사용하여 PDF 문서에 디지털 서명
Java API를 사용하여 PDF 문서에 디지털 서명 digitally-sign-pdf-documents-using-the-java-api
서명 API(Java)를 사용하여 PDF 문서에 디지털 서명을 합니다.
-
프로젝트 파일 포함
Java 프로젝트의 클래스 경로에 adobe-signatures-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
-
서명 클라이언트 만들기
- 만들기
ServiceClientFactory
연결 속성을 포함하는 객체입니다. - 만들기
SignatureServiceClient
생성자를 사용하여 객체를 전달하고ServiceClientFactory
개체.
- 만들기
-
서명할 PDF 문서 가져오기
- 만들기
java.io.FileInputStream
생성자를 사용하여 디지털 서명할 PDF 문서를 나타내고 PDF 문서의 위치를 지정하는 문자열 값을 전달하는 개체입니다. - 만들기
com.adobe.idp.Document
생성자를 사용하여 객체를 전달하고java.io.FileInputStream
개체.
- 만들기
-
PDF 문서에 서명
를 호출하여 PDF 문서에 서명합니다
SignatureServiceClient
개체sign
메서드 및 다음 값 전달:- A
com.adobe.idp.Document
서명할 PDF 문서를 나타내는 개체입니다. - 디지털 서명이 포함될 서명 필드의 이름을 나타내는 문자열 값입니다.
- A
Credential
PDF 문서에 디지털 서명하는 데 사용되는 자격 증명을 나타내는 개체입니다. 만들기Credential
객체를 호출하여Credential
개체의 정적getInstance
보안 자격 증명에 해당하는 별칭 값을 지정하는 문자열 값 전달 및 메서드 - A
HashAlgorithm
PDF 문서 다이제스트에 사용할 해시 알고리즘을 나타내는 정적 데이터 멤버를 지정하는 개체입니다. 예를 들어HashAlgorithm.SHA1
SHA1 알고리즘을 사용하려면 다음을 수행하십시오. - PDF 문서가 디지털 서명된 이유를 나타내는 문자열 값입니다.
- 서명자의 연락처 정보를 나타내는 문자열 값입니다.
- A
PDFSignatureAppearanceOptions
디지털 서명의 모양을 제어하는 개체입니다. 예를 들어 이 개체를 사용하여 디지털 서명에 사용자 지정 로고를 추가할 수 있습니다. - A
java.lang.Boolean
서명자 인증서에 대한 해지 확인을 수행할지 여부를 지정하는 개체입니다. - An
OCSPOptionSpec
OCSP(온라인 인증서 상태 프로토콜) 지원에 대한 환경 설정을 저장하는 개체입니다. 해지 검사가 수행되지 않으면 이 매개 변수가 사용되지 않으며 다음을 지정할 수 있습니다null
. - A
CRLPreferences
CRL(인증서 해지 목록) 환경설정을 저장하는 객체입니다. 해지 검사가 수행되지 않으면 이 매개 변수가 사용되지 않으며 다음을 지정할 수 있습니다null
. - A
TSPPreferences
TSP(타임스탬프 제공자) 지원에 대한 환경 설정을 저장하는 개체입니다. 이 매개 변수는 선택 사항이며 다음 작업을 수행할 수 있습니다null
. 자세한 내용은 AEM Forms API 참조.
다음
sign
메서드 반환com.adobe.idp.Document
서명된 PDF 문서를 나타내는 개체입니다. - A
-
서명된 PDF 문서를 저장합니다
- 만들기
java.io.File
개체 및 파일 확장명이 .pdf인지 확인합니다. - 를 호출합니다
com.adobe.idp.Document
개체copyToFile
메서드 및 전달java.io.File
의 내용을 복사하다Document
개체를 파일로 가져올 수 있습니다. 를 사용해야 합니다com.adobe.idp.Document
반환되는 개체sign
메서드를 사용합니다.
- 만들기
추가 참조
빠른 시작(SOAP 모드): Java API를 사용하여 PDF 문서에 디지털 서명
웹 서비스 API를 사용하여 PDF 문서에 디지털 서명 digitally-signing-pdf-documents-using-the-web-service-api
서명 API(웹 서비스)를 사용하여 PDF 문서에 디지털 서명을 하려면,
-
프로젝트 파일 포함
MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다.
http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1
.note note NOTE 바꾸기 localhost
(AEM Forms을 호스팅하는 서버의 IP 주소 사용) -
서명 클라이언트 만들기
-
만들기
SignatureServiceClient
기본 생성자를 사용하여 개체를 만듭니다. -
만들기
SignatureServiceClient.Endpoint.Address
개체를System.ServiceModel.EndpointAddress
생성자입니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예:http://localhost:8080/soap/services/SignatureService?WSDL
). 를 사용할 필요가 없습니다lc_version
속성을 사용합니다. 이 속성은 서비스 참조를 생성할 때 사용됩니다.) -
만들기
System.ServiceModel.BasicHttpBinding
개체의 값을 가져와서SignatureServiceClient.Endpoint.Binding
필드. 반환 값을 다음으로 캐스팅합니다.BasicHttpBinding
. -
설정
System.ServiceModel.BasicHttpBinding
개체MessageEncoding
필드 대상WSMessageEncoding.Mtom
. 이 값은 MTOM이 사용되도록 합니다. -
다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
- 필드에 AEM Forms 사용자 이름을 지정합니다
SignatureServiceClient.ClientCredentials.UserName.UserName
. - 필드에 해당 암호 값을 지정합니다
SignatureServiceClient.ClientCredentials.UserName.Password
. - 상수 값 할당
HttpClientCredentialType.Basic
아래와 같이 변경하는 것을 의미합니다BasicHttpBindingSecurity.Transport.ClientCredentialType
. - 상수 값 할당
BasicHttpSecurityMode.TransportCredentialOnly
아래와 같이 변경하는 것을 의미합니다BasicHttpBindingSecurity.Security.Mode
.
- 필드에 AEM Forms 사용자 이름을 지정합니다
-
-
서명할 PDF 문서 가져오기
- 만들기
BLOB
생성자를 사용하여 개체를 작성합니다. 다음BLOB
개체는 서명된 PDF 문서를 저장하는 데 사용됩니다. - 만들기
System.IO.FileStream
객체를 사용하여 해당 생성자를 호출하고 서명할 PDF 문서의 파일 위치를 나타내는 문자열 값과 파일을 열 모드를 전달하여 객체를 엽니다. - 의 내용을 저장하는 바이트 배열을 만듭니다
System.IO.FileStream
개체. 를 가져와서 바이트 배열의 크기를 결정할 수 있습니다System.IO.FileStream
개체Length
속성을 사용합니다. - 를 호출하여 바이트 배열을 스트림 데이터로 채웁니다
System.IO.FileStream
개체Read
바이트 배열, 시작 위치 및 읽을 스트림 길이를 전달하는 메서드와 전달 - 을(를) 채우기
BLOB
개체를 할당하여 개체를 개체 개체MTOM
속성은 바이트 배열의 내용을 나타냅니다.
- 만들기
-
PDF 문서에 서명
를 호출하여 PDF 문서에 서명합니다
SignatureServiceClient
개체sign
메서드 및 다음 값 전달:- A
BLOB
서명할 PDF 문서를 나타내는 개체입니다. - 디지털 서명이 포함될 서명 필드의 이름을 나타내는 문자열 값입니다.
- A
Credential
PDF 문서에 디지털 서명하는 데 사용되는 자격 증명을 나타내는 개체입니다. 만들기Credential
개체를 생성자로 사용하여 개체를 지정하고 값을Credential
개체alias
속성을 사용합니다. - A
HashAlgorithm
PDF 문서 다이제스트에 사용할 해시 알고리즘을 나타내는 정적 데이터 멤버를 지정하는 개체입니다. 예를 들어HashAlgorithm.SHA1
SHA1 알고리즘을 사용하려면 다음을 수행하십시오. - 해시 알고리즘이 사용되는지 여부를 지정하는 부울 값입니다.
- PDF 문서가 디지털 서명된 이유를 나타내는 문자열 값입니다.
- 서명자의 위치를 나타내는 문자열 값입니다.
- 서명자의 연락처 정보를 나타내는 문자열 값입니다.
- A
PDFSignatureAppearanceOptions
디지털 서명의 모양을 제어하는 개체입니다. 예를 들어 이 개체를 사용하여 디지털 서명에 사용자 지정 로고를 추가할 수 있습니다. - A
System.Boolean
서명자 인증서에 대한 해지 확인을 수행할지 여부를 지정하는 개체입니다. 이 해지 확인이 완료되면 서명에 포함됩니다. 기본값은false
입니다. - An
OCSPOptionSpec
OCSP(온라인 인증서 상태 프로토콜) 지원에 대한 환경 설정을 저장하는 개체입니다. 해지 검사가 수행되지 않으면 이 매개 변수가 사용되지 않으며 다음을 지정할 수 있습니다null
. 이 객체에 대한 자세한 내용은 AEM Forms API 참조. - A
CRLPreferences
CRL(인증서 해지 목록) 환경설정을 저장하는 객체입니다. 해지 검사가 수행되지 않으면 이 매개 변수가 사용되지 않으며 다음을 지정할 수 있습니다null
. - A
TSPPreferences
TSP(타임스탬프 제공자) 지원에 대한 환경 설정을 저장하는 개체입니다. 이 매개 변수는 선택 사항이며 다음 작업을 수행할 수 있습니다null
.
다음
sign
메서드 반환BLOB
서명된 PDF 문서를 나타내는 개체입니다. - A
-
서명된 PDF 문서를 저장합니다
- 만들기
System.IO.FileStream
개체를 생성자로 호출하여 개체를 가져옵니다. 서명된 PDF 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달합니다. - 의 내용을 저장하는 바이트 배열을 만듭니다
BLOB
반환되는 개체sign
메서드를 사용합니다. 의 값을 가져와서 바이트 배열을 채웁니다BLOB
개체MTOM
데이터 멤버. - 만들기
System.IO.BinaryWriter
생성자를 호출하고 전달하여 개체를System.IO.FileStream
개체. - 를 호출하여 PDF 파일에 바이트 배열의 내용을 씁니다.
System.IO.BinaryWriter
개체Write
메서드를 사용하여 바이트 배열을 전달합니다.
- 만들기
추가 참조
디지털 서명 대화형 Forms digitally-signing-interactive-forms
Forms 서비스에서 만드는 대화형 양식에 서명할 수 있습니다. 예를 들어 다음 워크플로우를 고려해 보십시오.
- 디자이너를 사용하여 만든 XFA 기반 PDF 양식과 Forms 서비스를 사용하여 XML 문서에 있는 양식 데이터를 병합합니다. Forms 서버가 대화형 양식을 렌더링합니다.
- 서명 서비스 API를 사용하여 대화형 양식에 서명합니다.
디지털 서명된 대화형 PDF 양식입니다. XFA 양식을 기반으로 하는 PDF 양식에 서명할 때 PDF 파일을 Adobe 정적 PDF 양식으로 저장했는지 확인합니다. Adobe 다이내믹 PDF 양식으로 저장된 PDF 양식에 서명하려고 하면 예외가 발생합니다. Forms 서비스에서 반환되는 양식에 서명하고 있으므로 양식에 서명 필드가 포함되어 있는지 확인하십시오.
Forms 서비스 API를 사용할 때 GenerateServerAppearance
에 대한 런타임 옵션 true
. 이 런타임 옵션을 사용하면 Acrobat 또는 Adobe Reader에서 연 후에도 서버에서 생성된 양식의 모양이 그대로 유지됩니다. Forms API를 사용하여 서명할 대화형 양식을 생성할 때 이 런타임 옵션을 설정하는 것이 좋습니다.
단계 요약 summary_of_steps-4
Forms 서비스가 반환하는 대화형 양식에 디지털 서명을 하려면 다음 작업을 수행합니다.
- 프로젝트 파일을 포함합니다.
- Forms 및 서명 클라이언트를 만듭니다.
- Forms 서비스를 사용하여 대화형 양식을 얻습니다.
- 대화형 양식에 서명합니다.
- 서명된 PDF 문서를 PDF 파일로 저장합니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함합니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함하십시오. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
다음 JAR 파일을 프로젝트의 클래스 경로에 추가해야 합니다.
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-signatures-client.jar
- adobe-forms-client.jar
- adobe-utilities.jar(AEM Forms이 JBoss에 배포된 경우 필수)
- jbossall-client.jar(AEM Forms이 JBoss에 배포되는 경우 필요)
이러한 JAR 파일의 위치에 대한 자세한 내용은 AEM Forms Java 라이브러리 파일 포함.
Forms 및 서명 클라이언트 만들기
이 워크플로우는 Forms 및 Signature 서비스를 모두 호출하므로, Forms 서비스 클라이언트와 Signature 서비스 클라이언트를 모두 만듭니다.
Forms 서비스를 사용하여 대화형 양식 가져오기
Forms 서비스를 사용하여 서명할 대화형 PDF 양식을 가져올 수 있습니다. AEM Forms의 경우 com.adobe.idp.Document
렌더링할 양식이 포함된 Forms 서비스에 대한 개체입니다. 이 메서드의 이름은 renderPDFForm2
. 이 메서드는 com.adobe.idp.Document
서명할 양식이 포함된 개체입니다. 이걸 전달하시면 됩니다 com.adobe.idp.Document
Signature 서비스에 인스턴스를 추가합니다.
마찬가지로, 웹 서비스를 사용하는 경우 를 전달할 수 있습니다 BLOB
Forms 서비스가 서명 서비스로 반환되는 인스턴스입니다.
renderPDFForm2
메서드를 사용합니다.대화형 양식에 서명
PDF 문서에 서명할 때 서명 서비스에서 사용하는 런타임 옵션을 설정할 수 있습니다. 다음 옵션을 설정할 수 있습니다.
- 모양 옵션
- 해지 확인
- 시간 스탬핑 값
를 사용하여 모양새 옵션을 설정합니다 PDFSignatureAppearanceOptionSpec
개체. 예를 들어 PDFSignatureAppearanceOptionSpec
개체 setShowDate
방법 및 전달 true
.
서명된 PDF 문서를 저장합니다
서명 서비스가 PDF 문서에 디지털 서명을 한 후 PDF 파일로 저장할 수 있습니다. PDF 파일은 Acrobat 또는 Adobe Reader에서 열 수 있습니다.
추가 참조
웹 서비스 API를 사용하여 대화형 양식에 디지털 서명
Java API를 사용하여 대화형 양식에 디지털 서명 digitally-sign-an-interactive-form-using-the-java-api
Forms 및 서명 API(Java)를 사용하여 대화형 양식에 디지털 서명합니다.
-
프로젝트 파일 포함
Java 프로젝트의 클래스 경로에 adobe-signatures-client.jar 및 adobe-forms-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
-
Forms 및 서명 클라이언트 만들기
- 만들기
ServiceClientFactory
연결 속성을 포함하는 객체입니다. - 만들기
SignatureServiceClient
생성자를 사용하여 객체를 전달하고ServiceClientFactory
개체. - 만들기
FormsServiceClient
생성자를 사용하여 객체를 전달하고ServiceClientFactory
개체.
- 만들기
-
Forms 서비스를 사용하여 대화형 양식 가져오기
-
만들기
java.io.FileInputStream
생성자를 사용하여 Forms 서비스에 전달할 PDF 문서를 나타내는 개체입니다. PDF 문서의 위치를 지정하는 문자열 값을 전달합니다. -
만들기
com.adobe.idp.Document
생성자를 사용하여 객체를 전달하고java.io.FileInputStream
개체. -
만들기
java.io.FileInputStream
생성자를 사용하여 Forms 서비스에 전달할 양식 데이터가 포함된 XML 문서를 나타내는 개체입니다. XML 파일의 위치를 지정하는 문자열 값을 전달합니다. -
만들기
com.adobe.idp.Document
생성자를 사용하여 객체를 전달하고java.io.FileInputStream
개체. -
만들기
PDFFormRenderSpec
런타임 옵션을 설정하는 데 사용되는 개체입니다. 를 호출합니다PDFFormRenderSpec
개체setGenerateServerAppearance
메서드 및 전달true
. -
를 호출합니다
FormsServiceClient
개체renderPDFForm2
메서드를 사용하여 다음 값을 전달합니다.- A
com.adobe.idp.Document
렌더링할 PDF 양식이 포함된 개체입니다. - A
com.adobe.idp.Document
폼과 병합할 데이터를 포함하는 개체입니다. - A
PDFFormRenderSpec
런타임 옵션을 저장하는 개체입니다. - A
URLSpec
Forms 서비스에 필요한 URI 값을 포함하는 객체입니다. 다음을 지정할 수 있습니다null
참조하십시오. - A
java.util.HashMap
첨부 파일을 저장하는 객체입니다. 선택적 매개 변수이며null
양식에 파일을 첨부하지 않으려면
다음
renderPDFForm2
메서드 반환FormsResult
양식 데이터 스트림을 포함하는 개체 - A
-
를 호출하여 PDF 양식을 검색합니다.
FormsResult
개체getOutputContent
메서드를 사용합니다. 이 메서드는com.adobe.idp.Document
대화형 양식을 나타내는 개체입니다.
-
-
대화형 양식에 서명
를 호출하여 PDF 문서에 서명합니다
SignatureServiceClient
개체sign
메서드 및 다음 값 전달:- A
com.adobe.idp.Document
서명할 PDF 문서를 나타내는 개체입니다. 이 개체가com.adobe.idp.Document
Forms 서비스에서 가져온 객체입니다. - 서명된 서명 필드의 이름을 나타내는 문자열 값입니다.
- A
Credential
PDF 문서에 디지털 서명하는 데 사용되는 자격 증명을 나타내는 개체입니다. 만들기Credential
객체를 호출하여Credential
개체의 정적getInstance
메서드를 사용합니다. 보안 자격 증명에 해당하는 별칭 값을 지정하는 문자열 값을 전달합니다. - A
HashAlgorithm
PDF 문서 다이제스트에 사용할 해시 알고리즘을 나타내는 정적 데이터 멤버를 지정하는 개체입니다. 예를 들어HashAlgorithm.SHA1
SHA1 알고리즘을 사용하려면 다음을 수행하십시오. - PDF 문서가 디지털 서명된 이유를 나타내는 문자열 값입니다.
- 서명자의 연락처 정보를 나타내는 문자열 값입니다.
- A
PDFSignatureAppearanceOptions
디지털 서명의 모양을 제어하는 개체입니다. 예를 들어 이 개체를 사용하여 디지털 서명에 사용자 지정 로고를 추가할 수 있습니다. - A
java.lang.Boolean
서명자 인증서에 대한 해지 확인을 수행할지 여부를 지정하는 개체입니다. - An
OCSPPreferences
OCSP(온라인 인증서 상태 프로토콜) 지원에 대한 환경 설정을 저장하는 개체입니다. 해지 검사가 수행되지 않으면 이 매개 변수가 사용되지 않으며 다음을 지정할 수 있습니다null
. - A
CRLPreferences
CRL(인증서 해지 목록) 환경설정을 저장하는 객체입니다. 해지 검사가 수행되지 않으면 이 매개 변수가 사용되지 않으며 다음을 지정할 수 있습니다null
. - A
TSPPreferences
TSP(타임스탬프 제공자) 지원에 대한 환경 설정을 저장하는 개체입니다. 이 매개 변수는 선택 사항이며 다음 작업을 수행할 수 있습니다null
.
다음
sign
메서드 반환com.adobe.idp.Document
서명된 PDF 문서를 나타내는 개체입니다. - A
-
서명된 PDF 문서를 저장합니다
- 만들기
java.io.File
개체 및 파일 확장명이 .pdf인지 확인합니다. - 를 호출합니다
com.adobe.idp.Document
개체copyToFile
메서드 및 전달java.io.File
의 내용을 복사하다Document
개체를 파일로 가져올 수 있습니다. 를 사용해야 합니다com.adobe.idp.Document
개체를sign
메서드가 반환되었습니다.
- 만들기
추가 참조
빠른 시작(SOAP 모드): Java API를 사용하여 PDF 문서에 디지털 서명
웹 서비스 API를 사용하여 대화형 양식에 디지털 서명 digitally-sign-an-interactive-form-using-the-web-service-api
Forms 및 서명 API(웹 서비스)를 사용하여 대화형 양식에 디지털 서명합니다.
-
프로젝트 파일 포함
MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 이 클라이언트 응용 프로그램은 두 개의 AEM Forms 서비스를 호출하므로 두 개의 서비스 참조를 만듭니다. 서명 서비스와 연결된 서비스 참조에 대해 다음 WSDL 정의를 사용하십시오.
http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1
.Forms 서비스와 연결된 서비스 참조에 대해 다음 WSDL 정의를 사용하십시오.
http://localhost:8080/soap/services/FormsService?WSDL&lc_version=9.0.1
.왜냐하면
BLOB
데이터 유형은 두 서비스 참조에 공통으로, 완전히 분류됩니다BLOB
데이터 유형을 사용합니다. 해당 웹 서비스 빠른 시작에서 모두BLOB
인스턴스는 완전히 검증됩니다.note note NOTE 바꾸기 localhost
(AEM Forms을 호스팅하는 서버의 IP 주소 사용) -
Forms 및 서명 클라이언트 만들기
-
만들기
SignatureServiceClient
기본 생성자를 사용하여 개체를 만듭니다. -
만들기
SignatureServiceClient.Endpoint.Address
개체를System.ServiceModel.EndpointAddress
생성자입니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예:http://localhost:8080/soap/services/SignatureService?WSDL
). 를 사용할 필요가 없습니다lc_version
속성을 사용합니다. 이 속성은 서비스 참조를 생성할 때 사용됩니다.) -
만들기
System.ServiceModel.BasicHttpBinding
개체의 값을 가져와서SignatureServiceClient.Endpoint.Binding
필드. 반환 값을 다음으로 캐스팅합니다.BasicHttpBinding
. -
설정
System.ServiceModel.BasicHttpBinding
개체MessageEncoding
필드 대상WSMessageEncoding.Mtom
. 이 값은 MTOM이 사용되도록 합니다. -
다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
- 필드에 AEM Forms 사용자 이름을 지정합니다
SignatureServiceClient.ClientCredentials.UserName.UserName
. - 필드에 해당 암호 값을 지정합니다
SignatureServiceClient.ClientCredentials.UserName.Password
. - 상수 값 할당
HttpClientCredentialType.Basic
아래와 같이 변경하는 것을 의미합니다BasicHttpBindingSecurity.Transport.ClientCredentialType
.
- 필드에 AEM Forms 사용자 이름을 지정합니다
-
상수 값 할당
BasicHttpSecurityMode.TransportCredentialOnly
아래와 같이 변경하는 것을 의미합니다BasicHttpBindingSecurity.Security.Mode
.
note note NOTE Forms 서비스 클라이언트에 대해 이러한 단계를 반복합니다. -
-
Forms 서비스를 사용하여 대화형 양식 가져오기
-
만들기
BLOB
생성자를 사용하여 개체를 작성합니다. 다음BLOB
개체는 서명된 PDF 문서를 저장하는 데 사용됩니다. -
만들기
System.IO.FileStream
객체를 사용하여 해당 생성자를 호출하고 서명할 PDF 문서의 파일 위치를 나타내는 문자열 값과 파일을 열 모드를 전달하여 객체를 엽니다. -
의 내용을 저장하는 바이트 배열을 만듭니다
System.IO.FileStream
개체. 를 가져와서 바이트 배열의 크기를 결정할 수 있습니다System.IO.FileStream
개체Length
속성을 사용합니다. -
를 호출하여 바이트 배열을 스트림 데이터로 채웁니다
System.IO.FileStream
개체Read
바이트 배열, 시작 위치 및 읽을 스트림 길이를 전달하는 메서드와 전달 -
을(를) 채우기
BLOB
개체를 할당하여 개체를 개체 개체MTOM
속성은 바이트 배열의 내용을 나타냅니다. -
만들기
BLOB
생성자를 사용하여 개체를 작성합니다. 다음BLOB
개체는 양식 데이터를 저장하는 데 사용됩니다. -
만들기
System.IO.FileStream
객체를 사용하여 해당 생성자를 호출하고 양식 데이터가 포함된 XML 파일의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달합니다. -
의 내용을 저장하는 바이트 배열을 만듭니다
System.IO.FileStream
개체. 를 가져와서 바이트 배열의 크기를 결정할 수 있습니다System.IO.FileStream
개체Length
속성을 사용합니다. -
를 호출하여 바이트 배열을 스트림 데이터로 채웁니다
System.IO.FileStream
개체Read
바이트 배열, 시작 위치 및 읽을 스트림 길이를 전달하는 메서드와 전달 -
을(를) 채우기
BLOB
개체를 할당하여 개체를 개체 개체MTOM
속성은 바이트 배열의 내용을 나타냅니다. -
만들기
PDFFormRenderSpec
런타임 옵션을 설정하는 데 사용되는 개체입니다. 값 할당true
변환 후PDFFormRenderSpec
개체generateServerAppearance
필드. -
를 호출합니다
FormsServiceClient
개체renderPDFForm2
메서드를 사용하여 다음 값을 전달합니다.- A
BLOB
렌더링할 PDF 양식이 포함된 개체입니다. - A
BLOB
폼과 병합할 데이터를 포함하는 개체입니다. - A
PDFFormRenderSpec
런타임 옵션을 저장하는 개체입니다. - A
URLSpec
Forms 서비스에 필요한 URI 값을 포함하는 객체입니다. 다음을 지정할 수 있습니다null
참조하십시오. - A
java.util.HashMap
첨부 파일을 저장하는 객체입니다. 선택적 매개 변수이며null
양식에 파일을 첨부하지 않으려면 - 양식의 페이지 수를 저장하는 데 사용되는 긴 출력 매개 변수입니다.
- 로케일 값에 사용되는 문자열 출력 매개 변수입니다.
- A
FormResult
양방향 양식을 저장하는 데 사용되는 출력 매개 변수인 값입니다.
- A
-
를 호출하여 PDF 양식을 검색합니다
FormsResult
개체outputContent
필드. 이 필드에는BLOB
대화형 양식을 나타내는 개체입니다.
-
-
대화형 양식에 서명
를 호출하여 PDF 문서에 서명합니다
SignatureServiceClient
개체sign
메서드 및 다음 값 전달:- A
BLOB
서명할 PDF 문서를 나타내는 개체입니다. 를 사용하십시오BLOB
Forms 서비스에서 반환한 인스턴스입니다. - 서명된 서명 필드의 이름을 나타내는 문자열 값입니다.
- A
Credential
PDF 문서에 디지털 서명하는 데 사용되는 자격 증명을 나타내는 개체입니다. 만들기Credential
개체를 생성자로 사용하여 개체를 지정하고 값을Credential
개체alias
속성을 사용합니다. - A
HashAlgorithm
PDF 문서 다이제스트에 사용할 해시 알고리즘을 나타내는 정적 데이터 멤버를 지정하는 개체입니다. 예를 들어HashAlgorithm.SHA1
SHA1 알고리즘을 사용하려면 다음을 수행하십시오. - 해시 알고리즘이 사용되는지 여부를 지정하는 부울 값입니다.
- PDF 문서가 디지털 서명된 이유를 나타내는 문자열 값입니다.
- 서명자의 위치를 나타내는 문자열 값입니다.
- 서명자의 연락처 정보를 나타내는 문자열 값입니다.
- A
PDFSignatureAppearanceOptions
디지털 서명의 모양을 제어하는 개체입니다. 예를 들어 이 개체를 사용하여 디지털 서명에 사용자 지정 로고를 추가할 수 있습니다. - A
System.Boolean
서명자 인증서에 대한 해지 확인을 수행할지 여부를 지정하는 개체입니다. 이 해지 확인이 완료되면 서명에 포함됩니다. 기본값은false
입니다. - An
OCSPPreferences
OCSP(온라인 인증서 상태 프로토콜) 지원에 대한 환경 설정을 저장하는 개체입니다. 해지 검사가 수행되지 않으면 이 매개 변수가 사용되지 않으며 다음을 지정할 수 있습니다null
. 이 객체에 대한 자세한 내용은 AEM Forms API 참조. - A
CRLPreferences
CRL(인증서 해지 목록) 환경설정을 저장하는 객체입니다. 해지 검사가 수행되지 않으면 이 매개 변수가 사용되지 않으며 다음을 지정할 수 있습니다null
. - A
TSPPreferences
TSP(타임스탬프 제공자) 지원에 대한 환경 설정을 저장하는 개체입니다. 이 매개 변수는 선택 사항이며 다음 작업을 수행할 수 있습니다null
.
다음
sign
메서드 반환BLOB
서명된 PDF 문서를 나타내는 개체입니다. - A
-
서명된 PDF 문서를 저장합니다
- 만들기
System.IO.FileStream
개체를 생성자로 호출하여 개체를 가져옵니다. 서명된 PDF 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달합니다. - 의 내용을 저장하는 바이트 배열을 만듭니다
BLOB
반환되는 개체sign
메서드를 사용합니다. 의 값을 가져와서 바이트 배열을 채웁니다BLOB
개체MTOM
데이터 멤버. - 만들기
System.IO.BinaryWriter
생성자를 호출하고 전달하여 개체를System.IO.FileStream
개체. - 를 호출하여 PDF 파일에 바이트 배열의 내용을 씁니다.
System.IO.BinaryWriter
개체Write
메서드를 사용하여 바이트 배열을 전달합니다.
- 만들기
추가 참조
PDF 문서 인증 certifying-pdf-documents
인증된 서명이라는 특정 유형의 서명을 사용하여 PDF 문서를 인증하여 보안을 설정할 수 있습니다. 인증된 서명은 다음과 같은 방식으로 디지털 서명과 구별됩니다.
- PDF 문서에 적용된 첫 번째 서명이어야 합니다. 즉, 인증된 서명이 적용될 때 문서의 다른 서명 필드는 서명되지 않아야 합니다. PDF 문서에는 하나의 인증된 서명만 허용됩니다. PDF 문서에 서명하고 인증하려면 서명하기 전에 인증을 받아야 합니다. PDF 문서를 인증하면 추가 서명 필드에 디지털 서명을 할 수 있습니다.
- 문서의 작성자 또는 작성자는 인증된 서명을 무효화하지 않고 특정 방식으로 문서를 수정할 수 있음을 지정할 수 있습니다. 예를 들어, 이 문서에서는 양식에 입력하거나 주석을 달 수 있습니다. 작성자가 특정 수정 사항이 허용되지 않도록 지정하는 경우 Acrobat에서는 사용자가 이러한 방식으로 문서를 수정하지 못하도록 제한합니다. 다른 응용 프로그램을 사용하는 등의 이러한 수정 사항이 있는 경우 인증된 서명이 유효하지 않으며 사용자가 문서를 열면 Acrobat에 경고가 표시됩니다. (인증되지 않은 서명을 사용하면 수정 사항이 방지되지 않으며 일반 편집 작업이 원본 서명을 무효화하지 않습니다.)
- 서명 시 문서의 컨텐츠가 모호하거나 오해를 일으킬 수 있는 특정 유형의 컨텐츠가 있는지 문서가 스캔됩니다. 예를 들어, 주석에서는 인증되는 텍스트를 이해하는 데 중요한 페이지의 일부 텍스트를 구분할 수 있습니다. 이러한 컨텐츠에 대한 설명(법적 증명)을 제공할 수 있습니다.
서명 서비스 Java API 또는 서명 웹 서비스 API를 사용하여 PDF 문서를 프로그래밍 방식으로 인증할 수 있습니다. PDF 문서를 인증하는 경우 자격 증명 서비스에 있는 보안 자격 증명을 참조해야 합니다. 보안 자격 증명에 대한 자세한 내용은 AEM Forms 설치 및 배포 애플리케이션 서버에 대한 안내서입니다.
/opt/nfast/cknfstrc(또는 c:\nfast\cknfastrc)에 있는 cknfstrc 파일에 다음 구성 값을 추가할 수 있습니다.
CKNFAST_ASSUME_SINGLE_PROCESS=0
이 구성 값을 cknfac 파일에 추가한 후 J2EE 응용 프로그램 서버를 다시 시작하지 않고 새 자격 증명을 사용할 수 있습니다.
단계 요약 summary_of_steps-5
PDF 문서를 인증하려면 다음 작업을 수행합니다.
- 프로젝트 파일을 포함합니다.
- 서명 클라이언트를 만듭니다.
- 인증할 PDF 문서를 가져옵니다.
- PDF 문서를 인증합니다.
- 인증된 PDF 문서를 PDF 파일로 저장합니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함합니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함하십시오. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
다음 JAR 파일을 프로젝트의 클래스 경로에 추가해야 합니다.
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-signatures-client.jar
- adobe-utilities.jar(AEM Forms이 JBoss에 배포된 경우 필수)
- jbossall-client.jar(AEM Forms이 JBoss에 배포되는 경우 필요)
이러한 JAR 파일의 위치에 대한 자세한 내용은 AEM Forms Java 라이브러리 파일 포함.
서명 클라이언트 만들기
서명 작업을 프로그래밍 방식으로 수행하려면 먼저 서명 클라이언트를 만들어야 합니다.
인증을 위해 PDF 문서 받기
PDF 문서를 인증하려면 서명 필드가 포함된 PDF 문서를 가져와야 합니다. PDF 문서에 서명 필드가 없으면 인증을 받을 수 없습니다. 디자이너를 사용하거나 프로그래밍 방식으로 서명 필드를 추가할 수 있습니다. 서명 필드를 프로그래밍 방식으로 추가하는 방법에 대한 자세한 내용은 서명 필드 추가.
PDF 문서 인증
PDF 문서를 성공적으로 인증하려면 서명 서비스에서 PDF 문서를 인증하기 위해 사용하는 다음 입력 값이 필요합니다.
- PDF 문서: 서명 필드를 포함하는 PDF 문서로서, 인증된 서명의 그래픽 표현이 포함된 양식 필드입니다. PDF 문서에 서명 필드를 포함해야 인증을 받을 수 있습니다. 디자이너를 사용하거나 프로그래밍 방식으로 서명 필드를 추가할 수 있습니다. (자세한 내용은 서명 필드 추가)
- 서명 필드 이름: 인증된 서명 필드의 정규화된 이름입니다. 다음 값이 예입니다.
form1[0].#subform[1].SignatureField3[3]
. XFA 양식 필드를 사용할 때 서명 필드의 부분 이름을 사용할 수도 있습니다.SignatureField3[3]
. 필드 이름에 대해 null 값이 전달되면 보이지 않는 서명 필드가 동적으로 만들어지고 인증됩니다. - 보안 자격 증명: PDF 문서를 인증하는 데 사용되는 자격 증명입니다. 이 보안 자격 증명에는 암호 및 별칭이 포함되어 있습니다. 이 별칭은 자격 증명 서비스 내에 있는 자격 증명에 나타나는 별칭과 일치해야 합니다. 별칭은 PKCS#12 파일(확장명이 .pfx) 또는 HSM(하드웨어 보안 모듈)에 있을 수 있는 실제 자격 증명을 참조합니다.
- 해시 알고리즘: PDF 문서를 다이제스트하는 데 사용할 해시 알고리즘입니다.
- 서명 이유: 다른 사용자가 PDF 문서가 인증된 이유를 알 수 있도록 Acrobat 또는 Adobe Reader에 표시되는 값입니다.
- 서명자의 위치: 자격 증명에서 지정한 서명자의 위치입니다.
- 연락처 정보: 서명자의 주소 및 전화 번호 등 연락처 정보입니다.
- 권한 정보: 인증된 서명이 유효하지 않게 하지 않고 최종 사용자가 문서에서 수행할 수 있는 작업을 제어하는 권한입니다. 예를 들어 PDF 문서를 변경하면 인증된 서명이 유효하지 않게 되도록 권한을 설정할 수 있습니다.
- 법적 설명: 문서가 인증되면 문서의 내용이 모호하거나 오해의 소지가 있는 특정 유형의 컨텐트를 자동으로 스캔합니다. 예를 들어, 주석에서는 인증되는 텍스트를 이해하는 데 중요한 페이지의 일부 텍스트를 구분할 수 있습니다. 검색 프로세스는 이러한 유형의 컨텐츠에 대한 경고를 생성합니다. 이 값은 경고를 생성한 컨텐츠에 대한 추가 설명을 제공합니다.
- 모양 옵션: 인증된 서명의 모양을 제어하는 옵션입니다. 예를 들어, 인증된 서명은 날짜 정보를 표시할 수 있습니다.
- 해지 확인: 이 값은 서명자의 인증서에 대해 해지 검사가 수행되는지 여부를 지정합니다. 기본 설정인
false
해지 확인이 완료되지 않았음을 의미합니다. - OCSP 설정: PDF 문서를 인증하는 데 사용되는 자격 증명의 상태에 대한 정보를 제공하는 OCSP(온라인 인증서 상태 프로토콜) 지원 설정 예를 들어 PDF 문서에 로그온하는 데 사용하는 자격 증명에 대한 정보를 제공하는 서버의 URL을 지정할 수 있습니다.
- CRL 설정: 해지 검사가 수행된 경우 CRL(인증서 해지 목록) 기본 설정에 대한 설정입니다. 예를 들어 자격 증명이 취소되었는지 항상 확인하도록 지정할 수 있습니다.
- 타임스탬프: 인증된 서명에 적용되는 타임스탬프 정보를 정의하는 설정입니다. 타임스탬프는 특정 시간 이전에 특정 데이터가 설정되었음을 나타냅니다. 이 지식은 서명자와 확인자 간의 신뢰 관계를 구축하는 데 도움이 됩니다.
인증된 PDF 문서를 PDF 파일로 저장
서명 서비스는 PDF 문서를 인증한 후 사용자가 Acrobat 또는 Adobe Reader에서 열 수 있도록 PDF 파일로 저장할 수 있습니다.
추가 참조
Java API를 사용하여 PDF 문서 인증 certify-pdf-documents-using-the-java-api
서명 API(Java)를 사용하여 PDF 문서를 인증합니다.
-
프로젝트 파일 포함
Java 프로젝트의 클래스 경로에 adobe-signatures-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
-
서명 클라이언트 만들기
- 만들기
ServiceClientFactory
연결 속성을 포함하는 객체입니다. - 만들기
SignatureServiceClient
생성자를 사용하여 객체를 전달하고ServiceClientFactory
개체.
- 만들기
-
인증을 위해 PDF 문서 받기
- 만들기
java.io.FileInputStream
생성자를 사용하고 PDF 문서의 위치를 지정하는 문자열 값을 전달하여 인증할 PDF 문서를 나타내는 개체입니다. - 만들기
com.adobe.idp.Document
생성자를 사용하여 객체를 전달하고java.io.FileInputStream
개체.
- 만들기
-
PDF 문서 인증
를 호출하여 PDF 문서를 인증합니다
SignatureServiceClient
개체certify
메서드 및 다음 값 전달:- 다음
com.adobe.idp.Document
인증할 PDF 문서를 나타내는 개체입니다. - 서명이 포함될 서명 필드의 이름을 나타내는 문자열 값입니다.
- A
Credential
PDF 문서를 인증하는 데 사용되는 자격 증명을 나타내는 개체입니다. 만들기Credential
객체를 호출하여Credential
개체의 정적getInstance
보안 자격 증명에 해당하는 별칭 값을 지정하는 문자열 값 전달 및 메서드 - A
HashAlgorithm
PDF 문서 다이제스트에 사용되는 해시 알고리즘을 나타내는 정적 데이터 멤버를 지정하는 개체입니다. 예를 들어HashAlgorithm.SHA1
SHA1 알고리즘을 사용하려면 다음을 수행하십시오. - PDF 문서가 인증된 이유를 나타내는 문자열 값입니다.
- 서명자의 연락처 정보를 나타내는 문자열 값입니다.
- A
MDPPermissions
서명을 무효화하는 PDF 문서에서 수행할 수 있는 작업을 지정하는 개체입니다. - A
PDFSignatureAppearanceOptions
인증된 서명의 모양을 제어하는 개체입니다. 원하는 경우 다음과 같은 메서드를 호출하여 서명의 모양을 수정합니다setShowDate
. - 서명을 무효화하는 작업에 대한 설명을 제공하는 문자열 값입니다.
- A
java.lang.Boolean
서명자 인증서에 대한 해지 확인을 수행할지 여부를 지정하는 개체입니다. 이 해지 확인이 완료되면 서명에 포함됩니다. 기본값은false
입니다. - A
java.lang.Boolean
인증할 서명 필드가 잠겨 있는지 여부를 지정하는 개체입니다. 필드가 잠겨 있으면 서명 필드가 읽기 전용으로 표시되고 해당 속성을 수정할 수 없으며 필요한 권한이 없는 사람은 이 필드를 지울 수 없습니다. 기본값은false
입니다. - An
OCSPPreferences
OCSP(온라인 인증서 상태 프로토콜) 지원에 대한 환경 설정을 저장하는 개체입니다. 해지 검사가 수행되지 않으면 이 매개 변수가 사용되지 않으며 다음을 지정할 수 있습니다null
. 이 객체에 대한 자세한 내용은 AEM Forms API 참조. - A
CRLPreferences
CRL(인증서 해지 목록) 환경설정을 저장하는 객체입니다. 해지 검사가 수행되지 않으면 이 매개 변수가 사용되지 않으며 다음을 지정할 수 있습니다null
. - A
TSPPreferences
TSP(타임스탬프 제공자) 지원에 대한 환경 설정을 저장하는 개체입니다. 예를 들어TSPPreferences
개체를 호출하면 TSP 서버의 URL을 설정할 수 있습니다TSPPreferences
개체setTspServerURL
메서드를 사용합니다. 이 매개 변수는 선택 사항이며 다음 작업을 수행할 수 있습니다null
. 자세한 내용은 AEM Forms에 대한 서비스 참조.
다음
certify
메서드 반환com.adobe.idp.Document
인증된 PDF 문서를 나타내는 개체입니다. - 다음
-
인증된 PDF 문서를 PDF 파일로 저장
- 만들기
java.io.File
개체 및 파일 확장명이 .pdf인지 확인합니다. - 를 호출합니다
com.adobe.idp.Document
개체copyToFile
컨텐츠의 내용 복사 방법com.adobe.idp.Document
개체를 파일로 가져올 수 있습니다.
- 만들기
추가 참조
빠른 시작(SOAP 모드): Java API를 사용하여 PDF 문서 인증
웹 서비스 API를 사용하여 PDF 문서 인증 certify-pdf-documents-using-the-web-service-api
서명 API(웹 서비스)를 사용하여 PDF 문서를 인증합니다.
-
프로젝트 파일 포함
MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다.
http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1
.note note NOTE 바꾸기 localhost
(AEM Forms을 호스팅하는 서버의 IP 주소 사용) -
서명 클라이언트 만들기
-
만들기
SignatureServiceClient
기본 생성자를 사용하여 개체를 만듭니다. -
만들기
SignatureServiceClient.Endpoint.Address
개체를System.ServiceModel.EndpointAddress
생성자입니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예:http://localhost:8080/soap/services/SignatureService?WSDL
). 를 사용할 필요가 없습니다lc_version
속성을 사용합니다. 이 속성은 서비스 참조를 생성할 때 사용됩니다.) -
만들기
System.ServiceModel.BasicHttpBinding
개체의 값을 가져와서SignatureServiceClient.Endpoint.Binding
필드. 반환 값을 다음으로 캐스팅합니다.BasicHttpBinding
. -
설정
System.ServiceModel.BasicHttpBinding
개체MessageEncoding
필드 대상WSMessageEncoding.Mtom
. 이 값은 MTOM이 사용되도록 합니다. -
다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
- 필드에 AEM Forms 사용자 이름을 지정합니다
SignatureServiceClient.ClientCredentials.UserName.UserName
. - 필드에 해당 암호 값을 지정합니다
SignatureServiceClient.ClientCredentials.UserName.Password
. - 상수 값 할당
HttpClientCredentialType.Basic
아래와 같이 변경하는 것을 의미합니다BasicHttpBindingSecurity.Transport.ClientCredentialType
. - 상수 값 할당
BasicHttpSecurityMode.TransportCredentialOnly
아래와 같이 변경하는 것을 의미합니다BasicHttpBindingSecurity.Security.Mode
.
- 필드에 AEM Forms 사용자 이름을 지정합니다
-
-
인증을 위해 PDF 문서 받기
- 만들기
BLOB
생성자를 사용하여 개체를 작성합니다. 다음BLOB
객체는 인증된 PDF 문서를 저장하는 데 사용됩니다. - 만들기
System.IO.FileStream
개체의 생성자를 호출하고 인증할 PDF 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달하여 개체를 만듭니다. - 의 내용을 저장하는 바이트 배열을 만듭니다
System.IO.FileStream
개체. 를 가져와서 바이트 배열의 크기를 결정할 수 있습니다System.IO.FileStream
개체Length
속성을 사용합니다. - 를 호출하여 바이트 배열을 스트림 데이터로 채웁니다
System.IO.FileStream
개체Read
바이트 배열, 시작 위치 및 읽을 스트림 길이를 전달하는 메서드와 전달 - 을(를) 채우기
BLOB
개체를 할당하여 개체를 개체 개체MTOM
데이터 멤버에는 바이트 배열의 내용이 포함됩니다.
- 만들기
-
PDF 문서 인증
를 호출하여 PDF 문서를 인증합니다
SignatureServiceClient
개체certify
메서드 및 다음 값 전달:- 다음
BLOB
인증할 PDF 문서를 나타내는 개체입니다. - 서명이 포함될 서명 필드의 이름을 나타내는 문자열 값입니다.
- A
Credential
PDF 문서를 인증하는 데 사용되는 자격 증명을 나타내는 개체입니다. 만들기Credential
생성자를 사용하여 객체를 지정하고 값을Credential
개체alias
속성을 사용합니다. - A
HashAlgorithm
PDF 문서 다이제스트에 사용되는 해시 알고리즘을 나타내는 정적 데이터 멤버를 지정하는 개체입니다. 예를 들어HashAlgorithm.SHA1
SHA1 알고리즘을 사용하려면 다음을 수행하십시오. - 해시 알고리즘이 사용되는지 여부를 지정하는 부울 값입니다.
- PDF 문서가 인증된 이유를 나타내는 문자열 값입니다.
- 서명자의 위치를 나타내는 문자열 값입니다.
- 서명자의 연락처 정보를 나타내는 문자열 값입니다.
- An
MDPPermissions
서명을 무효화하는 PDF 문서에서 수행할 수 있는 작업을 지정하는 개체의 정적 데이터 멤버입니다. - 를 사용할지 여부를 지정하는 부울 값
MDPPermissions
이전 매개 변수 값으로 전달된 개체입니다. - 서명을 무효화하는 작업을 설명하는 문자열 값입니다.
- A
PDFSignatureAppearanceOptions
인증된 서명의 모양을 제어하는 개체입니다. 만들기PDFSignatureAppearanceOptions
생성자를 사용하여 개체를 작성합니다. 해당 데이터 멤버 중 하나를 설정하여 서명의 모양을 수정할 수 있습니다. - A
System.Boolean
서명자 인증서에 대한 해지 확인을 수행할지 여부를 지정하는 개체입니다. 이 해지 확인이 완료되면 서명에 포함됩니다. 기본값은false
입니다. - A
System.Boolean
인증할 서명 필드가 잠겨 있는지 여부를 지정하는 개체입니다. 필드가 잠겨 있으면 서명 필드가 읽기 전용으로 표시되고 해당 속성을 수정할 수 없으며 필요한 권한이 없는 사람은 이 필드를 지울 수 없습니다. 기본값은false
입니다. - A
System.Boolean
서명 필드가 잠겨 있는지 여부를 지정하는 개체입니다. 그건, 만약 당신이true
이전 매개 변수로 이동한 다음true
추가 - An
OCSPPreferences
PDF 문서를 인증하는 데 사용되는 자격 증명의 상태에 대한 정보를 제공하는 OCSP(온라인 인증서 상태 프로토콜) 지원에 대한 환경 설정을 저장하는 객체입니다. 해지 검사가 수행되지 않으면 이 매개 변수가 사용되지 않으며 다음을 지정할 수 있습니다null
. - A
CRLPreferences
CRL(인증서 해지 목록) 환경설정을 저장하는 객체입니다. 해지 검사가 수행되지 않으면 이 매개 변수가 사용되지 않으며 다음을 지정할 수 있습니다null
. - A
TSPPreferences
TSP(타임스탬프 제공자) 지원에 대한 환경 설정을 저장하는 개체입니다. 예를 들어TSPPreferences
개체를 만들 때 TSP의 URL을TSPPreferences
개체tspServerURL
데이터 멤버. 이 매개 변수는 선택 사항이며 다음 작업을 수행할 수 있습니다null
.
다음
certify
메서드 반환BLOB
인증된 PDF 문서를 나타내는 개체입니다. - 다음
-
인증된 PDF 문서를 PDF 파일로 저장
- 만들기
System.IO.FileStream
개체의 생성자를 호출하고 인증된 PDF 문서를 포함할 PDF 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달하여 개체를 엽니다. - 의 내용을 저장하는 바이트 배열을 만듭니다
BLOB
반환되는 개체certify
메서드를 사용합니다. 의 값을 가져와서 바이트 배열을 채웁니다BLOB
개체binaryData
데이터 멤버. - 만들기
System.IO.BinaryWriter
생성자를 호출하고 전달하여 개체를System.IO.FileStream
개체. - 를 호출하여 PDF 파일에 바이트 배열의 내용을 씁니다.
System.IO.BinaryWriter
개체Write
메서드를 사용하여 바이트 배열을 전달합니다.
- 만들기
추가 참조
디지털 서명 확인 verifying-digital-signatures
디지털 서명을 확인하여 서명된 PDF 문서가 수정되지 않았으며 디지털 서명이 유효한지 확인할 수 있습니다. 디지털 서명을 확인할 때 서명의 상태와 서명자의 ID와 같은 서명의 속성을 확인할 수 있습니다. 디지털 서명을 신뢰하기 전에 확인하는 것이 좋습니다. 디지털 서명을 확인할 때 디지털 서명이 포함된 PDF 문서를 참조합니다.
서명자의 ID를 알 수 없다고 가정합니다. Acrobat에서 PDF 문서를 열면 다음 그림과 같이 서명자의 ID를 알 수 없다고 경고 메시지가 표시됩니다.
마찬가지로, 디지털 서명을 프로그래밍 방식으로 확인할 때 서명자의 ID 상태를 확인할 수 있습니다. 예를 들어 이전 그림에 표시된 문서에서 디지털 서명을 확인하면 서명자의 ID를 알 수 없게 됩니다.
단계 요약 summary_of_steps-6
디지털 서명을 확인하려면 다음 작업을 수행합니다.
- 프로젝트 파일을 포함합니다.
- 서명 클라이언트를 만듭니다.
- 확인할 서명이 포함된 PDF 문서를 가져옵니다.
- PKI 런타임 옵션을 설정합니다.
- 디지털 서명을 확인합니다.
- 서명의 상태를 확인합니다.
- 서명자의 ID를 확인합니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함하십시오. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함하십시오. 웹 서비스를 사용하는 경우 프록시 파일을 포함하십시오.
다음 JAR 파일을 프로젝트의 클래스 경로에 추가해야 합니다.
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-signatures-client.jar
- adobe-utilities.jar(AEM Forms이 JBoss에 배포된 경우 필수)
- jbossall-client.jar(AEM Forms이 JBoss에 배포되는 경우 필요)
이러한 JAR 파일의 위치에 대한 자세한 내용은 AEM Forms Java 라이브러리 파일 포함.
서명 클라이언트 만들기
서명 서비스 작업을 프로그래밍 방식으로 수행하기 전에 서명 서비스 클라이언트를 만듭니다.
확인할 서명이 포함된 PDF 문서를 가져옵니다
PDF 문서에 디지털 서명하거나 인증하는 데 사용되는 서명을 확인하려면 서명이 포함된 PDF 문서를 얻습니다.
PKI 런타임 옵션 설정
PDF 문서에서 서명을 확인할 때 서명 서비스에서 사용하는 이러한 PKI 런타임 옵션을 설정합니다.
- 확인 시간
- 해지 확인
- 시간 스탬핑 값
이러한 옵션을 설정할 때 확인 시간을 지정할 수 있습니다. 예를 들어 현재 시간을 사용함을 나타내는 현재 시간(유효성 검사기의 컴퓨터 시간)을 선택할 수 있습니다. 다른 시간 값에 대한 자세한 내용은 VerificationTime
열거형 값 AEM Forms API 참조.
확인 프로세스의 일부로 해지 확인을 수행할지 여부를 지정할 수도 있습니다. 예를 들어 해지 검사를 수행하여 인증서가 해지되었는지 확인할 수 있습니다. 해지 확인 옵션에 대한 자세한 내용은 RevocationCheckStyle
열거형 값 AEM Forms API 참조.
인증서에 대해 해지 검사를 수행하려면 다음을 사용하여 CRL(인증서 해지 목록) 서버의 URL을 지정합니다 CRLOptionSpec
개체. 그러나 CRL 서버에 대한 URL을 지정하지 않으면 서명 서비스는 인증서에서 URL을 가져옵니다.
CRL 서버를 사용하는 대신 해지 확인을 수행할 때 OCSP(온라인 인증서 상태 프로토콜) 서버를 사용할 수 있습니다. 일반적으로 CRL 서버와 반대로 OCSP 서버를 사용하는 경우 해지 확인이 더 빨리 수행됩니다. (자세한 내용은 온라인 인증서 상태 프로토콜)
Adobe 응용 프로그램 및 서비스를 사용하여 서명 서비스에서 사용하는 CRL 및 OCSP 서버 순서를 설정할 수 있습니다. 예를 들어, OCSP 서버가 Adobe 응용 프로그램 및 서비스에서 먼저 설정된 경우 OCSP 서버가 선택된 후 CRL 서버가 실행됩니다.
해지 확인을 수행하지 않으면 서명 서비스에서 인증서가 해지되었는지 확인하지 않습니다. 즉, CRL 및 OCSP 서버 정보는 무시됩니다.
CRLOptionSpec
그리고 OCSPOptionSpec
개체. 예를 들어 CRL 서버를 재정의하려면 CRLOptionSpec
개체 setLocalURI
메서드를 사용합니다.타임스탬프는 서명 또는 인증된 문서가 수정된 시간을 추적하는 프로세스입니다. 문서가 서명된 후에는 아무도 수정할 수 없습니다. 서명 또는 인증된 문서의 유효성을 검사하는 데 도움이 됩니다. 를 사용하여 타임스탬프 옵션을 설정할 수 있습니다 TSPOptionSpec
개체. 예를 들어 TSP(Time Staming Provider) 서버의 URL을 지정할 수 있습니다.
VerificationTime.CURRENT_TIME
및 해지 확인이 RevocationCheckStyle.BestEffort
. CRL 또는 OCSP 서버 정보를 지정하지 않았으므로 인증서에서 서버 정보를 가져옵니다.디지털 서명 확인
서명을 확인하려면 서명을 포함하는 서명 필드의 정규화된 이름(예: )을 지정하십시오 form1[0].#subform[1].SignatureField3[3]
. XFA 양식 필드를 사용할 때 서명 필드의 부분 이름 을 사용할 수도 있습니다. SignatureField3
.
기본적으로 서명 서비스는 유효성 검사 시간 이후에 문서를 서명할 수 있는 시간을 65분으로 제한합니다. 사용자가 현재 시간에 서명을 확인하려고 하는데 서명 시간이 현재 시간보다 늦고 65분 이내인 경우 서명 서비스는 확인 오류를 생성하지 않습니다.
서명의 상태 확인
디지털 서명 확인의 일부로 서명의 상태를 확인할 수 있습니다.
서명자의 ID 확인
다음 값 중 하나일 수 있는 서명자의 ID를 확인할 수 있습니다.
- 알 수 없음: 서명자 확인을 수행할 수 없으므로 이 서명자를 알 수 없습니다.
- 신뢰할 수 있음: 이 서명자는 신뢰할 수 있습니다.
- 신뢰할 수 없음: 이 서명자는 신뢰할 수 없습니다.
추가 참조
Java API를 사용하여 디지털 서명 확인 verify-digital-signatures-using-the-java-api
서명 서비스 API(Java)를 사용하여 디지털 서명을 확인합니다.
-
프로젝트 파일 포함
Java 프로젝트의 클래스 경로에 adobe-signatures-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
-
- 만들기
ServiceClientFactory
연결 속성을 포함하는 객체입니다. - 만들기
SignatureServiceClient
생성자를 사용하여 객체를 전달하고ServiceClientFactory
개체.
- 만들기
-
확인할 서명이 포함된 PDF 문서를 가져옵니다
- 만들기
java.io.FileInputStream
생성자를 사용하여 확인할 서명이 포함된 PDF 문서를 나타내는 개체입니다. PDF 문서의 위치를 지정하는 문자열 값을 전달합니다. - 만들기
com.adobe.idp.Document
생성자를 사용하여 객체를 전달하고java.io.FileInputStream
개체.
- 만들기
-
PKI 런타임 옵션 설정
- 만들기
PKIOptions
생성자를 사용하여 개체를 작성합니다. - 을 호출하여 확인 시간을 설정합니다
PKIOptions
개체setVerificationTime
메서드 및 전달VerificationTime
확인 시간을 지정하는 열거형 값입니다. - 을 호출하여 해지 확인 옵션을 설정합니다
PKIOptions
개체setRevocationCheckStyle
메서드 및 전달RevocationCheckStyle
해지 확인을 수행할지 여부를 지정하는 열거형 값입니다.
- 만들기
-
디지털 서명 확인
를 호출하여 서명을 확인합니다
SignatureServiceClient
개체verify2
메서드 및 다음 값 전달:- A
com.adobe.idp.Document
디지털 서명 또는 인증된 PDF 문서가 포함된 객체입니다. - 확인할 서명이 포함된 서명 필드 이름을 나타내는 문자열 값입니다.
- A
PKIOptions
PKI 런타임 옵션이 포함된 객체입니다. - A
VerifySPIOptions
SPI 정보가 포함된 인스턴스입니다. 다음을 지정할 수 있습니다null
참조하십시오.
다음
verify2
메서드 반환PDFSignatureVerificationInfo
디지털 서명을 확인하는 데 사용할 수 있는 정보가 들어 있는 개체입니다. - A
-
서명의 상태 확인
- 를 호출하여 서명의 상태를 확인합니다
PDFSignatureVerificationInfo
개체getStatus
메서드를 사용합니다. 이 메서드는SignatureStatus
서명 상태를 지정하는 개체입니다. 예를 들어 서명된 PDF 문서가 수정되지 않은 경우 이 메서드는 를 반환합니다SignatureStatus.DocumentSigNoChanges
.
- 를 호출하여 서명의 상태를 확인합니다
-
서명자의 ID 확인
- 를 호출하여 서명자의 ID를 확인합니다
PDFSignatureVerificationInfo
개체getSigner
메서드를 사용합니다. 이 메서드는IdentityInformation
개체. - 를 호출합니다
IdentityInformation
개체getStatus
서명자의 ID를 확인하는 방법입니다. 이 메서드는IdentityStatus
id를 지정하는 열거형 값입니다. 예를 들어 서명자를 신뢰할 수 있으면 이 메서드는 를 반환합니다IdentityStatus.TRUSTED
.
- 를 호출하여 서명자의 ID를 확인합니다
추가 참조
빠른 시작(SOAP 모드): Java API를 사용하여 디지털 서명 확인
웹 서비스 API를 사용하여 디지털 서명 확인 verify-digital-signatures-using-the-web-service-api
서명 서비스 API(웹 서비스)를 사용하여 디지털 서명을 확인합니다.
-
프로젝트 파일 포함
MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다.
http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1
.note note NOTE 바꾸기 localhost
(AEM Forms을 호스팅하는 서버의 IP 주소 사용) -
서명 클라이언트 만들기
-
만들기
SignatureServiceClient
기본 생성자를 사용하여 개체를 만듭니다. -
만들기
SignatureServiceClient.Endpoint.Address
개체를System.ServiceModel.EndpointAddress
생성자입니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예:http://localhost:8080/soap/services/SignatureService?WSDL
). 를 사용할 필요가 없습니다lc_version
속성을 사용합니다. 이 속성은 서비스 참조를 생성할 때 사용됩니다.) -
만들기
System.ServiceModel.BasicHttpBinding
개체의 값을 가져와서SignatureServiceClient.Endpoint.Binding
필드. 반환 값을 다음으로 캐스팅합니다.BasicHttpBinding
. -
설정
System.ServiceModel.BasicHttpBinding
개체MessageEncoding
필드 대상WSMessageEncoding.Mtom
. 이 값은 MTOM이 사용되도록 합니다. -
다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
- 필드에 AEM Forms 사용자 이름을 지정합니다
SignatureServiceClient.ClientCredentials.UserName.UserName
. - 필드에 해당 암호 값을 지정합니다
SignatureServiceClient.ClientCredentials.UserName.Password
. - 상수 값 할당
HttpClientCredentialType.Basic
아래와 같이 변경하는 것을 의미합니다BasicHttpBindingSecurity.Transport.ClientCredentialType
. - 상수 값 할당
BasicHttpSecurityMode.TransportCredentialOnly
아래와 같이 변경하는 것을 의미합니다BasicHttpBindingSecurity.Security.Mode
.
- 필드에 AEM Forms 사용자 이름을 지정합니다
-
-
확인할 서명이 포함된 PDF 문서를 가져옵니다
- 만들기
BLOB
생성자를 사용하여 개체를 작성합니다. 다음BLOB
객체는 확인할 디지털 또는 인증된 서명이 포함된 PDF 문서를 저장하는 데 사용됩니다. - 만들기
System.IO.FileStream
개체를 생성자로 호출하여 개체를 가져옵니다. 서명된 PDF 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달합니다. - 의 내용을 저장하는 바이트 배열을 만듭니다
System.IO.FileStream
개체. 를 가져와서 바이트 배열의 크기를 결정할 수 있습니다System.IO.FileStream
개체Length
속성을 사용합니다. - 를 호출하여 바이트 배열을 스트림 데이터로 채웁니다
System.IO.FileStream
개체Read
메서드를 사용합니다. 읽을 바이트 배열, 시작 위치 및 스트림 길이를 전달합니다. - 을(를) 채우기
BLOB
개체를 할당하여 개체를 개체 개체MTOM
속성은 바이트 배열의 내용을 나타냅니다.
- 만들기
-
PKI 런타임 옵션 설정
- 만들기
PKIOptions
생성자를 사용하여 개체를 작성합니다. - 을(를) 할당하여 확인 시간을 설정합니다.
PKIOptions
개체verificationTime
데이터 멤버VerificationTime
확인 시간을 지정하는 열거형 값입니다. - 해지 확인 옵션을 설정하려면
PKIOptions
개체revocationCheckStyle
데이터 멤버RevocationCheckStyle
해지 확인을 수행할지 여부를 지정하는 열거형 값입니다.
- 만들기
-
디지털 서명 확인
를 호출하여 서명을 확인합니다
SignatureServiceClient
개체verify2
메서드 및 다음 값 전달:- 다음
BLOB
디지털 서명 또는 인증된 PDF 문서가 포함된 객체입니다. - 확인할 서명이 포함된 서명 필드 이름을 나타내는 문자열 값입니다.
- A
PKIOptions
PKI 런타임 옵션이 포함된 객체입니다. - A
VerifySPIOptions
SPI 정보가 포함된 인스턴스입니다. 다음을 지정할 수 있습니다null
참조하십시오.
다음
verify2
메서드 반환PDFSignatureVerificationInfo
디지털 서명을 확인하는 데 사용할 수 있는 정보가 들어 있는 개체입니다. - 다음
-
서명의 상태 확인
의 값을 가져와서 서명의 상태를 확인합니다
PDFSignatureVerificationInfo
개체status
데이터 멤버. 이 데이터 멤버는SignatureStatus
시그니처의 상태를 지정하는 개체입니다. 예를 들어 서명된 PDF 문서가 수정되면status
데이터 멤버는 값을 저장합니다SignatureStatus.DocumentSigNoChanges
. -
서명자의 ID 확인
- 다음 값을 검색하여 서명자의 ID를 결정합니다
PDFSignatureVerificationInfo
개체signer
데이터 멤버. 이 멤버는IdentityInformation
개체. - 검색
IdentityInformation
개체status
서명자의 ID를 확인할 데이터 구성원입니다. 이 데이터 멤버는IdentityStatus
id를 지정하는 열거형 값입니다. 예를 들어, 서명자가 신뢰할 수 있으면 이 멤버는IdentityStatus.TRUSTED
.
- 다음 값을 검색하여 서명자의 ID를 결정합니다
추가 참조
여러 디지털 서명 확인 verifying-multiple-digital-signatures
AEM Forms은 PDF 문서에 있는 모든 디지털 서명을 확인하는 방법을 제공합니다. PDF 문서에 여러 서명자의 서명이 필요한 비즈니스 프로세스의 결과로 여러 디지털 서명이 포함되어 있다고 가정합니다. 예를 들어, 대출 담당자와 관리자의 서명을 모두 필요로 하는 금융 거래를 고려하십시오. 서명 서비스 Java API 또는 웹 서비스 API를 사용하여 PDF 문서 내에서 모든 서명을 확인할 수 있습니다. 여러 디지털 서명을 확인할 때 각 서명의 상태와 속성을 확인할 수 있습니다. 디지털 서명을 신뢰하기 전에 확인하는 것이 좋습니다. 단일 디지털 서명 확인에 익숙해지는 것이 좋습니다.
단계 요약 summary_of_steps-7
여러 디지털 서명을 확인하려면 다음 작업을 수행합니다.
- 프로젝트 파일을 포함합니다.
- 서명 클라이언트를 만듭니다.
- 확인할 서명이 포함된 PDF 문서를 가져옵니다.
- PKI 런타임 옵션을 설정합니다.
- 모든 디지털 서명을 검색합니다.
- 모든 서명을 반복합니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함하십시오. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함하십시오. 웹 서비스를 사용하는 경우 프록시 파일을 포함하십시오.
다음 JAR 파일을 프로젝트의 클래스 경로에 추가해야 합니다.
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-signatures-client.jar
- adobe-utilities.jar(AEM Forms이 JBoss에 배포된 경우 필수)
- jbossall-client.jar(AEM Forms이 JBoss에 배포되는 경우 필요)
이러한 JAR 파일의 위치에 대한 자세한 내용은 AEM Forms Java 라이브러리 파일 포함.
서명 클라이언트 만들기
서명 서비스 작업을 프로그래밍 방식으로 수행하기 전에 서명 서비스 클라이언트를 만듭니다.
확인할 서명이 포함된 PDF 문서를 가져옵니다.
PDF 문서에 디지털 서명하거나 인증하는 데 사용되는 서명을 확인하려면 서명이 포함된 PDF 문서를 얻습니다.
PKI 런타임 옵션 설정
PDF 문서에서 모든 서명을 확인할 때 서명 서비스에서 사용하는 이러한 PKI 런타임 옵션을 설정합니다.
- 확인 시간
- 해지 확인
- 시간 스탬핑 값
이러한 옵션을 설정할 때 확인 시간을 지정할 수 있습니다. 예를 들어 현재 시간을 사용함을 나타내는 현재 시간(유효성 검사기의 컴퓨터 시간)을 선택할 수 있습니다. 다른 시간 값에 대한 자세한 내용은 VerificationTime
열거형 값 AEM Forms API 참조.
확인 프로세스의 일부로 해지 확인을 수행할지 여부를 지정할 수도 있습니다. 예를 들어 해지 검사를 수행하여 인증서가 해지되었는지 확인할 수 있습니다. 해지 확인 옵션에 대한 자세한 내용은 RevocationCheckStyle
열거형 값 AEM Forms API 참조.
인증서에 대해 해지 검사를 수행하려면 다음을 사용하여 CRL(인증서 해지 목록) 서버의 URL을 지정합니다 CRLOptionSpec
개체. 그러나 CRL 서버에 대한 URL을 지정하지 않으면 서명 서비스는 인증서에서 URL을 가져옵니다.
CRL 서버를 사용하는 대신 해지 확인을 수행할 때 OCSP(온라인 인증서 상태 프로토콜) 서버를 사용할 수 있습니다. 일반적으로 CRL 서버 대신 OCSP 서버를 사용하는 경우 해지 확인이 더 빨리 수행됩니다. (자세한 내용은 온라인 인증서 상태 프로토콜)
Adobe 응용 프로그램 및 서비스를 사용하여 서명 서비스에서 사용하는 CRL 및 OCSP 서버 순서를 설정할 수 있습니다. 예를 들어 OCSP 서버가 Adobe 응용 프로그램 및 서비스에서 먼저 설정된 경우 OCSP 서버가 선택된 후 CRL 서버가 실행됩니다.
해지 확인을 수행하지 않으면 서명 서비스에서 인증서가 해지되었는지 확인하지 않습니다. 즉, CRL 및 OCSP 서버 정보는 무시됩니다.
CRLOptionSpec
그리고 OCSPOptionSpec
개체. 예를 들어 CRL 서버를 재정의하려면 CRLOptionSpec
개체 setLocalURI
메서드를 사용합니다.타임스탬프는 서명 또는 인증된 문서가 수정된 시간을 추적하는 프로세스입니다. 문서가 서명된 후에는 아무도 수정할 수 없습니다. 서명 또는 인증된 문서의 유효성을 검사하는 데 도움이 됩니다. 를 사용하여 타임스탬프 옵션을 설정할 수 있습니다 TSPOptionSpec
개체. 예를 들어 TSP(Time Staming Provider) 서버의 URL을 지정할 수 있습니다.
VerificationTime.CURRENT_TIME
및 해지 확인이 RevocationCheckStyle.BestEffort
. CRL 또는 OCSP 서버 정보를 지정하지 않았으므로 인증서에서 서버 정보를 가져옵니다.모든 디지털 서명 검색
PDF 문서에 있는 모든 디지털 서명을 확인하려면 PDF 문서에서 디지털 서명을 검색합니다. 모든 서명이 목록에 반환됩니다. 디지털 서명을 확인하는 과정의 일부로 서명의 상태를 확인합니다.
모든 서명 반복
각 서명을 반복합니다. 즉, 각 서명에 대해 디지털 서명을 확인하고 서명자의 신분과 각 서명의 상태를 확인합니다. (자세한 내용은 디지털 서명 확인)
추가 참조
Java API를 사용하여 여러 디지털 서명 확인 verify-multiple-digital-signatures-using-the-java-api
서명 서비스 API(Java)를 사용하여 여러 디지털 서명을 확인합니다.
-
프로젝트 파일 포함
Java 프로젝트의 클래스 경로에 adobe-signatures-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
-
서명 클라이언트 만들기
- 만들기
ServiceClientFactory
연결 속성을 포함하는 객체입니다. - 만들기
SignatureServiceClient
생성자를 사용하여 객체를 전달하고ServiceClientFactory
개체.
- 만들기
-
확인할 서명이 포함된 PDF 문서를 가져옵니다.
- 만들기
java.io.FileInputStream
생성자를 사용하여 확인할 여러 디지털 서명을 포함하는 PDF 문서를 나타내는 개체입니다. PDF 문서의 위치를 지정하는 문자열 값을 전달합니다. - 만들기
com.adobe.idp.Document
생성자를 사용하여 객체를 전달하고java.io.FileInputStream
개체.
- 만들기
-
PKI 런타임 옵션 설정
- 만들기
PKIOptions
생성자를 사용하여 개체를 작성합니다. - 을 호출하여 확인 시간을 설정합니다
PKIOptions
개체setVerificationTime
메서드 및 전달VerificationTime
확인 시간을 지정하는 열거형 값입니다. - 을 호출하여 해지 확인 옵션을 설정합니다
PKIOptions
개체setRevocationCheckStyle
메서드 및 전달RevocationCheckStyle
해지 확인을 수행할지 여부를 지정하는 열거형 값입니다.
- 만들기
-
모든 디지털 서명 검색
를 호출합니다
SignatureServiceClient
개체verifyPDFDocument
메서드를 사용하여 다음 값을 전달합니다.- A
com.adobe.idp.Document
여러 디지털 서명을 포함하는 PDF 문서를 포함하는 객체입니다. - A
PKIOptions
PKI 런타임 옵션이 포함된 객체입니다. - A
VerifySPIOptions
SPI 정보가 포함된 인스턴스입니다. 다음을 지정할 수 있습니다null
참조하십시오.
다음
verifyPDFDocument
메서드 반환PDFDocumentVerificationInfo
PDF 문서에 있는 모든 디지털 서명에 대한 정보를 포함하는 객체입니다. - A
-
모든 서명 반복
- 를 호출하여 모든 서명을 반복합니다
PDFDocumentVerificationInfo
개체getVerificationInfos
메서드를 사용합니다. 이 메서드는java.util.List
각 요소가 인 객체PDFSignatureVerificationInfo
개체. 다음 작업java.util.Iterator
서명 목록을 반복할 개체입니다. - 사용
PDFSignatureVerificationInfo
객체를 호출하면 서명의 상태 확인 등의 작업을 수행할 수 있습니다PDFSignatureVerificationInfo
개체getStatus
메서드를 사용합니다. 이 메서드는SignatureStatus
정적 데이터 멤버가 서명 상태에 대해 알리는 개체입니다. 예를 들어 서명을 알 수 없으면 이 메서드는 를 반환합니다SignatureStatus.DocumentSignatureUnknown
.
- 를 호출하여 모든 서명을 반복합니다
추가 참조
빠른 시작(SOAP 모드): Java API를 사용하여 여러 디지털 서명 확인
웹 서비스 API를 사용하여 여러 디지털 서명 확인 verifying-multiple-digital-signatures-using-the-web-service-api
서명 서비스 API(웹 서비스)를 사용하여 여러 디지털 서명을 확인합니다.
-
프로젝트 파일 포함
MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다.
http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1
.note note NOTE 바꾸기 localhost
(AEM Forms을 호스팅하는 서버의 IP 주소 사용) -
서명 클라이언트 만들기
-
만들기
SignatureServiceClient
기본 생성자를 사용하여 개체를 만듭니다. -
만들기
SignatureServiceClient.Endpoint.Address
개체를System.ServiceModel.EndpointAddress
생성자입니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예:http://localhost:8080/soap/services/SignatureService?WSDL
). 를 사용할 필요가 없습니다lc_version
속성을 사용합니다. 이 속성은 서비스 참조를 생성할 때 사용됩니다.) -
만들기
System.ServiceModel.BasicHttpBinding
개체의 값을 가져와서SignatureServiceClient.Endpoint.Binding
필드. 반환 값을 다음으로 캐스팅합니다.BasicHttpBinding
. -
설정
System.ServiceModel.BasicHttpBinding
개체MessageEncoding
필드 대상WSMessageEncoding.Mtom
. 이 값은 MTOM이 사용되도록 합니다. -
다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
- 필드에 AEM Forms 사용자 이름을 지정합니다
SignatureServiceClient.ClientCredentials.UserName.UserName
. - 필드에 해당 암호 값을 지정합니다
SignatureServiceClient.ClientCredentials.UserName.Password
. - 상수 값 할당
HttpClientCredentialType.Basic
아래와 같이 변경하는 것을 의미합니다BasicHttpBindingSecurity.Transport.ClientCredentialType
. - 상수 값 할당
BasicHttpSecurityMode.TransportCredentialOnly
아래와 같이 변경하는 것을 의미합니다BasicHttpBindingSecurity.Security.Mode
.
- 필드에 AEM Forms 사용자 이름을 지정합니다
-
-
확인할 서명이 포함된 PDF 문서를 가져옵니다.
- 만들기
BLOB
생성자를 사용하여 개체를 작성합니다. 다음BLOB
개체에는 확인할 여러 디지털 서명이 들어 있는 PDF 문서가 저장됩니다. - 만들기
System.IO.FileStream
개체를 생성자로 호출하여 개체를 가져옵니다. PDF 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달합니다. - 의 내용을 저장하는 바이트 배열을 만듭니다
System.IO.FileStream
개체. 를 가져와서 바이트 배열의 크기를 결정할 수 있습니다System.IO.FileStream
개체Length
속성을 사용합니다. - 를 호출하여 바이트 배열을 스트림 데이터로 채웁니다
System.IO.FileStream
개체Read
메서드를 사용합니다. 읽을 바이트 배열, 시작 위치 및 스트림 길이를 전달합니다. - 을(를) 채우기
BLOB
개체를 할당하여 개체를 개체 개체MTOM
속성은 바이트 배열의 내용을 나타냅니다.
- 만들기
-
PKI 런타임 옵션 설정
- 만들기
PKIOptions
생성자를 사용하여 개체를 작성합니다. - 을(를) 할당하여 확인 시간을 설정합니다.
PKIOptions
개체verificationTime
데이터 멤버VerificationTime
확인 시간을 지정하는 열거형 값입니다. - 해지 확인 옵션을 설정하려면
PKIOptions
개체revocationCheckStyle
데이터 멤버RevocationCheckStyle
해지 확인을 수행할지 여부를 지정하는 열거형 값입니다.
- 만들기
-
모든 디지털 서명 검색
를 호출합니다
SignatureServiceClient
개체verifyPDFDocument
메서드를 사용하여 다음 값을 전달합니다.- A
BLOB
여러 디지털 서명을 포함하는 PDF 문서를 포함하는 객체입니다. - A
PKIOptions
PKI 런타임 옵션이 포함된 객체입니다. - A
VerifySPIOptions
SPI 정보가 포함된 인스턴스입니다. 이 매개 변수에 대해 null을 지정할 수 있습니다.
다음
verifyPDFDocument
메서드 반환PDFDocumentVerificationInfo
PDF 문서에 있는 모든 디지털 서명에 대한 정보를 포함하는 객체입니다. - A
-
모든 서명 반복
- 를 받아서 모든 서명을 반복합니다
PDFDocumentVerificationInfo
개체verificationInfos
데이터 멤버. 이 데이터 멤버는Object
각 요소가 인 배열PDFSignatureVerificationInfo
개체. - 사용
PDFSignatureVerificationInfo
개체를 만들면,PDFSignatureVerificationInfo
개체status
데이터 멤버. 이 데이터 멤버는SignatureStatus
정적 데이터 멤버가 서명 상태에 대해 알리는 개체입니다. 예를 들어 서명을 알 수 없으면 이 메서드는 를 반환합니다SignatureStatus.DocumentSignatureUnknown
.
- 를 받아서 모든 서명을 반복합니다
추가 참조
디지털 서명 제거 removing-digital-signatures
새로운 디지털 서명을 적용하려면 먼저 서명 필드에서 디지털 서명을 제거해야 합니다. 디지털 서명을 덮어쓸 수 없습니다. 서명이 포함된 서명 필드에 디지털 서명을 적용하려고 하면 예외가 발생합니다.
단계 요약 summary_of_steps-8
서명 필드에서 디지털 서명을 제거하려면 다음 작업을 수행합니다.
- 프로젝트 파일을 포함합니다.
- 서명 클라이언트를 만듭니다.
- 제거할 서명이 포함된 PDF 문서를 가져옵니다.
- 서명 필드에서 디지털 서명을 제거합니다.
- PDF 문서를 PDF 파일로 저장합니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함합니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
다음 JAR 파일을 프로젝트의 클래스 경로에 추가해야 합니다.
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-signatures-client.jar
- adobe-utilities.jar(AEM Forms이 JBoss에 배포된 경우 필수)
- jbossall-client.jar(AEM Forms이 JBoss에 배포되는 경우 필요)
이러한 JAR 파일의 위치에 대한 자세한 내용은 AEM Forms Java 라이브러리 파일 포함.
서명 클라이언트 만들기
서명 서비스 작업을 프로그래밍 방식으로 수행하려면 먼저 서명 서비스 클라이언트를 만들어야 합니다.
제거할 서명이 포함된 PDF 문서 가져오기
PDF 문서에서 서명을 제거하려면 서명이 포함된 PDF 문서를 가져와야 합니다.
서명 필드에서 디지털 서명을 제거합니다
PDF 문서에서 디지털 서명을 성공적으로 제거하려면 디지털 서명이 포함된 서명 필드의 이름을 지정해야 합니다. 또한 디지털 서명을 제거할 수 있는 권한이 있어야 합니다. 그렇지 않으면 예외가 발생합니다.
PDF 문서를 PDF 파일로 저장
서명 서비스가 서명 필드에서 디지털 서명을 제거한 후 사용자가 Acrobat 또는 Adobe Reader에서 열 수 있도록 PDF 문서를 PDF 파일로 저장할 수 있습니다.
추가 참조
Java API를 사용하여 디지털 서명 제거 remove-digital-signatures-using-the-java-api
서명 API(Java)를 사용하여 디지털 서명을 제거합니다.
-
프로젝트 파일 포함
Java 프로젝트의 클래스 경로에 adobe-signatures-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
-
서명 클라이언트를 만듭니다.
- 만들기
ServiceClientFactory
연결 속성을 포함하는 객체입니다. - 만들기
SignatureServiceClient
생성자를 사용하여 객체를 전달하고ServiceClientFactory
개체.
- 만들기
-
제거할 서명이 포함된 PDF 문서 가져오기
- 만들기
java.io.FileInputStream
생성자를 사용하고 PDF 문서의 위치를 지정하는 문자열 값을 전달하여 제거할 서명이 포함된 PDF 문서를 나타내는 개체입니다. - 만들기
com.adobe.idp.Document
생성자를 사용하여 객체를 전달하고java.io.FileInputStream
개체.
- 만들기
-
서명 필드에서 디지털 서명을 제거합니다
를 호출하여 서명 필드에서 디지털 서명을 제거합니다
SignatureServiceClient
개체clearSignatureField
메서드 및 다음 값 전달:- A
com.adobe.idp.Document
제거할 서명이 포함된 PDF 문서를 나타내는 객체입니다. - 디지털 서명이 포함된 서명 필드의 이름을 지정하는 문자열 값입니다.
다음
clearSignatureField
메서드 반환com.adobe.idp.Document
디지털 서명이 제거된 PDF 문서를 나타내는 개체입니다. - A
-
PDF 문서를 PDF 파일로 저장
- 만들기
java.io.File
개체 및 파일 확장명이 .pdf인지 확인합니다. - 를 호출합니다
com.adobe.idp.Document
개체copyToFile
메서드를 사용합니다. 전달java.io.File
개체의 내용을 복사할 개체com.adobe.idp.Document
개체를 파일로 가져올 수 있습니다. 를 사용해야 합니다Document
반환되는 개체clearSignatureField
메서드를 사용합니다.
- 만들기
추가 참조
빠른 시작(SOAP 모드): Java API를 사용하여 디지털 서명 제거
웹 서비스 API를 사용하여 디지털 서명 제거 remove-digital-signatures-using-the-web-service-api
서명 API(웹 서비스)를 사용하여 디지털 서명을 제거합니다.
-
프로젝트 파일 포함
MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다.
http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1
.note note NOTE 바꾸기 localhost
(AEM Forms을 호스팅하는 서버의 IP 주소 사용) -
서명 클라이언트 만들기
-
만들기
SignatureServiceClient
기본 생성자를 사용하여 개체를 만듭니다. -
만들기
SignatureServiceClient.Endpoint.Address
개체를System.ServiceModel.EndpointAddress
생성자입니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예:http://localhost:8080/soap/services/SignatureService?WSDL
). 를 사용할 필요가 없습니다lc_version
속성을 사용합니다. 이 속성은 서비스 참조를 생성할 때 사용됩니다.) -
만들기
System.ServiceModel.BasicHttpBinding
개체의 값을 가져와서SignatureServiceClient.Endpoint.Binding
필드. 반환 값을 다음으로 캐스팅합니다.BasicHttpBinding
. -
설정
System.ServiceModel.BasicHttpBinding
개체MessageEncoding
필드 대상WSMessageEncoding.Mtom
. 이 값은 MTOM이 사용되도록 합니다. -
다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
- 필드에 AEM Forms 사용자 이름을 지정합니다
SignatureServiceClient.ClientCredentials.UserName.UserName
. - 필드에 해당 암호 값을 지정합니다
SignatureServiceClient.ClientCredentials.UserName.Password
. - 상수 값 할당
HttpClientCredentialType.Basic
아래와 같이 변경하는 것을 의미합니다BasicHttpBindingSecurity.Transport.ClientCredentialType
. - 상수 값 할당
BasicHttpSecurityMode.TransportCredentialOnly
아래와 같이 변경하는 것을 의미합니다BasicHttpBindingSecurity.Security.Mode
.
- 필드에 AEM Forms 사용자 이름을 지정합니다
-
-
제거할 서명이 포함된 PDF 문서 가져오기
- 만들기
BLOB
생성자를 사용하여 개체를 작성합니다. 다음BLOB
제거할 디지털 서명이 포함된 PDF 문서를 저장하는 데 사용됩니다. - 만들기
System.IO.FileStream
객체를 사용하여 생성자를 호출하고 서명된 PDF 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달합니다. - 의 내용을 저장하는 바이트 배열을 만듭니다
System.IO.FileStream
개체. 를 가져와서 바이트 배열의 크기를 결정할 수 있습니다System.IO.FileStream
개체Length
속성을 사용합니다. - 를 호출하여 바이트 배열을 스트림 데이터로 채웁니다
System.IO.FileStream
개체Read
메서드를 사용합니다. 읽을 바이트 배열, 시작 위치 및 스트림 길이를 전달합니다. - 을(를) 채우기
BLOB
개체를 할당하여 개체를 개체 개체MTOM
바이트 배열의 내용을 포함하는 속성입니다.
- 만들기
-
서명 필드에서 디지털 서명을 제거합니다
을 호출하여 디지털 서명을 제거합니다
SignatureServiceClient
개체clearSignatureField
메서드 및 다음 값 전달:- A
BLOB
서명된 PDF 문서를 포함하는 객체입니다. - 제거할 디지털 서명이 포함된 서명 필드의 이름을 나타내는 문자열 값입니다.
다음
clearSignatureField
메서드 반환BLOB
디지털 서명이 제거된 PDF 문서를 나타내는 개체입니다. - A
-
PDF 문서를 PDF 파일로 저장
- 만들기
System.IO.FileStream
개체의 생성자를 호출하고 빈 서명 필드 및 파일을 열 모드가 포함된 PDF 문서의 파일 위치를 나타내는 문자열 값을 전달하여 개체를 엽니다. - 의 내용을 저장하는 바이트 배열을 만듭니다
BLOB
반환되는 개체sign
메서드를 사용합니다. 의 값을 가져와서 바이트 배열을 채웁니다BLOB
개체MTOM
데이터 멤버. - 만들기
System.IO.BinaryWriter
생성자를 호출하고 전달하여 개체를System.IO.FileStream
개체. - 를 호출하여 PDF 파일에 바이트 배열의 내용을 씁니다.
System.IO.BinaryWriter
개체Write
메서드를 사용하여 바이트 배열을 전달합니다.
- 만들기
추가 참조