Show Menu
화제×

정책으로 문서 보호

Document Security Service 정보
Document Security 서비스를 사용하면 사용자가 Adobe PDF 문서에 기밀 설정을 동적으로 적용하고 문서 배포 범위에 관계없이 문서를 제어할 수 있습니다.
Document Security 서비스는 사용자가 정책으로 보호된 PDF 문서를 받는 사람이 사용하는 방법을 제어할 수 있도록 함으로써 정보가 사용자의 범위를 넘어 퍼지는 것을 방지합니다. 사용자는 문서를 열 수 있는 사용자를 지정하고 문서 사용 방법을 제한하며 문서를 배포한 후 문서를 모니터링할 수 있습니다. 또한 사용자는 정책으로 보호된 문서에 대한 액세스를 동적으로 제어할 수 있으며 문서에 대한 액세스 권한을 동적으로 취소할 수도 있습니다.
또한 Document Security 서비스는 Microsoft Word 파일(DOC 파일)과 같은 다른 파일 유형을 보호합니다. Document Security Client API를 사용하여 이러한 파일 유형을 사용할 수 있습니다. 지원되는 버전은 다음과 같습니다.
  • Microsoft Office 2003 파일(DOC, XLS, PPT 파일)
  • Microsoft Office 2007 파일(DOCX, XLSX, PPTX 파일)
  • PTC Pro/E 파일
명확하게 설명하자면 다음 두 섹션에서는 Word 문서를 사용하는 방법에 대해 설명합니다.
Document Security 서비스를 사용하여 다음 작업을 수행할 수 있습니다.
Document Security 서비스에 대한 자세한 내용은 AEM Forms에 대한 서비스 참조를 참조하십시오 .

정책 만들기

Document Security Java API 또는 웹 서비스 API를 사용하여 프로그래밍 방식으로 정책을 만들 수 있습니다. 정책 ** 은 문서 보안 설정, 권한이 있는 사용자 및 사용 권한이 포함된 정보의 집합입니다. 다양한 상황과 사용자에 적합한 보안 설정을 사용하여 원하는 수의 정책을 만들고 저장할 수 있습니다.
정책을 사용하면 다음 작업을 수행할 수 있습니다.
  • 문서를 열 수 있는 개인을 지정합니다. 수신자는 조직에 속하거나 외부에 있을 수 있습니다.
  • 받는 사람이 문서를 사용할 수 있는 방법을 지정합니다. 다른 Acrobat 및 Adobe Reader 기능에 대한 액세스를 제한할 수 있습니다. 이러한 기능에는 텍스트 인쇄 및 복사, 서명 추가 및 문서에 주석 추가 기능이 포함됩니다.
  • 정책으로 보호된 문서를 배포한 후에도 언제든지 액세스 및 보안 설정을 변경할 수 있습니다.
  • 문서를 배포한 후 문서 사용을 모니터링합니다. 문서가 어떻게 사용되고 있으며 누가 문서를 사용하고 있는지 확인할 수 있습니다. 예를 들어 문서를 연 시간을 확인할 수 있습니다.

웹 서비스를 사용하여 정책 만들기

웹 서비스 API를 사용하여 정책을 만들 때는 정책을 설명하는 기존 PDRL(Portable Document Rights Language) XML 파일을 참조하십시오. 정책 권한 및 주체가 PDRL 문서에 정의됩니다. 다음 XML 문서는 PDRL 문서의 예입니다.
 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <Policy PolicyInstanceVersion="1" PolicyID="5DA3F847-DE76-F9CC-63EA-49A8D59154DE" PolicyCreationTime="2004-08-30T00:02:28.294+00:00" PolicyType="1" PolicySchemaVersion="1.0" PolicyName="SDK Test Policy -4344050357301573237" PolicyDescription="An SDK Test policy" xmlns="https://www.adobe.com/schema/1.0/pdrl">
       <PolicyEntry>
          <ns1:Permission PermissionName="com.adobe.aps.onlineOpen" Access="ALLOW" xmlns:ns1="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns2:Permission PermissionName="com.adobe.aps.offlineOpen" Access="ALLOW" xmlns:ns2="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns3:Permission PermissionName="com.adobe.aps.pdf.editNotes" Access="ALLOW" xmlns:ns3="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns4:Permission PermissionName="com.adobe.aps.pdf.fillAndSign" Access="ALLOW" xmlns:ns4="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
          <Principal PrincipalNameType="SYSTEM">
             <PrincipalDomain>EDC_SPECIAL</PrincipalDomain>
 
             <PrincipalName>all_internal_users</PrincipalName>
          </Principal>
       </PolicyEntry>
       <PolicyEntry>
          <ns5:Permission PermissionName="com.adobe.aps.onlineOpen" Access="ALLOW" xmlns:ns5="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns6:Permission PermissionName="com.adobe.aps.offlineOpen" Access="ALLOW" xmlns:ns6="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns7:Permission PermissionName="com.adobe.aps.pdf.copy" Access="ALLOW" xmlns:ns7="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns8:Permission PermissionName="com.adobe.aps.pdf.printLow" Access="ALLOW" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" xmlns:ns8="https://www.adobe.com/schema/1.0/pdrl" />
 
          <ns9:Permission PermissionName="com.adobe.aps.policySwitch" Access="ALLOW" xmlns:ns9="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns10:Permission PermissionName="com.adobe.aps.revoke" Access="ALLOW" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" xmlns:ns10="https://www.adobe.com/schema/1.0/pdrl" />
 
          <ns11:Permission PermissionName="com.adobe.aps.pdf.edit" Access="ALLOW" xmlns:ns11="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns12:Permission PermissionName="com.adobe.aps.pdf.editNotes" Access="ALLOW" xmlns:ns12="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns13:Permission PermissionName="com.adobe.aps.pdf.fillAndSign" Access="ALLOW" xmlns:ns13="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns14:Permission PermissionName="com.adobe.aps.pdf.printHigh" Access="ALLOW" xmlns:ns14="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <Principal PrincipalNameType="SYSTEM">
             <PrincipalDomain>EDC_SPECIAL</PrincipalDomain>
 
             <PrincipalName>publisher</PrincipalName>
          </Principal>
       </PolicyEntry>
 
       <OfflineLeasePeriod>
          <Duration>P31D</Duration>
       </OfflineLeasePeriod>
 
       <AuditSettings isTracked="true" />
 
       <PolicyValidityPeriod isAbsoluteTime="false">
          <ValidityPeriodRelative>
             <NotBeforeRelative>PT0S</NotBeforeRelative>
 
             <NotAfterRelative>P20D</NotAfterRelative>
          </ValidityPeriodRelative>
       </PolicyValidityPeriod>
 </Policy>
 

Document Security 서비스에 대한 자세한 내용은 AEM Forms에 대한 서비스 참조를 참조하십시오 .

단계 요약

정책을 만들려면 다음 단계를 수행하십시오.
  1. 프로젝트 파일 포함
  2. Document Security Client API 개체를 만듭니다.
  3. 정책의 속성을 설정합니다.
  4. 정책 항목을 만듭니다.
  5. 정책을 등록하십시오.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함할 수 있습니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
다음 JAR 파일을 프로젝트의 클래스 경로에 추가해야 합니다.
  • adobe-rightsmanagement-client.jar
  • namespace.jar(AEM Forms이 JBoss에 배포된 경우)
  • jaxb-api.jar(AEM Forms이 JBoss에 배포된 경우)
  • jaxb-impl.jar(AEM Forms이 JBoss에 배포된 경우)
  • jaxb-libs.jar(AEM Forms이 JBoss에 배포된 경우)
  • jaxb-xjc.jar(AEM Forms이 JBoss에 배포된 경우)
  • relaxngDatatype.jar(AEM Forms이 JBoss에 배포된 경우)
  • xsdlib.jar(AEM Forms이 JBoss에 배포된 경우)
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar
  • jbossall-client.jar(AEM Forms이 JBoss에 배포되지 않은 경우 다른 JAR 파일 사용)
이러한 JAR 파일의 위치에 대한 자세한 내용은 AEM Forms Java 라이브러리 파일 포함을 참조하십시오 .
Document Security Client API 개체 만들기
프로그래밍 방식으로 Document Security 서비스 작업을 수행하려면 먼저 Document Security 서비스 클라이언트 개체를 만듭니다.
정책 속성 설정
정책을 만들려면 정책 속성을 설정합니다. 필수 속성은 정책 이름입니다. 정책 이름은 각 정책 세트에 대해 고유해야 합니다. 정책 집합은 정책의 집합일 뿐이다. 정책이 별도의 정책 세트에 속해 있는 경우 동일한 이름의 두 정책이 있을 수 있습니다. 하지만 단일 정책 집합 내의 두 정책은 동일한 정책 이름을 가질 수 없습니다.
설정할 다른 유용한 속성은 유효 기간입니다. 유효 기간은 정책으로 보호된 문서를 권한이 있는 수신자가 액세스할 수 있는 기간입니다. 이 속성을 설정하지 않으면 정책은 항상 유효합니다.
유효 기간은 다음 옵션 중 하나로 설정할 수 있습니다.
  • 문서를 게시한 시점부터 문서에 액세스할 수 있는 기간(일)입니다.
  • 문서에 액세스할 수 없는 종료 날짜
  • 문서에 액세스할 수 있는 특정 날짜 범위
  • 항상 유효
시작 날짜만 지정하여 시작 날짜 이후에 정책이 유효하게 됩니다. 종료 날짜만 지정하면 종료 날짜까지 정책이 유효합니다. 하지만 시작 날짜와 종료 날짜가 모두 정의되지 않은 경우 예외가 발생합니다.
정책에 속하는 속성을 설정할 때 암호화 설정을 설정할 수도 있습니다. 이러한 암호화 설정은 정책이 문서에 적용될 때 적용됩니다. 다음 암호화 값을 지정할 수 있습니다.
  • AES256 : 256비트 키가 있는 AES 암호화 알고리즘을 나타냅니다.
  • AES128 : 128비트 키가 있는 AES 암호화 알고리즘을 나타냅니다.
  • 암호화 없음: 암호화 없음을 나타냅니다.
옵션을 지정할 때 NoEncryption 옵션을 로 설정할 수 PlaintextMetadata 없습니다 false . 그렇게 하려고 하면 예외가 발생합니다.
설정할 수 있는 기타 속성에 대한 자세한 내용은 AEM Forms API 참조 Policy 인터페이스 설명을 참조하십시오 .
정책 항목 만들기
정책 항목에서는 그룹 및 사용자인 주도자와 정책에 권한을 첨부합니다. 정책에 하나 이상의 정책 항목이 있어야 합니다. 예를 들어 다음 작업을 한다고 가정합니다.
  • 그룹이 온라인 상태에서만 문서를 보고 받는 사람이 문서를 복사하지 못하도록 하는 정책 항목을 만들고 등록합니다.
  • 정책 항목을 정책에 첨부합니다.
  • Acrobat을 사용하여 정책으로 문서 보호
이러한 작업을 수행하면 수신자는 문서를 온라인에서만 볼 수 있고 복사할 수 없습니다. 보안이 제거될 때까지 문서는 안전합니다.
정책 등록
새 정책을 사용하려면 먼저 등록해야 합니다. 정책을 등록한 후 해당 정책을 사용하여 문서를 보호할 수 있습니다.

Java API를 사용하여 정책 만들기

Document Security API(Java)를 사용하여 정책을 만듭니다.
  1. 프로젝트 파일 포함
    Java 프로젝트의 클래스 경로에 adobe-rightsmanagement-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
  2. Document Security Client API 개체를 만듭니다.
    • 연결 속성을 포함하는 ServiceClientFactory 개체를 만듭니다.
    • 생성자를 사용하여 개체를 DocumentSecurityClient 만들고 개체를 ServiceClientFactory 전달합니다.
  3. 정책의 속성을 설정합니다.
    • 개체의 정적 Policy 메서드를 호출하여 개체를 InfomodelObjectFactory 만듭니다 createPolicy . 이 메서드는 Policy 개체를 반환합니다.
    • 개체의 메서드를 호출하고 정책 이름을 지정하는 문자열 값을 전달하여 Policy 정책의 이름 setName 속성을 설정합니다.
    • 개체의 메서드를 호출하고 정책의 설명을 지정하는 문자열 값을 전달하여 Policy 정책 setDescription 설명을 설정합니다.
    • 개체의 메서드를 호출하고 정책 집합 이름을 지정하는 문자열 값을 전달하여 새 정책이 속하는 정책 집합 Policy setPolicySetName 을 설정합니다. (이 매개 변수 값 null 에 대해 지정하여 내 정책 정책 세트에 정책을 추가할 수 있습니다.)
    • 객체의 정적 방법을 호출하여 정책 유효성 기간을 InfomodelObjectFactory createValidityPeriod 만듭니다. 이 메서드는 ValidityPeriod 개체를 반환합니다.
    • 개체 메서드를 호출하고 일 수를 지정하는 정수 값을 전달하여 정책으로 보호된 문서에 액세스할 수 있는 일 수를 ValidityPeriod 설정합니다 setRelativeExpirationDays .
    • 개체의 메서드를 호출하고 개체를 전달하여 정책 유효성 기간을 Policy setValidityPeriod ValidityPeriod 설정합니다.
  4. 정책 항목을 만듭니다.
    • 개체의 정적 메서드를 호출하여 정책 항목 InfomodelObjectFactory createPolicyEntry 만듭니다. 이 메서드는 PolicyEntry 개체를 반환합니다.
    • 개체의 정적 메서드를 호출하여 정책 권한을 InfomodelObjectFactory createPermission 지정합니다. 권한을 나타내는 인터페이스에 속하는 정적 데이터 멤버를 Permission 전달합니다. 이 메서드는 Permission 개체를 반환합니다. 예를 들어 사용자가 정책으로 보호된 PDF 문서의 데이터를 복사할 수 있는 권한을 추가하려면 전달하십시오 Permission.COPY . 추가할 각 권한에 대해 이 단계를 반복합니다.
    • 개체의 메서드를 호출하고 개체를 전달하여 정책 항목에 권한을 PolicyEntry addPermission Permission 추가합니다. 생성한 각 Permission 객체에 대해 이 단계를 반복합니다.
    • 개체의 정적 메서드를 호출하여 정책 주체 InfomodelObjectFactory createSpecialPrincipal 만듭니다. 주체가 되는 InfomodelObjectFactory 개체에 속하는 데이터 멤버를 전달합니다. 이 메서드는 Principal 개체를 반환합니다. 예를 들어 문서의 게시자를 주체로 추가하려면 전달하십시오 InfomodelObjectFactory.PUBLISHER_PRINCIPAL .
    • 개체의 PolicyEntry 메서드를 호출하고 개체를 전달하여 정책 항목에 setPrincipal Principal 주체가 추가됩니다.
    • 개체의 메서드를 호출하고 개체를 전달하여 정책 항목을 정책에 Policy addPolicyEntry PolicyEntry 추가합니다.
  5. 정책을 등록하십시오.
    • 개체 PolicyManager 의 메서드를 호출하여 DocumentSecurityClient 개체를 getPolicyManager 만듭니다.
    • 개체의 메서드를 호출하고 다음 값을 전달하여 PolicyManager 정책을 registerPolicy 등록합니다.
      • 등록할 정책을 나타내는 Policy 개체입니다.
    • 정책이 속하는 정책 집합을 나타내는 문자열 값입니다.
    연결 설정 내에서 AEM Forms 관리자 계정을 사용하여 개체를 만드는 경우 DocumentSecurityClient 메서드를 호출할 때 정책 세트 이름을 registerPolicy 지정합니다. 정책 세트에 대한 null 값을 전달하면 해당 정책은 관리자 내 정책 정책 세트에 만들어집니다.
    연결 설정 내에서 Document Security 사용자를 사용하는 경우 해당 정책만 허용하는 오버로드된 registerPolicy 메서드를 호출할 수 있습니다. 즉, 정책 집합 이름을 지정할 필요가 없습니다. 하지만, 정책은 내 정책이라는 정책 세트에 추가됩니다 . 이 정책 세트에 새 정책을 추가하지 않으려면 메서드를 호출할 때 정책 집합 이름을 registerPolicy 지정합니다.
    정책을 만들 때 기존 정책 세트를 참조합니다. 존재하지 않는 정책 세트를 지정하면 예외가 발생합니다.
