8 Contributors: |
8 Contributors: |
9 --> |
9 --> |
10 <!DOCTYPE concept |
10 <!DOCTYPE concept |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
12 <concept id="GUID-6BE03135-6192-5520-AE8F-80BDB3187259" xml:lang="en"><title>User |
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 |
13 Prompt Service</title><shortdesc>According to the platform security model of the Symbian |
14 application connecting to a network must have the <codeph>NetworkServices</codeph> capability. |
14 platform, any application connecting to a network must have the <codeph>NetworkServices</codeph> capability. |
15 All applications that have the <codeph>Networking service</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 |
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> |
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 |
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>. |
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>. |
24 <p>The target audience of this document is the device creators who write MCPR |
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 |
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 |
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 |
27 user prompt service must have knowledge of the Comms Framework, for more information |
28 see Communications Framework. </p> |
28 see Communications Framework. </p> |
29 <section><title> User prompt</title> <p>When comms UPS is implemented, the |
29 <section id="GUID-A3C21466-DD7C-499A-B4A1-BF12883A06F1"><title> User prompt</title> <p>When comms UPS is implemented, the |
30 user is requested to authorise a network connection, when an application opens |
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 |
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 |
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 |
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 |
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> |
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 |
36 <section id="GUID-62F53D49-ABCD-471E-ACA1-68202294418D"><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, |
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 |
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 |
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 |
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> |
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 |
42 <section id="GUID-E06196BB-BE7E-47D4-A465-C08FFFBC8DE3"><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 |
43 Service UIDs used by the messaging server are: </p><p><codeph>const TUid |
44 KUidPOPService = {0x2000BB68};</codeph></p><p><codeph>const TUid KUidIMAPService |
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 |
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 |
46 TUid KUidSendAs2Service = {0x2000BB6B}; </codeph></p><p><codeph>const TUid |
47 KUidSMSService = {0x2000BB6C}; </codeph></p></section> |
47 KUidSMSService = {0x2000BB6C}; </codeph></p></section> |
48 <section><title>Session life time</title> <p>When the comms user prompt service |
48 <section id="GUID-AFFF0469-722D-4F3B-8407-EB7188CB1DE1"><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 |
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>' |
50 prompt by authorising the request with either '<codeph>Session Yes</codeph>' |
51 or '<codeph>Always</codeph>' response. Any other applications running in the |
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 |
52 same process of the user authorised session will be granted network access |
53 for the duration of the process. </p> </section> |
53 for the duration of the process. </p> </section> |
54 <section><title>Network life time</title> <p>When the comms user |
54 <section id="GUID-CDA6684A-06A1-411C-A737-95B35829295F"><title>Network life time</title> <p>When the comms user prompt service |
55 prompt service component is configured for Network session life time, user |
55 component is configured for Network session life time, user responds to a |
56 responds to a UPS dialog prompt by authorising the request with either '<codeph>Session |
56 UPS dialog prompt by authorising the request with either '<codeph>Session |
57 Yes</codeph>' or '<codeph>Always</codeph>' response. Any other applications |
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 |
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 |
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> |
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 |
61 <section id="GUID-300CBACD-DAA1-43A0-BB8A-02323C0187B3"><title>See also</title> <p><xref href="GUID-DB827750-6057-537E-8FE1-8F68BF2E9F99.dita">Writing |
62 the UPS Policy File</xref> </p> </section> |
62 the UPS Policy File</xref> </p> </section> |
63 </conbody></concept> |
63 </conbody></concept> |