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

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

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

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

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

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-6BE03135-6192-5520-AE8F-80BDB3187259" xml:lang="en"><title>User

    13 Prompt Service</title><shortdesc>According to the platform security model of Symbian platform, any

    14 application connecting to a network must have the <codeph>NetworkServices</codeph> capability.

    15 All applications that have the <codeph>Networking service</codeph> capability

    16 must be signed. The Comms User Prompt Service (UPS) enables even the unsigned

    17 applications to access the network if user authorisation is provided. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    18 <p>Any application that requires network access uses the <xref href="GUID-61E0CD76-A2E3-5066-84A8-146EECA8ADCD.dita">Socket

    19 Server</xref> API with the help of <xref href="GUID-BED8A733-2ED7-31AD-A911-C1F4707C67FD.dita"><apiname>RConnection</apiname></xref> or <xref href="GUID-D4F08503-F1EF-3531-9C3C-4AF24A6255F0.dita"><apiname>RSocket</apiname></xref>.

    20 The platform security model checks the capability of the client application

    21 to access the network. The comms user prompt service is used to notify the

    22 user about the network access. The UPS feature enables applications without <codeph>NetworkServices</codeph> capability

    23 to access the network if the user authorises the connection. </p>

    24 <p>The target audience of this document is the device creators who write MCPR

    25 plug-ins. Symbian provides a reference plug-in for the device creators, which

    26 can be modified for customisation. The device creators implementing the comms

    27 user prompt service must have knowledge of the Comms Framework, for more information

    28 see Communications Framework. </p>

    29 <section><title> User prompt</title> <p>When comms UPS is implemented, the

    30 user is requested to authorise a network connection, when an application opens

    31 a new connection or when it attaches to an existing connection. The UPS prompts

    32 the user when an application tries to send data through a socket which is

    33 not explicitly associated with an authorised network connection. The IP network

    34 user prompt is implemented as an MCPR plug-in. The plug-in will invoke the

    35 UPS server. The UPS functionality can be configured by Symbian developers. </p> </section>

    36 <section><title>UPS server</title> <p>The UPS server generates the user prompts

    37 and responds back to the MCPR with the user selection. The dialog creator,

    38 a UPS plug-in, formats and streams the dialog box to the UPS server. The UPS

    39 server interacts with the User Interface (UI) and responds back to the MCPR. </p> <p>The

    40 UPS server is also responsible for checking the policy files which has the

    41 details of the process and the available options. </p> </section>

    42 <section><title>UPS integrations</title><p><b>Messaging server </b> </p><p>The

    43 Service UIDs used by the messaging server are:  </p><p><codeph>const TUid

    44 KUidPOPService = {0x2000BB68};</codeph></p><p><codeph>const TUid KUidIMAPService

    45 = {0x2000BB69};</codeph></p><p><codeph>const TUid KUidSMTPService = {0x2000BB6A}; </codeph></p><p><codeph>const

    46 TUid KUidSendAs2Service = {0x2000BB6B}; </codeph></p><p><codeph>const TUid

    47 KUidSMSService = {0x2000BB6C}; </codeph></p></section>

    48 <section><title>Session life time</title> <p>When the comms user prompt service

    49 component is configured for Session life time, user responds to a UPS dialog

    50 prompt by authorising the request with either '<codeph>Session Yes</codeph>'

    51 or '<codeph>Always</codeph>' response. Any other applications running in the

    52 same process of the user authorised session will be granted network access

    53 for the duration of the process. </p> </section>

    54 <section><title>Network life time</title> <p>When the comms user

    55 prompt service component is configured for Network session life time, user

    56 responds to a UPS dialog prompt by authorising the request with either '<codeph>Session

    57 Yes</codeph>' or '<codeph>Always</codeph>' response. Any other applications

    58 running in the same process of the user authorised application will be granted

    59 the network access. The UPS response for a particular process is valid for

    60 the duration of the network connection associated with the process. </p> </section>

    61 <section><title>See also</title> <p><xref href="GUID-DB827750-6057-537E-8FE1-8F68BF2E9F99.dita">Writing

    62 the UPS Policy File</xref>  </p> </section>

    63 </conbody></concept>