啟用 EPM System 的 OSSO

本節假設,您已經完整設定 OSSO 基礎架構。請參閱 Oracle Application Server Administrator's Guide。

將 EPM System Web 伺服器登錄為合作夥伴應用程式

您將使用 Oracle Identity Manager SSO 登錄工具 (ssoreg.sh 或 ssoreg.bat),將 Oracle Enterprise Performance Management System Web 伺服器,登錄為當作 OSSO 伺服器前端之 Oracle HTTP Server 上的合作夥伴應用程式。

請在裝載作為 OSSO 伺服器前端之 Oracle HTTP Server 的伺服器上,執行這個程序。這個程序將產生經過混淆處理的 osso.conf,並將它儲存您選擇的位置中。

如何將 EPM System Web 伺服器登錄為合作夥伴應用程式:

  1. 在裝載作為 OSSO 前端之 Oracle HTTP Server 的伺服器上開啟主控台,然後瀏覽至 Oracle HTTP Server 的 ORACLE_HOME/sso/bin 目錄,例如 C:/OraHome_1/sso/bin (Windows)。
  2. 執行類似下列的命令,但要加上 -remote_midtier 選項:
    ssoreg.bat -site_name epm.myCompany.com 
    -mod_osso_url http://epm.myCompany.com:19400 
    -config_mod_osso TRUE
    -update_mode CREATE 
    -remote_midtier 
    -config_file C:\OraHome_1\myFiles\osso.conf
    

    我們將在下方說明此命令中所用的參數。在以下說明中,合作夥伴應用程式是指作為 EPM System Web 伺服器的 Oracle HTTP Server。

    • -site_name:指出合作夥伴應用程式的網站,例如 epm.myCompany.com。
    • -mod_osso_url:指定合作夥伴應用程式的 URL,格式為 PROTOCOL://HOST_NAME:PORT。這是 EPM System Web 伺服器用來接受傳入的用戶端要求之 URL,例如 http://epm.myCompany.com:19000。
    • -config_mod_osso:指出合作夥伴應用程式使用 mod_osso。您必須納入 config_mod_osso 參數,才能產生 osso.conf。
    • -update_mode:指定更新模式。請使用預設的 CREATE 模式來產生新的記錄。
    • -remote_midtier:指定 mod_osso 合作夥伴應用程式位於遠端中層。當合作夥伴應用程式不在 OSSO 伺服器的 ORACLE_HOME 中,而是位於令一個 ORACLE_HOME 中的時候,請使用這個選項。
    • -virtualhost:指出合作夥伴應用程式 URL 是虛擬主機。如果您沒有要使用虛擬主機,請勿使用這個參數。

      如果您要登錄繫結至虛擬主機的合作夥伴應用程式,就必須在 httpd.conf 中定義虛擬主機。請參閱選用:定義虛擬主機。

    • -config_file:指定 osso.conf 檔案產生之處的路徑。

選用:定義虛擬主機

如果您在登錄合作夥伴應用程式時使用虛擬主機 URL,您就必須定義虛擬主機,方法是更新當作 EPM System Web 伺服器之 Oracle HTTP Server 上的 httpd.conf。

如何定義虛擬主機:

  1. 使用文字編輯器開啟 EPM_ORACLE_INSTANCE/httpConfig/ohs/config/OHS/ohs_component/httpd.conf。
  2. 新增類似下列內容的定義。這個定義假設,Web 伺服器是在位於連接埠 epm.myCompany.com:19400 的虛擬伺服器 epm.myCompany.com 上執行。請依照您的需求來修改這些設定。
    NameVirtualHost epm.myCompany.com:19400
    Listen 19400
       <VirtualHost epm.myCompany.com:19400>
    DocumentRoot "C:/Oracle/Middleware/user_projects/epmsystem1/httpConfig/ohs
             /config/OHS/ohs_component/private-docs"
          include "${ORACLE_INSTANCE}/config/${COMPONENT_TYPE}
             /${COMPONENT_NAME}/mod_osso.conf"
    </VirtualHost>

建立 mod_osso.conf

請在作為 EPM System Web 伺服器前端的 Oracle HTTP Server 上建立 mod_osso.conf。

