啟用 EPM SystemOSSO

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

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

您將使用 Oracle Identity Manager SSO 登錄工具 (ssoreg.shssoreg.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 ServerORACLE_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