All docs This doc

Versions Compared


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


  1. Download WSO2 Identity Server and extract it.

  2. Run the server by executing wso2is-5.0.0/bin/ if on a Unix-based systems, or /bin/wso2server.bat if on Windows.

  3. On the management console, click Add under Service Providers in the Main menu.

  4. Enter "publisher" as the Service Provider Name in the form that appears and click Register.

    add_publisher_sc.pngImage RemovedImage Added

  5. In the page that appears next, expand the Inbound Authentication Configuration section and the SAML2 Web SSO Configuration section. Click Configure. The Register New Service Provider page appears.

    Configure the following details for publisher.

  6. Repeat steps 1 to 5 and configure the following details for store.

  7. When attempting to login with SAML from WSO2 Identity Server in API publisher and API store, you can see the following default page located at <IS_HOME>/repository/deployment/server/webapps/authenticationendpoint/login.jsp

    For instructions on configuring WSO2 Identity Server as an identity provider, see Configuring Identity Server as IDP for SSO.


  1. Rename the existing 'login.jsp' to 'default_login.jsp'

  2. Create a new file with the name 'login.jsp' including the following code.

    Code Block
    String relyingParty = request.getParameter("relyingParty");
    if (relyingParty.equals("api_publisher")) {
     RequestDispatcher dispatcher = request.getRequestDispatcher("publisher_login.jsp");
     dispatcher.forward(request, response);
    } else if (relyingParty.equals("api_store")) {
      RequestDispatcher dispatcher = request.getRequestDispatcher("store_login.jsp");
      dispatcher.forward(request, response);
    else {
     RequestDispatcher dispatcher = request.getRequestDispatcher("default_login.jsp");
     dispatcher.forward(request, response);

    This code snippet forwards the request to a different login page by checking the value of relyingParty parameter.

  3. Get the 'publisher_login.jsp' from here and place it at the same level as 'login.jsp'. Also, download the contents of the 'css'  folders from that same link and put them inside the respective folders in the authenticationendpoint.

  4. Log in to the publisher web app again. You are presented with a different page.

    pub_login.pngImage RemovedImage Added

  5. Follow steps 1 to 4 to configure the custom login page to the store web app.