login

Establece una conexión segura a un entorno. Este comando soporta la conexión a un entorno con una contraseña de texto sin formato, un archivo de contraseña cifrado que contenga la contraseña o un símbolo de refrescamiento de OAuth 2.0. Está soportado el inicio de sesión con el símbolo de refrescamiento de OAuth 2.0 solo para entornos de OCI (Gen 2).

Puede iniciar una sesión, que permanecerá activa hasta que se desconecte.

Nota:

  • EPM Automate no admite el inicio de sesión con las credenciales de inicio de sesión único de su organización.
  • EPM Automate no funciona con el proxy SOCKS; solo funciona con el proxy HTTP/HTTPS.
  • Al utilizar este comando en los archivos por lotes para automatizar actividades, Oracle recomienda utilizar una contraseña cifrada o un símbolo de refrescamiento de OAuth 2.0 para evitar el registro de contraseñas de texto no cifrado en los archivos por lotes.
  • En equipos Windows, este comando identifica automáticamente el certificado de seguridad intermedio del servidor proxy que falta y que puede impedirle establecer una conexión y lo agrega al JRE instalado en C:\Oracle\EPM Automate. De esta forma se evitan los errores de conexión relacionados con los certificados de seguridad al usar servidores proxy para acceder a Internet.

    En equipos Linux, el comando login identifica el certificado de seguridad que falta del servidor proxy, lo descarga y muestra un error. Un usuario con acceso root puede instalar, a continuación, el certificado descargado en el JRE disponible en el JAVA_HOME identificado en las variables de entorno. Consulte las siguientes fuentes de información:

Al iniciar sesión, aparece un mensaje para actualizar EPM Automate si está usando una versión anterior de esta. Puede utilizar el comando upgrade para actualizar la instalación de forma silenciosa.

Si tiene previsto ejecutar el comando addUsers, removeUsers, assignRole o unassignRole, no se conecte con el símbolo de refrescamiento de OAuth. Con estos comandos debe usar la autentificación básica. El resto de comandos funcionan con OAuth 2.0 en entornos de OCI (Gen 2).

Se aplica a

Planning, Planning Modules, 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 y Strategic Workforce Planning.

Roles necesarios

Administrador del servicio, Usuario avanzado, Usuario, Visor

Sintaxis

  • Con contraseñas cifradas: epmautomate login USERNAME PASSWORD URL [IDENTITYDOMAIN] [ProxyServerUserName=PROXY_USERNAME ProxyServerPassword=PROXY_PASSWORD ProxyServerDomain=PROXY_DOMAIN] ] [KeystorePassword=PASSWORD]

  • Con archivo cifrado: epmautomate login USERNAME PASSWORD_FILE URL [IDENTITYDOMAIN] [ProxyServerUserName=PROXY_USERNAME] [ProxyServerPassword=PROXY_PASSWORD] [ProxyServerDomain=PROXY_DOMAIN] [KeystorePassword=KEYSTORE_PASSWORD]

En estos comandos:

  • USERNAME es el nombre de usuario del usuario.
  • PASSWORD es la contraseña del usuario.
  • PASSWORD_FILE es el nombre y la ubicación del archivo en el que se almacena la contraseña cifrada o el símbolo de refrescamiento de OAuth 2.0 del usuario. Consulte el comando encrypt.
  • URL es la URL del entorno al que conectarse. Puede usar una URL personalizada en lugar de la URL de Oracle Enterprise Performance Management Cloud.

    Para crear una URL personalizada para un entorno, utilice un acortador de enlaces, como T.ly, Bitly, Rebrandly, TinyUrl, is.gd, etc. Para obtener información detallada sobre la creación de URL personalizadas, consulte la documentación del acortador de enlaces del tercero.

    Nota:

    Si utiliza un gateway de API o un proxy inverso, use su URL y el contexto definido para su entorno en lugar de la URL de EPM Cloud.
  • IDENTITYDOMAIN, opcionalmente, es el dominio de identidad del entorno.

    Este valor se deriva automáticamente de la URL de EPM Cloud; se ignorará cualquier valor que se especifique. Sin embargo, se necesita este valor si está usando un gateway de API o una URL de proxy inverso para conectarse a un entorno de EPM Cloud Classic.

  • ProxyServerUserName es el nombre de usuario utilizado para autentificar una sesión segura con el servidor proxy HTTP que controla el acceso a Internet. Especifique el nombre de usuario sin agregar un prefijo al nombre de dominio. Necesaria solo si está activada la autentificación en el servidor proxy para la red.
  • ProxyServerPassword es la contraseña con la que el usuario se autentifica en el servidor proxy. Necesaria solo si está activada la autentificación en el servidor proxy para la red. Esta contraseña se puede cifrar. Consulte el comando encrypt. Si esta contraseña está cifrada, se lee del ARCHIVO_CONTRASEÑAS.
  • ProxyServerDomain es el nombre del dominio definido para el servidor proxy HTTP (no el nombre del servidor ni el nombre del host del servidor proxy). Necesaria solo si está activada la autentificación para la red en el servidor proxy y si se ha configurado un dominio de servidor proxy.
  • KeystorePassword, opcionalmente, es la contraseña del almacén de claves necesaria para importar el certificado de seguridad del servidor proxy. Use este parámetro solo en Windows y solo si aparecen los siguientes errores en entornos en los que se esté usando un servidor proxy para acceder a Internet: 
    EPMAT-7: Unable to connect as few SSL certificates are missing in the keystore
    EPMAT-7: Unable to connect as above-mentioned SSL certificates are missing in the keystore

Nota:

EPM Automate detecta y utiliza la configuración del proxy HTTP/HTTPS de su equipo.

EPM Automate soporta los siguientes mecanismos de autentificación para conectarse al servidor proxy:

  • Autentificación básica
  • Autentificación de resumen
  • Autentificación Kerberos
  • Autentificación de proxy con negociación
  • Autentificación NTLM

El método de autentificación disponible y su configuración depende del servidor proxy que esté usando.

En los equipos Linux, si la configuración de proxy requiere la autentificación con el servidor proxy, deberá introducir el dominio, el nombre de usuario y la contraseña de servidor proxy como parámetros de este comando. Póngase en contacto con el administrador de red si necesita ayuda con el nombre de dominio y las credenciales del servidor proxy.

Ejemplos

  • Con una contraseña de EPM Cloud no cifrada, sin autentificación proxy:

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

  • Con un archivo cifrado, sin autentificación proxy:

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

  • Con un archivo cifrado, si está activada la autentificación en el servidor proxy con un dominio de 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

  • Con un archivo cifrado, si está activada la autentificación en el servidor proxy sin un dominio de servidor:

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

  • Con una contraseña de servidor proxy y EPM Cloud cifrada, si la autentificación en el servidor proxy está activada con un dominio de servidor:

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

  • Con una contraseña de servidor proxy y EPM Cloud cifrada, si la autentificación en el servidor proxy está activada sin un dominio de servidor:

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

  • Con un archivo cifrado con puerta de enlace de API de APIGEE:

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