Logging In

If you are in a OneStream-hosted environment, see the Identity and Access Management Guide for information about authentication with OneStream IdentityServer.

If you are in a self-hosted environment, to log in with the desktop application, follow these steps.

  1. On the OneStream Logon screen, for Server Address, specify the URL or client connection. See Defining Server Connections.

  2. Click the Connect button.

    NOTE: The Logon screen will look different depending on how your environment is configured (native authentication, external identity provider, or both native authentication and an external identity provider).

    Native Authentication Only

    The Logon screen for native authentication only has a blue Authentication heading at the top with a server address below in a rectangular field. There are fields to enter a User Name and Password. There is also an Application drop-down menu that is a rectangle with a black down arrow.

    External Identity Provider Only

    The Logon screen for external identity provider only has a blue Authentication heading at the top with a server address below in a rectangular field. There is a blue, rectangular button for External Provider Sign In. There is also an Application drop-down menu that is a rectangle with a black down arrow.

    Native Authentication and an External Identity Provider

    The Logon screen for native authentication and external identity provider has a blue Authentication heading at the top with a server address below in a rectangular field. There is a blue, rectangular button for External Provider Sign In, and there are fields to enter a User Name and Password. There is also an Application drop-down menu that is a rectangle with a black down arrow.

  3. Follow the steps for your authentication configuration:

    • For native authentication:

      1. Enter your user name and password.

      2. Click the Logon button.

      NOTE: This process for native authentication is also used for authentication with MSAD and LDAP identity providers. Enter your user name and password set up in MSAD or LDAP and click the Logon button.

    • For an external identity provider:

      1. Click the External Provider Sign In button.

      2. Enter your external identity provider login credentials.

      NOTE: Single sign-on with an external identity provider can be configured to require a one-time verification code for authentication. If the Require Verification Code setting in the Web Server Configuration File is enabled, you will be provided with a one-time verification code to enter in the application. For information about the verification code, see the Installation and Configuration Guide.

  4. On the OneStream Logon screen, select an application from the drop-down menu.

  5. Click the Open Application button.

For instructions on configuring authentication in a self-hosted environment, see the Installation and Configuration Guide.