Document Security 서비스를 사용하는 코드 예제를 보려면 다음을 참조하십시오.
  • "빠른 시작(SOAP 모드): Java API를 사용하여 정책 만들기"

웹 서비스 API를 사용하여 정책 만들기

Document Security API(웹 서비스)를 사용하여 정책을 만듭니다.
  1. 프로젝트 파일 포함
    MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다. http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    AEM Forms localhost 를 호스팅하는 서버의 IP 주소로 대체합니다.
  2. Document Security Client API 개체를 만듭니다.
    • 기본 생성자를 사용하여 DocumentSecurityServiceClient 개체를 만듭니다.
    • 생성자를 사용하여 DocumentSecurityServiceClient.Endpoint.Address 개체를 System.ServiceModel.EndpointAddress 만듭니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예: http://localhost:8080/soap/services/RightsManagementService?WSDL .) 속성을 사용할 필요는 lc_version 없습니다. 이 속성은 서비스 참조를 만들 때 사용됩니다.)
    • 필드의 값을 System.ServiceModel.BasicHttpBinding 가져와 개체를 RightsManagementServiceClient.Endpoint.Binding 만듭니다. 반환 값을 다음으로 캐스팅합니다 BasicHttpBinding .
    • 개체 System.ServiceModel.BasicHttpBinding 필드를 (으)로 MessageEncoding 설정합니다 WSMessageEncoding.Mtom . 이 값을 사용하면 MTOM이 사용됩니다.
    • 다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
      • 필드에 AEM 양식 사용자 이름을 지정합니다 RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • 해당 암호 값을 필드에 지정합니다 RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • 필드에 상수 값 HttpClientCredentialType.Basic 을 지정합니다 BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • 필드에 상수 값 BasicHttpSecurityMode.TransportCredentialOnly 을 지정합니다 BasicHttpBindingSecurity.Security.Mode .
  3. 정책의 속성을 설정합니다.
    • 생성자를 사용하여 PolicySpec 개체를 만듭니다.
    • 개체의 데이터 멤버에 문자열 값을 할당하여 PolicySpec 정책의 이름을 name 설정합니다.
    • 개체의 데이터 멤버에 문자열 값을 할당하여 정책의 설명을 PolicySpec 설정합니다 description .
    • 객체의 데이터 멤버에 문자열 값을 할당하여 정책이 속할 정책 PolicySpec 세트를 policySetName 설정합니다. 기존 정책 집합 이름을 지정해야 합니다. (내 정책 null 에 정책이 추가되게 하는 이 매개 변수 값에 대해 지정할 수 있습니다 .)
    • 개체의 데이터 멤버에 정수 값을 할당하여 정책의 오프라인 임대 기간을 PolicySpec offlineLeasePeriod 설정합니다.
    • PDRL XML 데이터 PolicySpec 를 나타내는 문자열 값으로 개체의 policyXml 데이터 멤버를 설정합니다. 이 작업을 수행하려면 해당 생성자를 사용하여 .NET StreamReader 개체를 만듭니다. 정책을 나타내는 PDRL XML 파일의 위치를 생성자에 StreamReader 전달합니다. 그런 다음 StreamReader 개체의 ReadLine 메서드를 호출하고 반환 값을 문자열 변수에 지정합니다. 메서드가 null을 반환할 때까지 StreamReader 개체를 ReadLine 반복합니다. 문자열 변수를 PolicySpec 개체의 데이터 policyXml 멤버에 할당합니다.
  4. 정책 항목을 만듭니다.
    Document Security 웹 서비스 API를 사용하여 정책을 만들 때는 정책 항목을 만들 필요가 없습니다. 정책 항목은 PDRL 문서에 정의되어 있습니다.
  5. 정책을 등록하십시오.
    개체의 메서드를 호출하고 다음 값을 전달하여 DocumentSecurityServiceClient 정책을 registerPolicy 등록합니다.
    • 등록할 정책을 나타내는 PolicySpec 개체입니다.
    • 정책이 속하는 정책 집합을 나타내는 문자열 값입니다. 정책을 MyPolicies null ** 정책 세트에 추가할 수 있는 값을 지정할 수 있습니다.
    연결 설정 내에서 AEM Forms 관리자 계정을 사용하여 개체를 만드는 경우 DocumentSecurityClient 메서드를 호출할 때 정책 세트 이름을 registerPolicy 지정합니다.
    연결 설정 내에서 Document SecurityDocument Security 사용자를 사용하는 경우 해당 정책만 허용하는 오버로드된 registerPolicy 메서드를 호출할 수 있습니다. 즉, 정책 집합 이름을 지정할 필요가 없습니다. 하지만, 정책은 내 정책이라는 정책 세트에 추가됩니다 . 이 정책 세트에 새 정책을 추가하지 않으려면 메서드를 호출할 때 정책 집합 이름을 registerPolicy 지정합니다.
    정책을 만들고 정책 세트를 지정할 때는 기존 정책 세트를 지정해야 합니다. 존재하지 않는 정책 세트를 지정하면 예외가 발생합니다.
Document Security 서비스를 사용하는 코드 예제를 보려면 다음 빠른 시작을 참조하십시오.
  • "빠른 시작(MTOM): 웹 서비스 API를 사용하여 정책 만들기"
  • "빠른 시작(SwaRef): 웹 서비스 API를 사용하여 정책 만들기"

정책 수정

Document Security Java API 또는 웹 서비스 API를 사용하여 기존 정책을 수정할 수 있습니다. 기존 정책을 변경하려면 해당 정책을 검색하고 수정한 다음 서버에서 정책을 업데이트합니다. 예를 들어 기존 정책을 검색하고 유효 기간을 연장한다고 가정합니다. 변경 사항이 적용되기 전에 정책을 업데이트해야 합니다.
비즈니스 요구 사항이 변경되고 정책이 이러한 요구 사항을 더 이상 반영하지 않을 때 정책을 수정할 수 있습니다. 새 정책을 만드는 대신 기존 정책을 간단히 업데이트할 수 있습니다.
웹 서비스를 사용하여 정책 속성을 수정하려면(예: JAX-WS로 생성된 Java 프록시 클래스 사용) 정책이 Document Security 서비스에 등록되어 있는지 확인해야 합니다. 그런 다음 방법을 사용하여 기존 정책을 참조하고 해당 방법을 사용하여 정책 속성을 수정할 수 PolicySpec.getPolicyXml 있습니다. 예를 들어 메서드를 호출하여 오프라인 임대 기간을 수정할 수 PolicySpec.setOfflineLeasePeriod 있습니다.
Document Security 서비스에 대한 자세한 내용은 AEM Forms에 대한 서비스 참조를 참조하십시오 .

단계 요약

기존 정책을 수정하려면 다음 단계를 수행하십시오.
  1. 프로젝트 파일 포함
  2. Document Security Client API 개체를 만듭니다.
  3. 기존 정책을 검색합니다.
  4. 정책 속성을 변경합니다.
  5. 정책을 업데이트합니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함할 수 있습니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
Document Security Client API 개체 만들기
프로그래밍 방식으로 Document Security 서비스 작업을 수행하려면 먼저 Document Security 서비스 클라이언트 개체를 만들어야 합니다. Java API를 사용하는 경우 RightsManagementClient 개체를 만듭니다. Document Security 웹 서비스 API를 사용하는 경우 RightsManagementServiceService 개체를 만듭니다.
기존 정책 검색
기존 정책을 수정하려면 기존 정책을 검색해야 합니다. 정책을 검색하려면 정책 이름과 정책이 속하는 정책 세트를 지정합니다. 정책 집합 이름의 null 값을 지정하면 #정책 세트에서 정책이 검색됩니다.
정책 속성 설정
정책을 수정하려면 정책 속성의 값을 수정합니다. 변경할 수 없는 유일한 정책 속성은 name 속성입니다. 예를 들어 정책의 오프라인 임대 기간을 변경하려면 정책의 오프라인 임대 기간 속성의 값을 수정할 수 있습니다.
웹 서비스를 사용하여 정책의 오프라인 임대 기간을 수정할 때 인터페이스의 offlineLeasePeriod 필드가 PolicySpec 무시됩니다. 오프라인 임대 기간을 업데이트하려면 PDRL XML 문서의 OfflineLeasePeriod 요소를 수정합니다. 그런 다음 인터페이스의 데이터 멤버를 사용하여 업데이트된 PDRL XML 문서를 PolicySpec 참조합니다 policyXML .
설정할 수 있는 기타 속성에 대한 자세한 내용은 AEM Forms API 참조 Policy 인터페이스 설명을 참조하십시오 .
정책 업데이트
정책에 대한 변경 사항이 적용되기 전에 Document Security 서비스로 정책을 업데이트해야 합니다. 정책으로 보호된 문서가 다음에 Document Security 서비스와 동기화되면 문서를 보호하는 정책의 변경 사항이 업데이트됩니다.

Java API를 사용하여 기존 정책 수정

Document Security API(Java)를 사용하여 기존 정책을 수정합니다.
  1. 프로젝트 파일 포함
    Java 프로젝트의 클래스 경로에 adobe-rightsmanagement-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
  2. Document Security Client API 개체를 만듭니다.
    • 연결 속성을 포함하는 ServiceClientFactory 개체를 만듭니다.
    • 생성자를 사용하여 개체를 RightsManagementClient 만들고 개체를 ServiceClientFactory 전달합니다.
  3. 기존 정책을 검색합니다.
    • 개체 PolicyManager 의 메서드를 호출하여 RightsManagementClient 개체를 getPolicyManager 만듭니다.
    • 개체 Policy PolicyManager getPolicy 의 메서드를 호출하고 다음 값을 전달하여 업데이트할 정책을 나타내는 개체를 만듭니다."
      • 정책이 속하는 정책 집합 이름을 나타내는 문자열 값. 해당 결과 null MyPolicies 정책 세트가 사용되도록 지정할 수 있습니다.
      • 정책 이름을 나타내는 문자열 값입니다.
  4. 정책의 속성을 설정합니다.
    비즈니스 요구 사항에 맞게 정책 속성을 변경합니다. 예를 들어 정책의 오프라인 임대 기간을 변경하려면 Policy 개체의 setOfflineLeasePeriod 메서드를 호출합니다.
  5. 정책을 업데이트합니다.
    개체의 메서드를 호출하여 정책을 PolicyManager updatePolicy 업데이트합니다. 업데이트할 정책을 나타내는 Policy 개체를 전달합니다.
코드 예제
Document Security 서비스를 사용하는 코드 예제를 보려면 빠른 시작(SOAP 모드)을 참조하십시오. Java API 섹션을 사용하여 정책 수정

웹 서비스 API를 사용하여 기존 정책 수정

Document Security API(웹 서비스)를 사용하여 기존 정책을 수정합니다.
  1. 프로젝트 파일 포함
    MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다. http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    AEM Forms localhost 를 호스팅하는 서버의 IP 주소로 대체합니다.
  2. Document Security Client API 개체를 만듭니다.
    • 기본 생성자를 사용하여 RightsManagementServiceClient 개체를 만듭니다.
    • 생성자를 사용하여 RightsManagementServiceClient.Endpoint.Address 개체를 System.ServiceModel.EndpointAddress 만듭니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예: http://localhost:8080/soap/services/RightsManagementService?WSDL .) 속성을 사용할 필요는 lc_version 없습니다. 이 속성은 서비스 참조를 만들 때 사용됩니다.)
    • 필드의 값을 System.ServiceModel.BasicHttpBinding 가져와 개체를 RightsManagementServiceClient.Endpoint.Binding 만듭니다. 반환 값을 다음으로 캐스팅합니다 BasicHttpBinding .
    • 개체 System.ServiceModel.BasicHttpBinding 필드를 (으)로 MessageEncoding 설정합니다 WSMessageEncoding.Mtom . 이 값을 사용하면 MTOM이 사용됩니다.
    • 다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
      • 필드에 AEM 양식 사용자 이름을 지정합니다 RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • 해당 암호 값을 필드에 지정합니다 RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • 필드에 상수 값 HttpClientCredentialType.Basic 을 지정합니다 BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • 필드에 상수 값 BasicHttpSecurityMode.TransportCredentialOnly 을 지정합니다 BasicHttpBindingSecurity.Security.Mode .
  3. 기존 정책을 검색합니다.
    개체의 메서드를 호출하고 다음 값을 전달하여 수정할 정책을 나타내는 PolicySpec RightsManagementServiceClient getPolicy 개체를 만듭니다.
    • 정책이 속하는 정책 집합 이름을 지정하는 문자열 값. 해당 결과 null MyPolicies 정책 세트가 사용되도록 지정할 수 있습니다.
    • 정책의 이름을 지정하는 문자열 값.
  4. 정책의 속성을 설정합니다.
    비즈니스 요구 사항에 맞게 정책 속성을 변경합니다.
  5. 정책을 업데이트합니다.
    개체의 메서드를 호출하고 업데이트할 정책을 나타내는 RightsManagementServiceClient updatePolicyFromSDK PolicySpec 개체를 전달하여 정책을 업데이트합니다.
코드 예제
Document Security 서비스를 사용하는 코드 예제를 보려면 다음 빠른 시작을 참조하십시오.
  • "빠른 시작(MTOM): 웹 서비스 API를 사용하여 정책 수정"
  • "빠른 시작(SwaRef): 웹 서비스 API를 사용하여 정책 수정"

정책 삭제

Document Security Java API 또는 웹 서비스 API를 사용하여 기존 정책을 삭제할 수 있습니다. 정책을 삭제한 후에는 문서를 보호하는 데 더 이상 사용할 수 없습니다. 하지만 정책을 사용하는 기존 정책으로 보호된 문서는 여전히 보호됩니다. 새 정책을 사용할 수 있게 되면 정책을 삭제할 수 있습니다.
Document Security 서비스에 대한 자세한 내용은 AEM Forms에 대한 서비스 참조를 참조하십시오 .

단계 요약

기존 정책을 삭제하려면 다음 단계를 수행하십시오.
  1. 프로젝트 파일 포함
  2. Document Security Client API 개체를 만듭니다.
  3. 정책을 삭제합니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함할 수 있습니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
Document Security Client API 개체 만들기
프로그래밍 방식으로 Document Security 서비스 작업을 수행하려면 먼저 Document Security 서비스 클라이언트 개체를 만들어야 합니다. Java API를 사용하는 경우 RightsManagementClient 개체를 만듭니다. Document Security 웹 서비스 API를 사용하는 경우 RightsManagementServiceService 개체를 만듭니다.
정책 삭제
정책을 삭제하려면 삭제할 정책과 정책이 속하는 정책 세트를 지정합니다. AEM Forms을 호출하는 데 설정을 사용하는 사용자는 정책을 삭제할 권한이 있어야 합니다. 그렇지 않으면 예외가 발생합니다. 마찬가지로 존재하지 않는 정책을 삭제하려고 하면 예외가 발생합니다.

Java API를 사용하여 정책 삭제

Document Security API(Java)를 사용하여 정책을 삭제합니다.
  1. 프로젝트 파일 포함
    Java 프로젝트의 클래스 경로에 adobe-rightsmanagement-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
  2. Document Security Client API 개체를 만듭니다.
    • 연결 속성을 포함하는 ServiceClientFactory 개체를 만듭니다.
    • 생성자를 사용하여 개체를 RightsManagementClient 만들고 개체를 ServiceClientFactory 전달합니다.
  3. 정책을 삭제합니다.
    • 개체 PolicyManager 의 메서드를 호출하여 RightsManagementClient 개체를 getPolicyManager 만듭니다.
    • 개체의 메서드를 호출하고 다음 값을 전달하여 PolicyManager 정책을 deletePolicy 삭제합니다.
      • 정책이 속하는 정책 집합 이름을 지정하는 문자열 값. 해당 결과 null MyPolicies 정책 세트가 사용되도록 지정할 수 있습니다.
      • 삭제할 정책의 이름을 지정하는 문자열 값.
코드 예제
Document Security 서비스를 사용하는 코드 예제를 보려면 다음 빠른 시작을 참조하십시오.
  • "빠른 시작(SOAP 모드): Java API를 사용하여 정책 삭제"

