Web Agent Guides › Web Agent Configuration Guide › Manage Password Services › Localize CGI-based Password Services Change Forms

Localize CGI-based Password Services Change Forms

For Password Services change forms, the language encoding is read from the Web browser. 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 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 Web Agent:

• English: PasswordServicesUS-EN.properties
• French: PasswordServicesFR-FR.properties
• Japanese: PasswordServicesJP-JP.properties

If the ACCEPT_LANGUAGE variable indicates a language for which no properties file exists, 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 the SiteMinder Web Agent into the language of your choice. The files are located in web_agent_home/pw.

   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 PasswordServiceslanguage-country.properties

   Note: RFC 3066 defines the language tags that you can use as part of the naming convention. See IETF. Also, if the ACCEPT_LANGUAGE variable returned by the browser uses only the language tag as its value, then rename the file as PasswordServiceslanguage.properties instead.

   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.

Use a Fully Qualified URL for Password Services Redirects

When you use password services you can instruct a Web Agent to create a fully qualified domain name (FQDN) to where users are redirected. Use the following parameter:

ConstructFullPwsvcUrl

Instructs the agent to add the server name (FQDN) of the system that is hosing the password services before redirecting the user. You define this server name in the password policy on the Policy Server.

For example, suppose that the value of this parameter is yes, and your password policy points to siteminderagent/forms/smpwservices.fcc. the Web Agent redirects to the following URL:

HTTP://server_name.example.com/siteminderagent/forms/smpwservices.fcc

The Web Agent uses the value that is defined in your password policy when the value of this parameter is no. For example, if your password policy only points to a subdirectory, the Web Agent redirects users to that subdirectory.

Default: No.

Example: No (redirects to the /siteminderagent/forms/smpwservices.fcc defined in your password policy).

Example: Yes (adds HTTP://server_name.example.com to the /siteminderagent/forms/smpwservices.fcc defined in your password policy).

The default URL for password policies in the Administrative UI does not contain a server name. The Web Agent redirects users to whatever URL exists in the password policy when the value of the previous parameter is set to yes.

Follow these steps:

1. Use the examples in the following table as a guide for setting the ConstructFullPwsvcURl parameter: