文件AEM 6.5使用手冊

管理使用者 managing-users

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • undefined

本檔案中的範例和範例僅適用於JEE環境上的AEM Forms。

關於使用者管理

您可以使用User Management API建立使用者端應用程式，以管理角色、許可權和主體（可以是使用者或群組），並驗證使用者。 使用者管理API包含下列AEM Forms API：

  • 目錄管理員服務API
  • Authentication Manager服務API
  • 授權管理員服務API

「使用者管理」可讓您指派、移除及決定角色和許可權。 它也可讓您指派、移除及查詢網域、使用者和群組。 最後，您可以使用「使用者管理」來驗證使用者。

在新增使用者中，您將瞭解如何以程式設計方式新增使用者。 本節使用目錄管理員服務API。

在刪除使用者中，您將瞭解如何以程式設計方式刪除使用者。 本節使用目錄管理員服務API。

在管理使用者和群組中，您將瞭解本機使用者和目錄使用者之間的差異，並檢視如何使用Java和Web服務API以程式設計方式管理使用者和群組的範例。 本節使用目錄管理員服務API。

在管理角色和許可權中，您將瞭解系統角色和許可權，以及您可以以程式設計方式做哪些事來增強它們，並檢視有關如何使用Java和Web服務API以程式設計方式管理角色和許可權的範例。 本節同時使用目錄管理員服務API和授權管理員服務API。

在驗證使用者中，您將會看到如何使用Java和Web服務API以程式設計方式驗證使用者的範例。 本節使用授權管理員服務API。

瞭解驗證程式

「使用者管理」提供內建的驗證功能，也提供您連線至您自己的驗證提供者的功能。 當「使用者管理」收到驗證要求時（例如，使用者嘗試登入），會將使用者資訊傳遞給驗證提供者以進行驗證。 「使用者管理」會在驗證使用者之後，從驗證提供者接收結果。

下圖顯示嘗試登入的一般使用者、「使用者管理」和驗證提供者之間的互動。

mu_mu_umauth_process

下表說明驗證程式的每個步驟。

步驟
說明
1
使用者嘗試登入叫用「使用者管理」的服務。 使用者指定使用者名稱和密碼。
2
「使用者管理」會將使用者名稱和密碼以及組態資訊傳送給驗證提供者。
3
驗證提供者會連線到使用者存放區並驗證使用者。
4
驗證提供者會將結果傳回給「使用者管理」。
5
「使用者管理」可讓使用者登入或拒絕存取產品。
NOTE
如果伺服器時區與使用者端時區不同，使用WebSphere Application Server叢集上的.NET使用者端在本機SOAP棧疊上使用AEM Forms產生PDF服務的WSDL時，可能會發生下列「使用者管理」驗證錯誤：

[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存放庫來儲存使用者記錄，您可以建立自己的目錄服務提供者，與您的存放庫搭配使用。

目錄服務提供者會應使用者管理的要求，從使用者存放區擷取記錄。 「使用者管理」會定期快取資料庫中的使用者和群組記錄，以改善效能。

目錄服務提供者可用來將「使用者管理」資料庫與使用者存放區同步。 此步驟可確保所有使用者目錄資訊以及所有使用者和群組記錄都是最新的。

此外，DirectoryManagerService可讓您建立和管理網域。 網域會定義不同的使用者群。 網域邊界通常根據組織的建構方式或使用者存放區的設定方式來定義。 User Management網域提供驗證提供者和目錄服務提供者使用的組態設定。

在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

您可以使用目錄管理員服務API （Java和Web服務），以程式設計方式將使用者新增到AEM Forms。 新增使用者之後，您可以在執行需要使用者的服務操作時使用該使用者。 例如，您可以將任務指派給新使用者。

步驟摘要 summary-of-steps

若要新增使用者，請執行下列步驟：

  1. 包含專案檔案。
  2. 建立DirectoryManagerService使用者端。
  3. 定義使用者資訊。
  4. 新增使用者至AEM Forms。
  5. 確認已新增使用者。

包含專案檔

在您的開發專案中包含必要的檔案。 如果您使用Java建立使用者端應用程式，請包含必要的JAR檔案。 如果您使用Web服務，請包含Proxy檔案。

建立DirectoryManagerService使用者端

在您以程式設計方式執行「目錄管理員」服務作業之前，請先建立「目錄管理員服務API」使用者端。

定義使用者資訊

當您使用目錄管理員服務API新增使用者時，請定義該使用者的資訊。 通常，在新增使用者時，您會定義以下值：

  • 網域名稱：使用者所屬的網域（例如，DefaultDom）。
  • 使用者識別碼值：使用者的識別碼值（例如，wblue）。
  • 主體型別：使用者的型別(例如，您可以指定USER)。
  • 名字：使用者的名字（例如，Wendy）。
  • 姓氏：使用者的姓氏（例如，Blue)）。
  • 地區設定：使用者的地區設定資訊。