如何建立 mod_osso.conf:

  1. 使用文字編輯器建立一個檔案。
  2. 把以下內容複製到該檔案,然後針對您的環境來修改檔案。
    LoadModule osso_module C:/Oracle/Middleware/ohs/ohs/modules/mod_osso.so
    <IfModule mod_osso.c>
       OssoIpCheck off
       OssoIdleTimeout off
       OssoSecureCookies off 
       OssoConfigFile C:/Oracle/Middleware/user_projects/epmsystem1/httpConfig/
          ohs/config/OHS/ohs_component/osso/osso.conf
  3. 在 <IfModule mod_osso.c 定義中,納入類似下列內容的位置定義,以便指出您計畫要使用 OSSO 保護的每個資源。
       <Location /interop/>
          require valid user
          AuthType Osso
       </Location>
    </IfModule>
    
  4. 將檔案儲存成 mod_osso.conf。

改變 osso.conf 的位置

將 EPM System Web 伺服器登錄為合作夥伴應用程式的程序 (請參閱將 EPM System Web 伺服器登錄為合作夥伴應用程式),會在 -config_file 指示詞指定的位置中建立經過混淆處理的 osso.conf 檔案。

如何改變 osso.conf 的位置:

  1. 尋找當您在將 EPM System Web 伺服器登錄為合作夥伴應用程式時所建立的 osso.conf (請參閱將 EPM System Web 伺服器登錄為合作夥伴應用程式)。
  2. 將 osso.conf 複製到您在 mod_osso.conf 中定義的 OssoConifgFile 特性所指定的目錄 (在作為 OSSO 伺服器前端的 Oracle HTTP Server 上) 中 (請參閱建立 mod_osso.conf)。

針對 OSSO 來設定 EPM System

將與 OSSO 解決方案整合的 OID,設定成 EPM System 中的外部使用者目錄,然後啟用 SSO。

如何針對 OSSO 來設定 EPM System:

  1. 將 OSSO 解決方案所用的 OID 設定成外部使用者目錄。請參閱 Oracle Enterprise Performance Management System User Security 管理手冊中的「設定 OID、Active Directory 及其他 LDAP 型的使用者目錄」。
  2. 啟用 EPM System 中的 SSO。設定 EPM System 進行 SSO

    註:

    如要將 OSSO 設定為識別管理解決方案,您必須在 SSO 提供者或代理程式中選擇其他,以及在 SSO 機制中選擇自訂 HTTP 標頭,然後輸入 Proxy-Remote-User 來做為自訂 HTTP 標頭的名稱。
  3. 至少提供一位 OID 使用者來作為 Oracle Hyperion Shared Services 管理員。
  4. 重新啟動使用 Shared Services 安全性 API 的 EPM System 產品與自訂應用程式。

    註:

    請在重新啟動 EPM System 產品之前,確保利用 Shared Services 設定的 OID 正在執行中。

選用:啟用 OSSO 伺服器上的偵錯訊息

如要記錄 OSSO 伺服器的偵錯訊息,請修改 policy.properties。系統會把偵錯訊息會寫入 ORACLE_HOME/sso/log/ssoServer.log。

如何記錄偵錯訊息:

  1. 使用文字編輯器,開啟 OSSO 伺服器上的 ORACLE_HOME/sso/conf/policy.properties,例如 C:\OraHome_1\sso\conf\policy.properties。
  2. 將 debugLevel 特性的值設定為 DEBUG。
    debugLevel = DEBUG
  3. 儲存並關閉 policy.properties。

選用:啟用受保護資源的偵錯訊息

如要記錄使用 mod_osso.conf 保護之資源的 OSSO 偵錯訊息,請修改 EPM System Web 伺服器上的 httpd.conf。系統會把偵錯訊息寫入 EPM_ORACLE_INSTANCE/httpConfig/ohs/diagnostics/logs/OHS/ohs_component/ohs_component.log。

如何記錄受保護資源的偵錯訊息:

  1. 使用文字編輯器開啟 EPM_ORACLE_INSTANCE/httpConfig/ohs/config/OHS/ohs_component/httpd.conf。
  2. 將 OraLogSeverity 特性的值設定為 TRACE。
    OraLogSeverity TRACE:32
  3. 儲存並關閉 httpd.conf。