웹 서비스 API를 사용하여 정책 삭제

Document Security API(웹 서비스)를 사용하여 정책을 삭제합니다.
  1. 프로젝트 파일 포함
    MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다. http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    AEM Forms localhost 를 호스팅하는 서버의 IP 주소로 대체합니다.
  2. Document Security Client API 개체를 만듭니다.
    • 기본 생성자를 사용하여 RightsManagementServiceClient 개체를 만듭니다.
    • 생성자를 사용하여 RightsManagementServiceClient.Endpoint.Address 개체를 System.ServiceModel.EndpointAddress 만듭니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예: http://localhost:8080/soap/services/RightsManagementService?WSDL .) 속성을 사용할 필요는 lc_version 없습니다. 이 속성은 서비스 참조를 만들 때 사용됩니다.)
    • 필드의 값을 System.ServiceModel.BasicHttpBinding 가져와 개체를 RightsManagementServiceClient.Endpoint.Binding 만듭니다. 반환 값을 다음으로 캐스팅합니다 BasicHttpBinding .
    • 개체 System.ServiceModel.BasicHttpBinding 필드를 (으)로 MessageEncoding 설정합니다 WSMessageEncoding.Mtom . 이 값을 사용하면 MTOM이 사용됩니다.
    • 다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
      • 필드에 AEM 양식 사용자 이름을 지정합니다 RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • 해당 암호 값을 필드에 지정합니다 RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • 필드에 상수 값 HttpClientCredentialType.Basic 을 지정합니다 BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • 필드에 상수 값 BasicHttpSecurityMode.TransportCredentialOnly 을 지정합니다 BasicHttpBindingSecurity.Security.Mode .
  3. 정책을 삭제합니다.
    개체의 메서드를 호출하고 다음 값을 전달하여 RightsManagementServiceClient 정책을 deletePolicy 삭제합니다.
    • 정책이 속하는 정책 집합 이름을 지정하는 문자열 값. 해당 결과 null MyPolicies 정책 세트가 사용되도록 지정할 수 있습니다.
    • 삭제할 정책의 이름을 지정하는 문자열 값.
코드 예제
Document Security 서비스를 사용하는 코드 예제를 보려면 다음 빠른 시작을 참조하십시오.
  • "빠른 시작(MTOM): 웹 서비스 API를 사용하여 정책 삭제"
  • "빠른 시작(SwaRef): 웹 서비스 API를 사용하여 정책 삭제"

PDF 문서에 정책 적용

PDF 문서에 정책을 적용하여 문서를 보호할 수 있습니다. PDF 문서에 정책을 적용하면 문서에 대한 액세스를 제한합니다. 문서에 정책으로 이미 보호된 경우에는 정책을 적용할 수 없습니다.
문서가 열려 있는 동안 텍스트 인쇄 및 복사, 변경, 문서에 서명 및 주석 추가 등 Acrobat 및 Adobe Reader 기능에 대한 액세스를 제한할 수 있습니다. 또한 사용자가 문서에 더 이상 액세스하지 못하게 하려는 경우 정책으로 보호된 PDF 문서를 취소할 수 있습니다.
정책으로 보호된 문서를 배포한 후에 사용할 수 있습니다. 즉, 문서가 어떻게 사용되고 있으며 누가 문서를 사용하고 있는지 알 수 있습니다. 예를 들어 문서를 연 시간을 확인할 수 있습니다.
Document Security 서비스에 대한 자세한 내용은 AEM Forms에 대한 서비스 참조를 참조하십시오 .

단계 요약

PDF 문서에 정책을 적용하려면 다음 단계를 수행하십시오.
  1. 프로젝트 파일 포함
  2. Document Security Client API 개체를 만듭니다.
  3. 정책이 적용되는 PDF 문서를 검색합니다.
  4. PDF 문서에 기존 정책을 적용합니다.
  5. 정책으로 보호된 PDF 문서를 저장합니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함할 수 있습니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
Document Security Client API 개체 만들기
프로그래밍 방식으로 Document Security 서비스 작업을 수행하려면 먼저 Document Security 서비스 클라이언트 개체를 만듭니다. Java API를 사용하는 경우 DocumentSecurityClient 개체를 만듭니다. Document Security 웹 서비스 API를 사용하는 경우 DocumentSecurityServiceService 개체를 만듭니다.
PDF 문서 검색
정책을 적용하려면 PDF 문서를 검색할 수 있습니다. PDF 문서에 정책을 적용하면 사용자가 문서를 사용할 때 제한됩니다. 예를 들어 정책에서 오프라인 상태에서 문서를 열 수 있도록 하지 않으면 사용자는 온라인 상태여야 문서를 열 수 있습니다.
PDF 문서에 기존 정책 적용
PDF 문서에 정책을 적용하려면 기존 정책을 참조하고 정책이 속하는 정책 세트를 지정합니다. 연결 속성을 설정하는 사용자는 지정된 정책에 액세스할 수 있어야 합니다. 그렇지 않으면 예외가 발생합니다.
PDF 문서 저장
Document Security 서비스가 PDF 문서에 정책을 적용한 후 정책으로 보호된 PDF 문서를 PDF 파일로 저장할 수 있습니다.
참고 항목

Java API를 사용하여 PDF 문서에 정책 적용

Document Security API(Java)를 사용하여 PDF 문서에 정책을 적용합니다.
  1. 프로젝트 파일 포함
    Java 프로젝트의 클래스 경로에 adobe-rightsmanagement-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
  2. Document Security Client API 개체를 만듭니다.
    • 연결 속성을 포함하는 ServiceClientFactory 개체를 만듭니다.
    • 생성자를 사용하여 개체를 RightsManagementClient 만들고 개체를 ServiceClientFactory 전달합니다.
  3. PDF 문서 검색
    • 생성자를 사용하여 PDF 문서를 나타내는 java.io.FileInputStream 개체를 만듭니다. PDF 문서의 위치를 지정하는 문자열 값을 전달합니다.
    • 생성자를 사용하여 개체를 com.adobe.idp.Document 만들고 개체를 java.io.FileInputStream 전달합니다.
  4. PDF 문서에 기존 정책을 적용합니다.
    • 개체 DocumentManager 의 메서드를 호출하여 RightsManagementClient 개체를 getDocumentManager 만듭니다.
    • 객체의 메서드를 호출하고 다음 값을 전달하여 PDF 문서에 정책을 DocumentManager protectDocument 적용합니다.
      • 정책이 적용되는 PDF 문서를 포함하는 com.adobe.idp.Document 개체입니다.
      • 문서의 이름을 지정하는 문자열 값.
      • 정책이 속하는 정책 세트의 이름을 지정하는 문자열 값. 정책 null 세트가 사용되는 결과를 MyPolicies 지정할 수 있습니다.
      • 정책 이름을 지정하는 문자열 값.
      • 문서 게시자인 사용자의 사용자 관리자 도메인 이름을 나타내는 문자열 값입니다. 이 매개 변수 값은 선택 사항이며 null일 수 있습니다(이 매개 변수가 null이면 다음 매개 변수 값은 null이어야 함).
      • 문서의 게시자인 사용자 관리자 사용자의 정식 이름을 나타내는 문자열 값입니다. 이 매개 변수 값은 선택 사항이며 null 될 수 있습니다(이 매개 변수가 null이면 이전 매개 변수 값이 null 되어야 함).
      • MS Office 템플릿을 선택하는 데 사용되는 로케일을 나타내는 com.adobe.livecycle.rightsmanagement.Locale 로케일입니다. 이 매개 변수 값은 선택 사항이며 PDF 문서에 사용되지 않습니다. PDF 문서의 보안을 설정하려면 을 지정합니다 null .
      protectDocument 메서드는 정책으로 보호된 PDF 문서를 포함하는 RMSecureDocumentResult 개체를 반환합니다.
  5. PDF 문서를 저장합니다.
    • 정책으로 보호된 PDF 문서를 가져오려면 RMSecureDocumentResult 개체의 getProtectedDoc 방법을 불러옵니다. 이 메서드는 com.adobe.idp.Document 개체를 반환합니다.
    • 개체를 java.io.File 만들고 파일 확장자가 PDF인지 확인합니다.
    • 객체의 메서드를 호출하여 com.adobe.idp.Document 객체의 내용을 파일에 복사합니다(메서드에서 반환된 copyToFile 객체를 Document Document getProtectedDoc 사용해야 함).
코드 예제
Document Security 서비스를 사용하는 코드 예제를 보려면 다음 빠른 시작을 참조하십시오.
  • "빠른 시작(EJB 모드): Java API를 사용하여 PDF 문서에 정책 적용"
  • "빠른 시작(SOAP 모드): Java API를 사용하여 PDF 문서에 정책 적용"
참고 항목

웹 서비스 API를 사용하여 PDF 문서에 정책 적용