將使用者新增至AEM Forms

定義使用者資訊後，您可以將使用者新增至AEM Forms。 若要新增使用者，請叫用DirectoryManagerServiceClient物件的createLocalUser方法。

確認使用者已新增

您可以確認已新增使用者，以確保未發生任何問題。 使用使用者識別碼值來尋找新使用者。

另請參閱

使用Java API新增使用者

使用Web服務API新增使用者

包含AEM Forms Java程式庫檔案

設定連線屬性

刪除使用者

使用Java API新增使用者 add-users-using-the-java-api

使用目錄管理員服務API (Java)新增使用者：

  1. 包含專案檔案。

    在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-usermanager-client.jar。

  2. 建立DirectoryManagerServices使用者端。

    使用它的建構函式並傳遞包含連線屬性的ServiceClientFactory物件來建立DirectoryManagerServiceClient物件。

  3. 定義使用者資訊。

    • 使用物件的建構函式建立UserImpl物件。
    • 透過叫用UserImpl物件的setDomainName方法來設定主要名稱。 傳遞指定網域名稱的字串值。
    • 透過叫用UserImpl物件的setPrincipalType方法來設定主體型別。 傳遞指定使用者型別的字串值。 例如，您可以指定USER。
    • 透過叫用UserImpl物件的setUserid方法來設定使用者識別碼值。 傳遞字串值，指定使用者識別碼值。 例如，您可以指定wblue。
    • 透過叫用UserImpl物件的setCanonicalName方法來設定規範名稱。 傳遞字串值，指定使用者的正式名稱。 例如，您可以指定wblue。
    • 透過叫用UserImpl物件的setGivenName方法來設定名字。 傳遞字串值，指定使用者的名字。 例如，您可以指定Wendy。
    • 透過叫用UserImpl物件的setFamilyName方法來設定系列名稱。 傳遞字串值，指定使用者的姓氏。 例如，您可以指定Blue。
    note note
    NOTE
    叫用屬於UserImpl物件的方法，以設定其他值。 例如，您可以叫用UserImpl物件的setLocale方法來設定地區設定值。

  4. 新增使用者至AEM Forms。

    叫用DirectoryManagerServiceClient物件的createLocalUser方法，並傳遞下列值：

    • 代表新使用者的UserImpl物件
    • 代表使用者密碼的字串值

    createLocalUser方法會傳回指定本機使用者識別碼值的字串值。

  5. 確認使用者已新增。

    • 使用物件的建構函式建立PrincipalSearchFilter物件。
    • 透過叫用PrincipalSearchFilter物件的setUserId方法來設定使用者識別碼值。 傳遞代表使用者識別碼值的字串值。
    • 叫用DirectoryManagerServiceClient物件的findPrincipals方法並傳遞PrincipalSearchFilter物件。 此方法會傳回java.util.List執行個體，其中每個元素都是User物件。 逐一檢視java.util.List執行個體以找出使用者。

另請參閱

步驟摘要

快速入門(SOAP模式)：使用Java API新增使用者

包含AEM Forms Java程式庫檔案

設定連線屬性

使用Web服務API新增使用者 add-users-using-the-web-service-api

使用目錄管理員服務API （Web服務）新增使用者：

  1. 包含專案檔案。

    建立使用MTOM的Microsoft .NET專案。 請確定您對服務參考使用下列WSDL定義： http://localhost:8080/soap/services/DirectoryManagerService?WSDL&lc_version=9.0.1。

    note note
    NOTE
    將localhost取代為主控AEM Forms之伺服器的IP位址。

  2. 建立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驗證：

      • 將AEM表單使用者名稱指派給欄位DirectoryManagerServiceClient.ClientCredentials.UserName.UserName。
      • 將對應的密碼值指派給欄位DirectoryManagerServiceClient.ClientCredentials.UserName.Password。
      • 將常數值HttpClientCredentialType.Basic指派給欄位BasicHttpBindingSecurity.Transport.ClientCredentialType。
      • 將常數值BasicHttpSecurityMode.TransportCredentialOnly指派給欄位BasicHttpBindingSecurity.Security.Mode。

  3. 定義使用者資訊。

    • 使用物件的建構函式建立UserImpl物件。
    • 將字串值指派給UserImpl物件的domainName欄位，以設定主要網域名稱。
    • 將字串值指派給UserImpl物件的principalType欄位，以設定主體型別。 例如，您可以指定USER。
    • 將字串值指派給UserImpl物件的userid欄位，以設定使用者識別碼值。
    • 將字串值指派給UserImpl物件的canonicalName欄位，以設定標準名稱值。
    • 將字串值指派給UserImpl物件的givenName欄位，以設定指定的名稱值。
    • 將字串值指派給UserImpl物件的familyName欄位，以設定系列名稱值。

  4. 新增使用者至AEM Forms。

    叫用DirectoryManagerServiceClient物件的createLocalUser方法，並傳遞下列值：

    • 代表新使用者的UserImpl物件
    • 代表使用者密碼的字串值

    createLocalUser方法會傳回指定本機使用者識別碼值的字串值。

  5. 確認使用者已新增。

    • 使用物件的建構函式建立PrincipalSearchFilter物件。
    • 將代表使用者識別碼值的字串值指派給PrincipalSearchFilter物件的userId欄位，以設定使用者的使用者識別碼值。
    • 叫用DirectoryManagerServiceClient物件的findPrincipals方法並傳遞PrincipalSearchFilter物件。 此方法會傳回MyArrayOfUser集合物件，其中每個元素都是User物件。 逐一檢視MyArrayOfUser集合以找出使用者。

