Skip to main content
Pentaho Documentation

Configuring the BA Server to Accept Authentication Credentials in a URL

Overview

Explains how to configure the BA Server so you can pass authentication credentials in URL parameters.

By default, the BA Server does not accept authentication credentials passed as URL parameters.  To enable this, modify the security properties file on the BA Server.  Here is how to configure the BA Server to accept credentials in a URL.

If automatic remote authentication is required, we strongly encourage you to configure using one of the Single Sign-On (SSO) solutions available such as CAS. You can also use one of our other authentication methods outlined in the BA Server API documentation instead.

  1. Go to the  biserver-ee/pentaho-solutions/system directory and open the security.properties file.
  2. Set the requestParameterAuthenticationEnabled property to true like this:
requestParameterAuthenticationEnabled=true
  1. Save and close the file.
  2. Stop and restart the BA Server.
  3. Test the configuration by passing a username and password as URL parameters to one of the already-installed sample reports, like this:
http://localhost:8080/pentaho/api/repos/%3Apublic%3ASteel%20Wheels%3ACountry%20Performance%20%28heat%20grid%29.xanalyzer/editor?userid=admin&password=password

If you have configured it correctly you are not prompted to supply authentication credentials and the report displays.