Remedy SSO - How to disable it temporally and re-enable it

Version 12
    Share This:

    This document contains official content from the BMC Software Knowledge Base. It is automatically updated when the knowledge article is modified.


    PRODUCT:

    Remedy AR System Server


    COMPONENT:

    Single Sign On


    APPLIES TO:

    RSSO, AR Server, Mid Tier, SmartIT, Digital Workplace



    QUESTION:

    How do I temporarily disable, then re-enable RSSO, without having to completely uninstall and reinstall.


    ANSWER:

    Backup Files
    First, create a backup of the following 2 files:

       
    • C:\Program Files\BMC Software\ARSystem\midtier\WEB-INF\classes\config.properties
    •  
    • C:\Program Files\BMC Software\ARSystem\midtier\WEB-INF\web.xml
       If you experience errors with RSSO after carrying out these steps, restore the 2 backed up files.  

    Disabling RSSO for AR Server and Mid Tier

      
       
    • open C:\Program Files\BMC Software\ARSystem\midtier\WEB-INF\classes\config.properties in a text editor
    •  
    • locate the following line
                           
    arsystem.authenticator=com.bmc.rsso.plugin.authenticator.RSSOAuthenticator
      
       
    • update the line to read as follows
                           
    arsystem.authenticator=com.remedy.arsys.session.DefaultAuthenticator
      
       
    • save the file
    •  
    • open C:\Program Files\BMC Software\ARSystem\midtier\WEB-INF\web.xml in a text editor
    •  
    • locate the following Xml
                           
    <filter>     <filter-name>RSSOFilter</filter-name>    <filter-class>com.bmc.rsso.agent.RSSOFilter</filter-class></filter>
      
       
    • update the Xml as follows to comment it out, by surrounding the Xml fragment with <!-- and -->
                           
    <!--<filter>     <filter-name>RSSOFilter</filter-name>     <filter-class>com.bmc.rsso.agent.RSSOFilter</filter-class> </filter>-->
      
       
    • locate the following Xml
                           
    <filter-mapping>     <filter-name>RSSOFilter</filter-name>     <url-pattern>/*</url-pattern> </filter-mapping>
      
       
    • update the Xml as follows to comment it out, by surrounding the Xml fragment with <!-- and -->
                           
    <!--<filter-mapping>     <filter-name>RSSOFilter</filter-name>     <url-pattern>/*</url-pattern> </filter-mapping>-->
      
       
    • save the file
      

    Disabling RSSO for SmartIT and Digital Workplace

      
       
    • execute the following SQL statement against the SmartIT database:
                           
    UPDATE SmartIT_System.TENANT SET SAML_AUTHENTICATION = 0;
      
       
    • execute the following SQL statement against the Digital Workplace database:
                           
    UPDATE DWP_System.TENANT SET SAML_AUTHENTICATION = 0;
      Restart DWP and SmartIT Tomcats. To re enable, set value back to 1 and restart tomcat.  

    Disabling RSSO for DWP Catalog

      
       
    • Remove the rsso-agent-osgi.jar from  <DWPC Install directory>/deploy and restart the server.  
      

    Re-enabling RSSO

    If you have previously disabled RSSO using the steps outlined in this Knowledge Article, use the following steps to re-enable RSSO.  

    Enabling RSSO for AR Server and Mid Tier

      
       
    • open C:\Program Files\BMC Software\ARSystem\midtier\WEB-INF\classes\config.properties in a text editor
    •  
    • locate the following line
                           
    arsystem.authenticator=com.remedy.arsys.session.DefaultAuthenticator
      
       
    • update the line to read as follows
                           
    arsystem.authenticator=com.bmc.rsso.plugin.authenticator.RSSOAuthenticator
      
       
    • save the file
    •  
    • open C:\Program Files\BMC Software\ARSystem\midtier\WEB-INF\web.xml in a text editor
    •  
    • locate the following Xml
                           
    <!--<filter>      <filter-name>RSSOFilter</filter-name>      <filter-class>com.bmc.rsso.agent.RSSOFilter</filter-class>  </filter>-->
      
       
    • update the Xml as follows to uncomment it, by removing the surrounding <!-- and -->
                           
    <filter>     <filter-name>RSSOFilter</filter-name>    <filter-class>com.bmc.rsso.agent.RSSOFilter</filter-class> </filter>
      
       
    • locate the following Xml
                           
    <!--<filter-mapping>     <filter-name>RSSOFilter</filter-name>     <url-pattern>/*</url-pattern> </filter-mapping>-->
      
       
    • update the Xml as follows to uncomment it, by removing the surrounding <!-- and -->
                           
    <filter-mapping>     <filter-name>RSSOFilter</filter-name>    <url-pattern>/*</url-pattern> </filter-mapping>
      
       
    • save the file
      

      Enabling RSSO for SmartIT and Digital Workplace

      
       
    • execute the following SQL statement against the SmartIT database:
                           
    UPDATE SmartIT_System.TENANT SET SAML_AUTHENTICATION = 1;
      
       
    • execute the following SQL statement against the Digital Workplace database:
                           
    UPDATE DWP_System.TENANT SET SAML_AUTHENTICATION = 1;
      

    Enabling RSSO DWP Catalog

      
    Put the rsso-agent-osgi.jar back o <DWPC Install directory>/deploy and restart the server.   

     


    Article Number:

    000163062


    Article Type:

    FAQ/Procedural



      Looking for additional information?    Search BMC Support  or  Browse Knowledge Articles