Branding issue on SSO enabled SM 9.40

SM 9.40 with SSO enabled.

As part of enabling SSO, the 'customize-folder' parameter has been pointed to Tomcat directory.

Branding document says to use the same parameter to enable branding.

However, since the path for 'customize-folder' is longer for SSO related enabling, it is not working for branding.

Has anyone of you enabled branding in an SSO enabled 9.40 system?

If so, could you please help?

  • Hi Deepa,

    Try the below steps:

    The "keystorePassword" will be removed in web.xml, and this parameter will be move into an individual file webtier.properties.

    Its content would be:

    keystorePassword=
    webtier.properties could be found by following search paths (priority from high to low):

    1. The path defined in the "customize-folder" parameter in web.xml, and under a sub-folder named with "config"

    2. The WEB-INF/ directory of web client
    Like this: 1./config/webtier.properties
    2./WEB-INF/webtier.properties

  • Verified Answer

    hi Deepa,

    When you use customize folder for branding you will need to specify the keystore password in the webtier.properties file that you create in the <customfolder>/config/folder.

    <Customize-Folder>/config/webtier.properties (where <Customize-Folder> is the folder specified in the customize-folder parameter in the web.xml file.)

    You can use the <Webtier>/WEB-INF/webtier.properties file as a template for your <Customize-Folder>/config/webtier.properties file.

    When the web application server is started, Service Manager changes this value to an encrypted string. The following steps describe how you set a new or update an existing web client keystore password.

    To set a web client keystore password using the <Customize-Folder>, follow these steps:

    1. Make sure the customize-folder parameter is configured in the web tier configuration file (web.xml).
    2. Create a webtier.properties file in the <Customize-Folder>/config directory.

      Note: Make sure the web application server has read/write access to this directory.

    3. Open the file in a text editor, and add the following line to the file:

      When you use custom folder for branding you will need to specify the keystore password in the webtier.properties file that you create in the <customfolder>/config/folder.

      <Customize-Folder>/config/webtier.properties (where <Customize-Folder> is the folder specified in the customize-folder parameter in the web.xml file.)

      You can use the <Webtier>/WEB-INF/webtier.properties file as a template for your <Customize-Folder>/config/webtier.properties file.

      When the web application server is started, Service Manager changes this value to an encrypted string. The following steps describe how you set a new or update an existing web client keystore password.

      To set a web client keystore password using the <Customize-Folder>, follow these steps:

      Make sure the customize-folder parameter is configured in the web tier configuration file (web.xml).
      Create a webtier.properties file in the <Customize-Folder>/config directory.

      Note: Make sure the web application server has read/write access to this directory.

      Open the file in a text editor, and add the following line to the file:

      keystorePassword=< your keystore password in clear text format>

      Save and close the file.
      Restart the web application server.

      The password you entered is now encrypted. In the meantime, Service Manager adds the following line to the webtier.properties file:

      safePassword=true

      To update an existing keystore password of the web client, follow these steps:

      Stop the web application server.
      Open the webtier.properties file with a text editior.
      Modify the value of the safePassword parameter from true to false, or delete this parameter.
      Modify the value of the keystorePassword parameter to a new password.
      Save and close the file.
      Restart the web application server.

      < your keystore password in clear text format>

    4. Save and close the file.
    5. Restart the web application server.

      The password you entered is now encrypted. In the meantime, Service Manager adds the following line to the webtier.properties file:

      When you use custom folder for branding you will need to specify the keystore password in the webtier.properties file that you create in the <customfolder>/config/folder.

      <Customize-Folder>/config/webtier.properties (where <Customize-Folder> is the folder specified in the customize-folder parameter in the web.xml file.)

      You can use the <Webtier>/WEB-INF/webtier.properties file as a template for your <Customize-Folder>/config/webtier.properties file.

      When the web application server is started, Service Manager changes this value to an encrypted string. The following steps describe how you set a new or update an existing web client keystore password.

      To set a web client keystore password using the <Customize-Folder>, follow these steps:

      Make sure the customize-folder parameter is configured in the web tier configuration file (web.xml).
      Create a webtier.properties file in the <Customize-Folder>/config directory.

      Note: Make sure the web application server has read/write access to this directory.

      Open the file in a text editor, and add the following line to the file:

      keystorePassword=< your keystore password in clear text format>

      Save and close the file.
      Restart the web application server.

      The password you entered is now encrypted. In the meantime, Service Manager adds the following line to the webtier.properties file:

      safePassword=true

      To update an existing keystore password of the web client, follow these steps:

      Stop the web application server.
      Open the webtier.properties file with a text editior.
      Modify the value of the safePassword parameter from true to false, or delete this parameter.
      Modify the value of the keystorePassword parameter to a new password.
      Save and close the file.
      Restart the web application server.

    To update an existing keystore password of the web client, follow these steps:

    1. Stop the web application server.
    2. Open the webtier.properties file with a text editior.
    3. Modify the value of the safePassword parameter from true to false, or delete this parameter.
    4. Modify the value of the keystorePassword parameter to a new password.
    5. Save and close the file.
    6. Restart the web application server.

    Hope this helps,

    Rama

  • Hello Rama and Neo,

    Thank you for your response.

    I have already set up customize folder for SSO related, and SSO is all working fine.

    the path to customize-folder for SSO related is very long, since it is in <Tomcat Installation Directory>/webapps/<webtier folder>/WEB-INF/custfolder

    This is a very long path, and the branding document says to use C:\<directory>

    However I cannot use this path, the parameter customize-folder is already having the entry (related to SSO).

    Are you telling me to change the location / path for webtier.properties file to a smaller one?

    Thanks,

    Deepa