Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The authentication endpoint is the authentication URL used in authentication requests. The following sections discuss methods of customizing this endpoint for various scenarios.

...

The authentication endpoint URL refers to is the location in your web application that contains authentication related pages.To

Follow the steps below to customize the authentication endpoint URL, do the following:

  1. Open the application-authentication.xml file found in the

    Edit the <IS_HOME>/repository/conf/identity

    folder.

    Edit the following property to the location of the web application that contains the authentication related pages/application-authentication.xml file, and change the value of the following parameter depending on the URL that the web application should run.

    Code Block
    languagexml
    <AuthenticationEndpointURL>/sso/login</AuthenticationEndpointURL>

    Run the web application on the new authentication endpoint URL. For instance, if you updated the property to For example, If you specify the value as /sso/login as shown above, run the web application on runs on https://<host_name>:port no>_number>/sso/login.

    Note
    titleNote

    If you do not change the default value of the <AuthenticationEndpointURL> parameter, accessing the dashboard redirects you to the WSO2 Identity Server management console.

  2. Run the web application on the new authentication endpoint URL.

Controlling the request parameters going to the authentication endpoint

...

  1. Shutdown the server if it is already started.
  2. Set the property tenantListEnabled=false in the EndpointConfig.properties file.

    Info
    • If you are hosting the authenticationendpoint.war webapp within WSO2 Identity Server, set this property in the <IS_HOME>/repository/conf/identity/EndpointConfig.properties file.
       

    • If you are hosting it outside the WSO2 Identity Server (i.e., external Tomcat or WSO2 Application Server), set this property in the <IS_HOME>/repository/deployment/server/webapps/authenticationendpoint/WEB-INF/classes/EndpointConfig.properties file.  
  3. Set TenantDomainDropDownEnabled parameter to false in the <IS_HOME>/repository/conf/identity/application-authentication.xml file.

    Code Block
    languagexml
    <TenantDomainDropDownEnabled>false</TenantDomainDropDownEnabled>
  4. If the MutualSSLAuthenticator is only used for the purpose of listing tenant domains in the drop down, disable it in the <IS_HOME>/repository/conf/security/authenticators.xml file.

    Code Block
    languagexml
    <Authenticator name="MutualSSLAuthenticator" disabled="true">
  5. Restart the server.

...