자격 증명을 사용한 작업

마지막 업데이트: 2024년 7월 15일
  • 적용 대상:
  • Experience Manager 6.5
  • 주제:

작성 대상:

  • 개발자

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

자격 증명 서비스 정보

자격 증명에는 문서에 서명하거나 문서를 식별하는 데 필요한 개인 키 정보가 포함되어 있습니다. 인증서는 신뢰를 위해 구성하는 공개 키 정보입니다. AEM Forms은 여러 가지 용도로 인증서 및 자격 증명을 사용합니다.

  • Acrobat Reader DC 확장은 자격 증명을 사용하여 PDF 문서에서 Adobe Reader 사용 권한을 활성화합니다. (PDF 문서에 사용 권한 적용을 참조하십시오.)
  • 서명 서비스는 PDF 문서에 디지털 서명하는 등의 작업을 수행하는 동안 인증서 및 자격 증명에 액세스합니다. (PDF 문서에 디지털 서명하기를 참조하십시오.)

Trust Manager Java API를 사용하여 자격 증명 서비스와 프로그래밍 방식으로 상호 작용할 수 있습니다. 다음 작업을 수행할 수 있습니다.

노트
관리 콘솔을 사용하여 인증서를 가져오고 삭제할 수도 있습니다. (관리 도움말을 참조하십시오.)

Trust Manager API를 사용하여 자격 증명 가져오기

Trust Manager API를 사용하여 프로그래밍 방식으로 AEM Forms에 자격 증명을 가져올 수 있습니다. 예를 들어 PDF 문서에 서명하는 데 사용되는 자격 증명을 가져올 수 있습니다. (PDF 문서에 디지털 서명하기를 참조하십시오.)

자격 증명을 가져올 때 자격 증명에 대한 별칭을 지정합니다. 별칭은 자격 증명이 필요한 Forms 작업을 수행하는 데 사용됩니다. 자격 증명을 가져온 후에는 다음 그림과 같이 관리 콘솔에서 자격 증명을 볼 수 있습니다. 자격 증명의 별칭은 보안 ​입니다.

ww_ww_truststore

노트
웹 서비스를 사용하여 AEM Forms에 자격 증명을 가져올 수 없습니다.

단계 요약

자격 증명을 AEM Forms으로 가져오려면 다음 단계를 수행하십시오.

  1. 프로젝트 파일을 포함합니다.
  2. 자격 증명 서비스 클라이언트를 만듭니다.
  3. 자격 증명을 참조합니다.
  4. 가져오기 작업을 수행합니다.

프로젝트 파일 포함

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

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

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

이러한 JAR 파일의 위치에 대한 자세한 내용은 AEM Forms Java 라이브러리 파일 포함을 참조하십시오.

자격 증명 서비스 클라이언트 만들기

자격 증명을 AEM Forms에 프로그래밍 방식으로 가져오기 전에 자격 증명 서비스 클라이언트를 만듭니다. 자세한 내용은 연결 속성 설정을 참조하십시오.

자격 증명 참조

AEM Forms에 가져올 자격 증명을 참조합니다. 이 섹션과 연결된 빠른 시작은 파일 시스템의 P12 파일을 참조합니다.

가져오기 작업 수행

자격 증명을 참조한 후 AEM Forms으로 자격 증명을 가져옵니다. 자격 증명을 성공적으로 가져오지 못하면 예외가 발생합니다. 자격 증명을 가져올 때 자격 증명에 대한 별칭을 지정합니다.

추가 참조

Java API를 사용하여 자격 증명 가져오기

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

연결 속성 설정

자격 증명 서비스 API 빠른 시작

Trust Manager API를 사용하여 자격 증명 삭제

Java API를 사용하여 자격 증명 가져오기

Trust Manager API(Java)를 사용하여 AEM Forms에 자격 증명을 가져옵니다.

  1. 프로젝트 파일 포함

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

  2. 자격 증명 서비스 클라이언트 만들기

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

  3. 자격 증명 참조

    • 해당 생성자를 사용하여 java.io.FileInputStream 개체를 만듭니다. 자격 증명의 위치를 지정하는 문자열 값을 전달합니다.
    • com.adobe.idp.Document 생성자를 사용하여 자격 증명을 저장하는 com.adobe.idp.Document 개체를 만듭니다. 자격 증명이 포함된 java.io.FileInputStream 개체를 생성자에 전달합니다.

  4. 가져오기 작업 수행

    • 요소 하나를 보유하는 문자열 배열을 만듭니다. truststore.usage.type.sign 값을 요소에 할당합니다.

    • CredentialServiceClient 개체의 importCredential 메서드를 호출하고 다음 값을 전달하십시오.

      • 자격 증명의 별칭 값을 지정하는 문자열 값입니다.
      • 자격 증명을 저장하는 com.adobe.idp.Document 인스턴스입니다.
      • 자격 증명과 연결된 암호를 지정하는 문자열 값입니다.
      • 사용 값을 포함하는 문자열 배열입니다. 예를 들어 이 값 truststore.usage.type.sign을(를) 지정할 수 있습니다. Reader 확장 자격 증명을 가져오려면 truststore.usage.type.lcre을(를) 지정하십시오.

추가 참조

Trust Manager API를 사용하여 자격 증명 가져오기

빠른 시작(SOAP 모드): Java API를 사용하여 자격 증명 가져오기

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

연결 속성 설정