Need immediate support? (under contract or not!):

Green Brovanture logo on white background for brand recognition.
+44 (0)1483 685450

All our services are available in:

  • English
  • Italian
  • Spanish
  • French
  • Romanian
  • Hungarian
  • Afrikaans
  • Hindi/Telugu

SSO to On-Premises Oracle Hyperion EPM with Header Based Authentication in Microsoft Azure

SSO to On-Premises Oracle Hyperion EPM with Header Based Authentication in Microsoft Azure
  • upcoming events

All Articles

SSO to On-Premises Oracle Hyperion EPM with Header Based Authentication in Microsoft Azure

On‑premises Oracle Hyperion EPM environments more often than not rely on an external authentication provider.

While Brovanture offers hosted Oracle Hyperion EPM solutions within OCI, some customers prefer not to establish a VPN or network tunnel back to their environment to integrate with their on‑premises Microsoft Active Directory.

So, what are the alternatives?

Oracle has confirmed that Oracle Hyperion EPM supports any header‑based authentication provider. This provides flexibility in how authentication is implemented and one common example is using Azure AD (Entra ID) as the authentication source.

Microsoft Entra Private Network Connector

Download and Install on your Foundation Server (current link April ’26)

https://download.msappproxy.net/subscription/d3c8b69d-6bf7-42be-a529-3fe9c2e70c90/connector/download

SSO to On-Premises Oracle Hyperion EPM

Once installed it should run neatly as a Windows Service:

SSO to On-Premises Oracle Hyperion EPM

Set up an Enterprise Application in Azure and Register the Server with the private connector installed:

SSO to On-Premises Oracle Hyperion EPM

In your application proxy, set your internal URL and external URLs in the appropriate fields

SSO to On-Premises Oracle Hyperion EPM

Setup your users:

SSO to On-Premises Oracle Hyperion EPM

We’ll use the use.mail attribute in this example

SSO to On-Premises Oracle Hyperion EPM

Login to Workspace – Shared Services.

Administration ->  Configure User Directories

Use the Security Options tab.  In ‘Single Sign-On- Configuration’ as below, note that SSO mechanism needs to be set to ‘Custom HTTP Header’ ->HYPLOGIN

SSO to On-Premises Oracle Hyperion EPM

The user must exist as a Native user and be provisioned using the full email address as the username as it will be federated

SSO to On-Premises Oracle Hyperion EPM

Open the External URL Defined in the Application Proxy to be prompted for authentication

SSO to On-Premises Oracle Hyperion EPM

Note, you can enable a MFA layer here such as code authentication delivered from the MS Authenticator App, this should be set up by your Azure admin with little to no fuss.

Pass this point – you’re in!

SSO to On-Premises Oracle Hyperion EPM

Considerations:

While you’re in the testing phase, I’d advise to first set the Workspace Server Setting ‘Allow Direct Logon After SSO Failure’ to ‘Yes’ as otherwise any authentication other than Azure SSO will be locked out:

 

SSO to On-Premises Oracle Hyperion EPM

Breakglass Solution – IcoE 😉

Before configuring SSO run the command from:

\Oracle\Middleware\user_projects\<EPM_HOME>\bin

epmsys_registry.bat view shared_services_product/@CSSConfig

This writes the file ‘Comp_1_SHARED_SERVICES_PRODUCT_CSSConfig’ in ..\Oracle\Middleware\user_projects\<EPM_HOME>\bin

Take a backup of this file.

Note that post SSO Switch-on, when running the same command the file will then contain:

</delegatedUserManagement>

<enableHTTPURLAccess>false</enableHTTPURLAccess>

<securityAgent name=”OTHER”><ssoMode>CUSTOM_HTTP_HEADER</ssoMode><ssoValue>HYPLOGIN</ssoValue></securityAgent><groupsCacheRefreshInterval>60</groupsCacheRefreshInterval></css>

Either:

  • Modify to original state and update
  • Update from post SSO switch on file (Comp_1_SHARED_SERVICES_PRODUCT_CSSConfig)

To update, run the command

epmsys_registry update file shared_services_product/@CSSConfig Comp_1_SHARED_SERVICES_PRODUCT_CSSConfig

Restart Services

If you are interested in moving to this authentication approach, it can typically be implemented quickly alongside your existing environment.

Please feel free to get in touch – Brovanture would be happy to help.

Until next time

Ben

share this entry