Document Security API(웹 서비스)를 사용하여 PDF 문서에 정책을 적용합니다.
  1. 프로젝트 파일 포함
    MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다. http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    AEM Forms localhost 를 호스팅하는 서버의 IP 주소로 대체합니다.
  2. Document Security Client API 개체를 만듭니다.
    • 기본 생성자를 사용하여 RightsManagementServiceClient 개체를 만듭니다.
    • 생성자를 사용하여 RightsManagementServiceClient.Endpoint.Address 개체를 System.ServiceModel.EndpointAddress 만듭니다. WSDL을 지정하는 문자열 값을 Forms 서비스(예: http://localhost:8080/soap/services/RightsManagementService?WSDL .)로 전달합니다. 속성을 사용할 필요는 lc_version 없습니다. 이 속성은 서비스 참조를 만들 때 사용됩니다.)
    • 필드의 값을 System.ServiceModel.BasicHttpBinding 가져와 개체를 RightsManagementServiceClient.Endpoint.Binding 만듭니다. 반환 값을 다음으로 캐스팅합니다 BasicHttpBinding .
    • 개체 System.ServiceModel.BasicHttpBinding 필드를 (으)로 MessageEncoding 설정합니다 WSMessageEncoding.Mtom . 이 값을 사용하면 MTOM이 사용됩니다.
    • 다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
      • 필드에 AEM 양식 사용자 이름을 지정합니다 RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • 해당 암호 값을 필드에 지정합니다 RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • 필드에 상수 값 HttpClientCredentialType.Basic 을 지정합니다 BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • 필드에 상수 값 BasicHttpSecurityMode.TransportCredentialOnly 을 지정합니다 BasicHttpBindingSecurity.Security.Mode .
  3. PDF 문서 검색
    • 생성자를 사용하여 BLOB 개체를 만듭니다. 이 BLOB 개체는 정책이 적용되는 PDF 문서를 저장하는 데 사용됩니다.
    • 생성자를 호출하고 PDF 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달하여 System.IO.FileStream 개체를 만듭니다.
    • 개체의 내용을 저장하는 바이트 배열을 System.IO.FileStream 만듭니다. 개체의 속성을 가져와 바이트 배열 크기를 System.IO.FileStream 결정합니다 Length .
    • 개체의 메서드를 호출하여 바이트 배열을 스트림 데이터로 System.IO.FileStream 채웁니다 Read . 바이트 배열, 시작 위치 및 스트림 길이를 전달합니다.
    • 바이트 배열의 내용으로 해당 BLOB MTOM 필드를 할당하여 개체를 채웁니다.
  4. PDF 문서에 기존 정책을 적용합니다.
    객체의 메서드를 호출하고 다음 값을 전달하여 PDF 문서에 정책을 RightsManagementServiceClient protectDocument 적용합니다.
    • 정책이 적용되는 PDF 문서를 포함하는 BLOB 개체입니다.
    • 문서의 이름을 지정하는 문자열 값.
    • 정책이 속하는 정책 세트의 이름을 지정하는 문자열 값. 정책 null 세트가 사용되는 결과를 MyPolicies 지정할 수 있습니다.
    • 정책 이름을 지정하는 문자열 값.
    • 문서 게시자인 사용자의 사용자 관리자 도메인 이름을 나타내는 문자열 값입니다. 이 매개 변수 값은 선택 사항이며 null일 수 있습니다(이 매개 변수가 null이면 다음 매개 변수 값이 있어야 null 합니다).
    • 문서의 게시자인 사용자 관리자 사용자의 정식 이름을 나타내는 문자열 값입니다. 이 매개 변수 값은 선택 사항이며 null일 수 있습니다(이 매개 변수가 null이면 이전 매개 변수 값이 null 되어야 합니다).
    • 로케일 값(예:)을 지정하는 RMLocale RMLocale.en 값입니다.
    • 정책 식별자 값을 저장하는 데 사용되는 문자열 출력 매개 변수입니다.
    • 정책으로 보호된 식별자 값을 저장하는 데 사용되는 문자열 출력 매개 변수입니다.
    • MIME 형식을 저장하는 데 사용되는 문자열 출력 매개 application/pdf 변수입니다.
    protectDocument 메서드는 정책으로 보호된 PDF 문서를 포함하는 BLOB 개체를 반환합니다.
  5. PDF 문서를 저장합니다.
    • 생성자를 호출하고 정책으로 보호된 PDF 문서의 파일 위치를 나타내는 문자열 값을 전달하여 System.IO.FileStream 개체를 만듭니다.
    • 메서드에서 반환된 개체의 데이터 내용을 저장하는 바이트 배열을 BLOB protectDocument 만듭니다. 개체 데이터 멤버의 값을 가져와 바이트 배열 BLOB MTOM 채웁니다.
    • 생성자를 호출하고 개체를 전달하여 System.IO.BinaryWriter 개체를 System.IO.FileStream 만듭니다.
    • 개체의 메서드를 호출하고 바이트 배열을 전달하여 바이트 배열의 내용을 PDF 파일 System.IO.BinaryWriter Write 에 씁니다.
코드 예제
Document Security 서비스를 사용하는 코드 예제를 보려면 다음 빠른 시작을 참조하십시오.
  • "빠른 시작(MTOM): 웹 서비스 API를 사용하여 PDF 문서에 정책 적용"
  • "빠른 시작(SwaRef): 웹 서비스 API를 사용하여 PDF 문서에 정책 적용"

PDF 문서에서 정책 제거

문서에서 보안을 제거하려면 정책으로 보호된 문서에서 정책을 제거할 수 있습니다. 즉, 정책으로 문서를 보호하지 않으려는 경우 정책으로 보호된 문서를 최신 정책으로 업데이트하려면 정책을 제거하고 업데이트된 정책을 추가하는 대신 정책을 전환하는 것이 더 효율적입니다.
Document Security 서비스에 대한 자세한 내용은 AEM Forms에 대한 서비스 참조를 참조하십시오 .

단계 요약

정책으로 보호된 PDF 문서에서 정책을 제거하려면 다음 단계를 수행하십시오.
  1. 프로젝트 파일 포함
  2. Document Security Client API 개체를 만듭니다.
  3. 정책으로 보호된 PDF 문서 검색
  4. PDF 문서에서 정책을 제거합니다.
  5. 비보안 PDF 문서를 저장합니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함할 수 있습니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
Document Security Client API 개체 만들기
프로그래밍 방식으로 Document Security 서비스 작업을 수행하려면 먼저 Document Security 서비스 클라이언트 개체를 만듭니다.
정책으로 보호된 PDF 문서 검색
정책으로 보호된 PDF 문서를 검색하여 정책을 제거할 수 있습니다. 정책으로 보호되지 않은 PDF 문서에서 정책을 제거하려고 하면 예외가 발생합니다.
PDF 문서에서 정책 제거
관리자가 연결 설정에 지정된 경우 정책으로 보호된 PDF 문서에서 정책을 제거할 수 있습니다. 그렇지 않은 경우 PDF 문서에서 정책을 제거하려면 문서 보안에 사용된 정책에 SWITCH_POLICY 권한이 포함되어야 합니다. 또한 AEM Forms 연결 설정에 지정된 사용자에게도 해당 권한이 있어야 합니다. 그렇지 않으면 예외가 throw됩니다.
비보안 PDF 문서 저장
Document Security 서비스가 PDF 문서에서 정책을 제거한 후 비보안 PDF 문서를 PDF 파일로 저장할 수 있습니다.
참고 항목

Java API를 사용하여 PDF 문서에서 정책 제거

Document Security API(Java)를 사용하여 정책으로 보호된 PDF 문서에서 정책을 제거합니다.
  1. 프로젝트 파일 포함
    Java 프로젝트의 클래스 경로에 adobe-rightsmanagement-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
  2. Document Security Client API 개체를 만듭니다.
    • 연결 속성을 포함하는 ServiceClientFactory 개체를 만듭니다.
    • 생성자를 사용하여 개체를 DocumentSecurityClient 만들고 개체를 ServiceClientFactory 전달합니다.
  3. 정책으로 보호된 PDF 문서 검색
    • 생성자를 사용하여 정책으로 보호된 PDF 문서를 나타내는 java.io.FileInputStream 개체를 만들고 PDF 문서의 위치를 지정하는 문자열 값을 전달합니다.
    • 생성자를 사용하여 개체를 com.adobe.idp.Document 만들고 개체를 java.io.FileInputStream 전달합니다.
  4. PDF 문서에서 정책을 제거합니다.
    • 개체 DocumentManager 의 메서드를 호출하여 DocumentSecurityClient 개체를 getDocumentManager 만듭니다.
    • 개체의 방법을 호출하고 정책으로 보호된 PDF 문서가 포함된 DocumentManager removeSecurity com.adobe.idp.Document 개체를 전달하여 PDF 문서에서 정책을 제거합니다. 이 메서드는 보안되지 않은 PDF 문서를 포함하는 com.adobe.idp.Document 개체를 반환합니다.
  5. 비보안 PDF 문서를 저장합니다.
    • 개체를 java.io.File 만들고 파일 확장자가 PDF인지 확인합니다.
    • 객체의 메서드를 호출하여 Document 객체의 내용을 파일에 복사합니다(메서드에서 반환된 copyToFile 객체를 Document Document removeSecurity 사용해야 함).
코드 예제
Document Security 서비스를 사용하는 코드 예제를 보려면 다음 빠른 시작을 참조하십시오.
  • "빠른 시작(SOAP 모드): Java API를 사용하여 PDF 문서에서 정책 제거"

웹 서비스 API를 사용하여 정책 제거

Document Security API(웹 서비스)를 사용하여 정책으로 보호된 PDF 문서에서 정책을 제거합니다.
  1. 프로젝트 파일 포함
    MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다. http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    AEM Forms localhost 를 호스팅하는 서버의 IP 주소로 대체합니다.
  2. Document Security Client API 개체를 만듭니다.
    • 기본 생성자를 사용하여 DocumentSecurityServiceClient 개체를 만듭니다.
    • 생성자를 사용하여 DocumentSecurityServiceClient.Endpoint.Address 개체를 System.ServiceModel.EndpointAddress 만듭니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예: http://localhost:8080/soap/services/RightsManagementService?WSDL .) 속성을 사용할 필요는 lc_version 없습니다. 이 속성은 서비스 참조를 만들 때 사용됩니다.)
    • 필드의 값을 System.ServiceModel.BasicHttpBinding 가져와 개체를 DocumentSecurityServiceClient.Endpoint.Binding 만듭니다. 반환 값을 다음으로 캐스팅합니다 BasicHttpBinding .
    • 개체 System.ServiceModel.BasicHttpBinding 필드를 (으)로 MessageEncoding 설정합니다 WSMessageEncoding.Mtom . 이 값을 사용하면 MTOM이 사용됩니다.
    • 다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
      • 필드에 AEM 양식 사용자 이름을 지정합니다 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName .
      • 해당 암호 값을 필드에 지정합니다 DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • 필드에 상수 값 HttpClientCredentialType.Basic 을 지정합니다 BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • 필드에 상수 값 BasicHttpSecurityMode.TransportCredentialOnly 을 지정합니다 BasicHttpBindingSecurity.Security.Mode .
  3. 정책으로 보호된 PDF 문서 검색
    • 생성자를 사용하여 BLOB 개체를 만듭니다. 이 BLOB 개체는 정책이 제거된 정책으로 보호된 PDF 문서를 저장하는 데 사용됩니다.
    • 생성자를 호출하고 PDF 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달하여 System.IO.FileStream 개체를 만듭니다.
    • 개체의 내용을 저장하는 바이트 배열을 System.IO.FileStream 만듭니다. 개체의 속성을 가져와 바이트 배열의 크기를 결정할 수 System.IO.FileStream Length 있습니다.
    • 개체의 메서드를 호출하고 바이트 배열, 시작 위치 및 읽을 스트림 길이를 전달하여 바이트 배열 System.IO.FileStream Read 을 스트림 데이터로 채웁니다.
    • 바이트 배열의 내용으로 해당 BLOB MTOM 필드를 할당하여 개체를 채웁니다.
  4. PDF 문서에서 정책을 제거합니다.
    개체의 방법을 호출하고 정책으로 보호된 PDF 문서가 포함된 DocumentSecurityServiceClient removePolicySecurity BLOB 개체를 전달하여 PDF 문서에서 정책을 제거합니다. 이 메서드는 보안되지 않은 PDF 문서를 포함하는 BLOB 개체를 반환합니다.
  5. 비보안 PDF 문서를 저장합니다.
    • 생성자를 호출하고 비보안 PDF 문서의 파일 위치를 나타내는 문자열 값을 전달하여 System.IO.FileStream 개체를 만듭니다.
    • 메서드에서 반환된 개체의 데이터 내용을 저장하는 바이트 배열을 BLOB removePolicySecurity 만듭니다. 개체 필드의 값을 가져와 바이트 배열 BLOB MTOM 채웁니다.
    • 생성자를 호출하고 개체를 전달하여 System.IO.BinaryWriter 개체를 System.IO.FileStream 만듭니다.
코드 예제
Document Security 서비스를 사용하는 코드 예제를 보려면 다음 빠른 시작을 참조하십시오.
  • "빠른 시작(MTOM): 웹 서비스 API를 사용하여 PDF 문서에서 정책 제거"
  • "빠른 시작(SwaRef): 웹 서비스 API를 사용하여 PDF 문서에서 정책 제거"
참고 항목

문서에 대한 액세스 취소

정책으로 보호된 PDF 문서에 대한 액세스를 폐지하면 사용자가 해당 문서의 모든 사본에 액세스할 수 없게 됩니다. 사용자가 취소된 PDF 문서를 열려고 하면 수정된 문서를 볼 수 있는 지정된 URL로 리디렉션됩니다. 사용자를 리디렉션하는 URL을 프로그래밍 방식으로 지정해야 합니다. 문서에 대한 액세스를 폐지하면 사용자가 정책으로 보호된 문서를 온라인으로 열어 다음에 Document Security 서비스와 동기화하면 변경 사항이 적용됩니다.
문서에 대한 액세스를 취소하는 기능은 추가 보안을 제공합니다. 예를 들어 최신 버전의 문서를 사용할 수 있으며 더 이상 오래된 버전을 보는 사람이 없도록 해야 한다고 가정합니다. 이 경우 이전 문서에 대한 액세스는 취소될 수 있으며, 액세스가 복구되지 않으면 아무도 문서를 볼 수 없습니다.
Document Security 서비스에 대한 자세한 내용은 AEM Forms에 대한 서비스 참조를 참조하십시오 .

단계 요약

정책으로 보호된 문서를 취소하려면 다음 단계를 수행하십시오.
  1. 프로젝트 파일 포함
  2. Document Security Client API 개체를 만듭니다.
  3. 정책으로 보호된 PDF 문서 검색
  4. 정책으로 보호된 문서를 취소합니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함할 수 있습니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
Document Security Client API 개체 만들기
프로그래밍 방식으로 Document Security 서비스 작업을 수행하려면 먼저 Document Security 서비스 클라이언트 개체를 만들어야 합니다.
정책으로 보호된 PDF 문서 검색
정책으로 보호된 PDF 문서를 철회하려면 PDF 문서를 검색해야 합니다. 이미 해지되었거나 정책으로 보호된 문서가 아닌 문서는 취소할 수 없습니다.
정책으로 보호된 문서의 라이선스 식별자 값을 알고 있는 경우 정책으로 보호된 PDF 문서를 검색할 필요가 없습니다. 그러나 대부분의 경우 라이센스 식별자 값을 얻으려면 PDF 문서를 검색해야 합니다.
정책으로 보호된 문서 취소
정책으로 보호된 문서를 취소하려면 정책으로 보호된 문서의 라이선스 식별자를 지정합니다. 또한 사용자가 해지된 문서를 열려고 할 때 볼 수 있는 문서의 URL을 지정할 수 있습니다. 즉, 오래된 문서가 취소되었다고 가정합니다. 사용자가 취소된 문서를 열려고 하면 해지된 문서 대신 업데이트된 문서가 표시됩니다.
이미 취소된 문서를 취소하려고 하면 예외가 발생합니다.
참고 항목

Java API를 사용하여 문서에 대한 액세스 취소

Document Security API(Java)를 사용하여 정책으로 보호된 PDF 문서에 대한 액세스를 취소합니다.
  1. 프로젝트 파일 포함
    Java 프로젝트의 클래스 경로에 adobe-rightsmanagement-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
  2. Document Security Client API 개체 만들기
    • 연결 속성을 포함하는 ServiceClientFactory 개체를 만듭니다.
    • 생성자를 사용하여 개체를 DocumentSecurityClient 만들고 개체를 ServiceClientFactory 전달합니다.
  3. 정책으로 보호된 PDF 문서 검색
    • 생성자를 사용하여 PDF 문서의 위치를 지정하는 문자열 값을 전달하여 정책으로 보호된 PDF 문서를 나타내는 java.io.FileInputStream 개체를 만듭니다.
    • 생성자를 사용하여 개체를 com.adobe.idp.Document 만들고 개체를 java.io.FileInputStream 전달합니다.
  4. 정책으로 보호된 문서 취소
    • 개체 DocumentManager 의 메서드를 호출하여 DocumentSecurityClient 개체를 getDocumentManager 만듭니다.
    • 개체의 메서드를 호출하여 정책으로 보호된 문서의 라이선스 식별자 값을 DocumentManager 검색합니다 getLicenseId . 정책으로 보호된 문서를 나타내는 com.adobe.idp.Document 개체를 전달합니다. 이 메서드는 라이선스 식별자 값을 나타내는 문자열 값을 반환합니다.
    • 개체 LicenseManager 의 메서드를 호출하여 DocumentSecurityClient 개체를 getLicenseManager 만듭니다.
    • 개체의 메서드를 호출하고 다음 값을 전달하여 정책으로 보호된 문서 LicenseManager revokeLicense 취소합니다.
      • 정책으로 보호된 문서의 라이선스 식별자 값을 지정하는 문자열 값( DocumentManager 개체 getLicenseId 메서드의 반환 값 지정).
      • 문서를 취소하는 이유를 지정하는 License 인터페이스의 정적 데이터 멤버. For example, you can specify License.DOCUMENT_REVISED .
      • 수정된 문서가 있는 위치를 지정하는 java.net.URL 값. 사용자를 다른 URL로 리디렉션하지 않으려는 경우 전달할 수 있습니다 null .
코드 예제
Document Security 서비스를 사용하는 코드 예제를 보려면 다음 빠른 시작을 참조하십시오.
  • "빠른 시작(SOAP 모드): Java API를 사용하여 문서 취소"

웹 서비스 API를 사용하여 문서에 대한 액세스 취소

Document Security API(웹 서비스)를 사용하여 정책으로 보호된 PDF 문서에 대한 액세스를 취소합니다.
  1. 프로젝트 파일 포함
    MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다. http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    AEM Forms localhost 를 호스팅하는 서버의 IP 주소로 대체합니다.
  2. Document Security Client API 개체 만들기
    • 기본 생성자를 사용하여 DocumentSecurityServiceClient 개체를 만듭니다.
    • 생성자를 사용하여 DocumentSecurityServiceClient.Endpoint.Address 개체를 System.ServiceModel.EndpointAddress 만듭니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예: http://localhost:8080/soap/services/RightsManagementService?WSDL .) 속성을 사용할 필요는 lc_version 없습니다. 이 속성은 서비스 참조를 만들 때 사용됩니다.)
    • 필드의 값을 System.ServiceModel.BasicHttpBinding 가져와 개체를 DocumentSecurityServiceClient.Endpoint.Binding 만듭니다. 반환 값을 다음으로 캐스팅합니다 BasicHttpBinding .
    • 개체 System.ServiceModel.BasicHttpBinding 필드를 (으)로 MessageEncoding 설정합니다 WSMessageEncoding.Mtom . 이 값을 사용하면 MTOM이 사용됩니다.
    • 다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
      • 필드에 AEM 양식 사용자 이름을 지정합니다 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName .
      • 해당 암호 값을 필드에 지정합니다 DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • 필드에 상수 값 HttpClientCredentialType.Basic 을 지정합니다 BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • 필드에 상수 값 BasicHttpSecurityMode.TransportCredentialOnly 을 지정합니다 BasicHttpBindingSecurity.Security.Mode .
  3. 정책으로 보호된 PDF 문서 검색
    • 생성자를 사용하여 BLOB 개체를 만듭니다. 이 BLOB 개체는 해지된 정책으로 보호된 PDF 문서를 저장하는 데 사용됩니다.
    • 생성자를 호출하고 정책으로 보호된 PDF 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달하여 System.IO.FileStream 개체를 만듭니다.
    • 개체의 내용을 저장하는 바이트 배열을 System.IO.FileStream 만듭니다. 개체의 속성을 가져와 바이트 배열의 크기를 결정할 수 System.IO.FileStream Length 있습니다.
    • 개체의 메서드를 호출하고 바이트 배열, 시작 위치 및 읽을 스트림 길이를 전달하여 바이트 배열 System.IO.FileStream Read 을 스트림 데이터로 채웁니다.
    • 바이트 배열의 내용으로 해당 BLOB MTOM 필드를 할당하여 개체를 채웁니다.
  4. 정책으로 보호된 문서 취소
    • 개체의 메서드를 호출하고 정책으로 보호된 문서를 나타내는 DocumentSecurityServiceClient getLicenseID BLOB 개체를 전달하여 정책으로 보호된 문서의 라이선스 식별자 값을 검색합니다. 이 메서드는 라이선스 식별자를 나타내는 문자열 값을 반환합니다.
    • 개체의 메서드를 호출하고 다음 값을 전달하여 정책으로 보호된 문서 DocumentSecurityServiceClient revokeLicense 취소합니다.
      • 정책으로 보호된 문서의 라이선스 식별자 값을 지정하는 문자열 값( DocumentSecurityServiceService 개체 getLicenseId 메서드의 반환 값 지정).
      • 문서를 취소하는 이유를 지정하는 열거형 Reason 의 정적 데이터 멤버. For example, you can specify Reason.DOCUMENT_REVISED .
      • 수정된 문서가 위치한 URL 위치를 지정하는 string 값. 사용자를 다른 URL로 리디렉션하지 않으려는 경우 전달할 수 있습니다 null .
코드 예제
Document Security 서비스를 사용하는 코드 예제를 보려면 다음 빠른 시작을 참조하십시오.
  • "빠른 시작(MTOM): 웹 서비스 API를 사용하여 문서 취소"
  • "빠른 시작(SwaRef): 웹 서비스 API를 사용하여 문서 취소"
참고 항목

해지된 문서에 대한 액세스 복원

해지된 PDF 문서에 대한 액세스 권한을 다시 부여하면 사용자가 해지된 문서의 모든 사본을 액세스할 수 있습니다. 사용자가 취소된 복원된 문서를 열면 해당 문서를 볼 수 있습니다.
Document Security 서비스에 대한 자세한 내용은 AEM Forms에 대한 서비스 참조를 참조하십시오 .

단계 요약

취소된 PDF 문서에 대한 액세스를 복원하려면 다음 단계를 수행하십시오.
  1. 프로젝트 파일 포함
  2. Document Security Client API 개체를 만듭니다.
  3. 취소된 PDF 문서의 라이선스 식별자를 검색합니다.
  4. 취소된 PDF 문서에 대한 액세스 권한을 복원합니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함할 수 있습니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
Document Security Client API 개체 만들기
프로그래밍 방식으로 Document Security 서비스 작업을 수행하려면 먼저 Document Security 서비스 클라이언트 개체를 만들어야 합니다. Java API를 사용하는 경우 DocumentSecurityClient 개체를 만듭니다. Document Security 웹 서비스 API를 사용하는 경우 DocumentSecurityServiceService 개체를 만듭니다.
취소된 PDF 문서의 라이선스 식별자 검색
취소된 PDF 문서를 복원하려면 취소된 PDF 문서의 라이선스 식별자를 검색해야 합니다. 라이센스 식별자 값을 얻은 후, 취소된 문서를 복원할 수 있습니다. 취소되지 않은 문서를 복원하려고 하면 예외가 발생합니다.
취소된 PDF 문서에 대한 액세스 권한 복원
취소된 PDF 문서에 대한 액세스를 복원하려면 취소된 문서의 라이선스 식별자를 지정해야 합니다. 취소되지 않은 PDF 문서에 대한 액세스를 복원하려고 하면 예외가 발생합니다.
참고 항목

Java API를 사용하여 해지된 문서에 대한 액세스 권한 복원

Document Security API(Java)를 사용하여 해지된 문서에 대한 액세스 권한 복원:
  1. 프로젝트 파일 포함
    Java 프로젝트의 클래스 경로에 adobe-rightsmanagement-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
  2. Document Security Client API 개체를 만듭니다.
    • 연결 속성을 포함하는 ServiceClientFactory 개체를 만듭니다.
    • 생성자를 사용하여 개체를 DocumentSecurityClient 만들고 개체를 ServiceClientFactory 전달합니다.
  3. 취소된 PDF 문서의 라이선스 식별자를 검색합니다.
    • 생성자를 사용하여 PDF 문서의 위치를 지정하는 문자열 값을 전달하여 해지된 PDF 문서를 나타내는 java.io.FileInputStream 개체를 만듭니다.
    • 생성자를 사용하여 개체를 com.adobe.idp.Document 만들고 개체를 java.io.FileInputStream 전달합니다.
    • 개체 DocumentManager 의 메서드를 호출하여 DocumentSecurityClient 개체를 getDocumentManager 만듭니다.
    • 객체 메서드를 호출하고 해지된 문서를 나타내는 DocumentManager getLicenseId com.adobe.idp.Document 개체를 전달하여 해지된 문서의 라이선스 식별자 값을 검색합니다. 이 메서드는 라이선스 식별자를 나타내는 문자열 값을 반환합니다.
  4. 취소된 PDF 문서에 대한 액세스 권한을 복원합니다.
    • 개체 LicenseManager 의 메서드를 호출하여 DocumentSecurityClient 개체를 getLicenseManager 만듭니다.
    • 오브젝트의 방법을 호출하고 취소된 문서의 라이선스 식별자 값을 전달하여 취소된 PDF 문서에 대한 액세스 권한을 다시 LicenseManager unrevokeLicense 부여합니다.
코드 예제
Document Security 서비스를 사용하는 코드 예제를 보려면 다음 빠른 시작을 참조하십시오.
  • "빠른 시작(SOAP 모드): 웹 서비스 API를 사용하여 해지된 문서에 대한 액세스 권한 복원"

웹 서비스 API를 사용하여 취소된 문서에 대한 액세스 권한 복원

Document Security API(웹 서비스)를 사용하여 해지된 문서에 대한 액세스 권한 복원:
  1. 프로젝트 파일 포함
    MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다. http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    AEM Forms localhost 를 호스팅하는 서버의 IP 주소로 대체합니다.
  2. Document Security Client API 개체를 만듭니다.
    • 기본 생성자를 사용하여 DocumentSecurityServiceClient 개체를 만듭니다.
    • 생성자를 사용하여 DocumentSecurityServiceClient.Endpoint.Address 개체를 System.ServiceModel.EndpointAddress 만듭니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예: http://localhost:8080/soap/services/RightsManagementService?WSDL .) 속성을 사용할 필요는 lc_version 없습니다. 이 속성은 서비스 참조를 만들 때 사용됩니다.)
    • 필드의 값을 System.ServiceModel.BasicHttpBinding 가져와 개체를 DocumentSecurityServiceClient.Endpoint.Binding 만듭니다. 반환 값을 다음으로 캐스팅합니다 BasicHttpBinding .
    • 개체 System.ServiceModel.BasicHttpBinding 필드를 (으)로 MessageEncoding 설정합니다 WSMessageEncoding.Mtom . 이 값을 사용하면 MTOM이 사용됩니다.
    • 다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
      • 필드에 AEM 양식 사용자 이름을 지정합니다 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName .
      • 해당 암호 값을 필드에 지정합니다 DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • 필드에 상수 값 HttpClientCredentialType.Basic 을 지정합니다 BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • 필드에 상수 값 BasicHttpSecurityMode.TransportCredentialOnly 을 지정합니다 BasicHttpBindingSecurity.Security.Mode .
  3. 취소된 PDF 문서의 라이선스 식별자를 검색합니다.
    • 생성자를 사용하여 BLOB 개체를 만듭니다. 이 BLOB 개체는 액세스가 복원된 폐지된 PDF 문서를 저장하는 데 사용됩니다.
    • 생성자를 호출하고 폐지된 PDF 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달하여 System.IO.FileStream 개체를 만듭니다.
    • 개체의 내용을 저장하는 바이트 배열을 System.IO.FileStream 만듭니다. 개체의 속성을 가져와 바이트 배열의 크기를 결정할 수 System.IO.FileStream Length 있습니다.
    • 개체의 메서드를 호출하고 바이트 배열, 시작 위치 및 읽을 스트림 길이를 전달하여 바이트 배열 System.IO.FileStream Read 을 스트림 데이터로 채웁니다.
    • 바이트 배열의 내용으로 해당 BLOB MTOM 필드를 할당하여 개체를 채웁니다.
  4. 취소된 PDF 문서에 대한 액세스 권한을 복원합니다.
    • 객체 메서드를 호출하고 해지된 문서를 나타내는 DocumentSecurityServiceClient getLicenseID BLOB 개체를 전달하여 해지된 문서의 라이선스 식별자 값을 검색합니다. 이 메서드는 라이선스 식별자를 나타내는 문자열 값을 반환합니다.
    • 해지된 PDF 문서에 대한 액세스 권한을 다시 DocumentSecurityServiceClient 부여하려면 개체의 unrevokeLicense 방법을 호출하고, 해지된 PDF 문서의 라이선스 식별자 값을 지정하는 문자열 값을 전달해야 DocumentSecurityServiceClient 합니다(개체 getLicenseId 방법의 반환 값 전달).
코드 예제
Document Security 서비스를 사용하는 코드 예제를 보려면 다음 빠른 시작을 참조하십시오.
  • "빠른 시작(MTOM): 웹 서비스 API를 사용하여 해지된 문서에 대한 액세스 권한 복원"
  • "빠른 시작(SwaRef): 웹 서비스 API를 사용하여 해지된 문서에 대한 액세스 권한 복원"
참고 항목

정책으로 보호된 PDF 문서 검사

Document Security Service API(Java 및 웹 서비스)를 사용하여 정책으로 보호된 PDF 문서를 검사할 수 있습니다. 정책으로 보호된 PDF 문서를 검사하면 정책으로 보호된 PDF 문서에 대한 정보가 반환됩니다. 예를 들어 문서의 보안을 유지하는 데 사용된 정책과 문서의 보안을 설정한 날짜를 결정할 수 있습니다.
LiveCycle 버전이 8.x 또는 이전 버전인 경우 이 작업을 수행할 수 없습니다. 정책으로 보호된 문서 검사에 대한 지원이 AEM Forms에 추가됩니다. LiveCycle 8.x 또는 이전 버전을 사용하여 정책으로 보호된 문서를 검사하려고 하면 예외가 발생합니다.
Document Security 서비스에 대한 자세한 내용은 AEM Forms에 대한 서비스 참조를 참조하십시오 .

단계 요약

정책으로 보호된 PDF 문서를 검사하려면 다음 단계를 수행하십시오.
  1. 프로젝트 파일 포함
  2. Document Security Client API 개체를 만듭니다.
  3. 정책으로 보호된 문서를 검색하여 검사할 수 있습니다.
  4. 정책으로 보호된 문서에 대한 정보를 얻습니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함할 수 있습니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
Document Security Client API 개체 만들기
프로그래밍 방식으로 Document Security 서비스 작업을 수행하려면 먼저 Document Security 서비스 클라이언트 개체를 만듭니다. Java API를 사용하는 경우 RightsManagementClient 개체를 만듭니다. Document Security 웹 서비스 API를 사용하는 경우 RightsManagementServiceService 개체를 만듭니다.
정책으로 보호된 문서를 검색하여 검사
정책으로 보호된 문서를 검사하려면 검색하십시오. 정책으로 보호되지 않거나 취소된 문서를 검사하려고 하면 예외가 발생합니다.
문서 검사
정책으로 보호된 문서를 검색한 후 검사할 수 있습니다.
정책으로 보호된 문서에 대한 정보 얻기
정책으로 보호된 PDF 문서를 검사한 후 이에 대한 정보를 얻을 수 있습니다. 예를 들어 문서의 보안에 사용되는 정책을 결정할 수 있습니다.
내 정책에 속하는 정책을 사용하여 문서를 보호한 다음 RMInspectResult.getPolicysetName 또는 null을 호출하면 RMInspectResult.getPolicysetId 반환됩니다.
정책 세트(내 정책 제외)에 포함된 정책을 사용하여 문서를 보호하는 경우, 올바른 문자열 RMInspectResult.getPolicysetName RMInspectResult.getPolicysetId 반환합니다.
참고 항목

Java API를 사용하여 정책으로 보호된 PDF 문서 검사

Document Security Service API(Java)를 사용하여 정책으로 보호된 PDF 문서를 검사합니다.
  1. 프로젝트 파일 포함
    Java 프로젝트의 클래스 경로에 adobe-rightsmanagement-client.jar와 같은 클라이언트 JAR 파일을 포함합니다. 이러한 파일의 위치에 대한 자세한 내용은 AEM Forms Java 라이브러리 파일 포함을 참조하십시오 .
  2. Document Security Client API 개체를 만듭니다.
    • 연결 속성을 포함하는 ServiceClientFactory 개체를 만듭니다. 연결 속성 설정을 참조하십시오 .
    • 생성자를 사용하여 개체를 RightsManagementClient 만들고 개체를 ServiceClientFactory 전달합니다.
  3. 정책으로 보호된 문서를 검색하여 검사할 수 있습니다.
    • 생성자를 사용하여 정책으로 보호된 PDF 문서를 나타내는 java.io.FileInputStream 개체를 만듭니다. PDF 문서의 위치를 지정하는 문자열 값을 전달합니다.
    • 생성자를 사용하여 개체를 com.adobe.idp.Document 만들고 개체를 java.io.FileInputStream 전달합니다.
  4. 문서를 검사합니다.
    • 개체 DocumentManager 의 메서드를 호출하여 RightsManagementClient 개체를 getDocumentManager 만듭니다.
    • 개체의 메서드를 호출하여 정책으로 보호된 문서 LicenseManager inspectDocument 검사합니다. 정책으로 보호된 PDF 문서가 포함된 com.adobe.idp.Document 개체를 전달합니다. 이 메서드는 정책으로 보호된 문서에 대한 정보를 포함하는 개체를 반환합니다. RMInspectResult
  5. 정책으로 보호된 문서에 대한 정보를 얻습니다.
    정책으로 보호된 문서에 대한 정보를 얻으려면 RMInspectResult 개체가 속한 적절한 방법을 불러옵니다. 예를 들어, 정책 이름을 검색하려면 RMInspectResult 개체의 getPolicyName 메서드를 호출합니다.
코드 예제
Document Security 서비스를 사용하는 코드 예제를 보려면 다음 빠른 시작을 참조하십시오.
  • "빠른 시작(SOAP 모드): Java API를 사용하여 정책으로 보호된 PDF 문서 검사"

웹 서비스 API를 사용하여 정책으로 보호된 PDF 문서 검사

Document Security Service API(웹 서비스)를 사용하여 정책으로 보호된 PDF 문서를 검사합니다.
  1. 프로젝트 파일 포함
    MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다. http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    AEM Forms localhost 를 호스팅하는 서버의 IP 주소로 대체합니다.
  2. Document Security Client API 개체를 만듭니다.
    • 기본 생성자를 사용하여 RightsManagementServiceClient 개체를 만듭니다.
    • 생성자를 사용하여 RightsManagementServiceClient.Endpoint.Address 개체를 System.ServiceModel.EndpointAddress 만듭니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예: http://localhost:8080/soap/services/RightsManagementService?WSDL .) 속성을 사용할 필요는 lc_version 없습니다. 이 속성은 서비스 참조를 만들 때 사용됩니다.)
    • 필드의 값을 System.ServiceModel.BasicHttpBinding 가져와 개체를 RightsManagementServiceClient.Endpoint.Binding 만듭니다. 반환 값을 다음으로 캐스팅합니다 BasicHttpBinding .
    • 개체 System.ServiceModel.BasicHttpBinding 필드를 (으)로 MessageEncoding 설정합니다 WSMessageEncoding.Mtom . 이 값을 사용하면 MTOM이 사용됩니다.
    • 다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
      • 필드에 AEM 양식 사용자 이름을 지정합니다 RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • 해당 암호 값을 필드에 지정합니다 RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • 필드에 상수 값 HttpClientCredentialType.Basic 을 지정합니다 BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • 필드에 상수 값 BasicHttpSecurityMode.TransportCredentialOnly 을 지정합니다 BasicHttpBindingSecurity.Security.Mode .
  3. 정책으로 보호된 문서를 검색하여 검사할 수 있습니다.
    • 생성자를 사용하여 BLOB 개체를 만듭니다. 이 BLOB 개체는 검사하기 위해 PDF 문서를 저장하는 데 사용됩니다.
    • 생성자를 호출하여 System.IO.FileStream 개체를 만듭니다. PDF 문서의 파일 위치와 파일을 여는 모드를 나타내는 문자열 값을 전달합니다.
    • 개체의 내용을 저장하는 바이트 배열을 System.IO.FileStream 만듭니다. 개체의 속성을 가져와 바이트 배열의 크기를 결정할 수 System.IO.FileStream Length 있습니다.
    • 개체의 메서드를 호출하여 바이트 배열을 스트림 데이터로 System.IO.FileStream 채웁니다 Read . 바이트 배열, 시작 위치 및 스트림 길이를 전달합니다.
    • 바이트 배열의 내용으로 해당 BLOB MTOM 필드를 할당하여 개체를 채웁니다.
  4. 문서를 검사합니다.
    개체의 메서드를 호출하여 정책으로 보호된 문서 RightsManagementServiceClient inspectDocument 검사합니다. 정책으로 보호된 PDF 문서가 포함된 BLOB 개체를 전달합니다. 이 메서드는 정책으로 보호된 문서에 대한 정보를 포함하는 개체를 반환합니다. RMInspectResult
  5. 정책으로 보호된 문서에 대한 정보를 얻습니다.
    정책으로 보호된 문서에 대한 정보를 얻으려면 RMInspectResult 개체에 속하는 해당 필드의 값을 가져옵니다. 예를 들어, 정책 이름을 검색하려면 RMInspectResult 개체 필드의 값을 policyName 가져옵니다.
코드 예제
Document Security 서비스를 사용하는 코드 예제를 보려면 다음 빠른 시작을 참조하십시오.
  • "빠른 시작(MTOM): 웹 서비스 API를 사용하여 정책으로 보호된 PDF 문서 검사"
  • "빠른 시작(SwaRef): 웹 서비스 API를 사용하여 정책으로 보호된 PDF 문서 검사"
참고 항목

워터마크 만들기

워터마크는 문서를 고유하게 식별하고 저작권 침해를 제어하여 문서의 보안을 보장합니다. 예를 들어 문서의 모든 페이지에 대해 기밀 상태를 나타내는 워터마크를 만들어 배치할 수 있습니다. 워터마크가 만들어지면 정책의 일부로 포함할 수 있습니다. 즉, 정책의 워터마크 속성을 새로 만든 워터마크로 설정할 수 있습니다. 워터마크가 포함된 정책을 문서에 적용하면 정책으로 보호된 문서에 워터마크가 나타납니다.
Document Security 관리 권한이 있는 사용자만 워터마크를 만들 수 있습니다. 즉, Document Security 서비스 클라이언트 개체를 만드는 데 필요한 연결 설정을 정의할 때 이러한 사용자를 지정해야 합니다.
Document Security 서비스에 대한 자세한 내용은 AEM Forms에 대한 서비스 참조를 참조하십시오 .

단계 요약

워터마크를 만들려면 다음 단계를 수행하십시오.
  1. 프로젝트 파일 포함
  2. Document Security Client API 개체를 만듭니다.
  3. 워터마크 특성을 설정합니다.
  4. Document Security 서비스에 워터마크를 등록하십시오.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함할 수 있습니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
Document Security Client API 개체 만들기
프로그래밍 방식으로 Document Security 서비스 작업을 수행하려면 먼저 Document Security 서비스 클라이언트 개체를 만들어야 합니다. Java API를 사용하는 경우 RightsManagementClient 개체를 만듭니다. Document Security 웹 서비스 API를 사용하는 경우 RightsManagementServiceService 개체를 만듭니다.
워터마크 특성 설정
새 워터마크를 만들려면 워터마크 속성을 설정해야 합니다. name 속성은 항상 정의해야 합니다. name 속성 외에도 다음 속성 중 하나 이상을 설정해야 합니다.
  • 사용자 지정 텍스트
  • 포함된 날짜
  • UserIdIncluded
  • 사용자 이름 포함
다음 표에는 웹 서비스를 사용하여 워터마크를 만들 때 필요한 키 및 값 쌍이 나와 있습니다.
키 이름
설명
WaterBackCmd:IS_USERNAME_ENABLED
문서를 여는 사용자의 사용자 이름이 워터마크의 일부인지 지정합니다.
참 또는 거짓
WaterBackCmd:IS_USERID_ENABLED
문서를 여는 사용자의 ID가 워터마크의 일부인지 여부를 지정합니다.
참 또는 거짓
WaterBackCmd:IS_CURRENTDATE_ENABLED
현재 날짜가 워터마크의 일부인지 지정합니다.
참 또는 거짓
WaterBackCmd:IS_CUSTOMTEXT_ENABLED
이 값이 true이면 사용자 지정 텍스트 값을 WaterBackCmd:SRCTEXT
참 또는 거짓
WaterBackCmd:OPACITY
워터마크의 불투명도를 지정합니다. 기본값이 지정되지 않은 경우 기본값은 0.5입니다.
0.0에서 1.0 사이의 값입니다.
WaterBackCmd:ROTATION
워터마크의 회전을 지정합니다. 기본값은 0도입니다.
0에서 359 사이의 값입니다.
WaterBackCmd:SCALE
이 값을 지정하면 이 값이 존재해야 WaterBackCmd:IS_SIZE_ENABLED 하며 값이 true여야 합니다. 이 속성을 지정하지 않으면 기본 동작이 페이지에 적용됩니다.
0.0보다 크고 1.0보다 작거나 같은 값.
WaterBackCmd:HORIZ_ALIGN
워터마크의 가로 정렬을 지정합니다. 기본값은 중심입니다.
왼쪽, 가운데 또는 오른쪽
WaterBackCmd:VERT_ALIGN
워터마크의 세로 정렬을 지정합니다. 기본값은 중심입니다.
위쪽, 가운데 또는 아래쪽
WaterBackCmd:IS_USE_BACKGROUND
워터마크가 배경인지 여부를 지정합니다. 기본값은 false입니다.
참 또는 거짓
WaterBackCmd:IS_SIZE_ENABLED
사용자 지정 비율이 지정된 경우 true입니다. 이 값이 true이면 SCALE도 지정해야 합니다. 이 값이 false이면 기본값은 페이지에 맞습니다.
참 또는 거짓
WaterBackCmd:SRCTEXT
워터마크의 사용자 지정 텍스트를 지정합니다. 이 값이 있는 경우 이 값이 존재해야 WaterBackCmd:IS_CUSTOMTEXT_ENABLED 하며 true로 설정되어야 합니다.
참 또는 거짓
모든 워터마크는 다음 속성 중 하나를 정의해야 합니다.
  • WaterBackCmd:IS_USERNAME_ENABLED
  • WaterBackCmd:IS_USERID_ENABLED
  • WaterBackCmd:IS_CURRENTDATE_ENABLED
  • WaterBackCmd:IS_CUSTOMTEXT_ENABLED
다른 모든 속성은 선택 사항입니다.
워터마크 등록
새 워터마크를 사용하려면 Document Security 서비스에 등록해야 합니다. 워터마크를 등록한 후 정책 내에서 사용할 수 있습니다.
참고 항목

Java API를 사용하여 워터마크 만들기

Document Security API(Java)를 사용하여 워터마크를 만듭니다.
  1. 프로젝트 파일 포함
    Java 프로젝트의 클래스 경로 adobe-rightsmanagement-client.jar 에 클라이언트 JAR 파일(예: )을 포함합니다.
  2. Document Security Client API 개체를 만듭니다.
    • 연결 속성을 포함하는 ServiceClientFactory 개체를 만듭니다.
    • 생성자를 사용하여 개체를 RightsManagementClient 만들고 개체를 ServiceClientFactory 전달합니다.
  3. 워터마크 속성 설정
    • 개체의 정적 Watermark 메서드를 호출하여 개체를 InfomodelObjectFactory 만듭니다 createWatermark . 이 메서드는 Watermark 개체를 반환합니다.
    • 객체의 메서드를 호출하고 정책 이름을 지정하는 문자열 값을 전달하여 워터마크의 이름 속성을 Watermark setName 설정합니다.
    • 개체의 메서드를 호출하고 전달하여 워터마크의 배경 속성을 Watermark 설정합니다 setBackground true . 이 속성을 설정하면 문서 배경에 워터마크가 나타납니다.
    • 객체의 메서드를 호출하고 워터마크의 텍스트를 나타내는 문자열 값을 전달하여 워터마크의 사용자 지정 텍스트 속성을 Watermark setCustomText 설정합니다.
    • 오브젝트의 방법을 호출하고 불투명도 수준을 지정하는 정수 값을 전달하여 워터마크의 불투명도 속성을 Watermark setOpacity 설정합니다. 값이 100이면 워터마크가 완전히 불투명하고 값이 0이면 워터마크가 완전히 투명함을 나타냅니다.
  4. 워터마크를 등록하십시오.
    • 개체 WatermarkManager 의 메서드를 호출하여 RightsManagementClient 개체를 getWatermarkManager 만듭니다. 이 메서드는 WatermarkManager 개체를 반환합니다.
    • 개체의 메서드를 호출하고 등록할 워터마크를 나타내는 WatermarkManager registerWatermark Watermark 개체를 전달하여 워터마크를 등록하십시오. 이 메서드는 워터마크의 식별 값을 나타내는 문자열 값을 반환합니다.
코드 예제
Document Security 서비스를 사용하는 코드 예제를 보려면 다음 빠른 시작을 참조하십시오.
  • "빠른 시작(SOAP 모드): Java API를 사용하여 워터마크 만들기"

웹 서비스 API를 사용하여 워터마크 만들기

Document Security API(웹 서비스)를 사용하여 워터마크를 만듭니다.
  1. Document Security Client API 개체를 만듭니다.
    MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다. http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    AEM Forms localhost 를 호스팅하는 서버의 IP 주소로 대체합니다.
  2. Document Security Client API 개체를 만듭니다.
    • 기본 생성자를 사용하여 RightsManagementServiceClient 개체를 만듭니다.
    • 생성자를 사용하여 RightsManagementServiceClient.Endpoint.Address 개체를 System.ServiceModel.EndpointAddress 만듭니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예: http://localhost:8080/soap/services/RightsManagementService?WSDL .) 속성을 사용할 필요는 lc_version 없습니다. 이 속성은 서비스 참조를 만들 때 사용됩니다.)
    • 필드의 값을 System.ServiceModel.BasicHttpBinding 가져와 개체를 RightsManagementServiceClient.Endpoint.Binding 만듭니다. 반환 값을 다음으로 캐스팅합니다 BasicHttpBinding .
    • 개체 System.ServiceModel.BasicHttpBinding 필드를 (으)로 MessageEncoding 설정합니다 WSMessageEncoding.Mtom . 이 값을 사용하면 MTOM이 사용됩니다.
    • 다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
      • 필드에 AEM 양식 사용자 이름을 지정합니다 RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • 해당 암호 값을 필드에 지정합니다 RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • 필드에 상수 값 HttpClientCredentialType.Basic 을 지정합니다 BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • 필드에 상수 값 BasicHttpSecurityMode.TransportCredentialOnly 을 지정합니다 BasicHttpBindingSecurity.Security.Mode .
  3. 워터마크 속성을 설정합니다.
    • 생성자를 호출하여 WatermarkSpec 개체를 WatermarkSpec 만듭니다.
    • 개체의 데이터 멤버에 문자열 값을 할당하여 워터마크 이름을 WatermarkSpec 설정합니다 name .
    • 개체의 데이터 멤버에 문자열 값을 할당하여 워터마크 id 속성을 WatermarkSpec 설정합니다 id .
    • 각 워터마크 속성을 설정하려면 별도의 MyMapOf_xsd_string_To_xsd_anyType_Item 개체를 만듭니다.
    • 개체의 데이터 멤버에 값을 할당하여 키 값 MyMapOf_xsd_string_To_xsd_anyType_Item key 설정합니다(예: WaterBackCmd:OPACITY) ).
    • 개체의 데이터 멤버(예:)에 값을 할당하여 값을 MyMapOf_xsd_string_To_xsd_anyType_Item value .25 설정합니다.
    • 개체를 MyArrayOf_xsd_anyType 만듭니다. 각 MyMapOf_xsd_string_To_xsd_anyType_Item 개체에 대해 MyArrayOf_xsd_anyType 개체의 Add 메서드를 호출합니다. 개체를 MyMapOf_xsd_string_To_xsd_anyType_Item 전달합니다.
    • 객체의 데이터 멤버 MyArrayOf_xsd_anyType WatermarkSpec 객체를 values 할당합니다.
  4. 워터마크를 등록하십시오.
    개체의 메서드를 호출하고 등록할 워터마크를 나타내는 RightsManagementServiceClient registerWatermark WatermarkSpec 개체를 전달하여 워터마크를 등록하십시오.
