login

建立連到環境的安全連線。這個命令支援透過純文字密碼、內含密碼或 OAuth 2.0 重新整理憑證的加密密碼檔案登入環境。

您登入以起始階段作業，此階段作業會保持作用中狀態，直到登出為止。

註：

  • Oracle 建議使用 OAuth 2.0，而不要使用基本驗證，因為 OAuth 2.0 更為安全。
  • 此命令不支援已針對搭配多重因素驗證 (MFA) 設定基本驗證的使用者。
  • EPM Automate 不支援使用您組織的 SSO 憑證進行登入。
  • EPM Automate 無法與 SOCKS Proxy 搭配運作；它只能與 HTTP/HTTPS Proxy 搭配運作。
  • 在批次檔案中使用此命令自動化活動時，Oracle 建議您使用加密的密碼或 OAuth 2.0 重新整理憑證，藉此避免在批次檔案中記錄純文字密碼。
  • 在 Windows 電腦上，此命令會自動識別遺漏的代理伺服器中繼安全性憑證 (該情況可能導致您無法建立連線)，並將其新增至 C:\Oracle\EPM Automate 底下安裝的 JRE 中。當您使用代理伺服器存取網際網路時，這會避免發生與安全性憑證相關的登入錯誤。

    在 Linux 電腦中，登入命令會識別代理伺服器中遺漏的安全性憑證，並會在下載之後顯示錯誤。具備 root 存取權的使用者接著就可以在環境變數所識別之 JAVA_HOME 的 JRE 中安裝下載的憑證。請參閱下列資訊來源：

如果您使用舊版的 EPM Automate，登入時會顯示升級訊息。您可以使用 upgrade 命令，以無訊息模式升級您的安裝。

如果您計畫執行 addUsers、removeUsers、assignRole 或 unassignRole 命令，請勿使用 OAuth 重新整理憑證登入。這些命令要求您使用基本驗證。所有其他的命令都可與 OAuth 2.0 搭配使用。

註：

如果您使用純文字密碼，EPM Automate 會顯示警告。傳送證明資料和參數值以執行命令的偏好安全方法是使用 -p 選項。請參閱使用參數檔來傳送用於執行命令的值.。

適用於

Planning、Planning 模組、FreeForm、Financial Consolidation and Close、Tax Reporting、Account Reconciliation、Profitability and Cost Management、Enterprise Profitability and Cost Management、Oracle Enterprise Data Management Cloud、Narrative Reporting、Sales Planning 及 Strategic Workforce Planning。

必要角色

  • 服務管理員
  • 超級使用者
  • 使用者
  • 檢視者

用法

  • 使用未加密的密碼： epmautomate login USERNAME PASSWORD URL [IDENTITYDOMAIN] [ProxyServerUserName=PROXY_USERNAME ProxyServerPassword=PROXY_PASSWORD ProxyServerDomain=PROXY_DOMAIN] ] [KeystorePassword=PASSWORD]

  • 使用加密的檔案：epmautomate login USERNAME PASSWORD_FILE URL [IDENTITYDOMAIN] [ProxyServerUserName=PROXY_USERNAME] [ProxyServerPassword=PROXY_PASSWORD] [ProxyServerDomain=PROXY_DOMAIN] [KeystorePassword=KEYSTORE_PASSWORD]

