Previous Topic: Localize CGI-based Password ServicesNext Topic: Servlet-based Password Services JSP Form Customization


Create and Use a Localized Password Services Properties Files

Prior to 5.x QMR 2, the Web Agent passed on the value of the SMLOCALE variable so that the proper language encoding was set for Password Services change forms. This required you to append the variable SMLOCALE=<country>-<language> to the Target URL for the protected resource—for example:

http://server.mysite.org/dir1/targetpage.html?SMLOCALE=FR-FR

Beginning at 5.x QMR 2, the language encoding is read from the Web browser so no manual intervention is required. The Password Services CGI reads the ACCEPT_LANGUAGE variable from the Web browser to determine the language in which to display the password change forms.

For each language, the change forms included with the SiteMinder Web Agent use a different properties file. The properties file defines certain aspects of the text displayed on the HTML pages.

The following properties files are automatically installed with the SiteMinder Web Agent:

If the ACCEPT_LANGUAGE indicates a language for which no properties file is present the English properties file is used.

To create and use a properties file for another language

  1. Translate one of the properties files provided by SiteMinder into the language of your choice.

    For example, copy the PasswordServicesUS-EN.properties file and translate anything to the right of the equals sign (=).

  2. Rename the file according to the convention for Password Services, which is:

    PasswordServices<country>-<language>.properties

    Note: RFC 3066 defines the language tags that you should use as part of the naming convention (http://www.ietf.org/rfc/rfc3066.txt).

    Note: Be sure the browser is set for the correct language.

    If you set multiple languages for the browser, Password Services will only use the first language in the list. If the Password Services CGI cannot find a properties file for that language, the English properties file is used. The other languages specified for the browser are ignored.