코드 예제
Document Security 서비스를 사용하는 코드 예제를 보려면 다음 빠른 시작을 참조하십시오.
  • "빠른 시작(MTOM): 웹 서비스 API를 사용하여 워터마크 만들기"
  • "빠른 시작(SwaRef): 웹 서비스 API를 사용하여 워터마크 만들기"
참고 항목

워터마크 수정

Document Security Java API 또는 웹 서비스 API를 사용하여 기존 워터마크를 수정할 수 있습니다. 기존 워터마크를 변경하려면 해당 워터마크를 검색하고 속성을 수정한 다음 서버에서 업데이트합니다. 예를 들어 워터마크를 검색하고 불투명도 속성을 수정한다고 가정합니다. 변경 사항이 적용되기 전에 워터마크를 업데이트해야 합니다.
워터마크를 수정하면 워터마크가 적용된 이후 문서에 변경 사항이 적용됩니다. 즉, 워터마크가 포함된 기존 PDF 문서에는 영향을 주지 않습니다.
Document Security 관리 권한이 있는 사용자만 워터마크를 수정할 수 있습니다. 즉, Document Security 서비스 클라이언트 개체를 만드는 데 필요한 연결 설정을 정의할 때 이러한 사용자를 지정해야 합니다.
Document Security 서비스에 대한 자세한 내용은 AEM Forms에 대한 서비스 참조를 참조하십시오 .