在這些命令中：

  • USERNAME 是使用者的使用者名稱。

    註：

    這是必要參數，但其值只用於基本驗證。若為 OAuth2 型驗證，此值是衍生自 OAuth2 憑證；執行這個命令時，所提供的值會被忽略。
  • PASSWORD 是使用者的密碼。
  • PASSWORD_FILE 是儲存使用者加密密碼或 OAuth 2.0 重新整理憑證之檔案的名稱和位置。此檔案預設會儲存在 ProgramData\Oracle\EPM Automate\password.epw 中 (Windows)，或儲存在呼叫 EPM Automate 的目錄中 (UNIX/Linux)。請參閱 encrypt 命令。如果檔案未儲存在預設位置中，請指定完整檔案名稱。
  • URL 是要連線之環境的基礎 URL。您可以在 Oracle Fusion Cloud Enterprise Performance Management URL 中使用自訂或虛名 URL。請參閱管理員適用的入門手冊中的使用虛名 URL

    註：

    如果使用 API 閘道或反向代理伺服器，請使用其 URL 以及為環境定義的內容來代替 Cloud EPM URL。
  • IDENTITYDOMAIN (選擇性)，是環境的識別網域。

    這個值是自動從 Cloud EPM URL 衍生；您指定的任何值都會被忽略。

  • ProxyServerUserName 是用於驗證 HTTP 代理伺服器 (控制網際網路存取) 之安全階段作業的使用者名稱。指定不帶網域名稱前綴的使用者名稱。僅當您的網路已啟用在代理伺服器驗證時才需要。
  • ProxyServerPassword 是用於向代理伺服器驗證使用者的密碼。僅當您的網路已啟用在代理伺服器驗證時才需要。可加密此密碼。請參閱 encrypt 命令。如果此密碼已加密，可從 PASSWORD_FILE 讀取。
  • ProxyServerDomain 是為 HTTP 代理伺服器定義之網域的名稱 (不是伺服器名稱或代理伺服器主機名稱)。僅當您的網路已啟用在代理伺服器驗證，而且已設定代理伺服器網域時才需要。
  • KeystorePassword (選擇性) 是匯入代理伺服器安全性憑證所需的金鑰存放區密碼。僅在 Windows 使用此參數，且只有在使用代理伺服器作為網路網路存取通道的環境中面對下列錯誤時使用此參數： 
    EPMAT-7：無法連線，因為金鑰存放區中遺漏一些 SSL 憑證
    EPMAT-7：無法連線，因為中遺漏上述的 SSL 憑證

註：

EPM Automate 會偵測並使用您電腦上的 HTTP/HTTPS 代理設定值。

EPM Automate 支援以下驗證機制來連接到代理伺服器：

  • 基本驗證
  • 摘要驗證
  • Kerberos 驗證
  • 協商代理主機認證
  • NTLM 驗證

可用的驗證方法及其組態取決於您使用的代理伺服器。

在 Linux 電腦上，如果代理伺服器設定值規定您必須到代理伺服器進行驗證，則您必須輸入代理伺服器網域、使用者名稱和密碼，作為此命令的參數。請聯絡網路管理員，以協助您設定代理伺服器網域名稱和憑證。

範例

  • 使用未加密的 Cloud EPM 密碼，無代理伺服器認證：

    epmautomate login serviceAdmin P@ssword1 https://test-cloud-pln.pbcs.us1.oraclecloud.com

  • 使用儲存在預設位置 ProgramData\Oracle\EPM Automate\password.epw 中的加密密碼檔案，不使用代理主機驗證：

    epmautomate login serviceAdmin password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com

  • 使用儲存在自訂資料夾中的加密密碼檔案，不使用代理主機驗證：

    epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com

  • 如果在有伺服器網域的情況下啟用在代理伺服器上驗證，則使用加密的檔案：

    epmautomate login serviceAdmin password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com ProxyServerUserName=john.doe@example.com ProxyServerPassword=example ProxyServerDomain=example

  • 如果在無伺服器網域的情況下啟用在代理伺服器上驗證，則使用加密的檔案：

    epmautomate login serviceAdmin password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com ProxyServerUserName=john.doe@example.com ProxyServerPassword=example

  • 使用加密的 Cloud EPM 和代理伺服器密碼，如果在代理伺服器上啟用驗證時有指定伺服器網域：

    epmautomate login serviceAdmin password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com ProxyServerUserName=john.doe@example.com ProxyServerDomain=example

  • 使用加密的 Cloud EPM 和代理伺服器密碼，如果在代理伺服器上啟用驗證時未指定伺服器網域：

    epmautomate login serviceAdmin password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com ProxyServerUserName=john.doe@example.com

  • 使用有 OAuth2 重新整理憑證的加密檔案：

    epmautomate login ignoredUsername OAuth2.epw https://test-cloud-pln.epm.us-ashburn-1.ocs.oraclecloud.com

    註：

    在此命令中，EPM Automate 會忽略指定的使用者名稱 ignoredUsername。改為使用衍生自 OAuth2 憑證的使用者名稱來登入環境。
  • 使用加密的檔案搭配 APIGEE API 閘道：

    epmautomate login serviceAdmin C:\mySecuredir\password.epw https://exampleapigee.apigee.com/epm example_ID_DOM

  • 使用虛名 URL：

    epmautomate login serviceAdmin C:\mySecuredir\password.epw https://rebrand.ly/Automate