另請參閱

步驟摘要

使用MTOM叫用AEM Forms

使用SwaRef叫用AEM Forms

刪除使用者 deleting-users

您可以使用目錄管理員服務API （Java和Web服務），以程式設計方式從AEM Forms中刪除使用者。 刪除使用者後，該使用者將無法再用來執行需要使用者的服務操作。 例如，您無法將任務指派給已刪除的使用者。

步驟摘要 summary_of_steps-1

若要刪除使用者，請執行下列步驟：

  1. 包含專案檔案。
  2. 建立DirectoryManagerService使用者端。
  3. 指定要刪除的使用者。
  4. 從AEM Forms刪除使用者。

包含專案檔

在您的開發專案中包含必要的檔案。 如果您使用Java建立使用者端應用程式，請包含必要的JAR檔案。 如果您使用Web服務，請包含Proxy檔案。

建立DirectoryManagerService使用者端

在您以程式設計方式執行「目錄管理員服務API」作業之前，請先建立「目錄管理員」服務使用者端。

指定要刪除的使用者

您可以使用使用者的識別碼值來指定要刪除的使用者。

從AEM Forms刪除使用者

若要刪除使用者，請叫用DirectoryManagerServiceClient物件的deleteLocalUser方法。

另請參閱

使用Java API刪除使用者

使用Web服務API刪除使用者

包含AEM Forms Java程式庫檔案

設定連線屬性

新增使用者

使用Java API刪除使用者 delete-users-using-the-java-api

使用目錄管理員服務API (Java)刪除使用者：

  1. 包含專案檔案。

    在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-usermanager-client.jar。

  2. 建立DirectoryManagerService使用者端。

    使用它的建構函式並傳遞包含連線屬性的ServiceClientFactory物件來建立DirectoryManagerServiceClient物件。

  3. 指定要刪除的使用者。

    • 使用物件的建構函式建立PrincipalSearchFilter物件。
    • 透過叫用PrincipalSearchFilter物件的setUserId方法來設定使用者識別碼值。 傳遞代表使用者識別碼值的字串值。
    • 叫用DirectoryManagerServiceClient物件的findPrincipals方法並傳遞PrincipalSearchFilter物件。 此方法會傳回java.util.List執行個體，其中每個元素都是User物件。 逐一檢視java.util.List執行個體，找出要刪除的使用者。

  4. 從AEM Forms刪除使用者。

    叫用DirectoryManagerServiceClient物件的deleteLocalUser方法，並傳遞User物件的oid欄位值。 叫用User物件的getOid方法。 使用從java.util.List執行個體擷取的User物件。

另請參閱

步驟摘要

快速入門（EJB模式）：使用Java API刪除使用者

快速入門(SOAP模式)：使用Java API刪除使用者

包含AEM Forms Java程式庫檔案

設定連線屬性

使用Web服務API刪除使用者 delete-users-using-the-web-service-api

使用目錄管理員服務API （Web服務）刪除使用者：

  1. 包含專案檔案。

    在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-usermanager-client.jar。

  2. 建立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驗證：

      • 將AEM表單使用者名稱指派給欄位DirectoryManagerServiceClient.ClientCredentials.UserName.UserName。
      • 將對應的密碼值指派給欄位DirectoryManagerServiceClient.ClientCredentials.UserName.Password。
      • 將常數值HttpClientCredentialType.Basic指派給欄位BasicHttpBindingSecurity.Transport.ClientCredentialType。
      • 將常數值BasicHttpSecurityMode.TransportCredentialOnly指派給欄位BasicHttpBindingSecurity.Security.Mode。

  3. 指定要刪除的使用者。

    • 使用物件的建構函式建立PrincipalSearchFilter物件。
    • 將字串值指派給PrincipalSearchFilter物件的userId欄位，以設定使用者識別碼值。
    • 叫用DirectoryManagerServiceClient物件的findPrincipals方法並傳遞PrincipalSearchFilter物件。 此方法會傳回MyArrayOfUser集合物件，其中每個元素都是User物件。 逐一檢視MyArrayOfUser集合以找出使用者。 從MyArrayOfUser集合物件擷取的User物件是用來刪除使用者。

  4. 從AEM Forms刪除使用者。

    將User物件的oid欄位值傳遞至DirectoryManagerServiceClient物件的deleteLocalUser方法，以刪除使用者。