단계 요약

워터마크를 수정하려면 다음 단계를 수행하십시오.
  1. 프로젝트 파일 포함
  2. Document Security Client API 개체를 만듭니다.
  3. 수정할 워터마크를 검색합니다.
  4. 워터마크 특성을 설정합니다.
  5. 워터마크를 업데이트합니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함할 수 있습니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
Document Security Client API 개체 만들기
프로그래밍 방식으로 Document Security 서비스 작업을 수행하려면 먼저 Document Security 서비스 클라이언트 개체를 만들어야 합니다. Java API를 사용하는 경우 DocumentSecurityClient 개체를 만듭니다. Document Security 웹 서비스 API를 사용하는 경우 DocumentSecurityServiceService 개체를 만듭니다.
수정할 워터마크 검색
워터마크를 수정하려면 기존 워터마크를 검색해야 합니다. 이름을 지정하거나 해당 식별자 값을 지정하여 워터마크를 검색할 수 있습니다.
워터마크 특성 설정
기존 워터마크를 수정하려면 하나 이상의 워터마크 속성의 값을 변경합니다. 웹 서비스를 사용하여 프로그래밍 방식으로 워터마크를 업데이트할 때는 값이 변경되지 않더라도 원래 설정된 모든 속성을 설정해야 합니다. 예를 들어 다음과 같은 워터마크 속성이 설정되었다고 가정합니다. WaterBackCmd:IS_USERID_ENABLED , WaterBackCmd:IS_CUSTOMTEXT_ENABLED , WaterBackCmd:OPACITY WaterBackCmd:SRCTEXT 를 참조하십시오. 수정하려는 유일한 속성은 WaterBackCmd:OPACITY 아니지만 다른 값은 설정해야 합니다.
Java API를 사용하여 워터마크를 수정할 때 모든 속성을 지정할 필요가 없습니다. 수정할 워터마크 속성을 설정합니다.
워터마크 속성 이름에 대한 자세한 내용은 워터마크 만들기를 참조하십시오 .
워터마크 업데이트
워터마크 속성을 수정한 후 워터마크를 업데이트해야 합니다.
참고 항목

Java API를 사용하여 워터마크 수정

Document Security API(Java)를 사용하여 워터마크를 수정합니다.
  1. 프로젝트 파일 포함
    Java 프로젝트의 클래스 경로에 adobe-rightsmanagement-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
  2. Document Security Client API 개체를 만듭니다.
    • 연결 속성을 포함하는 ServiceClientFactory 개체를 만듭니다.
    • 생성자를 사용하여 개체를 DocumentSecurityClient 만들고 개체를 ServiceClientFactory 전달합니다.
  3. 수정할 워터마크를 검색합니다.
    개체 WatermarkManager DocumentSecurityClient getWatermarkManager 의 메서드를 호출하여 개체를 만들고 워터마크 이름을 지정하는 문자열 값을 전달합니다. 이 메서드는 수정할 워터마크를 나타내는 Watermark 개체를 반환합니다.
  4. 워터마크 속성을 설정합니다.
    오브젝트의 방법을 호출하고 불투명도 수준을 지정하는 정수 값을 전달하여 워터마크의 불투명도 속성을 Watermark setOpacity 설정합니다. 값이 100이면 워터마크가 완전히 불투명하고 값이 0이면 워터마크가 완전히 투명함을 나타냅니다.
    이 예에서는 opacity 속성만 수정합니다.
  5. 워터마크를 업데이트합니다.
    • 객체의 메서드를 호출하여 워터마크를 WatermarkManager 업데이트하고 속성이 수정된 updateWatermark Watermark 개체를 전달합니다.
코드 예제
Document Security 서비스를 사용하는 코드 예제를 보려면 빠른 시작(SOAP 모드)을 참조하십시오. Java API 섹션을 사용하여 워터마크 수정

웹 서비스 API를 사용하여 워터마크 수정

