Add an Oracle BI Enterprise Edition application

This page describes process of configuring an Oracle BI Enterprise Edition application through the Access Gateway Admin UI console.

Oracle Hyperion Architecture

Before you begin

Ensure that:

  • Access Gateway is installed and configured for use.
    See Manage Access Gateway deployment.
  • Access Gateway has been configured to use your Okta tenant as IDP.
    See Configure your Okta tenant as an Identity Provider for more information about configuring your Okta tenant as an IDP.
  • You have administrator rights on your Okta tenant and can assign applications to users and create groups.
  • The protected Oracle BI Enterprise Edition resource has been configured to trust incoming messages and to support SSO (User identity and SSO cookie in header).
  • The external app version is supported. Oracle Business Enterprise Edition supported versions include:
    • Oracle BI Enterprise Edition 11g with latest patchset
    • Oracle BI Enterprise Edition 12.1
    • Oracle BI Enterprise Edition 12.2
  • Appropriate DNS entries for both the legacy application and the exposed new URL exist.
  • Appropriate DNS entries for both the protected application and the external URL for example:
    ValueDescription
    https://obiee.externalexample.comExternal or customer facing application URL.
    https://obiee.internalexample.com

    Internal or protected application URL of an Oracle BI Enterprise Edition application.

 

Tip

Tip

This application is part of a class of applications which exchange user information using header variables. See Add a generic header application for more information about the Access Gateway generic header application.

Access Gateway also provides a sample header application. See Add a sample header application.

Create the application in Access Gateway

  1. Sign in to the Access Gateway Admin UI console.
  2. Click the Applications tab.

  3. Click +Add to add a new application.

  4. Select the Oracle BI Enterprise Edition option from the left column menu, and click Create.

    Select Oracle Hyperion based app and click create.

    The New Protected Application wizard will start and display the Essentials pane for the application being added.

  5. In the Essentials pane specify the following:

    Field Value
    Label A name for the application, such as Oracle Hyperion application.
    Public Domain A fully qualified host name such as <yourexternalname>.<your domain>.
    In the example provided this would beobiee.externalexample.com.
    Protected Web Resource

    The URL of the internal, protected, application.
    In the example provided this would be obiee.internalexample.com:<port>
    Where:

    • port - the port Oracle BI Enterprise Edition is listening on for HTTP requests.
    Group Enter the group containing the users who should have access to the application.

    Post Login URL

    Enter or modify the post login URL. By default this field is enabled and contains value:
    https://obiee.externalexample.com/analytics/

    Description Optional. An appropriate description for your application.
  6. Important Note

    Important

    While optional, Okta recommends that all applications include certificates.
    See About Access Gateway Certificates for general information about certificate.
    See Certificate management tasks for a general task flow for obtaining and assigning certificates.  

  7. Expand the Certificates tab.
    Note

    Note

    By default a wild card self signed certificate is created and assigned to the application when the application is initially created.

  8. Optional. Click Generate self-signed certificate

    A self-signed certificate is created and automatically assigned to the application.
  9. Optional. Select an existing certificate from the list of provided certificates.
    Use the Search field to narrow the set of certificates by common name.
    Use the page forward (>)and backward(<) arrows to navigate through the list of available certificates.

  10. Click Next. The Applications pane appears.
  11. The Attributes pane provides a list of attributes that will be passed into the application as header fields.
    Confirm the attributes match those required by Oracle BI Enterprise Edition.
    Datasource

    Value

    NAME
    idp

    login

    OAM_REMOTE_USER

    If required, use the Edit () icon to modify the name and other values associated with each attribute.
    Add or modify any additional required attributes. See Application attributes. for more information on attribute options.

  12. Click Next. The Policies pane appears.
  13. Leave all policies unchanged and click Done.
    See Managing Application Policy for more information on application policies.

Test the application

The following steps assign the application to a test account and then execute the application to verify basic functionality.

Assign the application

  1. Sign in to your Okta tenant as administrator.

  2. In the Admin Console, go to Applications > Applications.

  3. Click the name of the newly added header application.

  4. Select the Assignments tab.

  5. Select Assign > Assign To People.

  6. Select an appropriate user and click Assign.

    Info

    Note

    Testing is typically initially done using the same user who is associated with administering Access Gateway

  7. Click Done.

Execute the Application

  1. Return to the Access Gateway Admin UI console.

  2. On the row representing the newly added app, select one of Goto application > IDP Initiated or Goto application > SP Initiated.

  3. Verify the resulting page displays as expected.
  4. Close the results page.

Related topics