另請參閱

步驟摘要

使用MTOM叫用AEM Forms

使用SwaRef叫用AEM Forms

建立群組 creating-groups

您可以使用目錄管理員服務API （Java和Web服務）以程式設計方式建立AEM Forms群組。 建立群組之後，您可以使用該群組來執行需要群組的服務作業。 例如，您可以將使用者指派給新群組。 （請參閱管理使用者和群組。）

步驟摘要 summary_of_steps-2

若要建立群組，請執行下列步驟：

  1. 包含專案檔案。
  2. 建立DirectoryManagerService使用者端。
  3. 確定群組不存在。
  4. 建立群組。
  5. 對群組執行動作。

包含專案檔

在您的開發專案中包含必要的檔案。 如果您使用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使用者端

在您以程式設計方式執行「目錄管理員」服務作業之前，請先建立「目錄管理員服務API」使用者端。

判斷群組是否存在

建立群組時，請確定該群組不存在於同一個網域中。 也就是說，兩個群組在相同網域中不能有相同的名稱。 若要執行此工作，請執行搜尋並根據兩個值篩選搜尋結果。 將主體型別設定為com.adobe.idp.um.api.infomodel.Principal.PRINCIPALTYPE_GROUP以確保只傳回群組。 此外，請確定您指定網域名稱。

建立群組

確定群組不存在於領域之後，請建立群組並指定下列屬性：

  • CommonName：群組的名稱。
  • 網域：新增群組的網域。
  • 描述：群組的描述。

對群組執行動作

建立群組後，您可以使用群組執行動作。 例如，您可以將使用者新增至群組。 若要新增使用者至群組，請擷取使用者和群組的唯一識別碼值。 將這些值傳遞至addPrincipalToLocalGroup方法。

另請參閱

使用Java API建立群組

包含AEM Forms Java程式庫檔案

設定連線屬性

新增使用者

刪除使用者

使用Java API建立群組 create-groups-using-the-java-api

使用目錄管理員服務API (Java)建立群組：

  1. 包含專案檔案。

    在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-usermanager-client.jar。

  2. 建立DirectoryManagerService使用者端。

    使用它的建構函式並傳遞包含連線屬性的ServiceClientFactory物件來建立DirectoryManagerServiceClient物件。

  3. 判斷群組是否存在。

    • 使用物件的建構函式建立PrincipalSearchFilter物件。
    • 透過叫用PrincipalSearchFilter物件的setPrincipalType物件來設定主體型別。 傳遞值com.adobe.idp.um.api.infomodel.Principal.PRINCIPALTYPE_GROUP。
    • 透過叫用PrincipalSearchFilter物件的setSpecificDomainName物件來設定網域。 傳遞指定網域名稱的字串值。
    • 若要尋找群組，請叫用DirectoryManagerServiceClient物件的findPrincipals方法（主體可以是群組）。 傳遞指定主體型別和網域名稱的PrincipalSearchFilter物件。 此方法會傳回java.util.List執行個體，其中每個元素都是Group執行個體。 每個群組執行個體都符合使用PrincipalSearchFilter物件所指定的篩選器。
    • 反複執行java.util.List執行個體。 對於每個元素，擷取群組名稱。 確保群組名稱不等於新群組名稱。

  4. 建立群組。

    • 如果群組不存在，請叫用Group物件的setCommonName方法，並傳遞指定群組名稱的字串值。
    • 叫用Group物件的setDescription方法，並傳遞指定群組描述的字串值。
    • 叫用Group物件的setDomainName方法，並傳遞指定網域名稱的字串值。
    • 叫用DirectoryManagerServiceClient物件的createLocalGroup方法並傳遞Group執行個體。

    createLocalUser方法會傳回指定本機使用者識別碼值的字串值。

  5. 對群組執行動作。

    • 使用物件的建構函式建立PrincipalSearchFilter物件。
    • 透過叫用PrincipalSearchFilter物件的setUserId方法來設定使用者識別碼值。 傳遞代表使用者識別碼值的字串值。
    • 叫用DirectoryManagerServiceClient物件的findPrincipals方法並傳遞PrincipalSearchFilter物件。 此方法會傳回java.util.List執行個體，其中每個元素都是User物件。 逐一檢視java.util.List執行個體以找出使用者。
    • 透過叫用DirectoryManagerServiceClient物件的addPrincipalToLocalGroup方法新增使用者到群組。 傳遞User物件的getOid方法的傳回值。 傳遞Group物件的getOid方法的傳回值（使用代表新群組的Group執行個體）。

