建立邀請外部使用者處理常式

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

您可以為Rights Management服務建立邀請外部用戶處理程式。邀請外部用戶處理程式可讓Rights Management服務邀請外部用戶成為Rights Management用戶。當使用者成為Rights Management使用者後，使用者就可以執行工作，例如開啟受原則保護的PDF檔案。在邀請外部使用者處理常式部署至AEM Forms後，您可以使用管理主控台與其互動。

注意

邀請外部使用者處理常式是AEM Forms元件。在您建立邀請外部使用者處理常式之前，建議您熟悉建立元件。

步驟摘要

要開發邀請外部用戶處理程式，必須執行以下步驟：

設定您的開發環境。
定義邀請外部使用者處理常式實作。
定義元件XML檔案。
部署邀請外部使用者處理常式。
測試邀請外部使用者處理常式。

設定您的開發環境

若要設定您的開發環境，您必須建立新的Java專案，例如Eclipse專案。支援的Eclipse版本為3.2.1或更新版本。

Rights ManagementSPI要求在項目的類路徑中設定edc-server-spi.jar檔案。如果未引用此JAR檔案，則不能在Java項目中使用Rights ManagementSPI。此JAR檔案隨[install directory]\Adobe\Adobe_Experience_Manager_forms\sdk\spi資料夾中的AEM FormsSDK一起安裝。

除了將edc-server-spi.jar檔案新增至專案的類別路徑外，您還必須新增使用Rights Management服務API所需的JAR檔案。在邀請外部用戶處理程式中使用Rights Management服務API時，需要這些檔案。

定義邀請外部用戶處理程式實施

要開發邀請外部用戶處理程式，必須建立實現com.adobe.edc.server.spi.ersp.InvitedUserProvider介面的Java類。此類包含名為invitedUser的方法，當使用新增已邀請的使用者頁面提交電子郵件地址時，Rights Management服務會叫用此方法。

invitedUser方法接受java.util.List實例，該實例包含從添加邀請的用戶頁提交的字串型電子郵件地址。 invitedUser方法返回InvitedUserProviderResult對象的陣列，通常是電子郵件地址與用戶對象的映射（不返回null）。

注意

除了示範如何建立邀請外部使用者處理常式外，本節也使用AEM FormsAPI。

邀請外部用戶處理程式的實現包含名為createLocalPrincipalAccount的用戶定義方法。此方法接受一個字串值，該字串值指定電子郵件地址為參數值。 createLocalPrincipalAccount方法假定存在名為EDC_EXTERNAL_REGISTERED的本地域。您可以將此域名配置為任何您希望的域名；但是，對於生產應用程式，您可能想要與企業網域整合。

createUsers方法會重複每個電子郵件地址，並建立對應的使用者物件（EDC_EXTERNAL_REGISTERED網域中的本機使用者）。最後，調用doEmails方法。此方法被有意保留為樣本中的樁模組。在生產實作中，它會包含應用程式邏輯，以傳送邀請電子郵件訊息給新建立的使用者。它留在範例中，以示範實際應用程式的應用程式邏輯流程。

定義邀請外部用戶處理程式實施

下列邀請外部使用者處理常式實作接受從「新增已邀請的使用者」頁面提交的電子郵件地址，此頁面可透過管理控制台存取。

package com.adobe.livecycle.samples.inviteexternalusers.provider; 
 
import com.adobe.edc.server.spi.ersp.*; 
import com.adobe.idp.dsc.clientsdk.ServiceClientFactory; 
import com.adobe.idp.um.api.*; 
import com.adobe.idp.um.api.infomodel.*; 
import com.adobe.idp.um.api.impl.UMBaseLibrary; 
import com.adobe.livecycle.usermanager.client.DirectoryManagerServiceClient; 
 
import java.util.ArrayList; 
import java.util.Iterator; 
import java.util.List; 
 
public class InviteExternalUsersSample implements InvitedUserProvider 
{ 
       private ServiceClientFactory _factory = null; 
 
       private User createLocalPrincipalAccount(String email_address) throws Exception 
       { 
    String ret = null; 
 
    //  Assume the local domain already exists! 
    String domain = "EDC_EXTERNAL_REGISTERED"; 
         
    List aliases = new ArrayList(); 
    aliases.add( email_address ); 
         
    User local_user = UMBaseLibrary.createUser( email_address, domain, email_address ); 
    local_user.setCommonName( email_address ); 
    local_user.setEmail( email_address ); 
    local_user.setEmailAliases( aliases ); 
         
    //  You may wish to disable the local user until, for example, his registration is processed by a confirmation link 
    //local_user.setDisabled( true ); 
 
    DirectoryManager directory_manager = new DirectoryManagerServiceClient( _factory ); 
    String ret_oid = directory_manager.createLocalUser( local_user, null ); 
     
    if( ret_oid == null ) 
    { 
        throw new Exception( "FAILED TO CREATE PRINCIPAL FOR EMAIL ADDRESS: " + email_address ); 
    } 
 
    return local_user; 
       } 
 
       protected User[] createUsers( List emails ) throws Exception 
       { 
    ArrayList ret_users = new ArrayList(); 
 
    _factory = ServiceClientFactory.createInstance(); 
 
    Iterator iter = emails.iterator(); 
 
    while( iter.hasNext() ) 
    { 
        String current_email = (String)iter.next(); 
 
        ret_users.add( createLocalPrincipalAccount( current_email ) ); 
    } 
 
    return (User[])ret_users.toArray( new User[0] ); 
       } 
 
