login

Stellt eine sichere Verbindung zu einer Umgebung her. Dieser Befehl unterstützt die Anmeldung bei einer Umgebung mit einem Nur-Text-Kennwort, mit einer verschlüsselten Kennwortdatei, die das Kennwort enthält, oder mit einem OAuth 2.0-Aktualisierungstoken. Die Anmeldung über das OAuth 2.0-Aktualisierungstoken wird nur für OCI-Umgebungen (2. Generation) unterstützt.

Sie melden sich an, um eine Session zu starten, die bis zu Ihrer Abmeldung aktiv bleibt.

Hinweis:

  • EPM Automate unterstützt keine Anmeldung mit den SSO-Zugangsdaten Ihrer Organisation.
  • EPM Automate funktioniert nicht mit SOCKS-Proxy, nur mit HTTP/HTTPS-Proxy.
  • Wenn dieser Befehl in Batchdateien zum Automatisieren von Aktivitäten verwendet wird, empfiehlt Oracle die Verwendung von verschlüsselten Kennwörtern oder OAuth 2.0-Aktualisierungstokens, um in Batchdateien die Aufzeichnung von Kennwörtern in Klartext zu vermeiden.
  • Auf Windows-Computern ermittelt dieser Befehl automatisch, ob das Sicherheitszwischenzertifikat für Proxyserver fehlt. Durch sein Fehlen kann das Herstellen einer Verbindung verhindert werden, weshalb es der unter C:\Oracle\EPM Automate installierten JRE hinzugefügt wird. Dadurch werden Anmeldefehler in Verbindung mit Sicherheitszertifikaten bei der Verwendung von Proxyservern für den Internetzugriff verhindert.

    Auf Linux-Computern ermittelt der Anmeldebefehl das fehlende Sicherheitszertifikat für den Proxyserver, lädt es herunter und zeigt einen Fehler an. Benutzer mit root-Zugriff können dann das heruntergeladene Zertifikat in der JRE installieren, die in der Umgebungsvariable JAVA_HOME verfügbar ist, die in den Umgebungsvariablen ermittelt wurde. Informationen hierzu finden Sie in den folgenden Informationsquellen:

Wenn Sie eine ältere Version von EPM Automate verwenden, wird bei der Anmeldung eine Meldung zum Upgraden angezeigt. Sie können den Befehl upgrade verwenden, um das Upgrade Ihrer Installation im Hintergrund auszuführen.

Wenn Sie den Befehl addUsers, removeUsers, assignRole oder unassignRole ausführen möchten, melden Sie sich nicht mit dem OAuth-Aktualisierungstoken an. Für diese Befehle müssen Sie die Basisauthentifizierung verwenden. Alle anderen Befehle funktionieren mit OAuth 2.0 in OCI (Gen 2)-Umgebungen.

Gilt für

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 und Strategische Personalplanung.

Erforderliche Rollen

Serviceadministrator, Poweruser, Benutzer, Viewer

Verwendung

  • Bei Verwendung eines nicht verschlüsselten Kennworts: epmautomate login USERNAME PASSWORD URL [IDENTITYDOMAIN] [ProxyServerUserName=PROXY_USERNAME ProxyServerPassword=PROXY_PASSWORD ProxyServerDomain=PROXY_DOMAIN] ] [KeystorePassword=PASSWORD]

  • Bei Verwendung einer verschlüsselten Datei: epmautomate login USERNAME PASSWORD_FILE URL [IDENTITYDOMAIN] [ProxyServerUserName=PROXY_USERNAME] [ProxyServerPassword=PROXY_PASSWORD] [ProxyServerDomain=PROXY_DOMAIN] [KeystorePassword=KEYSTORE_PASSWORD]