另請參閱

步驟摘要

包含AEM Forms Java程式庫檔案

設定連線屬性

管理使用者和群組 managing-users-and-groups

本主題說明如何使用(Java)以程式設計方式指派、移除及查詢網域、使用者和群組。

NOTE
設定網域時，您必須為群組和使用者設定唯一識別碼。 選擇的屬性不僅在LDAP環境中必須是唯一的，而且必須是不可變的，並且不會在目錄中變更。 此屬性也必須是簡單字串資料型別（目前Active Directory 2000/2003允許的唯一例外是"objectsid"，這是二進位值）。 例如，Novell eDirectory屬性"GUID"不是簡單的字串資料型別，因此將無法運作。
  • 對於Active Directory，請使用"objectsid"。
  • 對於SunOne，請使用"nsuniqueid"。
NOTE
不支援在LDAP目錄同步處理進行中時建立多個本機使用者和群組。 嘗試此程式可能會導致錯誤。

步驟摘要 summary_of_steps-3

若要管理使用者和群組，請執行下列步驟：

  1. 包含專案檔案。
  2. 建立DirectoryManagerService使用者端。
  3. 叫用適當的使用者或群組作業。

包含專案檔

在您的開發專案中包含必要的檔案。 如果您使用Java建立使用者端應用程式，則請包含必要的JAR檔案。 如果您使用Web服務，請務必包含Proxy檔案。

建立DirectoryManagerService使用者端

您必須先建立「目錄管理員」服務使用者端，才能以程式設計方式執行「目錄管理員」服務作業。 使用Java API可透過建立DirectoryManagerServiceClient物件來完成。 使用Web服務API可透過建立DirectoryManagerServiceService物件來完成。

叫用適當的使用者或群組作業

建立服務使用者端後，您就可以叫用使用者或群組管理作業。 服務使用者端可讓您指派、移除及查詢網域、使用者和群組。 請注意，可以將目錄主體或本機主體新增至本機群組，但無法將本機主體新增至目錄群組。

另請參閱

使用Java API管理使用者和群組

使用網站服務API管理使用者和群組

包含AEM Forms Java程式庫檔案

設定連線屬性

使用者管理員API快速入門

使用Java API管理使用者和群組 managing-users-and-groups-using-the-java-api

若要使用(Java)以程式設計方式管理使用者、群組和網域，請執行以下工作：

  1. 包含專案檔案。

    在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-usermanager-client.jar。 如需這些檔案位置的相關資訊，請參閱包含AEM Forms Java程式庫檔案。

  2. 建立DirectoryManagerService使用者端。

    使用它的建構函式並傳遞包含連線屬性的ServiceClientFactory物件來建立DirectoryManagerServiceClient物件。 如需詳細資訊，請參閱設定連線內容​.

  3. 叫用適當的使用者或群組作業。

    若要尋找使用者或群組，請叫用DirectoryManagerServiceClient物件的其中一個方法來尋找主參與者（因為主參與者可以是使用者或群組）。 在下列範例中，使用搜尋篩選器（一個PrincipalSearchFilter物件）呼叫findPrincipals方法。

    由於此案例中的傳回值是包含Principal物件的java.util.List，請逐一檢視結果並將Principal物件轉換為User或Group物件。

    使用結果User或Group物件（兩者都繼承自Principal介面），擷取工作流程中所需的資訊。 例如，網域名稱和規範名稱值組合在一起時，會唯一識別主參與者。 分別透過叫用Principal物件的getDomainName和getCanonicalName方法來擷取它們。

    若要刪除本機使用者，請叫用DirectoryManagerServiceClient物件的deleteLocalUser方法，並傳遞使用者的識別碼。

    若要刪除本機群組，請叫用DirectoryManagerServiceClient物件的deleteLocalGroup方法，並傳遞群組的識別碼。

另請參閱

步驟摘要

包含AEM Forms Java程式庫檔案

設定連線屬性

使用網站服務API管理使用者和群組 managing-users-and-groups-using-the-web-service-api