Document Security API(웹 서비스)를 사용하여 워터마크를 수정합니다.
  1. 프로젝트 파일 포함
    MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다. http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    AEM Forms localhost 를 호스팅하는 서버의 IP 주소로 대체합니다.
  2. Document Security Client API 개체를 만듭니다.
    • 기본 생성자를 사용하여 DocumentSecurityServiceClient 개체를 만듭니다.
    • 생성자를 사용하여 RightsManagementServiceClient.Endpoint.Address 개체를 System.ServiceModel.EndpointAddress 만듭니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예: http://localhost:8080/soap/services/DocumentSecurityService?WSDL .) 속성을 사용할 필요는 lc_version 없습니다. 이 속성은 서비스 참조를 만들 때 사용됩니다.)
    • 필드의 값을 System.ServiceModel.BasicHttpBinding 가져와 개체를 DocumentSecurityServiceClient.Endpoint.Binding 만듭니다. 반환 값을 다음으로 캐스팅합니다 BasicHttpBinding .
    • 개체 System.ServiceModel.BasicHttpBinding 필드를 (으)로 MessageEncoding 설정합니다 WSMessageEncoding.Mtom . 이 값을 사용하면 MTOM이 사용됩니다.
    • 다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
      • 필드에 AEM 양식 사용자 이름을 지정합니다 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName .
      • 해당 암호 값을 필드에 지정합니다 DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • 필드에 상수 값 HttpClientCredentialType.Basic 을 지정합니다 BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • 필드에 상수 값 BasicHttpSecurityMode.TransportCredentialOnly 을 지정합니다 BasicHttpBindingSecurity.Security.Mode .
  3. 수정할 워터마크를 검색합니다.
    객체의 메서드를 호출하여 수정할 워터마크를 DocumentSecurityServiceClient 검색합니다 getWatermarkByName . 워터마크 이름을 지정하는 문자열 값을 전달합니다. 이 메서드는 수정할 워터마크를 나타내는 WatermarkSpec 개체를 반환합니다.
  4. 워터마크 속성을 설정합니다.
    • 각 워터마크 속성을 업데이트하려면 별도의 MyMapOf_xsd_string_To_xsd_anyType_Item 개체를 만듭니다.
    • 개체의 데이터 멤버에 값을 할당하여 키 값 MyMapOf_xsd_string_To_xsd_anyType_Item key 설정합니다(예: WaterBackCmd:OPACITY) ).
    • 개체의 데이터 멤버(예:)에 값을 할당하여 값을 MyMapOf_xsd_string_To_xsd_anyType_Item value .50 설정합니다.
    • 개체를 MyArrayOf_xsd_anyType 만듭니다. 각 MyMapOf_xsd_string_To_xsd_anyType_Item 개체에 대해 MyArrayOf_xsd_anyType 개체의 Add 메서드를 호출합니다. 개체를 MyMapOf_xsd_string_To_xsd_anyType_Item 전달합니다.
    • 객체의 데이터 멤버 MyArrayOf_xsd_anyType WatermarkSpec 객체를 values 할당합니다.
  5. 워터마크를 업데이트합니다.
    객체의 메서드를 호출하고 수정할 워터마크를 나타내는 DocumentSecurityServiceClient updateWatermark WatermarkSpec 객체를 전달하여 워터마크를 업데이트합니다.
코드 예제
Document Security 서비스를 사용하는 코드 예제를 보려면 다음 빠른 시작을 참조하십시오.
  • "빠른 시작(MTOM): 웹 서비스 API를 사용하여 워터마크 수정"

이벤트 검색

Rights Management 서비스는 문서에 정책 적용, 정책으로 보호된 문서 열기, 문서에 대한 액세스 취소 등 특정 작업을 추적합니다. 이벤트 감사는 Rights Management 서비스에 대해 활성화되어야 하며 그렇지 않으면 이벤트가 추적되지 않습니다.
이벤트는 다음 카테고리 중 하나로 분류됩니다.
  • 관리자 이벤트는 새 관리자 계정 만들기와 같은 관리자와 관련된 작업입니다.
  • 문서 이벤트는 정책으로 보호된 문서를 닫는 등 문서와 관련된 작업입니다.
  • 정책 이벤트는 새 정책 만들기와 같은 정책과 관련된 작업입니다.
  • 서비스 이벤트는 사용자 디렉토리와 동기화하는 것과 같은 Rights Management 서비스와 관련된 작업입니다.
Rights Management Java API 또는 웹 서비스 API를 사용하여 특정 이벤트를 검색할 수 있습니다. 이벤트를 검색하여 특정 이벤트의 로그 파일 만들기와 같은 작업을 수행할 수 있습니다.
Rights Management 서비스에 대한 자세한 내용은 AEM Forms에 대한 서비스 참조를 참조하십시오 .

단계 요약

Rights Management 이벤트를 검색하려면 다음 단계를 수행하십시오.
  1. 프로젝트 파일 포함
  2. Rights Management 클라이언트 API 개체를 만듭니다.
  3. 검색할 이벤트를 지정합니다.
  4. 이벤트를 검색합니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함할 수 있습니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
Rights Management 클라이언트 API 개체 만들기
Rights Management 서비스 작업을 프로그래밍 방식으로 수행하려면 먼저 Rights Management 서비스 클라이언트 개체를 만들어야 합니다. Java API를 사용하는 경우 DocumentSecurityClient 개체를 만듭니다. Rights Management 웹 서비스 API를 사용하는 경우 DocumentSecurityServiceService 개체를 만듭니다.
검색할 이벤트 지정
검색할 이벤트를 지정해야 합니다. 예를 들어 새 정책을 만들 때 발생하는 정책 만들기 이벤트를 검색할 수 있습니다.
이벤트 검색
검색할 이벤트를 지정한 후 Rights Management Java API 또는 Rights Management 웹 서비스 API를 사용하여 이벤트를 검색할 수 있습니다.
참고 항목

Java API를 사용하여 이벤트 검색

Rights Management API(Java)를 사용하여 이벤트를 검색합니다.
  1. 프로젝트 파일 포함
    Java 프로젝트의 클래스 경로에 adobe-rightsmanagement-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
  2. Rights Management 클라이언트 API 개체 만들기
    생성자를 사용하여 DocumentSecurityClient 객체를 만들고 연결 속성이 포함된 ServiceClientFactory 객체를 전달합니다.
  3. 검색할 이벤트 지정
    • 개체 EventManager 의 메서드를 호출하여 DocumentSecurityClient 개체를 getEventManager 만듭니다. 이 메서드는 EventManager 개체를 반환합니다.
    • 생성자를 호출하여 EventSearchFilter 개체를 만듭니다.
    • 개체의 메서드를 호출하고 검색할 이벤트를 나타내는 EventSearchFilter setEventCode EventManager 클래스에 속하는 정적 데이터 멤버를 전달하여 검색할 이벤트를 지정합니다. 예를 들어 정책 만들기 이벤트를 검색하려면 전달하십시오 EventManager.POLICY_CREATE_EVENT .
    객체 메서드를 호출하여 추가 검색 기준을 정의할 수 EventSearchFilter 있습니다. 예를 들어, 메서드를 호출하여 이벤트와 연관된 사용자를 지정합니다 setUserName .
  4. 이벤트 검색
    객체의 메서드를 호출하고 이벤트 검색 기준을 정의하는 EventManager searchForEvents EventSearchFilter 객체를 전달하여 이벤트를 검색합니다. 이 메서드는 Event 개체 배열을 반환합니다.
코드 예제
Rights Management 서비스를 사용하는 코드 예제를 보려면 다음 빠른 시작을 참조하십시오.
  • "빠른 시작(SOAP): Java API를 사용하여 이벤트 검색"

웹 서비스 API를 사용하여 이벤트 검색

Rights Management API(웹 서비스)를 사용하여 이벤트를 검색합니다.
  1. 프로젝트 파일 포함
    MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다. http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    AEM Forms localhost 를 호스팅하는 서버의 IP 주소로 대체합니다.
  2. Rights Management 클라이언트 API 개체 만들기
    • 기본 생성자를 사용하여 DocumentSecurityServiceClient 개체를 만듭니다.
    • 생성자를 사용하여 DocumentSecurityServiceClient.Endpoint.Address 개체를 System.ServiceModel.EndpointAddress 만듭니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예: http://localhost:8080/soap/services/RightsManagementService?WSDL .) 속성을 사용할 필요는 lc_version 없습니다. 이 속성은 서비스 참조를 만들 때 사용됩니다.)
    • 필드의 값을 System.ServiceModel.BasicHttpBinding 가져와 개체를 DocumentSecurityServiceClient.Endpoint.Binding 만듭니다. 반환 값을 다음으로 캐스팅합니다 BasicHttpBinding .
    • 개체 System.ServiceModel.BasicHttpBinding 필드를 (으)로 MessageEncoding 설정합니다 WSMessageEncoding.Mtom . 이 값을 사용하면 MTOM이 사용됩니다.
    • 다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
      • 필드에 AEM 양식 사용자 이름을 지정합니다 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName .
      • 해당 암호 값을 필드에 지정합니다 DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • 필드에 상수 값 HttpClientCredentialType.Basic 을 지정합니다 BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • 필드에 상수 값 BasicHttpSecurityMode.TransportCredentialOnly 을 지정합니다 BasicHttpBindingSecurity.Security.Mode .
  3. 검색할 이벤트 지정
    • 생성자를 사용하여 EventSpec 개체를 만듭니다.
    • 이벤트의 날짜 범위 시작을 나타내는 EventSpec firstTime.date DataTime 인스턴스로 개체의 데이터 멤버를 설정하여 이벤트가 발생한 기간의 시작을 지정합니다.
    • 객체의 데이터 멤버 true 에 값을 EventSpec 할당합니다 firstTime.dateSpecified .
    • 이벤트가 발생한 날짜 범위의 끝을 나타내는 인스턴스로 EventSpec 개체의 lastTime.date 데이터 멤버를 설정하여 이벤트가 발생한 기간의 끝 DataTime 을 지정합니다.
    • 객체의 데이터 멤버 true 에 값을 EventSpec 할당합니다 lastTime.dateSpecified .
    • 개체의 데이터 멤버에 문자열 값을 할당하여 검색할 이벤트를 EventSpec 설정합니다 eventCode . 다음 표에는 이 속성에 지정할 수 있는 숫자 값이 나와 있습니다.
    이벤트 유형
    ALL_EVENTS
    999
    USER_CHANGE_PASSWORD_EVENT
    1000
    USER_REGISTER_EVENT
    1001
    USER_PREREGISTER_EVENT
    1002
    USER_ACTIVATE_EVENT
    1003
    USER_DEACTIVATE_EVENT
    1004
    USER_AUTHENTICATE_EVENT
    1005
    USER_AUTHENTICATE_DENY_EVENT
    1006
    USER_ACCOUNT_LOCK_EVENT
    1007
    USER_DELETE_EVENT
    1008
    USER_UPDATE_PROFILE_EVENT
    1009
    DOCUMENT_VIEW_EVENT
    2000
    DOCUMENT_PRINT_LOW_EVENT
    2001
    DOCUMENT_PRINT_HIGH_EVENT
    2002
    DOCUMENT_SIGN_EVENT
    2003
    DOCUMENT_ADD_ANNOTATION_EVENT
    2004
    DOCUMENT_FORM_FILL_EVENT
    2005
    DOCUMENT_CLOSE_EVENT
    2006
    DOCUMENT_MODIFY_EVENT
    2007
    DOCUMENT_CHANGE_SECURITY_HANDLER_EVENT
    2008
    DOCUMENT_SWITCH_POLICY_EVENT
    2009
    DOCUMENT_REVOKE_EVENT
    2010
    $1
    2011
    DOCUMENT_SECURE_EVENT
    2012
    DOCUMENT_UNKNOWN_CLIENT_EVENT
    2013
    DOCUMENT_CHANGE_REVOKE_URL_EVENT
    2014
    POLICY_CHANGE_EVENT
    3000
    POLICY_ENABLE_EVENT
    3001
    POLICY_DISABLE_EVENT
    3002
    POLICY_CREATE_EVENT
    3003
    POLICY_DELETE_EVENT
    3004
    POLICY_CHANGE_OWNER_EVENT
    3005
    SERVER_CLIENT_SYNC_EVENT
    4000
    SERVER_SYNC_DIR_INFO_EVENT
    4001
    SERVER_SYNC_DIR_COMPLETE_EVENT
    4002
    SERVER_VERSION_MISMATCH_EVENT
    4003
    SERVER_CONFIG_CHANGE_EVENT
    4004
    SERVER_ENABLE_OFFLINE_ACCESS_EVENT
    4005
    ADMIN_ADD_EVENT
    5000
    ADMIN_DELETE_EVENT
    5001
    ADMIN_EDIT_EVENT
    5002
    ADMIN_ACTIVATE_EVENT
    5003
    ADMIN_DEACTIVATE_EVENT
    5004
    ERROR_DIRECTORY_SERVICE_EVENT
    6000
    CREATED_POLICYSET_EVENT
    7000
    DELETED_POLICYSET_EVENT
    7001
    MODIFIED_POLICYSET_EVENT
    7002
  4. 이벤트 검색
    개체의 DocumentSecurityServiceClient 메서드를 호출하고 검색할 이벤트와 최대 결과 수를 나타내는 searchForEvents EventSpec 개체를 전달하여 이벤트를 검색합니다. 이 메서드는 각 요소가 인스턴스인 MyArrayOf_xsd_anyType 컬렉션을 AuditSpec 반환합니다. 인스턴스를 사용하여 AuditSpec 발생한 시간과 같은 이벤트에 대한 정보를 얻을 수 있습니다. 인스턴스에는 이 정보를 지정하는 AuditSpec timestamp 데이터 멤버가 포함되어 있습니다.
코드 예제
Rights Management 서비스를 사용하는 코드 예제를 보려면 다음 빠른 시작을 참조하십시오.
  • "빠른 시작(MTOM): 웹 서비스 API를 사용하여 이벤트 검색"
  • "빠른 시작(SwaRef): 웹 서비스 API를 사용하여 이벤트 검색"
참고 항목

Word 문서에 정책 적용

PDF 문서 외에도 Rights Management 서비스는 Microsoft Word 문서(DOC 파일) 및 기타 Microsoft Office 파일 포맷과 같은 추가 문서 형식을 지원합니다. 예를 들어 Word 문서에 정책을 적용하여 보안을 유지할 수 있습니다. Word 문서에 정책을 적용하면 문서에 대한 액세스를 제한합니다. 문서에 정책으로 이미 보호된 경우에는 정책을 적용할 수 없습니다.
정책으로 보호된 Word 문서를 배포한 후 이를 모니터링할 수 있습니다. 즉, 문서가 어떻게 사용되고 있으며 누가 문서를 사용하고 있는지 알 수 있습니다. 예를 들어 문서를 연 시간을 확인할 수 있습니다.
Document Security 서비스에 대한 자세한 내용은 AEM Forms에 대한 서비스 참조를 참조하십시오 .

단계 요약

Word 문서에 정책을 적용하려면 다음 단계를 수행하십시오.
  1. 프로젝트 파일 포함
  2. Document Security Client API 개체를 만듭니다.
  3. 정책이 적용되는 Word 문서를 검색합니다.
  4. Word 문서에 기존 정책을 적용합니다.
  5. 정책으로 보호된 Word 문서를 저장합니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함할 수 있습니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
Document Security Client API 개체 만들기
프로그래밍 방식으로 Document Security 서비스 작업을 수행하려면 먼저 Document Security 서비스 클라이언트 개체를 만들어야 합니다.
Word 문서 검색
정책을 적용하려면 Word 문서를 검색해야 합니다. Word 문서에 정책을 적용하면 문서를 사용할 때 사용자가 제한됩니다. 예를 들어 정책에서 오프라인 상태에서 문서를 열 수 있도록 하지 않으면 사용자는 온라인 상태여야 문서를 열 수 있습니다.
Word 문서에 기존 정책 적용
Word 문서에 정책을 적용하려면 기존 정책을 참조하고 정책이 속하는 정책 세트를 지정해야 합니다. 연결 속성을 설정하는 사용자는 지정된 정책에 액세스할 수 있어야 합니다. 그렇지 않으면 예외가 발생합니다.
Word 문서 저장
Document Security 서비스가 Word 문서에 정책을 적용한 후 정책으로 보호된 Word 문서를 DOC 파일로 저장할 수 있습니다.
참고 항목

Java API를 사용하여 Word 문서에 정책 적용

