Chapter 4
Internationalization of End-Entity Interface
The services interfaces that come with iPlanet Certificate Management System (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
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
|
|
|
|