若要使用「目錄管理員服務API」（Web服務）以程式設計方式管理使用者、群組和網域，請執行下列工作：

  1. 包含專案檔案。

  2. 建立DirectoryManagerService使用者端。

    使用您的Proxy類別的建構函式建立DirectoryManagerServiceService物件。

  3. 叫用適當的使用者或群組作業。

    若要尋找使用者或群組，請叫用DirectoryManagerServiceService物件的其中一個方法來尋找主參與者（因為主參與者可以是使用者或群組）。 在下列範例中，使用搜尋篩選器（一個PrincipalSearchFilter物件）呼叫findPrincipalsWithFilter方法。 使用PrincipalSearchFilter物件時，只有當isLocal屬性設定為true時，才會傳回本機主參與者。 此行為與Java API的情況不同。

    note note
    NOTE
    如果未在搜尋篩選（透過PrincipalSearchFilter.resultsMax欄位）中指定結果數目上限，則最多會傳回1000個結果。 這與使用Java API時的行為不同，在後一種情況下，預設最大值為10個結果。 此外，搜尋方法（例如findGroupMembers）不會產生任何結果，除非在搜尋篩選條件中指定最大數目的結果（例如，透過GroupMembershipSearchFilter.resultsMax欄位）。 這適用於繼承自GenericSearchFilter類別的所有搜尋篩選器。 如需詳細資訊，請參閱AEM Forms API參考。

    由於此案例中的傳回值是包含Principal物件的object[]，請逐一檢視結果並將Principal物件轉換為User或Group物件。

    使用結果User或Group物件（兩者都繼承自Principal介面），擷取工作流程中所需的資訊。 例如，網域名稱和規範名稱值組合在一起時，會唯一識別主參與者。 分別透過叫用Principal物件的domainName和canonicalName欄位來擷取它們。

    若要刪除本機使用者，請叫用DirectoryManagerServiceService物件的deleteLocalUser方法，並傳遞使用者的識別碼。

    若要刪除本機群組，請叫用DirectoryManagerServiceService物件的deleteLocalGroup方法，並傳遞群組的識別碼。

另請參閱

步驟摘要

使用MTOM叫用AEM Forms

管理角色和許可權 managing-roles-and-permissions

本主題說明如何使用授權管理員服務API (Java)以程式設計方式指派、移除及決定角色和許可權。

在AEM Forms中，角色 ​是存取一或多個系統層級資源的許可權群組。 這些許可權是透過「使用者管理」建立並由服務元件強制執行。 例如，管理員可以將「原則集作者」的角色指派給一組使用者。 然後，Rights Management將允許該群組中具有該角色的使用者透過administration console建立原則集。

有兩種角色型別： 預設角色 ​和​ 自訂角色。 預設角色（系統角色） ​已駐留在AEM Forms中。 假設管理員無法刪除或修改預設角色，因此這些角色是不可變的。 管理員建立的自訂角色之後可能會修改或刪除它們，因此是可變的。

角色可讓您更輕鬆地管理許可權。 將角色指派給主體時，系統會自動將一組許可權指派給該主體，而主體的所有特定存取相關決定均會根據該整體指派的許可權集來做出。

步驟摘要 summary_of_steps-4

若要管理角色和許可權，請執行下列步驟：

  1. 包含專案檔案。
  2. 建立AuthorizationManagerService使用者端。
  3. 叫用適當的角色或許可權作業。

包含專案檔

在您的開發專案中包含必要的檔案。 如果您使用Java建立使用者端應用程式，則請包含必要的JAR檔案。 如果您使用Web服務，請務必包含Proxy檔案。

建立AuthorizationManagerService使用者端

您必須先建立AuthorizationManagerService使用者端，才能以程式設計方式執行User Management AuthorizationManagerService作業。 使用Java API可透過建立AuthorizationManagerServiceClient物件來完成。

叫用適當的角色或許可權作業

建立服務使用者端後，您就可以叫用角色或許可權作業。 服務使用者端可讓您指派、移除及決定角色和許可權。

另請參閱

使用Java API管理角色和許可權

使用網站服務API管理角色和許可權

包含AEM Forms Java程式庫檔案

設定連線屬性

使用者管理員API快速入門

使用Java API管理角色和許可權 managing-roles-and-permissions-using-the-java-api

若要使用授權管理員服務API (Java)管理角色和許可權，請執行以下工作：

  1. 包含專案檔案。

    在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-usermanager-client.jar。

  2. 建立AuthorizationManagerService使用者端。

    使用它的建構函式並傳遞包含連線屬性的ServiceClientFactory物件來建立AuthorizationManagerServiceClient物件。

  3. 叫用適當的角色或許可權作業。

    若要將角色指派給主體，請叫用AuthorizationManagerServiceClient物件的assignRole方法，並傳遞下列值：

    • 包含角色識別碼的java.lang.String物件
    • 包含主要識別碼的java.lang.String物件陣列。

    若要從主體移除角色，請叫用AuthorizationManagerServiceClient物件的unassignRole方法，並傳遞下列值：

    • 包含角色識別碼的java.lang.String物件。
    • 包含主要識別碼的java.lang.String物件陣列。

另請參閱

步驟摘要

快速入門(SOAP模式)：使用Java API管理角色和許可權

包含AEM Forms Java程式庫檔案

設定連線屬性

使用網站服務API管理角色和許可權 managing-roles-and-permissions-using-the-web-service-api