       protected void doInvitations(List emails) 
       { 
    //  Here you may choose to send the users who were created an invitation email 
    //  This step is completely optional, depending on your requirements.   
       } 
 
       public InvitedUserProviderResult[] invitedUser(List emails) 
       { 
    //  This sample demonstrates the workflow for inviting a user via email 
 
    try 
    { 
 
        User[] principals = createUsers(emails); 
 
        InvitedUserProviderResult[] result = new InvitedUserProviderResult[principals.length]; 
        for( int i = 0; i < principals.length; i++ ) 
        { 
        result[i] = new InvitedUserProviderResult(); 
 
        result[i].setEmail( (String)emails.get( i ) ); 
        result[i].setUser( principals[i] ); 
        } 
 
        doInvitations(emails); 
 
        System.out.println( "SUCCESSFULLY INVITED " + result.length + " USERS" ); 
 
        return result; 
 
    } 
    catch( Exception e ) 
    { 
        System.out.println( "FAILED TO INVITE USERS FOR INVITE USERS SAMPLE" ); 
        e.printStackTrace(); 
 
        return new InvitedUserProviderResult[0]; 
    } 
       } 
}

注意

此Java類會儲存為名為InviteExternalUsersSample.java的JAVA檔案。

為授權處理程式定義元件XML檔案

您必須定義元件XML檔案，才能部署邀請外部使用者處理常式元件。每個元件都有元件XML檔案，並提供有關元件的中繼資料。

以下component.xml檔案用於邀請外部使用者處理常式。請注意，服務名為InviteExternalUsersSample ，此服務公開的操作名為invitedUser。輸入參數是java.util.List實例，輸出值是com.adobe.edc.server.spi.esrp.InvitedUserProviderResult實例的陣列。

為邀請外部用戶處理程式定義元件XML檔案

<component xmlns="http://adobe.com/idp/dsc/component/document"> 
<component-id>com.adobe.livecycle.samples.inviteexternalusers</component-id> 
<version>1.0</version> 
<bootstrap-class>com.adobe.livecycle.samples.inviteexternalusers.provider.BootstrapImpl</bootstrap-class> 
<descriptor-class>com.adobe.idp.dsc.component.impl.DefaultPOJODescriptorImpl</descriptor-class> 
<services> 
<service name="InviteExternalUsersSample"> 
<specifications> 
<specification spec-id="com.adobe.edc.server.spi.ersp.InvitedUserProvider"/> 
</specifications> 
<specification-version>1.0</specification-version> 
<implementation-class>com.adobe.livecycle.samples.inviteexternalusers.provider.InviteExternalUsersSample</implementation-class> 
<auto-deploy category-id="Samples" service-id="InviteExternalUsersSample" major-version="1" minor-version="0"/> 
<operations> 
<operation name="invitedUser"> 
<input-parameter name="input" type="java.util.List" required="true"/> 
<output-parameter name="result" type="com.adobe.edc.server.spi.esrp.InvitedUserProviderResult[]"/> 
</operation> 
</operations> 
</service> 
</services> 
</component>

封裝邀請外部使用者處理常式

若要將邀請外部使用者處理常式部署至AEM Forms，您必須將Java專案封裝至JAR檔案。您必須確保邀請外部用戶處理程式的業務邏輯所依賴的外部JAR檔案（如edc-server-spi.jar和adobe-rightsmanagement-client.jar檔案）也包含在JAR檔案中。此外，元件XML檔案也必須存在。 component.xml檔案和外部JAR檔案必須位於JAR檔案的根目錄中。

注意

在下圖中，顯示BootstrapImpl類。本節不討論如何建立BootstrapImpl類。

下圖顯示封裝在邀請外部使用者處理常式的JAR檔案中的Java專案內容。

邀請使用者

答：元件B所需的外部JAR檔案。JAVA檔案

您必須將邀請外部用戶處理程式打包到JAR檔案中。在上圖中，請注意。JAVA檔案已列出。打包到JAR檔案後，還必須指定相應的。CLASS檔案。沒有。CLASS檔案，授權處理程式將無法工作。

注意

將外部授權處理常式封裝到JAR檔案後，您就可將元件部署至AEM Forms。指定時間只能部署一個邀請外部使用者處理常式。

注意

您也可以以程式設計方式部署元件。

測試邀請外部用戶處理程式

若要測試邀請外部使用者處理常式，您可以使用管理控制台新增要邀請的外部使用者。

若要使用管理控制台新增要邀請的外部使用者：

使用Workbench部署邀請外部使用者處理常式的JAR檔案。
重新啟動應用程式伺服器。
登入管理控制台。
按一下「服務 > Rights Management > 配置 >已邀請用戶註冊」。
選中啟用邀請的用戶註冊框，以啟用邀請的用戶註冊。在使用內置註冊系統下，按一下否。儲存您的設定。
在管理控制台首頁，按一下「設定 > 使用者管理 > 網域管理」。
按一下新建本地域。在以下頁面上，建立名稱和標識符值為EDC_EXTERNAL_REGISTERED的域。儲存您的變更。
在管理控制台首頁中，按一下「服務 > Rights Management > 已邀請和本地用戶」。此時將顯示添加邀請的用戶頁。
輸入電子郵件地址（因為目前的邀請外部使用者處理常式實際上不會傳送電子郵件訊息，所以電子郵件地址不一定有效）。按一下「確定」。系統會邀請用戶。
在管理控制台首頁中，按一下「設定 > 使用者管理 > 使用者和群組」。
在Find欄位中，輸入您指定的電子郵件地址。按一下查找。您邀請的使用者會以使用者身分出現在本機EDC_EXTERNAL_REGISTERED網域中。