login

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

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

註：

  • 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 重新整理憑證登入。這些命令要求您使用基本驗證。其他所有命令皆可在 OCI (Gen 2) 環境中搭配 OAuth 2.0 使用。

適用於

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 是使用者的使用者名稱。
  • PASSWORD 是使用者的密碼。
  • PASSWORD_FILE 是儲存使用者加密密碼或 OAuth 2.0 重新整理憑證之檔案的名稱和位置。請參閱 encrypt 命令。
  • URL 是要連線之環境的 URL。您可以在 Oracle Enterprise Performance Management Cloud URL 中使用自訂或虛名 URL。

    若要建立環境的虛名 URL，您可以使用第三方連結縮網址服務，例如 T.ly、Bitly、Rebrandly、TinyUrl、is.gd 等。如需建立虛名 URL 的詳細資訊，請參閱來自第三方連結縮網址服務的文件。

    註：

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

    這個值是自動從 EPM Cloud URL 衍生； 您指定的任何值都會被忽略。但是，如果您使用 API 閘道或反向代理伺服器 URL 連接到一般 EPM Cloud 環境，則需要此值。

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

範例

  • 使用未加密的 EPM Cloud 密碼，無代理主機認證：

    epmautomate login serviceAdmin P@ssword1 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 C:\mySecuredir\password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com ProxyServerUserName=john.doe@example.com ProxyServerPassword=example ProxyServerDomain=example

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

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

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

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

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

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

  • 使用加密的檔案搭配 APIGEE API 閘道：

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