Collapse all Symbian^3 Product Developer Library

Modifying TLD Policy Data

This document explains how to update the TLD character lists.

Before you start, you must:

Be familiar with the general concepts of Top-Level Domain (TLD) and International Domain Name (IDN): see What is the Domain Name Server.
Understand SIS files and how to install them: see Secure Software Install SIS Tools.

For each TLD, the InetURIList database contains a white list of safe characters and a black list of forbidden characters. These Unicode character sets improve the phone security by restricting access to potential phishing addresses.

The default policy data is stored in an XML file in the ROM. To change the policy data, install an SIS package with a new TLD policy file.

Create a policy file with the updated data. For more information, see the Policy data file example section below. The version must be higher than in the TLD policy file already installed on the phone.
```
<?xml version="1.0" encoding="UTF-8" ?>
<PolicyData version="2">
   ...
</PolicyData>
```
Create a SIS package containing the TLD policy file. For more information, see SIS Tools Overview.
Install the SIS package on the phone. The SIS installation replaces the previous TLD policy file by the new one.

The next time the InetURIList server starts, it updates the InetURIList database if the policy data's version is higher than the current one.

Policy data file example

Here is a sample XML file for the TLD policy data: the character separator for the white and black lists is the space (blank) character.


<?xml version="1.0" encoding="UTF-8" ?>
<PolicyData version="2">
        <TLD name="TEST">
               <Whitelist>
            a b c d e f g h i j k l m n o p r s t u v w y 0 1 2 3 4 5 6 7 8 9 0 _ - A B C D E F G H I J K L M N O P R S T U V W Y
               </Whitelist>
               <Blacklist>
            q z Q Z
               </Blacklist>
        </TLD>
     <TLD name="GRK">
               <Whitelist>
            a b c d e f g h i j k l m n o p r s t u v w y 0 1 2 3 4 5 6 7 8 9 0 _ - A B C D E F G H I J K L M N O P R S T U V W Y
               </Whitelist>
               <Blacklist>
            α ν β ξ    γ ο δ π ε Ρ Ζ Σ Η Τ Θ Υ Ι ι Φ Κ κ Χ χ Λ Ψ ψ Μ μ    Ω ω
               </Blacklist>
        </TLD>
 </PolicyData>

To remove the updated policy data, uninstall the SIS package. The policy database reverts to the default policy data.

Parent topic: WhiteList/BlackList TLD Services

Related concepts

WhiteList/BlackList TLD Services Overview

Related tasks

Querying the TLD policy data