사용자 관리 managing-users
이 문서의 샘플과 예제는 JEE 환경의 AEM Forms에 대해서만 적용됩니다.
사용자 관리 정보
사용자 관리 API를 사용하여 역할, 권한 및 주체(사용자 또는 그룹일 수 있음)를 관리하고 사용자를 인증할 수 있는 클라이언트 애플리케이션을 만들 수 있습니다. 사용자 관리 API는 다음 AEM Forms API로 구성됩니다.
- 디렉터리 관리자 서비스 API
- 인증 관리자 서비스 API
- 인증 관리자 서비스 API
사용자 관리를 사용하면 역할 및 권한을 지정, 제거 및 결정할 수 있습니다. 또한 도메인, 사용자 및 그룹을 할당, 제거 및 쿼리할 수 있습니다. 마지막으로 사용자 관리를 사용하여 사용자를 인증할 수 있습니다.
사용자 추가에서는 프로그래밍 방식으로 사용자를 추가하는 방법을 이해합니다. 이 섹션에서는 Directory Manager 서비스 API를 사용합니다.
사용자 삭제에서는 사용자를 프로그래밍 방식으로 삭제하는 방법을 이해하게 됩니다. 이 섹션에서는 Directory Manager 서비스 API를 사용합니다.
사용자 및 그룹 관리에서는 로컬 사용자와 디렉터리 사용자의 차이점을 이해하고 Java 및 웹 서비스 API를 사용하여 사용자 및 그룹을 프로그래밍 방식으로 관리하는 방법의 예를 봅니다. 이 섹션에서는 Directory Manager 서비스 API를 사용합니다.
역할 및 권한 관리에서 시스템 역할 및 권한과 이를 늘리기 위해 프로그래밍 방식으로 수행할 수 있는 작업에 대해 알아보고, Java 및 웹 서비스 API를 사용하여 역할 및 권한을 프로그래밍 방식으로 관리하는 방법에 대한 예제를 참조하십시오. 이 섹션에서는 디렉토리 관리자 서비스 API 및 인증 관리자 서비스 API를 모두 사용합니다.
사용자 인증에서 Java 및 웹 서비스 API를 사용하여 사용자를 프로그래밍 방식으로 인증하는 방법의 예를 볼 수 있습니다. 이 섹션에서는 권한 부여 관리자 서비스 API를 사용합니다.
인증 프로세스 이해
User Management는 기본 제공 인증 기능을 제공하며 사용자가 자신의 인증 공급자와 연결하는 기능도 제공합니다. User Management가 인증 요청을 수신하면(예: 사용자가 로그인을 시도하는 경우) 사용자 정보를 인증 공급자에게 전달하여 인증합니다. User Management는 사용자를 인증한 후 인증 공급자로부터 결과를 수신합니다.
다음 다이어그램은 로그인하려는 최종 사용자, 사용자 관리 및 인증 공급자 간의 상호 작용을 보여 줍니다.
다음 표에서는 인증 프로세스의 각 단계를 설명합니다.
[com.adobe.idp.um.webservices.WSSecurityHandler] errorCode:12803 errorCodeHEX:0x3203 message:WSSecurityHandler: UM authenticate returns exception : An error was discovered processing the <wsse:Security> header. (WSSecurityEngine: Invalid timestamp The security semantics of message have expired).
디렉터리 관리 이해
사용자 관리는 LDAP 디렉터리에 대한 연결을 지원하는 디렉터리 서비스 공급자(DirectoryManagerService)와 함께 패키지됩니다. 조직에서 비LDAP 저장소를 사용하여 사용자 레코드를 저장하는 경우 리포지토리와 함께 작동하는 고유한 디렉토리 서비스 공급자를 만들 수 있습니다.
디렉터리 서비스 공급자는 사용자 관리의 요청에 따라 사용자 저장소에서 레코드를 검색합니다. User Management는 성능을 개선하기 위해 데이터베이스에서 사용자 및 그룹 레코드를 정기적으로 캐시합니다.
디렉터리 서비스 공급자를 사용하여 사용자 관리 데이터베이스를 사용자 저장소와 동기화할 수 있습니다. 이 단계에서는 모든 사용자 디렉토리 정보와 모든 사용자 및 그룹 레코드가 최신 상태인지 확인합니다.
또한 DirectoryManagerService는 도메인을 만들고 관리하는 기능도 제공합니다. 도메인은 서로 다른 사용자 기반을 정의합니다. 도메인의 경계는 일반적으로 조직의 구성 방식 또는 사용자 저장소 설정 방식에 따라 정의됩니다. 사용자 관리 도메인은 인증 공급자와 디렉터리 서비스 공급자가 사용하는 구성 설정을 제공합니다.
User Management에서 내보내는 구성 XML에서 특성 값이 Domains
인 루트 노드에는 User Management에 대해 정의된 각 도메인에 대한 XML 요소가 포함되어 있습니다. 이들 요소 각각은 특정 서비스 공급자와 연관된 도메인의 측면을 정의하는 다른 요소를 포함한다.
objectSID 값 이해
Active Directory를 사용하는 경우 objectSID
값이 여러 도메인에서 고유한 특성이 아님을 이해하는 것이 중요합니다. 이 값은 개체의 보안 식별자를 저장합니다. 여러 도메인 환경(예: 도메인 트리)에서 objectSID
값은 다를 수 있습니다.
개체를 한 Active Directory 도메인에서 다른 도메인으로 이동하면 objectSID
값이 변경됩니다. 일부 개체는 도메인의 모든 위치에서 동일한 objectSID
값을 가집니다. 예를 들어 BUILTIN\Administrators, BUILTIN\Power Users 등과 같은 그룹은 도메인에 관계없이 동일한 objectSID
값을 갖습니다. 이 objectSID
값은 잘 알려져 있습니다.
사용자 추가 adding-users
Directory Manager 서비스 API(Java 및 웹 서비스)를 사용하여 프로그래밍 방식으로 AEM Forms에 사용자를 추가할 수 있습니다. 사용자를 추가한 후 사용자가 필요한 서비스 작업을 수행할 때 해당 사용자를 사용할 수 있습니다. 예를 들어 새 사용자에게 작업을 할당할 수 있습니다.
단계 요약 summary-of-steps
사용자를 추가하려면 다음 단계를 수행하십시오.
- 프로젝트 파일을 포함합니다.
- DirectoryManagerService 클라이언트를 만듭니다.
- 사용자 정보를 정의합니다.
- AEM Forms에 사용자를 추가합니다.
- 사용자가 추가되었는지 확인합니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함합니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함합니다.
DirectoryManagerService 클라이언트 만들기
Directory Manager 서비스 작업을 프로그래밍 방식으로 수행하려면 먼저 Directory Manager 서비스 API 클라이언트를 만듭니다.
사용자 정보 정의
디렉터리 관리자 서비스 API를 사용하여 새 사용자를 추가할 때 해당 사용자에 대한 정보를 정의합니다. 일반적으로 새 사용자를 추가할 때 다음 값을 정의합니다.
- 도메인 이름: 사용자가 속한 도메인입니다(예:
DefaultDom
). - 사용자 식별자 값: 사용자의 식별자 값(예:
wblue
). - 사용자 형식: 사용자 형식입니다(예:
USER)
을(를) 지정할 수 있음). - 지정된 이름: 사용자의 지정된 이름(예:
Wendy
). - 가족 이름: 사용자의 가족 이름(예:
Blue)
). - 로케일: 사용자의 로케일 정보입니다.
AEM Forms에 사용자 추가
사용자 정보를 정의한 후 AEM Forms에 사용자를 추가할 수 있습니다. 사용자를 추가하려면 DirectoryManagerServiceClient
개체의 createLocalUser
메서드를 호출하십시오.
사용자가 추가되었는지 확인
문제가 발생하지 않도록 사용자가 추가되었는지 확인할 수 있습니다. 사용자 식별자 값을 사용하여 새 사용자를 찾습니다.
추가 참조
Java API를 사용하여 사용자 추가 add-users-using-the-java-api
Directory Manager Service API(Java)를 사용하여 사용자 추가:
-
프로젝트 파일을 포함합니다.
Java 프로젝트의 클래스 경로에 adobe-usermanager-client.jar과 같은 클라이언트 JAR 파일을 포함합니다.
-
DirectoryManagerServices 클라이언트를 만듭니다.
해당 생성자를 사용하고 연결 속성이 포함된
ServiceClientFactory
개체를 전달하여DirectoryManagerServiceClient
개체를 만듭니다. -
사용자 정보를 정의합니다.
- 해당 생성자를 사용하여
UserImpl
개체를 만듭니다. UserImpl
개체의setDomainName
메서드를 호출하여 기본 이름을 설정합니다. 도메인 이름을 지정하는 문자열 값을 전달합니다.UserImpl
개체의setPrincipalType
메서드를 호출하여 사용자 형식을 설정합니다. 사용자 유형을 지정하는 문자열 값을 전달합니다. 예를 들어USER
을(를) 지정할 수 있습니다.UserImpl
개체의setUserid
메서드를 호출하여 사용자 식별자 값을 설정하십시오. 사용자 식별자 값을 지정하는 문자열 값을 전달합니다. 예를 들어wblue
을(를) 지정할 수 있습니다.UserImpl
개체의setCanonicalName
메서드를 호출하여 정식 이름을 설정합니다. 사용자의 정식 이름을 지정하는 문자열 값을 전달합니다. 예를 들어wblue
을(를) 지정할 수 있습니다.UserImpl
개체의setGivenName
메서드를 호출하여 지정된 이름을 설정하십시오. 사용자의 이름을 지정하는 문자열 값을 전달합니다. 예를 들어Wendy
을(를) 지정할 수 있습니다.UserImpl
개체의setFamilyName
메서드를 호출하여 패밀리 이름을 설정하십시오. 사용자의 성을 지정하는 문자열 값을 전달합니다. 예를 들어Blue
을(를) 지정할 수 있습니다.
note note NOTE 다른 값을 설정하려면 UserImpl
개체에 속하는 메서드를 호출하십시오. 예를들어,UserImpl
개체의setLocale
메서드를 호출하여 로케일 값을 설정할 수 있습니다. - 해당 생성자를 사용하여
-
AEM Forms에 사용자를 추가합니다.
DirectoryManagerServiceClient
개체의createLocalUser
메서드를 호출하고 다음 값을 전달하십시오.- 새 사용자를 나타내는
UserImpl
개체 - 사용자 암호를 나타내는 문자열 값
createLocalUser
메서드는 로컬 사용자 식별자 값을 지정하는 문자열 값을 반환합니다. - 새 사용자를 나타내는
-
사용자가 추가되었는지 확인합니다.
- 해당 생성자를 사용하여
PrincipalSearchFilter
개체를 만듭니다. PrincipalSearchFilter
개체의setUserId
메서드를 호출하여 사용자 식별자 값을 설정하십시오. 사용자 식별자 값을 나타내는 문자열 값을 전달합니다.DirectoryManagerServiceClient
개체의findPrincipals
메서드를 호출하고PrincipalSearchFilter
개체를 전달하십시오. 이 메서드는java.util.List
인스턴스를 반환합니다. 여기서 각 요소는User
개체입니다.java.util.List
인스턴스를 반복하여 사용자를 찾습니다.
- 해당 생성자를 사용하여
추가 참조
웹 서비스 API를 사용하여 사용자 추가 add-users-using-the-web-service-api
디렉터리 관리자 서비스 API(웹 서비스)를 사용하여 사용자 추가:
-
프로젝트 파일을 포함합니다.
MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. 서비스 참조에 다음 WSDL 정의를 사용하는지 확인하십시오.
http://localhost:8080/soap/services/DirectoryManagerService?WSDL&lc_version=9.0.1
.note note NOTE localhost
을(를) AEM Forms을 호스팅하는 서버의 IP 주소로 바꾸십시오. -
DirectoryManagerService 클라이언트를 만듭니다.
-
기본 생성자를 사용하여
DirectoryManagerServiceClient
개체를 만듭니다. -
System.ServiceModel.EndpointAddress
생성자를 사용하여DirectoryManagerServiceClient.Endpoint.Address
개체를 만듭니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예:http://localhost:8080/soap/services/DirectoryManagerService?blob=mtom
).lc_version
특성은 사용할 필요가 없습니다. 이 속성은 서비스 참조를 만들 때 사용됩니다.?blob=mtom
을(를) 지정했는지 확인하십시오. -
DirectoryManagerServiceClient.Endpoint.Binding
필드의 값을 가져와System.ServiceModel.BasicHttpBinding
개체를 만듭니다. 반환 값을BasicHttpBinding
(으)로 캐스팅합니다. -
System.ServiceModel.BasicHttpBinding
개체의MessageEncoding
필드를WSMessageEncoding.Mtom
(으)로 설정합니다. 이 값은 MTOM이 사용되도록 합니다. -
다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
DirectoryManagerServiceClient.ClientCredentials.UserName.UserName
필드에 AEM Forms 사용자 이름을 지정하십시오.- 필드
DirectoryManagerServiceClient.ClientCredentials.UserName.Password
에 해당 암호 값을 지정하십시오. - 상수 값
HttpClientCredentialType.Basic
을(를) 필드BasicHttpBindingSecurity.Transport.ClientCredentialType
에 할당합니다. - 상수 값
BasicHttpSecurityMode.TransportCredentialOnly
을(를) 필드BasicHttpBindingSecurity.Security.Mode
에 할당합니다.
-
-
사용자 정보를 정의합니다.
- 해당 생성자를 사용하여
UserImpl
개체를 만듭니다. UserImpl
개체의domainName
필드에 문자열 값을 할당하여 기본 이름을 설정하십시오.UserImpl
개체의principalType
필드에 문자열 값을 할당하여 보안 주체 형식을 설정하십시오. 예를 들어USER
을(를) 지정할 수 있습니다.UserImpl
개체의userid
필드에 문자열 값을 할당하여 사용자 식별자 값을 설정하십시오.UserImpl
개체의canonicalName
필드에 문자열 값을 할당하여 정식 이름 값을 설정하십시오.UserImpl
개체의givenName
필드에 문자열 값을 할당하여 지정된 이름 값을 설정하십시오.UserImpl
개체의familyName
필드에 문자열 값을 할당하여 패밀리 이름 값을 설정하십시오.
- 해당 생성자를 사용하여
-
AEM Forms에 사용자를 추가합니다.
DirectoryManagerServiceClient
개체의createLocalUser
메서드를 호출하고 다음 값을 전달하십시오.- 새 사용자를 나타내는
UserImpl
개체 - 사용자 암호를 나타내는 문자열 값
createLocalUser
메서드는 로컬 사용자 식별자 값을 지정하는 문자열 값을 반환합니다. - 새 사용자를 나타내는
-
사용자가 추가되었는지 확인합니다.
- 해당 생성자를 사용하여
PrincipalSearchFilter
개체를 만듭니다. - 사용자 식별자 값을 나타내는 문자열 값을
PrincipalSearchFilter
개체의userId
필드에 할당하여 사용자의 사용자 식별자 값을 설정합니다. DirectoryManagerServiceClient
개체의findPrincipals
메서드를 호출하고PrincipalSearchFilter
개체를 전달하십시오. 이 메서드는MyArrayOfUser
컬렉션 개체를 반환합니다. 여기서 각 요소는User
개체입니다.MyArrayOfUser
컬렉션을 반복하여 사용자를 찾습니다.
- 해당 생성자를 사용하여
추가 참조
사용자 삭제 deleting-users
Directory Manager 서비스 API(Java 및 웹 서비스)를 사용하여 AEM Forms에서 사용자를 프로그래밍 방식으로 삭제할 수 있습니다. 사용자를 삭제한 후 해당 사용자를 더 이상 사용자가 필요한 서비스 작업을 수행하는 데 사용할 수 없습니다. 예를 들어 삭제된 사용자에게 작업을 할당할 수 없습니다.
단계 요약 summary_of_steps-1
사용자를 삭제하려면 다음 단계를 수행하십시오.
- 프로젝트 파일을 포함합니다.
- DirectoryManagerService 클라이언트를 만듭니다.
- 삭제할 사용자를 지정합니다.
- AEM Forms에서 사용자를 삭제합니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함합니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함합니다.
DirectoryManagerService 클라이언트 만들기
Directory Manager 서비스 API 작업을 프로그래밍 방식으로 수행하려면 먼저 Directory Manager 서비스 클라이언트를 만듭니다.
삭제할 사용자 지정
사용자의 식별자 값을 사용하여 삭제할 사용자를 지정할 수 있습니다.
AEM Forms에서 사용자 삭제
사용자를 삭제하려면 DirectoryManagerServiceClient
개체의 deleteLocalUser
메서드를 호출하십시오.
추가 참조
Java API를 사용하여 사용자 삭제 delete-users-using-the-java-api
Directory Manager Service API(Java)를 사용하여 사용자를 삭제합니다.
-
프로젝트 파일을 포함합니다.
Java 프로젝트의 클래스 경로에 adobe-usermanager-client.jar과 같은 클라이언트 JAR 파일을 포함합니다.
-
DirectoryManagerService 클라이언트를 만듭니다.
해당 생성자를 사용하고 연결 속성이 포함된
ServiceClientFactory
개체를 전달하여DirectoryManagerServiceClient
개체를 만듭니다. -
삭제할 사용자를 지정합니다.
- 해당 생성자를 사용하여
PrincipalSearchFilter
개체를 만듭니다. PrincipalSearchFilter
개체의setUserId
메서드를 호출하여 사용자 식별자 값을 설정하십시오. 사용자 식별자 값을 나타내는 문자열 값을 전달합니다.DirectoryManagerServiceClient
개체의findPrincipals
메서드를 호출하고PrincipalSearchFilter
개체를 전달하십시오. 이 메서드는java.util.List
인스턴스를 반환합니다. 여기서 각 요소는User
개체입니다.java.util.List
인스턴스를 반복하여 삭제할 사용자를 찾습니다.
- 해당 생성자를 사용하여
-
AEM Forms에서 사용자를 삭제합니다.
DirectoryManagerServiceClient
개체의deleteLocalUser
메서드를 호출하고User
개체의oid
필드의 값을 전달하십시오.User
개체의getOid
메서드를 호출합니다.java.util.List
인스턴스에서 검색된User
개체를 사용합니다.
추가 참조
빠른 시작(EJB 모드): Java API를 사용하여 사용자 삭제
웹 서비스 API를 사용하여 사용자 삭제 delete-users-using-the-web-service-api
디렉터리 관리자 서비스 API(웹 서비스)를 사용하여 사용자를 삭제합니다.
-
프로젝트 파일을 포함합니다.
Java 프로젝트의 클래스 경로에 adobe-usermanager-client.jar과 같은 클라이언트 JAR 파일을 포함합니다.
-
DirectoryManagerService 클라이언트를 만듭니다.
-
기본 생성자를 사용하여
DirectoryManagerServiceClient
개체를 만듭니다. -
System.ServiceModel.EndpointAddress
생성자를 사용하여DirectoryManagerServiceClient.Endpoint.Address
개체를 만듭니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예:http://localhost:8080/soap/services/DirectoryManagerService?blob=mtom
).lc_version
특성은 사용할 필요가 없습니다. 이 속성은 서비스 참조를 만들 때 사용됩니다.blob=mtom.
을(를) 지정해야 합니다. -
DirectoryManagerServiceClient.Endpoint.Binding
필드의 값을 가져와System.ServiceModel.BasicHttpBinding
개체를 만듭니다. 반환 값을BasicHttpBinding
(으)로 캐스팅합니다. -
System.ServiceModel.BasicHttpBinding
개체의MessageEncoding
필드를WSMessageEncoding.Mtom
(으)로 설정합니다. 이 값은 MTOM이 사용되도록 합니다. -
다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
DirectoryManagerServiceClient.ClientCredentials.UserName.UserName
필드에 AEM Forms 사용자 이름을 지정하십시오.- 필드
DirectoryManagerServiceClient.ClientCredentials.UserName.Password
에 해당 암호 값을 지정하십시오. - 상수 값
HttpClientCredentialType.Basic
을(를) 필드BasicHttpBindingSecurity.Transport.ClientCredentialType
에 할당합니다. - 상수 값
BasicHttpSecurityMode.TransportCredentialOnly
을(를) 필드BasicHttpBindingSecurity.Security.Mode
에 할당합니다.
-
-
삭제할 사용자를 지정합니다.
- 해당 생성자를 사용하여
PrincipalSearchFilter
개체를 만듭니다. PrincipalSearchFilter
개체의userId
필드에 문자열 값을 할당하여 사용자 식별자 값을 설정하십시오.DirectoryManagerServiceClient
개체의findPrincipals
메서드를 호출하고PrincipalSearchFilter
개체를 전달하십시오. 이 메서드는MyArrayOfUser
컬렉션 개체를 반환합니다. 여기서 각 요소는User
개체입니다.MyArrayOfUser
컬렉션을 반복하여 사용자를 찾습니다.MyArrayOfUser
컬렉션 개체에서 검색된User
개체는 사용자를 삭제하는 데 사용됩니다.
- 해당 생성자를 사용하여
-
AEM Forms에서 사용자를 삭제합니다.
User
개체의oid
필드 값을DirectoryManagerServiceClient
개체의deleteLocalUser
메서드에 전달하여 사용자를 삭제합니다.
추가 참조
그룹 만들기 creating-groups
Directory Manager Service API(Java 및 웹 서비스)를 사용하여 프로그래밍 방식으로 AEM Forms 그룹을 만들 수 있습니다. 그룹을 만든 후 해당 그룹을 사용하여 그룹이 필요한 서비스 작업을 수행할 수 있습니다. 예를 들어 사용자를 새 그룹에 할당할 수 있습니다. 사용자 및 그룹 관리를 참조하십시오.
단계 요약 summary_of_steps-2
그룹을 만들려면 다음 단계를 수행하십시오.
- 프로젝트 파일을 포함합니다.
- DirectoryManagerService 클라이언트를 만듭니다.
- 그룹이 존재하지 않는지 확인합니다.
- 그룹을 만듭니다.
- 그룹으로 작업을 수행합니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함합니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함합니다.
프로젝트의 클래스 경로에 다음 JAR 파일을 추가해야 합니다.
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-utilities.jar (AEM Forms이 JBoss에 배포된 경우 필수)
- jbossall-client.jar (AEM Forms이 JBoss에 배포된 경우 필수)
이러한 JAR 파일의 위치에 대한 자세한 내용은 AEM Forms Java 라이브러리 파일 포함을 참조하십시오.
DirectoryManagerService 클라이언트 만들기
Directory Manager 서비스 작업을 프로그래밍 방식으로 수행하려면 먼저 Directory Manager 서비스 API 클라이언트를 만듭니다.
그룹이 있는지 확인
그룹을 만들 때 그룹이 동일한 도메인에 존재하지 않는지 확인합니다. 즉, 두 그룹은 동일한 도메인 내에서 동일한 이름을 가질 수 없습니다. 이 작업을 수행하려면 검색을 수행하고 두 값을 기준으로 검색 결과를 필터링합니다. 그룹만 반환되도록 보안 주체 형식을 com.adobe.idp.um.api.infomodel.Principal.PRINCIPALTYPE_GROUP
(으)로 설정하십시오. 또한 도메인 이름을 지정해야 합니다.
그룹 만들기
그룹이 도메인에 존재하지 않는다고 판단되면 그룹을 생성하고 다음 속성을 지정합니다.
- CommonName: 그룹의 이름입니다.
- 도메인: 그룹이 추가되는 도메인입니다.
- 설명: 그룹에 대한 설명입니다.
그룹으로 동작 수행
그룹을 만든 후 그룹을 사용하여 작업을 수행할 수 있습니다. 예를 들어 사용자를 그룹에 추가할 수 있습니다. 그룹에 사용자를 추가하려면 사용자와 그룹 모두의 고유 식별자 값을 검색합니다. 이 값을 addPrincipalToLocalGroup
메서드에 전달합니다.
추가 참조
Java API를 사용하여 그룹 만들기 create-groups-using-the-java-api
Directory Manager Service API(Java)를 사용하여 그룹을 생성합니다.
-
프로젝트 파일을 포함합니다.
Java 프로젝트의 클래스 경로에 adobe-usermanager-client.jar과 같은 클라이언트 JAR 파일을 포함합니다.
-
DirectoryManagerService 클라이언트를 만듭니다.
해당 생성자를 사용하고 연결 속성이 포함된
ServiceClientFactory
개체를 전달하여DirectoryManagerServiceClient
개체를 만듭니다. -
그룹이 존재하는지 확인합니다.
- 해당 생성자를 사용하여
PrincipalSearchFilter
개체를 만듭니다. PrincipalSearchFilter
개체의setPrincipalType
개체를 호출하여 사용자 형식을 설정합니다. 값com.adobe.idp.um.api.infomodel.Principal.PRINCIPALTYPE_GROUP
을(를) 전달합니다.PrincipalSearchFilter
개체의setSpecificDomainName
개체를 호출하여 도메인을 설정합니다. 도메인 이름을 지정하는 문자열 값을 전달합니다.- 그룹을 찾으려면
DirectoryManagerServiceClient
개체의findPrincipals
메서드를 호출하십시오(보안 주체는 그룹일 수 있음). 사용자 형식 및 도메인 이름을 지정하는PrincipalSearchFilter
개체를 전달합니다. 이 메서드는 각 요소가Group
인스턴스인java.util.List
인스턴스를 반환합니다. 각 그룹 인스턴스는PrincipalSearchFilter
개체를 사용하여 지정된 필터를 준수합니다. java.util.List
인스턴스를 반복합니다. 각 요소에 대해 그룹 이름을 검색합니다. 그룹 이름이 새 그룹 이름과 같지 않은지 확인합니다.
- 해당 생성자를 사용하여
-
그룹을 만듭니다.
- 그룹이 없으면
Group
개체의setCommonName
메서드를 호출하고 그룹 이름을 지정하는 문자열 값을 전달하십시오. Group
개체의setDescription
메서드를 호출하고 그룹 설명을 지정하는 문자열 값을 전달하십시오.Group
개체의setDomainName
메서드를 호출하고 도메인 이름을 지정하는 문자열 값을 전달하십시오.DirectoryManagerServiceClient
개체의createLocalGroup
메서드를 호출하고Group
인스턴스를 전달합니다.
createLocalUser
메서드는 로컬 사용자 식별자 값을 지정하는 문자열 값을 반환합니다. - 그룹이 없으면
-
그룹으로 작업을 수행합니다.
- 해당 생성자를 사용하여
PrincipalSearchFilter
개체를 만듭니다. PrincipalSearchFilter
개체의setUserId
메서드를 호출하여 사용자 식별자 값을 설정하십시오. 사용자 식별자 값을 나타내는 문자열 값을 전달합니다.DirectoryManagerServiceClient
개체의findPrincipals
메서드를 호출하고PrincipalSearchFilter
개체를 전달하십시오. 이 메서드는java.util.List
인스턴스를 반환합니다. 여기서 각 요소는User
개체입니다.java.util.List
인스턴스를 반복하여 사용자를 찾습니다.DirectoryManagerServiceClient
개체의addPrincipalToLocalGroup
메서드를 호출하여 사용자를 그룹에 추가합니다.User
개체의getOid
메서드에 대한 반환 값을 전달합니다.Group
개체의getOid
메서드에 대한 반환 값을 전달합니다(새 그룹을 나타내는Group
인스턴스 사용).
- 해당 생성자를 사용하여
추가 참조
사용자 및 그룹 관리 managing-users-and-groups
이 항목에서는 (Java)를 사용하여 도메인, 사용자 및 그룹을 프로그래밍 방식으로 할당, 제거 및 쿼리하는 방법에 대해 설명합니다.
"objectsid"
입니다). 예를 들어 Novell eDirectory 특성 "GUID"
은(는) 간단한 문자열 데이터 형식이 아니므로 작동하지 않습니다.- Active Directory의 경우
"objectsid"
을(를) 사용합니다. - SunOne의 경우
"nsuniqueid"
사용
단계 요약 summary_of_steps-3
사용자 및 그룹을 관리하려면 다음 단계를 수행하십시오.
- 프로젝트 파일을 포함합니다.
- DirectoryManagerService 클라이언트를 만듭니다.
- 적절한 사용자 또는 그룹 작업을 호출합니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함합니다. Java를 사용하여 클라이언트 응용 프로그램을 생성하는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
DirectoryManagerService 클라이언트 만들기
Directory Manager 서비스 작업을 프로그래밍 방식으로 수행하려면 먼저 Directory Manager 서비스 클라이언트를 만들어야 합니다. Java API를 사용하면 DirectoryManagerServiceClient
개체를 만들어 수행할 수 있습니다. 웹 서비스 API를 사용하면 DirectoryManagerServiceService
개체를 만들어 이 작업을 수행할 수 있습니다.
적절한 사용자 또는 그룹 작업 호출
서비스 클라이언트를 만든 후에는 사용자 또는 그룹 관리 작업을 호출할 수 있습니다. 서비스 클라이언트를 사용하여 도메인, 사용자 및 그룹을 할당, 제거 및 쿼리할 수 있습니다. 로컬 그룹에 디렉토리 주도자나 로컬 주도자를 추가할 수는 있지만 디렉토리 그룹에 로컬 주도자를 추가할 수는 없습니다.
추가 참조
Java API를 사용하여 사용자 및 그룹 관리 managing-users-and-groups-using-the-java-api
(Java)를 사용하여 사용자, 그룹 및 도메인을 프로그래밍 방식으로 관리하려면 다음 작업을 수행합니다.
-
프로젝트 파일을 포함합니다.
Java 프로젝트의 클래스 경로에 adobe-usermanager-client.jar과 같은 클라이언트 JAR 파일을 포함합니다. 이러한 파일의 위치에 대한 자세한 내용은 AEM Forms Java 라이브러리 파일 포함을 참조하십시오.
-
DirectoryManagerService 클라이언트를 만듭니다.
해당 생성자를 사용하고 연결 속성이 포함된
ServiceClientFactory
개체를 전달하여DirectoryManagerServiceClient
개체를 만듭니다. 자세한 내용은 연결 속성 설정. 을 참조하세요. -
적절한 사용자 또는 그룹 작업을 호출합니다.
사용자 또는 그룹을 찾으려면 보안 주체를 찾기 위한
DirectoryManagerServiceClient
개체의 메서드 중 하나를 호출합니다(보안 주체는 사용자 또는 그룹일 수 있으므로). 아래 예제에서는 검색 필터(PrincipalSearchFilter
개체)를 사용하여findPrincipals
메서드를 호출합니다.이 경우 반환 값이
Principal
개의 개체가 포함된java.util.List
이므로 결과를 반복하고Principal
개의 개체를User
또는Group
개의 개체로 캐스팅하십시오.결과
User
또는Group
개체(Principal
인터페이스에서 상속)를 사용하여 워크플로우에서 필요한 정보를 검색합니다. 예를 들어 도메인 이름과 정식 이름 값을 조합하여 고유하게 사용자를 식별합니다.Principal
개체의getDomainName
및getCanonicalName
메서드를 각각 호출하여 검색됩니다.로컬 사용자를 삭제하려면
DirectoryManagerServiceClient
개체의deleteLocalUser
메서드를 호출하고 사용자 식별자를 전달하십시오.로컬 그룹을 삭제하려면
DirectoryManagerServiceClient
개체의deleteLocalGroup
메서드를 호출하고 그룹 식별자를 전달합니다.
추가 참조
웹 서비스 API를 사용하여 사용자 및 그룹 관리 managing-users-and-groups-using-the-web-service-api
Directory Manager Service API(웹 서비스)를 사용하여 사용자, 그룹 및 도메인을 프로그래밍 방식으로 관리하려면 다음 작업을 수행하십시오.
-
프로젝트 파일을 포함합니다.
- 디렉터리 관리자 WSDL을 사용하는 Microsoft .NET 클라이언트 어셈블리를 만듭니다. Base64 인코딩을 사용하여 AEM Forms 호출을 참조하십시오.
- Microsoft .NET 클라이언트 어셈블리를 참조합니다. Base64 인코딩을 사용하는 .NET 클라이언트 어셈블리 만들기를 참조하십시오.
-
DirectoryManagerService 클라이언트를 만듭니다.
프록시 클래스의 생성자를 사용하여
DirectoryManagerServiceService
개체를 만듭니다. -
적절한 사용자 또는 그룹 작업을 호출합니다.
사용자 또는 그룹을 찾으려면 보안 주체를 찾기 위한
DirectoryManagerServiceService
개체의 메서드 중 하나를 호출합니다(보안 주체는 사용자 또는 그룹일 수 있으므로). 아래 예제에서는 검색 필터(PrincipalSearchFilter
개체)를 사용하여findPrincipalsWithFilter
메서드를 호출합니다.PrincipalSearchFilter
개체를 사용할 때 로컬 보안 주체는isLocal
속성이true
(으)로 설정된 경우에만 반환됩니다. 이 동작은 Java API에서 발생하는 것과 다릅니다.note note NOTE PrincipalSearchFilter.resultsMax
필드를 통해 검색 필터에 최대 결과 수를 지정하지 않으면 최대 1000개의 결과가 반환됩니다. 이는 10개의 결과가 기본 최대값인 Java API를 사용하여 발생하는 것과 다른 동작입니다. 또한findGroupMembers
과(와) 같은 검색 메서드는 검색 필터에 최대 결과 수를 지정하지 않으면(예:GroupMembershipSearchFilter.resultsMax
필드를 통해) 결과를 생성하지 않습니다. 이는GenericSearchFilter
클래스에서 상속하는 모든 검색 필터에 적용됩니다. 자세한 내용은 AEM Forms API 참조를 참조하십시오.이 경우 반환 값이
Principal
개의 개체가 포함된object[]
이므로 결과를 반복하고Principal
개의 개체를User
또는Group
개의 개체로 캐스팅하십시오.결과
User
또는Group
개체(Principal
인터페이스에서 상속)를 사용하여 워크플로우에서 필요한 정보를 검색합니다. 예를 들어 도메인 이름과 정식 이름 값을 조합하여 고유하게 사용자를 식별합니다.Principal
개체의domainName
및canonicalName
필드를 각각 호출하여 검색됩니다.로컬 사용자를 삭제하려면
DirectoryManagerServiceService
개체의deleteLocalUser
메서드를 호출하고 사용자 식별자를 전달하십시오.로컬 그룹을 삭제하려면
DirectoryManagerServiceService
개체의deleteLocalGroup
메서드를 호출하고 그룹 식별자를 전달합니다.
추가 참조
역할 및 권한 관리 managing-roles-and-permissions
이 항목에서는 권한 부여 관리자 서비스 API(Java)를 사용하여 역할 및 권한을 프로그래밍 방식으로 할당, 제거 및 결정하는 방법을 설명합니다.
AEM Forms에서 role 은(는) 하나 이상의 시스템 수준 리소스에 액세스할 수 있는 권한 그룹입니다. 이러한 권한은 사용자 관리를 통해 생성되며 서비스 구성 요소에 의해 적용됩니다. 예를 들어 관리자가 사용자 그룹에 "정책 세트 작성자" 역할을 할당할 수 있습니다. 그러면 Rights Management은 해당 역할을 가진 그룹의 사용자가 관리 콘솔을 통해 정책 세트를 만들 수 있도록 허용합니다.
역할에는 기본 역할 및 사용자 지정 역할 의 두 가지 유형이 있습니다. 기본 역할(시스템 역할) 이 이미 AEM Forms에 있습니다. 기본 역할은 관리자가 삭제하거나 수정할 수 없으므로 변경할 수 없다고 가정합니다. 관리자가 만든 사용자 정의 역할은 나중에 수정하거나 삭제할 수 있으므로 변경할 수 있습니다.
역할을 사용하면 권한을 보다 쉽게 관리할 수 있습니다. 역할이 주도자에게 할당되면 권한 집합이 자동으로 해당 주도자에게 할당되고, 주도자에 대한 모든 특정 액세스 관련 결정은 할당된 전체 권한 집합을 기반으로 합니다.
단계 요약 summary_of_steps-4
역할 및 권한을 관리하려면 다음 단계를 수행하십시오.
- 프로젝트 파일을 포함합니다.
- AuthorizationManagerService 클라이언트를 만듭니다.
- 적절한 역할 또는 권한 작업을 호출합니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함합니다. Java를 사용하여 클라이언트 응용 프로그램을 생성하는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
AuthorizationManagerService 클라이언트 만들기
User Management AuthorizationManagerService 작업을 프로그래밍 방식으로 수행하려면 먼저 AuthorizationManagerService 클라이언트를 만들어야 합니다. Java API를 사용하면 AuthorizationManagerServiceClient
개체를 만들어 수행할 수 있습니다.
적절한 역할 또는 권한 작업을 호출합니다
서비스 클라이언트를 만든 후에는 역할 또는 권한 작업을 호출할 수 있습니다. 서비스 클라이언트를 사용하여 역할 및 권한을 지정, 제거 및 결정할 수 있습니다.
추가 참조
Java API를 사용하여 역할 및 권한 관리 managing-roles-and-permissions-using-the-java-api
Java(Authorization Manager Service API)를 사용하여 역할 및 권한을 관리하려면 다음 작업을 수행하십시오.
-
프로젝트 파일을 포함합니다.
Java 프로젝트의 클래스 경로에 adobe-usermanager-client.jar과 같은 클라이언트 JAR 파일을 포함합니다.
-
AuthorizationManagerService 클라이언트를 만듭니다.
해당 생성자를 사용하고 연결 속성이 포함된
ServiceClientFactory
개체를 전달하여AuthorizationManagerServiceClient
개체를 만듭니다. -
적절한 역할 또는 권한 작업을 호출합니다.
주체에 역할을 할당하려면
AuthorizationManagerServiceClient
개체의assignRole
메서드를 호출하고 다음 값을 전달하십시오.- 역할 식별자가 포함된
java.lang.String
개체 - 사용자 식별자를 포함하는
java.lang.String
개체의 배열입니다.
주체에서 역할을 제거하려면
AuthorizationManagerServiceClient
개체의unassignRole
메서드를 호출하고 다음 값을 전달하십시오.- 역할 식별자가 포함된
java.lang.String
개체입니다. - 사용자 식별자를 포함하는
java.lang.String
개체의 배열입니다.
- 역할 식별자가 포함된
추가 참조
웹 서비스 API를 사용하여 역할 및 권한 관리 managing-roles-and-permissions-using-the-web-service-api
Authorization Manager Service API(웹 서비스)를 사용하여 역할 및 권한을 관리합니다.
-
프로젝트 파일을 포함합니다.
MTOM을 사용하는 Microsoft .NET 프로젝트를 만듭니다. WSDL 정의
http://localhost:8080/soap/services/AuthorizationManagerService?WSDL&lc_version=9.0.1
을(를) 사용하는지 확인하십시오.note note NOTE localhost
을(를) AEM Forms을 호스팅하는 서버의 IP 주소로 바꾸십시오. -
AuthorizationManagerService 클라이언트를 만듭니다.
-
기본 생성자를 사용하여
AuthorizationManagerServiceClient
개체를 만듭니다. -
System.ServiceModel.EndpointAddress
생성자를 사용하여AuthorizationManagerServiceClient.Endpoint.Address
개체를 만듭니다. WSDL을 지정하는 문자열 값을 AEM Forms 서비스에 전달합니다(예:http://localhost:8080/soap/services/AuthorizationManagerService?blob=mtom
).lc_version
특성은 사용할 필요가 없습니다. 이 속성은 서비스 참조를 만들 때 사용됩니다. -
AuthorizationManagerServiceClient.Endpoint.Binding
필드의 값을 가져와System.ServiceModel.BasicHttpBinding
개체를 만듭니다. 반환 값을BasicHttpBinding
(으)로 캐스팅합니다. -
System.ServiceModel.BasicHttpBinding
개체의MessageEncoding
필드를WSMessageEncoding.Mtom
(으)로 설정합니다. 이 값은 MTOM이 사용되도록 합니다. -
다음 작업을 수행하여 기본 HTTP 인증을 활성화합니다.
AuthorizationManagerServiceClient.ClientCredentials.UserName.UserName
필드에 AEM Forms 사용자 이름을 지정하십시오.- 필드
AuthorizationManagerServiceClient.ClientCredentials.UserName.Password
에 해당 암호 값을 지정하십시오. - 상수 값
HttpClientCredentialType.Basic
을(를) 필드BasicHttpBindingSecurity.Transport.ClientCredentialType
에 할당합니다. - 상수 값
BasicHttpSecurityMode.TransportCredentialOnly
을(를) 필드BasicHttpBindingSecurity.Security.Mode
에 할당합니다.
-
-
적절한 역할 또는 권한 작업을 호출합니다.
주체에 역할을 할당하려면
AuthorizationManagerServiceClient
개체의assignRole
메서드를 호출하고 다음 값을 전달하십시오.- 역할 식별자가 포함된
string
개체 - 사용자 식별자를 포함하는
MyArrayOf_xsd_string
개체입니다.
주체에서 역할을 제거하려면
AuthorizationManagerServiceService
개체의unassignRole
메서드를 호출하고 다음 값을 전달하십시오.- 역할 식별자가 포함된
string
개체입니다. - 사용자 식별자를 포함하는
string
개체의 배열입니다.
- 역할 식별자가 포함된
추가 참조
사용자 인증 authenticating-users
이 항목에서는 Authentication Manager Service API(Java)를 사용하여 클라이언트 응용 프로그램에서 사용자를 프로그래밍 방식으로 인증할 수 있도록 하는 방법에 대해 설명합니다.
사용자 인증은 보안 데이터를 저장하는 엔터프라이즈 데이터베이스 또는 다른 엔터프라이즈 저장소와 상호 작용하기 위해 필요할 수 있습니다.
예를 들어 사용자가 웹 페이지에 사용자 이름과 암호를 입력하고 값을 Forms을 호스팅하는 J2EE 애플리케이션 서버에 제출하는 시나리오를 생각해 보십시오. Forms 사용자 지정 응용 프로그램은 인증 관리자 서비스를 사용하여 사용자를 인증할 수 있습니다.
인증이 성공하면 응용 프로그램이 보안 엔터프라이즈 데이터베이스에 액세스합니다. 그렇지 않으면, 사용자가 인증된 사용자가 아니라는 메시지가 사용자에게 전송됩니다.
다음 다이어그램은 애플리케이션의 논리 흐름을 보여 줍니다.
다음 표에서는 이 다이어그램의 단계에 대해 설명합니다.
단계 요약 summary_of_steps-5
사용자를 프로그래밍 방식으로 인증하려면 다음 단계를 수행하십시오.
- 프로젝트 파일을 포함합니다.
- AuthenticationManagerService 클라이언트를 만듭니다.
- 인증 작업을 호출합니다.
- 필요한 경우 클라이언트 애플리케이션이 인증을 위해 다른 AEM Forms 서비스에 전달할 수 있도록 컨텍스트를 검색합니다.
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함합니다. Java를 사용하여 클라이언트 응용 프로그램을 생성하는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
AuthenticationManagerService 클라이언트 만들기
사용자를 프로그래밍 방식으로 인증하려면 먼저 AuthenticationManagerService 클라이언트를 만들어야 합니다. Java API를 사용하는 경우 AuthenticationManagerServiceClient
개체를 만듭니다.
인증 작업 호출
서비스 클라이언트를 만든 후에는 인증 작업을 호출할 수 있습니다. 이 작업에는 사용자 이름 및 암호와 같은 사용자에 대한 정보가 필요합니다. 사용자가 인증하지 않으면 예외가 발생합니다.
인증 컨텍스트 검색
사용자를 인증했으면 인증된 사용자를 기반으로 컨텍스트를 만들 수 있습니다. 그런 다음 콘텐츠를 사용하여 다른 AEM Forms 서비스를 호출할 수 있습니다. 예를 들어, 컨텍스트를 사용하여 EncryptionServiceClient
을(를) 만들고 암호로 PDF 문서를 암호화할 수 있습니다. 인증된 사용자에게 AEM Forms 서비스를 호출하는 데 필요한 Services User
역할이 있는지 확인하십시오.
추가 참조
Java API를 사용하여 사용자 인증 authenticate-a-user-using-the-java-api
인증 관리자 서비스 API(Java)를 사용하여 사용자 인증:
-
프로젝트 파일을 포함합니다.
Java 프로젝트의 클래스 경로에 adobe-usermanager-client.jar과 같은 클라이언트 JAR 파일을 포함합니다.
-
AuthenticationManagerServices 클라이언트를 만듭니다.
해당 생성자를 사용하고 연결 속성이 포함된
ServiceClientFactory
개체를 전달하여AuthenticationManagerServiceClient
개체를 만듭니다. -
인증 작업을 호출합니다.
AuthenticationManagerServiceClient
개체의authenticate
메서드를 호출하고 다음 값을 전달하십시오.- 사용자 이름이 포함된
java.lang.String
개체입니다. - 사용자 암호를 포함하는 바이트 배열(
byte[]
개체)입니다.java.lang.String
개체의getBytes
메서드를 호출하여byte[]
개체를 가져올 수 있습니다.
authenticate 메서드는 인증된 사용자에 대한 정보가 포함된
AuthResult
개체를 반환합니다. - 사용자 이름이 포함된
-
인증 컨텍스트를 검색합니다.
Context
개체를 반환하는ServiceClientFactory
개체의getContext
메서드를 호출합니다.그런 다음
Context
개체의initPrincipal
메서드를 호출하고AuthResult
을(를) 전달합니다.
웹 서비스 API를 사용하여 사용자 인증 authenticate-a-user-using-the-web-service-api
인증 관리자 서비스 API(웹 서비스)를 사용하여 사용자 인증:
-
프로젝트 파일을 포함합니다.
- 인증 관리자 WSDL을 사용하는 Microsoft .NET 클라이언트 어셈블리를 만듭니다. Base64 인코딩을 사용하여 AEM Forms 호출을 참조하십시오.
- Microsoft .NET 클라이언트 어셈블리를 참조합니다. Base64 인코딩을 사용하여 AEM Forms 호출에서 ".NET 클라이언트 어셈블리 참조"를 참조하십시오.
-
AuthenticationManagerService 클라이언트를 만듭니다.
프록시 클래스의 생성자를 사용하여
AuthenticationManagerServiceService
개체를 만듭니다. -
인증 작업을 호출합니다.
AuthenticationManagerServiceClient
개체의authenticate
메서드를 호출하고 다음 값을 전달하십시오.- 사용자 이름이 포함된
string
개체 - 사용자 암호를 포함하는 바이트 배열(
byte[]
개체)입니다. 아래 예제와 같은 논리를 사용하여 암호가 포함된string
개체를byte[]
배열로 변환하면byte[]
개체를 가져올 수 있습니다. - 반환된 값은 사용자에 대한 정보를 검색하는 데 사용할 수 있는
AuthResult
개체가 됩니다. 아래 예제에서는 먼저AuthResult
개체의authenticatedUser
필드를 얻은 다음 그 다음 결과User
개체의canonicalName
및domainName
필드를 얻은 후 사용자 정보를 검색합니다.
- 사용자 이름이 포함된
추가 참조
프로그래밍 방식으로 사용자 동기화 programmatically-synchronizing-users
사용자 관리 API를 사용하여 사용자를 프로그래밍 방식으로 동기화할 수 있습니다. 사용자를 동기화할 때 사용자 저장소에 있는 사용자 데이터로 AEM Forms을 업데이트합니다. 예를 들어 사용자 저장소에 새 사용자를 추가한다고 가정해 보겠습니다. 동기화 작업을 수행하면 새 사용자가 AEM Forms 사용자가 됩니다. 또한, 더 이상 사용자 저장소의 사용자가 AEM Forms에서 제거되지 않습니다.
다음 다이어그램은 AEM Forms을 사용자 저장소와 동기화하는 것을 보여 줍니다.
다음 표에서는 이 다이어그램의 단계에 대해 설명합니다.
단계 요약 summary_of_steps-6
사용자를 프로그래밍 방식으로 동기화하려면 다음 단계를 수행하십시오.
- 프로젝트 파일을 포함합니다.
- UserManagerUtilServiceClient 클라이언트를 만듭니다.
- Enterprise 도메인을 지정합니다.
- 인증 작업을 호출합니다.
- 동기화 작업이 완료되었는지 확인
프로젝트 파일 포함
개발 프로젝트에 필요한 파일을 포함합니다. Java를 사용하여 클라이언트 응용 프로그램을 생성하는 경우 필요한 JAR 파일을 포함합니다. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.
UserManagerUtilServiceClientclient 만들기
사용자를 프로그래밍 방식으로 동기화하려면 먼저 UserManagerUtilServiceClient
개체를 만들어야 합니다.
Enterprise 도메인 지정
사용자 관리 API를 사용하여 동기화 작업을 수행하기 전에 사용자가 속한 Enterprise 도메인을 지정합니다. 하나 이상의 Enterprise 도메인을 지정할 수 있습니다. 동기화 작업을 프로그래밍 방식으로 수행하려면 먼저 관리 콘솔을 사용하여 엔터프라이즈 도메인을 설정해야 합니다. (관리 도움말을 참조하세요.)
동기화 작업 호출
하나 이상의 Enterprise 도메인을 지정한 후 동기화 작업을 수행할 수 있습니다. 이 작업을 수행하는 데 걸리는 시간은 사용자 저장소에 있는 사용자 레코드 수에 따라 다릅니다.
동기화 작업이 완료되었는지 확인
동기화 작업을 프로그래밍 방식으로 수행하면 작업이 완료되었는지 확인할 수 있습니다.
추가 참조
Java API를 사용하여 프로그래밍 방식으로 사용자 동기화 programmatically-synchronizing-users-using-the-java-api
Java(사용자 관리 API)를 사용하여 사용자를 동기화합니다.
-
프로젝트 파일을 포함합니다.
Java 프로젝트의 클래스 경로에 adobe-usermanager-client.jar 및 adobe-usermanager-util-client.jar과 같은 클라이언트 JAR 파일을 포함합니다.
-
UserManagerUtilServiceClient 클라이언트를 만듭니다.
해당 생성자를 사용하고 연결 속성이 포함된
ServiceClientFactory
개체를 전달하여UserManagerUtilServiceClient
개체를 만듭니다. -
Enterprise 도메인을 지정합니다.
- 사용자 동기화 작업을 시작하려면
UserManagerUtilServiceClient
개체의scheduleSynchronization
메서드를 호출하십시오. HashSet
생성자를 사용하여java.util.Set
인스턴스를 만듭니다.String
을(를) 데이터 형식으로 지정하십시오. 이Java.util.Set
인스턴스는 동기화 작업이 적용되는 도메인 이름을 저장합니다.- 추가할 각 도메인 이름에 대해
java.util.Set
개체의 add 메서드를 호출하고 도메인 이름을 전달합니다.
- 사용자 동기화 작업을 시작하려면
-
동기화 작업을 호출합니다.
Context
개체를 반환하는ServiceClientFactory
개체의getContext
메서드를 호출합니다.그런 다음
Context
개체의initPrincipal
메서드를 호출하고AuthResult
을(를) 전달합니다.
추가 참조