Previous     Contents     Index     Next     
iPlanet Certificate Management System Customization Guide



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  

 

 

 


Previous     Contents     Index     Next     
Copyright © 2001 Sun Microsystems, Inc. Some preexisting portions Copyright © 2001 Netscape Communications Corp. All rights reserved.

Last Updated April 02, 2001