管理產生器
本節說明以下主題：
如果您要將在本機部署的 Portlet 提供給遠端做為 WSRP 用戶的其他入口網站，則建立產生器。入口網站可代管多個產生器。用戶可匯入多個由產生器提供的遠端 Portlet。您可以根據您要提供給 WSRP 用戶的 Portlet，來建立一個或多個產生器。產生器可支援註冊，或不需要註冊。如果產生器支援註冊，則用戶必須註冊才能使用產生器。
建立支援註冊的產生器
註冊可在用戶和產生器之間建立技術或業務關係。建立產生器時，您可以定義以下任何一個註冊機制：頻帶內註冊或頻帶外註冊：
如果產生器需要註冊及啟用頻帶內註冊：用戶可透過 WSRP 介面提供詳細資訊，並在產生器中註冊。此外用戶也可選擇透過頻帶外通訊進行註冊。亦即，用戶可提供透過頻帶外通訊所取得的註冊控點。
如果產生器需要註冊及啟用頻帶外註冊：用戶應透過頻帶外通訊取得註冊控點，並在註冊期間提供註冊控點。頻帶外註冊需要手動介入 (例如電話、電子郵件等等)。對於支援頻帶外註冊的產生器，產生器會透過頻帶外通訊取得有關用戶的詳細資訊，並為用戶建立註冊控點。註冊控點會透過頻帶外通訊告知用戶。
建立支援註冊的產生器
-
選取 [入口網站] 標籤。
-
在 [入口網站] 中選取入口網站伺服器。
-
按一下 [WSRP] 標籤。
-
從 [選取 DN] 下拉式功能表中，選取任何 DN，並按一下 [產生器] 標籤。
[WSRP 產生器] 表顯示所有已建立的產生器。
備註 –組織是在 Sun Java System Identity Server 中建立的。根據 Portlet 的可用性選取組織或子組織的 DN。
-
按一下 [新增] 建立新產生器。
-
輸入可識別產生器的名稱。
-
為 [註冊] 選取 [必需]。
-
如果您要用戶在新增配置的產生器時，使用 Sun Java System Portal Server 應用程式介面輸入詳細資訊，請為 [頻帶內註冊] 選取 [支援]。
-
若要新增註冊特性，按一下 [增加列]。輸入值。輸入註冊特性的名稱與描述。
備註 –註冊特性是當用戶在特定的產生器中註冊時，您要向用戶取得的詳細資訊。用戶所輸入的註冊特性可透過「註冊認證程式」類別進行驗證。
-
如果您要用戶透過頻帶外通訊 (例如手機、電子郵件等等) 提供詳細資訊，則選取 [支援頻帶外註冊]。
-
按 [下一步]。
[檢閱] 螢幕顯示您輸入的詳細資訊。檢閱詳細資訊。您可以按 [上一個] 變更您輸入的詳細資訊。
-
按一下 [完成]。
相當於 psadmin 指令
建立不支援註冊的產生器
對於不需要註冊的產生器，用戶不需要輸入任何資訊或透過頻帶外通訊取得任何資訊。在此情況下，用戶無法自訂 (或編輯) 由產生器提供的 Portlet。不支援註冊的產生器會提供「唯讀的」入口網站給用戶。
建立不支援註冊的產生器
-
選取 [入口網站] 標籤。
-
在 [入口網站] 中選取入口網站伺服器。
-
按一下 [WSRP] 標籤。
-
選取 DN。
[已配置的產生器] 表顯示所有已配置的產生器。
-
按一下 [新增]。
-
輸入產生器的名稱。
-
為 [註冊] 選取 [非必需]。
-
按一下 [完成]。
相當於 psadmin 指令
啟用和編輯 WSRP 產生器特性
新建立的產生器應啟用，用戶才能註冊。新增一個或多個 Portlet 可啟用產生器。
可停用產生器。但是，所有在已停用產生器中註冊的用戶無法存取由產生器提供的 Portlet。
啟用和編輯產生器特性
-
在 [產生器] 標籤中，按一下產生器名稱連結。
顯示 [編輯特性] 螢幕。螢幕顯示 WSDL (Web Services Definition Language, Web 服務定義語言) URL。WSDL URL 是特定產生器的唯一的 URL，用戶透過此 URL 來存取產生器。
-
新增一個或多個已發佈的 Portlet 至產生器。
備註 –產生器必須至少有一個已發佈的 Portlet 才能啟用之。螢幕顯示所有與已建立產生器的入口網站相關聯的已發佈 Portlet。
-
選取 Portlet，並按一下 [新增]。
-
編輯 [註冊認證程式類別] (如有需要)。
註冊認證程式用於驗證由用戶輸入的註冊特性。您也可以根據需求自訂此類別。
-
按一下 [儲存]。現在，可編輯螢幕中顯示的 [使用中] 核取方塊。選取 [使用中] 並按一下 [儲存]。
備註 –您也可以編輯產生器的其他特性。
相當於 psadmin 指令
自訂註冊認證程式類別
您可以自訂 RegistrationValidator 類別。使用此類別，您可以處理註冊特性。例如，驗證用戶的郵遞區號。RegistrationValidator 是 WSRP 產生器中註冊驗證的 SPI。如需自訂驗證類別的詳細資訊，請參閱 http://portalID/portal/javadocs/desktop。您也可以參閱「Sun Java System Portal Server 7.1 Developer’s Guide」中的「WSRP:Validating Registration Data」。
產生註冊控點
對於支援註冊的產生器，必須產生特定用戶的註冊控點。在產生註冊控點後，必須告知用戶才能透過頻帶外通訊向產生器註冊。用戶在向產生器註冊時，必須輸入註冊控點。
產生註冊控點
-
按一下 [用戶註冊] 標籤。
螢幕顯示所有已向特定產生器註冊的用戶。
-
按一下 [新增]。
-
鍵入詳細資訊，例如名稱、狀態、用戶代理程式和方法。
- 用戶名稱
-
用來識別用戶的唯一名稱。
- 狀態
-
可為 [使用中] 或 [已停用]。
- 用戶代理程式
-
指定用戶供應商的名稱和版本。「用戶代理程式名稱」應為 ProductName.MajorVersion.MinorVersion，其中 ProductName 指明用戶為其部署安裝的產品，majorVersion 和 minorVersion 是供應商為其產品定義的版本識別碼。此字串可包含產品或用戶希望提供的任何額外字元/文字。
- 方法
-
指定用戶是否以支援 HTML 標記 (包含使用 get 方法的表單) 的方式，來實作 Portlet URL。
-
按 [下一步]。
螢幕顯示在建立產生器時指定的註冊特性值。
-
輸入值，並按 [下一步]。按一下 [完成]。
發佈產生器詳細資訊至 ebXML Registry
發佈產生器會將產生器詳細資訊儲存在任何一個儲存庫中，例如 Sun Java System Service Registry Server 或 ebXML Registry 伺服器。在發佈產生器後，您可以使用應用程式介面或使用指令行介面來搜尋產生器詳細資訊。如需設定 Sun Java System Service Registry Server 的詳細資訊，請參閱「Service Registry 3.1 Administration Guide」。
您需要為 Registry 配置 Sun Java System Portal Server 才能將產生器的詳細資訊發佈至登錄。
為 Registry 配置 Sun Java System Portal Server
-
在安裝 Portal Server 的機器上建立目錄 /soar/3.0/jaxr-ebxml/security。
-
將 keystore.jks 從 Registry Server 的 /var/opt/SUNWsrvc-registry/3.0/data/security 目錄複製至 /soar/3.0/jaxr-ebxml/security。
-
選取 [入口網站] 標籤。
-
在 [入口網站] 中選取入口網站伺服器。
-
按一下子功能表中的 [SSO 配接卡]。
-
按一下 [JES-REGISTRY-SERVER]。
顯示 [編輯中介配接卡 - JES-REGISTRY-SERVER] 螢幕。
-
鍵入詳細資訊。
如果您正透過代理伺服器存取登錄伺服器：
- http.proxy.host
-
代理伺服器的主機名稱。
- http.proxy.password
-
代理伺服器密碼 (如果代理伺服器需要認證)。
- http.proxy.port
-
供代理伺服器使用的連接埠。
- http.proxy.user
-
代理伺服器使用者名稱 (如果代理伺服器需要認證)。
如果您未使用代理伺服器：
- registry.keypassword
-
從金鑰庫取得金鑰的密碼。
- registry.keystorealias
-
在金鑰庫中的金鑰別名，用於登錄伺服器認證。
- registry.keystorelocation
-
金鑰庫相對於 /soar/3.0/jaxr-ebxml/ 的位置。
- registry.keystorepassword
-
用於開啟金鑰庫的密碼。
- registry.publishurl
-
登錄伺服器的 URL (發佈請求應發送至此)。URL 應接受 SOAP 請求。
- registry.queryurl
-
登錄伺服器的 URL (搜尋請求應發送至此)。URL 應接受 SOAP 請求。
發佈產生器詳細資訊至 Registry
以下步驟說明如何將產生器發佈至 Registry Server：
-
建立組織資料與產生器資料檔案。
組織資料檔案可包含以下項目：
org.name=Sun Microsystems
org.description=Description
org.primarycontact.name=Henry
org.primarycontact.phoneno=1234567
org.primarycontact.email=someone@host.com
備註 –org.name 和 org.description 應與 Identity Server 中的詳細資訊類似，除非 Registry 是在內部部署的。
產生器資料檔案應包含以下項目：
producer.name=Producer_name
producer.description=Producer_Description
producer.id=Producer_ID
備註 –您不必建立所有的資料檔案。然而，為了搜尋產生器、組織或 Portlet 的詳細資訊，您應建立至少一個與它們關聯的檔案。
-
停止和重新啟動共用代理程式容器：
/usr/lib/cacao/bin/cacaoadm stop
/usr/lib/cacao/bin/cacaoadm start
-
若要發佈產生器詳細資訊，請使用以下指令：
./psadmin publish-registry -u amadmin -f password_file -p portal1 -m producer -U producer_data_file -O organization_data_file -T portlet - L --debug
備註 –Portlet 檔案指定由 WSRP 產生器提供的 Portlet。Portlet 清單以字串形式指定，前後加上雙引號，元素之間以空格分隔。例如 "NotepadPortlet BookmarkPortlet WeatherPortlet"。
備註 –您可以使用以下指令檢查記錄檔：more var/opt/SUNWportal/logs/admin/portal.admin.cli.0.0.log
相當於 psadmin 指令
尋找產生器
下節說明如何搜尋產生器：
搜尋產生器
-
建立「搜尋產生器」資料檔案。
「搜尋產生器」資料檔案可包含以下內容：
producer.name=producer_name
producer.description=producer_description
備註 –「搜尋產生器」資料檔案包含要在登錄中搜尋的產生器描述。使用字元 % 做為萬用字元。例如，producer.name 中的 %acme% 會搜尋任何名稱包含 "acme" 的 WSRP 產生器。
-
若要搜尋登錄，請使用以下指令：
./psadmin search-registry -m consumer -u amadmin -f ps_password -C search_producer_datafile -p portal1
-
建立「搜尋 Portlet」資料檔案。
「搜尋 Portlet」資料檔案可包含以下內容：
portlet.name=portlet_name
portlet.description=portlet_description
備註 –「搜尋 Portlet」資料檔案包含要在登錄中搜尋的 Portlet 描述。使用字元 % 做為萬用字元。例如，portlet.name 中的 %stock% 會搜尋任何名稱包含字串 "stock" 的 Portlet。
-
若要根據詳細資訊搜尋 Portlet，請使用以下指令：
./psadmin search-registry -m consumer -u amadmin -f ps_password -D search_portlet_datafile
-
建立「搜尋組織」資料檔案。
「搜尋組織」資料檔案應包含以下內容：
organization.name=organization_name
organization.description=organization_description
備註 –「搜尋組織」資料檔案包含要在登錄中搜尋的組織描述。使用字元 % 做為萬用字元。例如，portlet.name 中的 %acme% 會搜尋任何名稱包含字串 "acme" 的組織。
-
若要根據組織資料檔案搜尋，請使用以下指令：
./psadmin search-registry -m consumer -u amadmin -f ps_password -L search_organization_datafile -p portal1
相當於 psadmin 指令
- © 2010, Oracle Corporation and/or its affiliates