Chapter 4   Internationalization of End-Entity Interface


The services interfaces that come with iPlanet Certificate Management Server (CMS) make it possible for end-entities and agents to interact with the server. Your end-entities and agents can use the interface's HTML-based forms to carry out various certificate and key-related operations, such as enrolling for, renewing, and revoking certificates.

You can use the default forms as they are, customize them, or develop your own forms to suit your organization's policies or terminology. This chapter explains how to customize the forms and templates used by the interfaces.

The chapter has the following sections:

• Displaying Forms in Non-English Languages

Displaying Forms in Non-English Languages

---

The forms and response templates that come with Certificate Management System are all in English. Certificate Management System supports forms and templates in other languages, and multiple languages can be supported on the same CMS server instance. Every aspect of the CMS server is designed to accomodate multiple languages, including all storage and certificate processing (it is possible to have certificate subject names with data in Chinese, for example). The CMS administration console windows support data in non-English languages, but the messages and menu items cannot be localized.

When an HTTP or HTTPS request arrives at the CMS server, the CMS server checks the HTTP Accept-language header to see what languages are preferred by the requestor. For example, a client that prefers content in Korean would have the value "ko" in the Accept-language header. The server looks in the directory where the default form would be stored to see if there is a directory matching the first value in the Accept-language header. If there is such a directory, the CMS server looks for the correct form or template in the language-specific directory; if the form or template is not found, the default is still used.

For example, the manual user enrollment form is ManUserEnroll.html. It is stored in the web/ee/ directory below the CMS server root. If you wanted to provide a version of this form in French and German for your users, you would translate the form, create the directories web/ee/fr (French) and web/ee/de (German), and put the translated versions of the form in the appropriate, language-specific subdirectory. The appropriate form is sent to users automatically based on the language preferences set in their browsers.

Localized versions of the agent forms and templates are supported in the same way. Create language-specific subdirectories of web/agent/ca, web/agent/kra, and web/agent/ra to provide forms and templates for agents in non-English languages.

Note that if a browser sends more than one language, the CMS server will try to match one of the browser's language preferences with the default locale of the system where the server is running. If no match is found, the default page in English will be returned to the browser. Users having trouble accessing your localized content should make sure they have only one language set in their browsers.

Certificate Management System uses a default character set for each language (see Table 4-1). If you want to use a different character set for a language, you must edit the CMS server configuration file CMS.cfg and add a line with the following format:

i18nCharset.<lang>=<charset>

Where <lang> is the two-letter code for the language (the same as the directory where the localized files are stored) and <charset> is the character set to use with files in that language. For example, to use a character set named EUC_KR for Korean-language (ko) content, add the following line to CMS.cfg:

i18nCharset.ko=EUC_KR

The following table lists the languages supported by Certificate Management System, the two-letter language code to use for language-specific directories, and the default character set Certificate Management System uses for the language:

Table 4-1    Languages and Default Character Sets  

Language	Code	Character set	Language	Code	Character set
Albanian	sq	ISO-8859-2	Arabic	ar	ISO-8859-6
Bulgarian	bg	ISO-8859-5	Byelorussian	be	ISO-8859-5
Catalan (Spanish)	ca	ISO-8859-1	Chinese (Simplified/Mainland)	zh	GB2312
Chinese (Traditional/Taiwan)	zh	Big5	Croatian	hr	ISO-8859-2
Czech	cs	ISO-8859-2	Danish	da	ISO-8859-1
Dutch	nl	ISO-8859-1	English	en	ISO-8859-1
Estonian	et	ISO-8859-1	Finnish	fi	ISO-8859-1
French	fr	ISO-8859-1	German	de	ISO-8859-1
Greek	el	ISO-8859-7	Hebrew	he	ISO-8859-8
Hungarian	hu	ISO-8859-2	Icelandic	is	ISO-8859-1
Italian	it	ISO-8859-1	Japanese	ja	Shift_JIS
Korean	ko	KSC_5601	Latvian (Lettish)	lv	ISO-8859-2
Lithuanian	lt	ISO-8859-2	Macedonian	mk	ISO-8859-5
Norwegian	no	ISO-8859-1	Polish	pl	ISO-8859-2
Portuguese	pt	ISO-8859-1	Romanian	ro	ISO-8859-2
Russian	ru	ISO-8859-5	Serbian	sr	ISO-8859-5
Serbo-Croatian	sh	ISO-8859-5	Slovak	sk	ISO-8859-2
Slovenian	sl	ISO-8859-2	Spanish	es	ISO-8859-1
Swedish	sv	ISO-8859-1	Turkish	tr	ISO-8859-9
Ukranian	uk	ISO-8859-5