login

建立与环境的安全连接。此命令支持使用以下方式登录到环境：明文密码，或者包含密码或 OAuth 2.0 刷新令牌的加密密码文件。

需要登录来启动会话，会话在您注销之前将保持活动状态。

注：

  • 对于已设置为使用多因素身份验证 (MFA) 进行基本身份验证的用户，不支持此命令。
  • EPM Automate 不支持使用组织的 SSO 凭据登录。
  • EPM Automate 不能与 SOCKS 代理一起使用，只能与 HTTP/HTTPS 代理一起使用。
  • 在批处理文件中使用此命令自动执行活动时，Oracle 建议您使用加密的密码或 OAuth 2.0 刷新令牌以避免在批处理文件中记录明文密码。
  • 在 Windows 计算机上，此命令会自动找到缺失的可能会阻止您建立连接的代理服务器中间安全证书，并将其添加到安装在 C:\Oracle\EPM Automate 下的 JRE。这可以防止在使用代理服务器访问 Internet 时出现与安全证书相关的登录错误。

    在 Linux 计算机上，login 命令从代理服务器找到缺失的安全证书，下载该证书，并显示错误。然后，具有 root 访问权限的用户可以将下载的证书安装在环境变量中标识的 JAVA_HOME 中可用的 JRE 中。请参阅以下信息源：

如果您使用的是较旧版本，登录时会显示升级 EPM Automate 的消息。可以使用 upgrade 命令对安装进行静默升级。

如果您计划运行 addUsers、removeUsers、assignRole 或 unassignRole 命令，请不要使用 OAuth 刷新令牌登录。这些命令要求您使用基本身份验证。所有其他命令都适用于 OAuth 2.0。

适用于

Planning、Planning 模块、自由形式、Financial Consolidation and Close、Tax Reporting、Account Reconciliation、Profitability and Cost Management、Enterprise Profitability and Cost Management、Oracle Fusion Cloud Enterprise Data Management、Narrative Reporting、销售规划和战略性人员规划。

所需角色

  • 服务管理员
  • 超级用户
  • 用户
  • 查看者

用法

  • 使用未加密的密码：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 刷新令牌的文件的名称和位置。请参阅 encrypt 命令。
  • URL 是要连接的环境的基本 URL。您可以使用自定义或虚名 URL 来代替 Oracle Fusion Cloud Enterprise Performance Management URL。请参阅《管理员入门指南》中的“使用虚名 URL”

    注：

    如果使用 API 网关或反向代理，则使用其 URL 和为您的环境定义的上下文来代替云 EPM URL。
  • IDENTITYDOMAIN（可选）是环境的身份域。

    此值自动派生自云 EPM URL；将忽略您指定的任何值。

  • ProxyServerUserName 是用户名，用于在控制 Internet 访问的 HTTP 代理服务器中对安全会话进行身份验证。在不添加域名前缀的情况下指定用户名。仅当在代理服务器上对您的网络启用了身份验证时才需要。
  • ProxyServerPassword 是用于在代理服务器中对用户进行身份验证的密码。仅当在代理服务器上对您的网络启用了身份验证时才需要。可对此密码进行加密。请参阅 encrypt 命令。如果此密码已加密，则从 PASSWORD_FILE 读取。
  • ProxyServerDomain 是为 HTTP 代理服务器定义的域的名称（而非服务器名称或代理服务器主机名）。仅当在代理服务器上对您的网络启用了身份验证并且配置了代理服务器域时才需要。
  • KeystorePassword（可选）是导入代理服务器安全证书所需的密钥库密码。仅在 Windows 上使用此参数，并且仅当在使用代理服务器来引导 Internet 访问的环境中遇到以下错误时使用此参数： 
    EPMAT-7: 由于密钥库中缺少一些 SSL 证书而无法连接
    EPMAT-7: 由于密钥库中缺少上述 SSL 证书而无法连接

注：

EPM Automate 检测并使用您计算机上的 HTTP/HTTPS 代理设置。

EPM Automate 支持使用以下身份验证机制连接到代理服务器：

  • 基本身份验证
  • 摘要身份验证
  • Kerberos 身份验证
  • 协商代理身份验证
  • NTLM 身份验证

可用的身份验证方法及其配置取决于您使用的代理服务器。

在 Linux 计算机上，如果代理设置要求您在代理服务器中进行身份验证，您必须输入代理服务器域、用户名和密码作为此命令的参数。如果您需要代理服务器域和凭据方面的帮助，请与您的网络管理员联系。

示例

  • 使用未加密的云 EPM 密码，无代理身份验证：

    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 和代理服务器密码：

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

  • 在代理服务器上启用了身份验证但没有服务器域时，使用加密的云 EPM 和代理服务器密码：

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

  • 使用含有 OAuth2 刷新令牌的加密文件：

    epmautomate login ignoredUsername C:\mySecuredir\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