使用授權管理員服務API （Web服務）管理角色和許可權：

  1. 包含專案檔案。

    建立使用MTOM的Microsoft .NET專案。 確定您使用下列WSDL定義： http://localhost:8080/soap/services/AuthorizationManagerService?WSDL&lc_version=9.0.1。

    note note
    NOTE
    將localhost取代為主控AEM Forms之伺服器的IP位址。

  2. 建立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驗證：

      • 將AEM表單使用者名稱指派給欄位AuthorizationManagerServiceClient.ClientCredentials.UserName.UserName。
      • 將對應的密碼值指派給欄位AuthorizationManagerServiceClient.ClientCredentials.UserName.Password。
      • 將常數值HttpClientCredentialType.Basic指派給欄位BasicHttpBindingSecurity.Transport.ClientCredentialType。
      • 將常數值BasicHttpSecurityMode.TransportCredentialOnly指派給欄位BasicHttpBindingSecurity.Security.Mode。

  3. 叫用適當的角色或許可權作業。

    若要將角色指派給主體，請叫用AuthorizationManagerServiceClient物件的assignRole方法，並傳遞下列值：

    • 包含角色識別碼的string物件
    • 包含主要識別碼的MyArrayOf_xsd_string物件。

    若要從主體移除角色，請叫用AuthorizationManagerServiceService物件的unassignRole方法，並傳遞下列值：

    • 包含角色識別碼的string物件。
    • 包含主要識別碼的string物件陣列。

另請參閱

步驟摘要

使用MTOM叫用AEM Forms

驗證使用者 authenticating-users

本主題說明如何使用Authentication Manager Service API (Java)讓您的使用者端應用程式以程式設計方式驗證使用者。

可能需要使用者驗證，才能與儲存安全資料的企業資料庫或其他企業儲存區域互動。

例如，假設使用者在網頁中輸入使用者名稱和密碼，並將值提交至託管Forms的J2EE應用程式伺服器。 Forms自訂應用程式可以使用Authentication Manager服務驗證使用者。

如果驗證成功，應用程式會存取安全的企業資料庫。 否則，會傳送訊息給使用者，指出該使用者不是授權使用者。

下圖顯示應用程式的邏輯流程。

au_au_umauth_process

下表說明此圖表中的步驟

步驟
說明
1
使用者存取網站並指定使用者名稱和密碼。 此資訊會提交至裝載AEM Forms的J2EE應用程式伺服器。
2
使用者認證是透過Authentication Manager服務驗證。 如果使用者認證有效，工作流程會繼續到步驟3。 否則，會傳送訊息給使用者，指出該使用者不是授權使用者。
3
使用者資訊和表單設計會從安全企業資料庫中擷取。
4
使用者資訊會與表單設計合併，且表單會呈現給使用者。

步驟摘要 summary_of_steps-5

若要以程式設計方式驗證使用者，請執行下列步驟：

  1. 包含專案檔案。
  2. 建立AuthenticationManagerService使用者端。
  3. 叫用驗證作業。
  4. 如有必要，請擷取內容，以便使用者端應用程式可將其轉送至其他AEM Forms服務以進行驗證。

包含專案檔

在您的開發專案中包含必要的檔案。 如果您使用Java建立使用者端應用程式，則請包含必要的JAR檔案。 如果您使用Web服務，請務必包含Proxy檔案。

建立AuthenticationManagerService使用者端

您必須先建立AuthenticationManagerService使用者端，才能以程式設計方式驗證使用者。 使用Java API時，請建立AuthenticationManagerServiceClient物件。

叫用驗證作業

建立服務使用者端後，您就可以叫用驗證作業。 此作業需要有關使用者的資訊，例如使用者名稱和密碼。 如果使用者未驗證，則會擲回例外狀況。

擷取驗證內容

在驗證使用者之後，您可以根據已驗證的使用者來建立內容。 然後，您可以使用內容叫用其他AEM Forms服務。 例如，您可以使用內容來建立EncryptionServiceClient並使用密碼加密PDF檔案。 確定已驗證的使用者具有呼叫AEM Forms服務所需的名為Services User的角色。

另請參閱

包含AEM Forms Java程式庫檔案

設定連線屬性

使用者管理員API快速入門

使用密碼加密PDF檔案

使用Java API驗證使用者 authenticate-a-user-using-the-java-api

使用Authentication Manager Service API (Java)驗證使用者：

  1. 包含專案檔案。

    在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-usermanager-client.jar。

  2. 建立AuthenticationManagerServices使用者端。

    使用它的建構函式並傳遞包含連線屬性的ServiceClientFactory物件來建立AuthenticationManagerServiceClient物件。

  3. 叫用驗證作業。

    叫用AuthenticationManagerServiceClient物件的authenticate方法，並傳遞下列值：

    • 包含使用者名稱的java.lang.String物件。
    • 包含使用者密碼的位元組陣列（byte[]物件）。 您可以叫用java.lang.String物件的getBytes方法來取得byte[]物件。

    驗證方法傳回AuthResult物件，其中包含已驗證使用者的相關資訊。

  4. 擷取驗證內容。

    叫用ServiceClientFactory物件的getContext方法，這會傳回Context物件。

    然後叫用Context物件的initPrincipal方法並傳遞AuthResult。