Document Security API(Java)를 사용하여 Word 문서에 정책을 적용합니다.
  1. 프로젝트 파일 포함
    Java 프로젝트의 클래스 경로에 adobe-rightsmanagement-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
  2. Document Security Client API 개체를 만듭니다.
    • 연결 속성을 포함하는 ServiceClientFactory 개체를 만듭니다.
    • 생성자를 사용하여 개체를 DocumentSecurityClient 만들고 개체를 ServiceClientFactory 전달합니다.
  3. Word 문서 검색
    • 생성자를 사용하여 Word 문서를 나타내는 java.io.FileInputStream 개체를 만들고 Word 문서의 위치를 지정하는 문자열 값을 전달합니다.
    • 생성자를 사용하여 개체를 com.adobe.idp.Document 만들고 개체를 java.io.FileInputStream 전달합니다.
  4. Word 문서에 기존 정책을 적용합니다.
    • 개체 DocumentManager 의 메서드를 호출하여 DocumentSecurityClient 개체를 getDocumentManager 만듭니다.
    • 개체의 메서드를 호출하고 다음 값을 전달하여 Word 문서에 정책을 DocumentManager protectDocument 적용합니다.
      • 정책이 적용되는 Word 문서가 들어 있는 com.adobe.idp.Document 개체입니다.
      • 문서의 이름을 지정하는 문자열 값.
      • 정책이 속하는 정책 세트의 이름을 지정하는 문자열 값. 정책 null 세트가 사용되는 결과를 MyPolicies 지정할 수 있습니다.
      • 정책 이름을 지정하는 문자열 값.
      • 문서 게시자인 사용자의 사용자 관리자 도메인 이름을 나타내는 문자열 값입니다. 이 매개 변수 값은 선택 사항이며 null일 수 있습니다(이 매개 변수가 null이면 다음 매개 변수 값은 null이어야 함).
      • 문서의 게시자인 사용자 관리자 사용자의 정식 이름을 나타내는 문자열 값입니다. 이 매개 변수 값은 선택 사항이며 null 될 수 있습니다(이 매개 변수가 null 있는 경우 이전 매개 변수 값은 null 되어야 함).
      • MS Office 템플릿을 선택하는 데 사용되는 로케일을 나타내는 com.adobe.livecycle.rightsmanagement.Locale 로케일입니다. 이 매개 변수 값은 선택 사항이며 지정할 수 있습니다 null .
      protectDocument 메서드는 정책으로 보호된 Word 문서를 포함하는 RMSecureDocumentResult 개체를 반환합니다.
  5. Word 문서를 저장합니다.
    • 개체의 RMSecureDocumentResult getProtectedDoc 메서드를 호출하여 정책으로 보호된 Word 문서를 가져옵니다. 이 메서드는 com.adobe.idp.Document 개체를 반환합니다.
    • 객체를 java.io.File 만들고 파일 확장자가 DOC인지 확인합니다.
    • 객체의 메서드를 호출하여 com.adobe.idp.Document 객체의 내용을 파일에 복사합니다(메서드에서 반환된 copyToFile 객체를 Document Document getProtectedDoc 사용해야 함).
코드 예제
Document Security 서비스를 사용하는 코드 예제를 보려면 다음 빠른 시작을 참조하십시오.
  • "빠른 시작(SOAP 모드): Java API를 사용하여 Word 문서에 정책 적용"

웹 서비스 API를 사용하여 Word 문서에 정책 적용

Document Security API(웹 서비스)를 사용하여 Word 문서에 정책을 적용합니다.
  1. 프로젝트 파일 포함
    MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다. http://localhost:8080/soap/services/DocumentSecurityService?WSDL&lc_version=9.0.1 .
    AEM Forms localhost 를 호스팅하는 서버의 IP 주소로 대체합니다.
  2. Document Security Client API 개체를 만듭니다.
    • 기본 생성자를 사용하여 DocumentSecurityServiceClient 개체를 만듭니다.
    • 생성자를 사용하여 DocumentSecurityServiceClient.Endpoint.Address 개체를 System.ServiceModel.EndpointAddress 만듭니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예: http://localhost:8080/soap/services/DocumentSecurityService?WSDL .) 속성을 사용할 필요는 lc_version 없습니다. 이 속성은 서비스 참조를 만들 때 사용됩니다.)
    • 필드의 값을 System.ServiceModel.BasicHttpBinding 가져와 개체를 DocumentSecurityServiceClient.Endpoint.Binding 만듭니다. 반환 값을 다음으로 캐스팅합니다 BasicHttpBinding .
    • 개체 System.ServiceModel.BasicHttpBinding 필드를 (으)로 MessageEncoding 설정합니다 WSMessageEncoding.Mtom . 이 값을 사용하면 MTOM이 사용됩니다.
    • 다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
      • 필드에 AEM 양식 사용자 이름을 지정합니다 DocumentSecurityServiceClient.ClientCredentials.UserName.UserName .
      • 해당 암호 값을 필드에 지정합니다 DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • 필드에 상수 값 HttpClientCredentialType.Basic 을 지정합니다 BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • 필드에 상수 값 BasicHttpSecurityMode.TransportCredentialOnly 을 지정합니다 BasicHttpBindingSecurity.Security.Mode .
  3. Word 문서 검색
    • 생성자를 사용하여 BLOB 개체를 만듭니다. 이 BLOB 개체는 정책이 적용되는 Word 문서를 저장하는 데 사용됩니다.
    • 생성자를 호출하고 Word 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달하여 System.IO.FileStream 개체를 만듭니다.
    • 개체의 내용을 저장하는 바이트 배열을 System.IO.FileStream 만듭니다. 개체의 속성을 가져와 바이트 배열 크기를 System.IO.FileStream 결정합니다 Length .
    • 개체의 메서드를 호출하여 바이트 배열을 스트림 데이터로 System.IO.FileStream 채웁니다 Read . 바이트 배열, 시작 위치 및 스트림 길이를 전달합니다.
    • 바이트 배열의 내용으로 해당 BLOB MTOM 필드를 할당하여 개체를 채웁니다.
  4. Word 문서에 기존 정책을 적용합니다.
    개체의 메서드를 호출하고 다음 값을 전달하여 Word 문서에 정책을 DocumentSecurityServiceClient protectDocument 적용합니다.
    • 정책이 적용되는 Word 문서가 들어 있는 BLOB 개체입니다.
    • 문서의 이름을 지정하는 문자열 값.
    • 정책이 속하는 정책 세트의 이름을 지정하는 문자열 값. 정책 null 세트가 사용되는 결과를 MyPolicies 지정할 수 있습니다.
    • 정책 이름을 지정하는 문자열 값.
    • 문서 게시자인 사용자의 사용자 관리자 도메인 이름을 나타내는 문자열 값입니다. 이 매개 변수 값은 선택 사항이며 null일 수 있습니다(이 매개 변수가 null이면 다음 매개 변수 값이 있어야 null 합니다).
    • 문서의 게시자인 사용자 관리자 사용자의 정식 이름을 나타내는 문자열 값입니다. 이 매개 변수 값은 선택 사항이며 null일 수 있습니다(이 매개 변수가 null이면 이전 매개 변수 값이 null 되어야 합니다).
    • 로케일 값(예:)을 지정하는 RMLocale RMLocale.en 값입니다.
    • 정책 식별자 값을 저장하는 데 사용되는 문자열 출력 매개 변수입니다.
    • 정책으로 보호된 식별자 값을 저장하는 데 사용되는 문자열 출력 매개 변수입니다.
    • MIME 형식을 저장하는 데 사용되는 문자열 출력 매개 application/doc 변수입니다.
    protectDocument 메서드는 정책으로 보호된 Word 문서를 포함하는 BLOB 개체를 반환합니다.
  5. Word 문서를 저장합니다.
    • 생성자를 호출하고 정책으로 보호된 Word 문서의 파일 위치를 나타내는 문자열 값을 전달하여 System.IO.FileStream 개체를 만듭니다.
    • 메서드에서 반환된 개체의 데이터 내용을 저장하는 바이트 배열을 BLOB protectDocument 만듭니다. 개체 데이터 멤버의 값을 가져와 바이트 배열 BLOB MTOM 채웁니다.
    • 생성자를 호출하고 개체를 전달하여 System.IO.BinaryWriter 개체를 System.IO.FileStream 만듭니다.
    • 개체의 메서드를 호출하고 바이트 배열을 전달하여 바이트 배열의 내용을 Word 파일 System.IO.BinaryWriter Write 에 씁니다.
코드 예제
Document Security 서비스를 사용하는 코드 예제를 보려면 다음 빠른 시작을 참조하십시오.
  • "빠른 시작(MTOM): 웹 서비스 API를 사용하여 Word 문서에 정책 적용"

Word 문서에서 정책 제거

정책으로 보호된 Word 문서에서 정책을 제거하여 문서에서 보안을 제거할 수 있습니다. 즉, 정책으로 문서를 보호하지 않으려는 경우 정책으로 보호된 Word 문서를 최신 정책으로 업데이트하려면 정책을 제거하고 업데이트된 정책을 추가하는 대신 정책을 전환하는 것이 더 효율적입니다.
Document Security 서비스에 대한 자세한 내용은 AEM Forms에 대한 서비스 참조를 참조하십시오 .

단계 요약

정책으로 보호된 Word 문서에서 정책을 제거하려면 다음 단계를 수행하십시오.
  1. 프로젝트 파일 포함
  2. Document Security Client API 개체를 만듭니다.
  3. 정책으로 보호된 Word 문서를 검색합니다.
  4. Word 문서에서 정책을 제거합니다.
  5. 비보안 Word 문서 저장
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함할 수 있습니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
Document Security Client API 개체 만들기
프로그래밍 방식으로 Document Security 서비스 작업을 수행하려면 먼저 Document Security 서비스 클라이언트 개체를 만듭니다.
정책으로 보호된 Word 문서 검색
정책을 제거하려면 정책으로 보호된 Word 문서를 검색해야 합니다. 정책으로 보호되지 않은 Word 문서에서 정책을 제거하려고 하면 예외가 발생합니다.
Word 문서에서 정책 제거
관리자가 연결 설정에 지정되어 있는 경우 정책으로 보호된 Word 문서에서 정책을 제거할 수 있습니다. 그렇지 않은 경우 Word 문서에서 정책을 제거하려면 문서 보안에 사용된 정책에 SWITCH_POLICY 권한이 포함되어야 합니다. 또한 AEM Forms 연결 설정에 지정된 사용자에게도 해당 권한이 있어야 합니다. 그렇지 않으면 예외가 throw됩니다.
비보안 Word 문서 저장
Document Security 서비스가 Word 문서에서 정책을 제거한 후 비보안 Word 문서를 DOC 파일로 저장할 수 있습니다.
참고 항목

Java API를 사용하여 Word 문서에서 정책 제거

Document Security API(Java)를 사용하여 정책으로 보호된 Word 문서에서 정책을 제거합니다.
  1. 프로젝트 파일 포함
    Java 프로젝트의 클래스 경로에 adobe-rightsmanagement-client.jar와 같은 클라이언트 JAR 파일을 포함합니다.
  2. Document Security Client API 개체 만들기
    • 연결 속성을 포함하는 ServiceClientFactory 개체를 만듭니다.
    • 생성자를 사용하여 개체를 RightsManagementClient 만들고 개체를 ServiceClientFactory 전달합니다.
  3. 정책으로 보호된 Word 문서 검색
    • 생성자를 사용하고 Word 문서의 위치를 지정하는 문자열 값을 전달하여 정책으로 보호된 Word 문서를 나타내는 java.io.FileInputStream 개체를 만듭니다.
    • 생성자를 사용하여 개체를 com.adobe.idp.Document 만들고 개체를 java.io.FileInputStream 전달합니다.
  4. Word 문서에서 정책 제거
    • 개체 DocumentManager 의 메서드를 호출하여 RightsManagementClient 개체를 getDocumentManager 만듭니다.
    • 개체의 메서드를 호출하고 정책으로 보호된 Word 문서를 포함하는 DocumentManager removeSecurity com.adobe.idp.Document 개체를 전달하여 Word 문서에서 정책을 제거합니다. 이 메서드는 비보안 Word 문서를 포함하는 com.adobe.idp.Document 개체를 반환합니다.
  5. 비보안 Word 문서 저장
    • 객체를 java.io.File 만들고 파일 확장자가 DOC인지 확인합니다.
    • 객체의 메서드를 호출하여 Document 객체의 내용을 파일에 복사합니다(메서드에서 반환된 copyToFile 객체를 Document Document removeSecurity 사용해야 함).
코드 예제
Document Security 서비스를 사용하는 코드 예제를 보려면 다음 빠른 시작을 참조하십시오.
  • "빠른 시작(SOAP 모드): Java API를 사용하여 Word 문서에서 정책 제거"

웹 서비스 API를 사용하여 Word 문서에서 정책 제거

Document Security API(웹 서비스)를 사용하여 정책으로 보호된 Word 문서에서 정책을 제거합니다.
  1. 프로젝트 파일 포함
    MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 다음 WSDL 정의를 사용해야 합니다. http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    AEM Forms localhost 를 호스팅하는 서버의 IP 주소로 대체합니다.
  2. Document Security Client API 개체 만들기
    • 기본 생성자를 사용하여 RightsManagementServiceClient 개체를 만듭니다.
    • 생성자를 사용하여 RightsManagementServiceClient.Endpoint.Address 개체를 System.ServiceModel.EndpointAddress 만듭니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예: http://localhost:8080/soap/services/RightsManagementService?WSDL .) 속성을 사용할 필요는 lc_version 없습니다. 이 속성은 서비스 참조를 만들 때 사용됩니다.)
    • 필드의 값을 System.ServiceModel.BasicHttpBinding 가져와 개체를 RightsManagementServiceClient.Endpoint.Binding 만듭니다. 반환 값을 다음으로 캐스팅합니다 BasicHttpBinding .
    • 개체 System.ServiceModel.BasicHttpBinding 필드를 (으)로 MessageEncoding 설정합니다 WSMessageEncoding.Mtom . 이 값을 사용하면 MTOM이 사용됩니다.
    • 다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
      • 필드에 AEM 양식 사용자 이름을 지정합니다 RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • 해당 암호 값을 필드에 지정합니다 RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • 필드에 상수 값 HttpClientCredentialType.Basic 을 지정합니다 BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • 필드에 상수 값 BasicHttpSecurityMode.TransportCredentialOnly 을 지정합니다 BasicHttpBindingSecurity.Security.Mode .
  3. 정책으로 보호된 Word 문서 검색
    • 생성자를 사용하여 BLOB 개체를 만듭니다. 이 BLOB 개체는 정책이 제거된 정책으로 보호된 Word 문서를 저장하는 데 사용됩니다.
    • 생성자를 호출하고 Word 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달하여 System.IO.FileStream 개체를 만듭니다.
    • 개체의 내용을 저장하는 바이트 배열을 System.IO.FileStream 만듭니다. 개체의 속성을 가져와 바이트 배열의 크기를 결정할 수 System.IO.FileStream Length 있습니다.
    • 개체의 메서드를 호출하고 바이트 배열, 시작 위치 및 읽을 스트림 길이를 전달하여 바이트 배열 System.IO.FileStream Read 을 스트림 데이터로 채웁니다.
    • 바이트 배열의 내용으로 해당 BLOB MTOM 필드를 할당하여 개체를 채웁니다.
  4. Word 문서에서 정책 제거
    개체의 메서드를 호출하고 정책으로 보호된 Word 문서를 포함하는 RightsManagementServiceClient removePolicySecurity BLOB 개체를 전달하여 Word 문서에서 정책을 제거합니다. 이 메서드는 비보안 Word 문서를 포함하는 BLOB 개체를 반환합니다.
  5. 비보안 Word 문서 저장
    • 생성자를 호출하고 보안되지 않은 Word 문서의 파일 위치를 나타내는 문자열 값을 전달하여 System.IO.FileStream 개체를 만듭니다.
    • 메서드에서 반환된 개체의 데이터 내용을 저장하는 바이트 배열을 BLOB removePolicySecurity 만듭니다. 개체 필드의 값을 가져와 바이트 배열 BLOB MTOM 채웁니다.
    • 생성자를 호출하고 개체를 전달하여 System.IO.BinaryWriter 개체를 System.IO.FileStream 만듭니다.
코드 예제
Document Security 서비스를 사용하는 코드 예제를 보려면 다음 빠른 시작을 참조하십시오.
  • "빠른 시작(MTOM): 웹 서비스 API를 사용하여 Word 문서에서 정책 제거"
참고 항목