In diesen Befehlen gilt Folgendes:

  • USERNAME ist der Benutzername des Benutzers.
  • PASSWORD ist das Kennwort des Benutzers.
  • PASSWORD_FILE ist der Name und der Speicherort der Datei, in der das verschlüsselte Kennwort oder das OAuth 2.0-Aktualisierungstoken des Benutzers gespeichert ist. Informationen hierzu finden Sie im Abschnitt zum Befehl encrypt.
  • URL ist die URL der Umgebung, zu der eine Verbindung hergestellt werden soll. Sie können eine benutzerdefinierte oder eine Vanity-URL anstelle der Oracle Enterprise Performance Management Cloud-URL verwenden.

    Zum Erstellen einer Vanity-URL für eine Umgebung können Sie einen Drittanbieter zum Kürzen von Links verwenden, beispielsweise T.ly, Bitly, Rebrandly, TinyUrl, is.gd usw. Ausführliche Informationen zum Erstellen von Vanity-URLs finden Sie in der Dokumentation des Drittanbieters zum Kürzen von Links.

    Hinweis:

    Wenn Sie ein API-Gateway oder einen Reverse-Proxy verwenden, verwenden Sie die zugehörige URL und den für Ihre Umgebung definierten Kontext anstelle der EPM Cloud-URL.
  • IDENTITYDOMAIN (optional) ist die Identitätsdomain der Umgebung.

    Dieser Wert wird automatisch von der EPM Cloud-URL abgeleitet. Alle von Ihnen angegebenen Werte werden ignoriert. Dieser Wert ist jedoch erforderlich, wenn Sie eine API-Gateway- oder Reverse-Proxy-URL für die Verbindung zu einer klassischen EPM Cloud-Umgebung verwenden.

  • ProxyServerUserName ist der Benutzername zum Authentifizieren einer sicheren Session auf dem HTTP-Proxyserver, der den Zugriff auf das Internet steuert. Geben Sie den Benutzernamen ohne einen Domainnamen als Präfix an. Nur erforderlich, wenn die Authentifizierung auf dem Proxyserver für Ihr Netzwerk aktiviert ist.
  • ProxyServerPassword das Kennwort zum Authentifizieren des Benutzers beim Proxyserver. Nur erforderlich, wenn die Authentifizierung auf dem Proxyserver für Ihr Netzwerk aktiviert ist. Dieses Kennwort kann verschlüsselt werden. Informationen hierzu finden Sie im Abschnitt zum Befehl encrypt. Wenn dieses Kennwort verschlüsselt ist, wird es aus der Datei PASSWORD_FILE gelesen.
  • ProxyServerDomain ist der Name der Domain, die für den HTTP-Proxyserver definiert ist (nicht der Servername oder der Hostname des Proxyservers). Nur erforderlich, wenn die Authentifizierung auf dem Proxyserver für Ihr Netzwerk aktiviert ist und eine Proxyserverdomain konfiguriert ist.
  • KeystorePassword (optional) ist das Keystore-Kennwort, das für den Import des Sicherheitszertifikats für Proxyserver erforderlich ist. Verwenden Sie diesen Parameter nur unter Windows und nur, wenn Ihnen die folgenden Fehler in Umgebungen angezeigt werden, in denen der Internetzugriff über einen Proxyserver erfolgt: 
    EPMAT-7: Verbindung kann nicht hergestellt werden, da einige SSL-Zertifikate nicht im Keystore vorhanden sind
    EPMAT-7: Verbindung kann nicht hergestellt werden, da die oben genannten SSL-Zertifikate im Keystore nicht vorhanden sind

Hinweis:

EPM Automate ermittelt und verwendet die HTTP/HTTPS-Proxyeinstellungen auf Ihrem Computer.

EPM Automate unterstützt die folgenden Authentifizierungsmechanismen für die Verbindung zum Proxyserver:

  • Basisauthentifizierung
  • Digest-Authentifizierung
  • Kerberos-Authentifizierung
  • Negotiate Proxy-Authentifizierung
  • NTLM-Authentifizierung

Welche Authentifizierungsmethode in welcher Konfiguration verfügbar ist, hängt vom verwendeten Proxyserver ab.

Wenn auf Linux-Computern gemäß den Proxyeinstellungen erforderlich ist, dass Sie sich beim Proxyserver authentifizieren, müssen Sie die Proxyserverdomain, den Benutzernamen und das Kennwort als Parameter für diesen Befehl eingeben. Wenden Sie sich an Ihren Netzwerkadministrator zur Unterstützung beim Domainnamen des Proxyservers und bei den Zugangsdaten.

Beispiele

  • Nicht verschlüsseltes EPM Cloud-Kennwort verwenden, keine Proxyauthentifizierung:

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

  • Verschlüsselte Datei verwenden, keine Proxyauthentifizierung:

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

  • Verschlüsselte Datei verwenden, wenn die Authentifizierung auf dem Proxyserver mit Serverdomain aktiviert ist:

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

  • Verschlüsselte Datei verwenden, wenn die Authentifizierung auf dem Proxyserver ohne Serverdomain aktiviert ist:

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

  • Verschlüsseltes EPM Cloud- und Proxyserverkennwort verwenden, wenn die Authentifizierung auf dem Proxyserver mit Serverdomain aktiviert ist:

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

  • Verschlüsseltes EPM Cloud- und Proxyserverkennwort verwenden, wenn die Authentifizierung auf dem Proxyserver ohne Serverdomain aktiviert ist:

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

  • Verschlüsselte Datei mit Apigee API-Gateway verwenden:

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