使用網站服務API驗證使用者 authenticate-a-user-using-the-web-service-api

使用Authentication Manager服務API （Web服務）驗證使用者：

  1. 包含專案檔案。

  2. 建立AuthenticationManagerService使用者端。

    使用您的Proxy類別的建構函式建立AuthenticationManagerServiceService物件。

  3. 叫用驗證作業。

    叫用AuthenticationManagerServiceClient物件的authenticate方法，並傳遞下列值：

    • 包含使用者名稱的string物件
    • 包含使用者密碼的位元組陣列（byte[]物件）。 您可以使用下列範例中所示的邏輯，將包含密碼的string物件轉換為byte[]陣列，以取得byte[]物件。
    • 傳回的值將為AuthResult物件，可用來擷取有關使用者的資訊。 在以下範例中，會先取得AuthResult物件的authenticatedUser欄位，然後取得結果User物件的canonicalName和domainName欄位，以擷取使用者的資訊。

另請參閱

使用MTOM叫用AEM Forms

使用SwaRef叫用AEM Forms

以程式設計方式同步使用者 programmatically-synchronizing-users

您可以使用使用者管理API，以程式設計方式同步使用者。 當您同步使用者時，會使用使用者存放庫中的使用者資料更新AEM Forms。 例如，假設您將新使用者新增至使用者存放庫。 執行同步化作業後，新使用者會成為AEM Forms使用者。 此外，您使用者存放庫中不再存在的使用者也會從AEM Forms中移除。

下圖顯示與使用者存放庫同步的AEM Forms。

ps_ps_umauth_sync

下表說明此圖表中的步驟

步驟
說明
1
使用者端應用程式要求AEM Forms執行同步作業。
2
AEM Forms會執行同步作業。
3
使用者資訊已更新。
4
使用者可以檢視更新的使用者資訊。

步驟摘要 summary_of_steps-6

若要以程式設計方式同步使用者，請執行下列步驟：

  1. 包含專案檔案。
  2. 建立UserManagerUtilServiceClient使用者端。
  3. 指定企業網域。
  4. 叫用驗證作業。
  5. 判斷同步化作業是否已完成

包含專案檔

在您的開發專案中包含必要的檔案。 如果您使用Java建立使用者端應用程式，則請包含必要的JAR檔案。 如果您使用Web服務，請務必包含Proxy檔案。

建立UserManagerUtilServiceClientclient

您必須先建立UserManagerUtilServiceClient物件，才能以程式設計方式同步使用者。

指定企業網域

在使用「使用者管理API」執行同步化作業之前，請先指定使用者所屬的企業網域。 您可以指定一或多個企業網域。 您必須先使用「管理主控台」設定企業網域，才能以程式設計方式執行同步化作業。 （請參閱管理說明。）

叫用同步作業

指定一或多個企業網域後，即可執行同步化作業。 執行此作業所需的時間取決於使用者存放庫中的使用者記錄數量。

判斷同步處理作業是否完成

以程式設計方式執行同步化作業之後，您可以判斷作業是否已完成。

另請參閱

包含AEM Forms Java程式庫檔案

設定連線屬性

使用者管理員API快速入門

使用密碼加密PDF檔案

使用Java API以程式設計方式同步使用者 programmatically-synchronizing-users-using-the-java-api

使用使用者管理API (Java)同步使用者：

  1. 包含專案檔案。

    在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-usermanager-client.jar和adobe-usermanager-util-client.jar。

  2. 建立UserManagerUtilServiceClient使用者端。

    使用它的建構函式並傳遞包含連線屬性的ServiceClientFactory物件來建立UserManagerUtilServiceClient物件。

  3. 指定企業網域。

    • 叫用UserManagerUtilServiceClient物件的scheduleSynchronization方法以啟動使用者同步作業。
    • 使用HashSet建構函式建立java.util.Set執行個體。 請確定您指定String做為資料型別。 此Java.util.Set執行個體儲存同步化作業套用的網域名稱。
    • 對於每個要新增的網域名稱，叫用java.util.Set物件的新增方法並傳遞網域名稱。

  4. 叫用同步作業。

    叫用ServiceClientFactory物件的getContext方法，這會傳回Context物件。

    然後叫用Context物件的initPrincipal方法並傳遞AuthResult。

另請參閱

以程式設計方式同步使用者

包含AEM Forms Java程式庫檔案

設定連線屬性

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2