Disabling single sing-on manually

About this task

In case of issue with the single sign-on there is possible to revert back to previous user authentication methods by modifing the web.xml and server.xml, correct the configuration and repeat the enablement.

Procedure

  1. Stop the BigFix Inventory server.
  2. Make changes in the web.xml file that is in the following directory.
    • Unix systems bfi_install_dir/wlp/usr/servers/server1/apps/tema.war/WEB-INF
    • Windows systems bfi_install_dir\wlp\usr\servers\server1\apps\tema.war\WEB-INF
    1. If there is available backup web.xml.timestamp.backup use it to restore the web.xml.
    2. Ensure that the value of the <config.sso.enabled> parameter to false.
      <context-param>
          <param-name>config.sso.enabled</param-name>
          <param-value>false</param-value>
      </context-param>
    3. Remove the <security-constraint> element.
      <security-constraint>
      	<display-name>TemaSSOAuthenticated</display-name>
      	<web-resource-collection>
       		<web-resource-name>index</web-resource-name>
      		<url-pattern>/</url-pattern>
      ...
      		<url-pattern>/help/*</url-pattern>
      	</web-resource-collection>
      	<auth-constraint>
      		<role-name>TemaSSOAuthenticated</role-name>
      	</auth-constraint>
      	<user-data-constraint>
      		<transport-guarantee>CONFIDENTIAL</transport-guarantee>
      	</user-data-constraint>
      </security-constraint>
    4. Steps b and c are sufficent modification of web.xml
  3. Make changes in the server.xml file that is in the following directory.
    • Unix systems bfi_install_dir/wlp/usr/servers/server1
    • Windows systems bfi_install_dir\wlp\usr\servers\server1
    1. Remove the <application-bnd> element that is inside of the <application> element.
      <application autoStart='true' location="tema.war" context-root="/" name="tema" type="war">
        <classloader commonLibraryRef='tema,DatabaseLib' delegation='parentLast'/>
          <application-bnd>
            <security-role id="TemaSSOAuthenticated" name="TemaSSOAuthenticated">
              <special-subject type="ALL_AUTHENTICATED_USERS" />
            </security-role>
          </application-bnd>
      </application>
  4. Start the BigFix Inventory server.
    Above steps does not remove SAML feature. They are intended to only allow to login to BigFix Inventory Server using previous authentication method. To completry disable SAML there is also needed to remove in server.xml <feature>samlWeb-2.0</feature> element that is inside the <featureManager> element, the <samlWebSso20> element if it exists and keyStore elements with id="SPKeyStore" and id="IdPKeyStore".