<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE task

  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">

<task id="GUID-AC4C18D1-D6A3-5988-AB10-5A5025183950" xml:lang="en"><title> Modifying

TLD Policy Data</title><shortdesc>This document explains how to update the TLD character lists. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>

<prereq id="GUID-229CD8D8-0BC4-443A-B3BA-7CA4E2DEEDF8"><p>Before you start, you must: </p> <ul>

<li id="GUID-93E6F781-F32E-591C-AFF0-5E2965672620"><p>Be familiar with the

general concepts of Top-Level Domain (TLD) and International Domain Name (IDN):

see <xref href="GUID-6A78F618-09A9-56A7-8C58-98C353BF0788.dita">What is the Domain

Name Server</xref>. </p> </li>

<li id="GUID-2E726E0D-4BBA-51BB-9F9B-A89B2A2C2B5A"><p>Understand SIS files

and how to install them: see <xref href="GUID-ED2D5BEA-AD2A-51CE-8CBC-8B5E33DD6356.dita">Secure

Software Install SIS Tools</xref>. </p> </li>

</ul> </prereq>

<context id="GUID-352A7085-58F8-4D18-9FD2-E42CA9C6E7DC"><p>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. </p> <p>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. </p> </context>

<steps id="GUID-FC107B6B-8AD5-5088-9687-C4A76905A62D">

<step id="GUID-2AB5E926-62F2-5536-A8F5-855E9FEB2541"><cmd>Create a policy

file with the updated data. For more information, see the <xref href="GUID-AC4C18D1-D6A3-5988-AB10-5A5025183950.dita#GUID-AC4C18D1-D6A3-5988-AB10-5A5025183950/GUID-4319147E-A6A0-5FBE-AC15-C61C287A762A">Policy data file example</xref> section below. </cmd>

<info>The version must be higher than in the TLD policy file already installed

on the phone. </info>

<stepxmp><codeblock id="GUID-7759073B-9D6D-578E-8E85-2D32F79A3D21" xml:space="preserve">&lt;?xml version="1.0" encoding="UTF-8" ?&gt;

<PolicyData version="2">

   ...

&lt;/PolicyData&gt;</codeblock> </stepxmp>

</step>

<step id="GUID-FA0E5385-250A-51A8-A34D-3F7588DECAB0"><cmd>Create a SIS package

containing the TLD policy file. </cmd>

<info>For more information, see <xref href="GUID-AFE0238A-D6A4-5D07-BB99-85E8CF97BD26.dita">SIS

Tools Overview</xref>. </info>

</step>

<step id="GUID-ABB82F08-20B6-5B77-9FCC-E9ED9B04BC00"><cmd>Install the SIS

package on the phone. </cmd>

<info>The SIS installation replaces the previous TLD policy file by the new

one. </info>

</step>

</steps>

<result id="GUID-8B69E81C-D10B-4B75-866B-28A5C17B1EAC"><p>The next time the InetURIList server starts, it updates the InetURIList

database if the policy data's version is higher than the current one. </p> </result>

<example id="GUID-4319147E-A6A0-5FBE-AC15-C61C287A762A"><title>Policy data

file example</title> <p>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. </p> <codeblock id="GUID-871D3153-DCCD-5B05-8776-6653ADBC2FD1" xml:space="preserve">

<?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>

 &lt;/PolicyData&gt;</codeblock> </example>

<postreq id="GUID-0E78E46A-3D54-455A-B2B0-1657C811396B"><p>To remove the updated policy data, uninstall the SIS package.

The policy database reverts to the default policy data. </p> </postreq>

</taskbody><related-links>

<link href="GUID-EDA831F7-7248-5C00-B6BE-B7F44097C9B6.dita"><linktext>WhiteList/BlackList

TLD Services Overview</linktext></link>

<link href="GUID-E97C2A7E-8E8F-58E6-99D4-288589385B44.dita"><linktext>Querying

the TLD policy data</linktext></link>

</related-links></task>