login

Estabelece uma conexão segura com um ambiente. Esse comando permite o sign-on em um ambiente usando uma senha de texto simples ou um arquivo de senha criptografada que contém a senha ou o token de atualização do OAuth 2.0. O login usando o token de atualização do OAuth 2.0 é permitido somente para ambientes OCI (Gen 2).

Você efetua sign-in para iniciar uma sessão, que permanece ativa até que você efetue sign-out.

Nota:

  • O EPM Automate não dá suporte à conexão com as credenciais de SSO da sua organização.
  • O EPM Automate não funciona com o proxy SOCKS; ele funciona somente com o proxy HTTP/HTTPS.
  • Quando esse comando é usado em arquivos de lote para automatizar atividades, a Oracle recomenda o uso de senhas criptografadas ou token de atualização do OAuth 2.0 para evitar a gravação de senhas com texto não criptografado nesses arquivos.
  • Em computadores Windows, esse comando identifica automaticamente o certificado de segurança intermediário do servidor proxy ausente que pode impedir que você estabeleça uma conexão e o adiciona ao JRE instalado em C:\Oracle\EPM Automate. Isso evita erros de login relacionados a certificados de segurança ao usar servidores proxy para acessar a Internet.

    Em computadores Linux, o comando login identifica o certificado de segurança ausente do servidor proxy, baixa-o e exibe um erro. Um usuário com acesso root pode então instalar o certificado baixado no JRE disponível no JAVA_HOME identificado nas variáveis de ambiente. Consulte estas fontes de informações:

Durante o login, será exibida uma mensagem para atualizar o EPM Automate se você estiver usando uma versão mais antiga do utilitário. Você pode usar o comando upgrade para atualizar a sua instalação silenciosamente.

Se você planeja executar o comando addUsers, removeUsers, assignRole ou unassignRole, não faça login usando o token de atualização OAuth. Esses comandos exigem que você use a autenticação básica. Todos os outros comandos funcionam com OAuth 2.0 em ambientes OCI (Gen 2).

Aplica-se a

Planning, Módulos do Planning, FreeFrom, 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 e Strategic Workforce Planning.

Funções Necessárias

Administrador de Serviço, Usuário Avançado, Usuário, Visualizador

Uso

  • Com uma senha não criptografada: epmautomate login USERNAME PASSWORD URL [IDENTITYDOMAIN] [ProxyServerUserName=PROXY_USERNAME ProxyServerPassword=PROXY_PASSWORD ProxyServerDomain=PROXY_DOMAIN] ] [KeystorePassword=PASSWORD]

  • Com uma senha criptografada: epmautomate login USERNAME PASSWORD_FILE URL [IDENTITYDOMAIN] [ProxyServerUserName=PROXY_USERNAME] [ProxyServerPassword=PROXY_PASSWORD] [ProxyServerDomain=PROXY_DOMAIN] [KeystorePassword=KEYSTORE_PASSWORD]

Nesses comandos:

  • USERNAME é o nome de usuário do usuário.
  • PASSWORD é a senha do usuário.
  • PASSWORD_FILE é o nome e o local do arquivo que armazena a senha criptografada ou token de atualização OAuth 2.0 do usuário. Consulte o comando encrypt.
  • URL é o URL do ambiente para conexão. Você pode usar um URL personalizado ou personalizado no lugar do URL do Oracle Enterprise Performance Management Cloud.

    Para criar um URL intuitivo para um ambiente, você usa um link de terceiros mais curto; por exemplo, T.ly, Bitly, Rebrandly, TinyUrl, is.gd e assim por diante. Para obter informações detalhadas de como criar URLs intuitivos, consulte a documentação do link mais curto de terceiros.

    Nota:

    Se você estiver usando um proxy reverso ou um gateway API, use o respectivo URL e o contexto definido para seu ambiente, em vez do URL do EPM Cloud.
  • IDENTITYDOMAIN, opcionalmente, é o domínio de identidade do ambiente.

    Este valor será derivado automaticamente do URL do EPM Cloud; qualquer valor que você especificar será ignorado. No entanto, este valor será obrigatório se você estiver usando o URL de um proxy reverso ou gateway de API para se conectar com um ambiente do EPM Cloud Clássico.

  • ProxyServerUserName é o nome de usuário para autenticar uma sessão segura com o servidor proxy HTTP que controla o acesso à Internet. Especifique o nome do usuário sem inserir um prefixo de nome de domínio. Esta opção só será obrigatória se a autenticação no servidor proxy estiver habilitada para a sua rede.
  • ProxyServerPassword é a senha para autenticar o usuário no servidor proxy. Esta opção só será obrigatória se a autenticação no servidor proxy estiver habilitada para a sua rede. Essa senha pode estar criptografada. Consulte o comando encrypt. Se essa senha estiver criptografada, ela será lida do PASSWORD_FILE.
  • ProxyServerDomain é o nome do domínio definido para o servidor proxy HTTP (não o nome do servidor ou do host do servidor proxy). Esta opção só será obrigatória se a autenticação no servidor proxy estiver habilitada para a sua rede e se houver um domínio de servidor proxy configurado.
  • KeystorePassword, opcionalmente, é a senha do keystore necessária para importar o certificado de segurança do servidor proxy. Use este parâmetro apenas no Windows e somente se você se deparar com os seguintes erros em ambientes em que um servidor proxy está sendo usado para canalizar o acesso à Internet: 
    EPMAT-7: Não é possível conectar, pois faltam poucos certificados SSL no keystore
    EPMAT-7: Não é possível conectar, pois os certificados SSL mencionados acima estão ausentes no keystore

Nota:

O EPM Automate detecta e usa as configurações de proxy HTTP/HTTPS no seu computador.

O EPM Automate suporta os seguintes mecanismos de autenticação para se conectar com o servidor proxy:

  • Autenticação básica
  • Autenticação do compilador
  • Autenticação Kerberos
  • Autenticação do proxy por Negotiate
  • Autenticação NTLM

O método de autenticação disponível e a respectiva configuração dependem do servidor proxy que você está usando.

Em computadores Linux, se as configurações do proxy exigirem que você se autentique no servidor proxy, será necessário inserir o domínio de servidor proxy, o nome do usuário e uma senha como parâmetros para esse comando. Entre em contato com o administrador de rede para obter ajuda com o nome e as credenciais do domínio do servidor proxy.

Exemplos

  • Usando uma senha do EPM Cloud não criptografada, sem autenticação de proxy:

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

  • Usando um arquivo criptografado, sem autenticação de proxy:

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

  • Usando um arquivo criptografado, se a autenticação no servidor proxy estiver habilitada com o domínio do servidor:

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

  • Usando um arquivo criptografado, se a autenticação no servidor proxy estiver habilitada sem um domínio do servidor:

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

  • Usando a senha do EPM Cloud e a senha do servidor proxy criptografadas, se a autenticação no servidor proxy estiver habilitada com um domínio do servidor:

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

  • Usando a senha do EPM Cloud e a senha do servidor proxy criptografadas, se a autenticação no servidor proxy estiver habilitada sem um domínio do servidor:

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

  • Usando um arquivo criptografado com o gateway APIGEE:

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