Enable and Disable SSO Authentication Using WLST Commands

Use WLST commands to enable or disable SSO authentication for Oracle Analytics Server.

SSO is enabled by default. If you leave it enabled, then Oracle Analytics Server uses SSO across the stack regardless of whether you use an external SSO for the initial login. And your configuration will use WLS Asserters for SSO.

If you disable SSO, then your configuration won't use WLS Asserters for Oracle Analytics Server or data visualization, and you'll be prompted a second time for login credentials when navigating from Oracle Analytics Server to data visualization.

  • You must have file system and WebLogic Administrator permissions.
  • You must perform the enable or disable SSO authentication as an offline activity.
  • Validation is limited to URL format. Connectivity and WebLogic configuration isn't validated.
  • Changing the URL for log off requires that you disable, and then re-enable with new URL.
  • A logon URL is not required.

Pre-requisites:

  • Configure WebLogic security providers.

Use the table to learn the arguments appropriate for each command.

Command Arguments Return Description

enableBISingleSignOn

DOMAIN_HOME, <logoff-url>

None

Enable SSO and configure logoff URL.

disableBISingleSignOn

DOMAIN_HOME

None

Disable SSO.
  1. Stop the BI system.
  2. Enter a SSO management command from the table using the WLST command line.
  3. Start WLST using ./wlst.sh command.
  4. Optional: Run the command help(‘BILifecycle’) to display help about enableBISingleSignOn and disableBISingleSignOn commands and their arguments.
  5. Run the enableBISingleSignOn or disableBISingleSignOn command using the arguments appropriate for each command.

    For example: enableBISingleSignOn('C:/.../user_projects/domains/bi','/bi-security-login/logout?redirect=/va') or disableBISingleSignOn('C:/oracle/Middleware/Oracle_Home/user_projects/domains/bi')

    The SSO configuration for Oracle Analytics Server is updated.

  6. Restart the Oracle Analytics Server component processes to consume the changes.