12 <concept id="GUID-1F6DA049-AC03-5122-8B91-32C007A41526" xml:lang="en"><title>SecureServerExample:

    12 <concept id="GUID-1F6DA049-AC03-5122-8B91-32C007A41526" xml:lang="en"><title>SecureServerExample: Implementing the Policy Server Framework</title><shortdesc>This example demonstrates the use of the policy server

    13 Implementing the Policy Server Framework</title><shortdesc>This example demonstrates the use of the policy server framework.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    13 framework.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p> The example shows you how a server checks messages from a client against

    14 <p> The example shows you how a server checks messages from a client

    15 a security policy. It also shows you how to deal with the result of a security

    15 against a security policy. It also shows you how to deal with the

    16 check. </p>

    16 result of a security check. </p>

    17 <p>The following sections provide more information about this example application: </p>

    17 <p>The following sections provide more information about this example

    18 <section id="GUID-14AB89A0-C5AD-5598-ABA3-F1243CA00D97"><title>Download</title> <p>Click

    18 application: </p>

    19 on the following link to download the example: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-a84e1714-2cf0-4023-b3d3-d35217f4159d.zip" scope="external">SecureServer.zip</xref></p><p>Click: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-a84e1714-2cf0-4023-b3d3-d35217f4159d.html" scope="peer">browse</xref> to view the example code.</p> </section>

    19 <section id="GUID-14AB89A0-C5AD-5598-ABA3-F1243CA00D97"><title>Download</title> <p>Click on the following link to download the example: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-a84e1714-2cf0-4023-b3d3-d35217f4159d.zip" scope="external">SecureServer.zip</xref></p><p>Click: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-a84e1714-2cf0-4023-b3d3-d35217f4159d.html" scope="peer">browse</xref> to view the example code.</p> </section>

    20 <section id="GUID-D8761EA7-00C3-5273-A082-C3DE4AC2BFB9"><title>Description</title> <p>The

    20 <section id="GUID-D8761EA7-00C3-5273-A082-C3DE4AC2BFB9"><title>Description</title> <p>The server contains a simple counter. It can change the value

    21 server contains a simple counter. It can change the value of the counter.

    21 of the counter. It can also write the value of the counter to a file.

    22 It can also write the value of the counter to a file. The server offers the

    22 The server offers the following services to a client: </p> <ul>

    23 following services to a client: </p> <ul>

    23 <li id="GUID-79AEF61F-24B7-55FC-88F2-73A3CA124597"><p>Increase the

    24 <li id="GUID-79AEF61F-24B7-55FC-88F2-73A3CA124597"><p>Increase the value of

    24 value of the counter by any number greater than 1. </p> </li>

    25 the counter by any number greater than 1. </p> </li>

    25 <li id="GUID-67736263-0785-558E-8FAA-B73CD05F3511"><p>Decrease the

    26 <li id="GUID-67736263-0785-558E-8FAA-B73CD05F3511"><p>Decrease the value of

    26 value of the counter by any number greater than 1. </p> </li>

    27 the counter by any number greater than 1. </p> </li>

    27 <li id="GUID-A7FE0EFE-EDA3-5394-AA6C-D34FFEBB2CD4"><p>Increase the

    28 <li id="GUID-A7FE0EFE-EDA3-5394-AA6C-D34FFEBB2CD4"><p>Increase the value of

    28 value of the counter by 1. </p> </li>

    29 the counter by 1. </p> </li>

    29 <li id="GUID-191ADD33-2EDC-5493-9F3B-F25AE2AF0708"><p>Decrease the

    30 <li id="GUID-191ADD33-2EDC-5493-9F3B-F25AE2AF0708"><p>Decrease the value of

    30 value of the counter by 1. </p> </li>

    31 the counter by 1. </p> </li>

    31 <li id="GUID-3B10E37A-7172-56EC-A6A2-50C3BC84A029"><p>Reset the counter

    32 <li id="GUID-3B10E37A-7172-56EC-A6A2-50C3BC84A029"><p>Reset the counter to

    32 to its default value. </p> </li>

    33 its default value. </p> </li>

    33 <li id="GUID-305441F7-6797-52C5-92F2-353C45A7260B"><p>Reset the counter

    34 <li id="GUID-305441F7-6797-52C5-92F2-353C45A7260B"><p>Reset the counter to

    34 to the value in the file <filepath>counter.dat</filepath>. </p> </li>

    35 the value in the file <filepath>counter.dat</filepath>. </p> </li>

    35 <li id="GUID-9744CA5A-3D99-57F3-B596-D8145CC66494"><p>Save the counter

    36 <li id="GUID-9744CA5A-3D99-57F3-B596-D8145CC66494"><p>Save the counter value

    36 value in the file <filepath>counter.dat</filepath>. </p> </li>

    37 in the file <filepath>counter.dat</filepath>. </p> </li>

    37 <li id="GUID-42C92895-BD40-58C3-ABB2-0D3DD40CA78E"><p>Send the current

    38 <li id="GUID-42C92895-BD40-58C3-ABB2-0D3DD40CA78E"><p>Send the current value

    38 value of the counter to a client. </p> </li>

    39 of the counter to a client. </p> </li>

    39 <li id="GUID-D6FF0681-5DC7-5605-83F2-4C225EF7520B"><p>Create, initialise

    40 <li id="GUID-D6FF0681-5DC7-5605-83F2-4C225EF7520B"><p>Create, initialise and

    40 and close a subsession. </p> </li>

    41 close a subsession. </p> </li>

    41 <li id="GUID-78587766-2027-5A3D-BE90-6FBF512DD252"><p>Send the current

    42 <li id="GUID-78587766-2027-5A3D-BE90-6FBF512DD252"><p>Send the current number

    42 number of open subsessions to a client. </p> </li>

    43 of open subsessions to a client. </p> </li>

    43 </ul> <p>The client sends a message to the server to request one of

    44 </ul> <p>The client sends a message to the server to request one of these

    44 these services. The server checks each request against its security

    45 services. The server checks each request against its security policy. If the

    45 policy. If the request fails the security check, the request is rejected. </p> <p>The security policy has the following rules: </p> <ul>

    46 request fails the security check, the request is rejected. </p> <p>The security

    46 <li id="GUID-AF85DEBB-0A7D-5794-912E-9382D31834CE"><p>If a client

    47 policy has the following rules: </p> <ul>

    47 asks the server to increase the counter value by more than 10, the

    48 <li id="GUID-AF85DEBB-0A7D-5794-912E-9382D31834CE"><p>If a client asks the

    48 client ‘s SID value must be less than or equal to 0x70fffff5. </p> </li>

    49 server to increase the counter value by more than 10, the client ‘s SID value

    49 <li id="GUID-007E3288-B47F-5E2C-AA3A-E21FE1251B41"><p>If a client

    50 must be less than or equal to 0x70fffff5. </p> </li>

    50 asks the server to decrease the counter value by more than 10, the

    51 <li id="GUID-007E3288-B47F-5E2C-AA3A-E21FE1251B41"><p>If a client asks the

    51 client ‘s SID value must be less than or equal to 0x70fffff5. </p> </li>

    52 server to decrease the counter value by more than 10, the client ‘s SID value

    52 <li id="GUID-2C3B7481-478F-5248-98D2-423D288D12C6"><p>If a client

    53 must be less than or equal to 0x70fffff5. </p> </li>

    53 asks the server for the number of open subsessions, the client’s SID

    54 <li id="GUID-2C3B7481-478F-5248-98D2-423D288D12C6"><p>If a client asks the

    54 value must be 0x70fffff0. </p> </li>

    55 server for the number of open subsessions, the client’s SID value must be

    55 <li id="GUID-BBBDAF33-5DC0-5D01-AEAF-89D36C834045"><p>If a client

    56 0x70fffff0. </p> </li>

    56 asks the server to save the counter value to the file <filepath>counter.dat</filepath>, the client must have both <codeph>ReadDeviceData</codeph> and <codeph>WriteDeviceData</codeph> capabilities. </p> </li>

    57 <li id="GUID-BBBDAF33-5DC0-5D01-AEAF-89D36C834045"><p>If a client asks the

    57 <li id="GUID-9D5144DB-D113-5AF9-9FBC-F31E9E5BA96F"><p>If a client

    58 server to save the counter value to the file <filepath>counter.dat</filepath>,

    58 asks the server to reset the counter value from the file <filepath>counter.dat</filepath>, the client must have both <codeph>ReadDeviceData</codeph> and <codeph>WriteDeviceData</codeph> capabilities. </p> </li>

    59 the client must have both <codeph>ReadDeviceData</codeph> and <codeph>WriteDeviceData</codeph> capabilities. </p> </li>

    60 <li id="GUID-9D5144DB-D113-5AF9-9FBC-F31E9E5BA96F"><p>If a client asks the

    61 server to reset the counter value from the file <filepath>counter.dat</filepath>,

    62 the client must have both <codeph>ReadDeviceData</codeph> and <codeph>WriteDeviceData</codeph> capabilities. </p> </li>

    64 It also shows you the constants and classes that you must define to use the

    60 It also shows you the constants and classes that you must define to

    65 policy server framework. </p> </section>

    61 use the policy server framework. </p> </section>

    66 <section id="GUID-DD984CA6-90E7-4B7D-9876-356A7BBFEA26"><title>Class summary</title><p>This

    62 <section id="GUID-DD984CA6-90E7-4B7D-9876-356A7BBFEA26"><title>Class

    67 example demonstrates the following classes:<ul>

    63 summary</title><p>This example demonstrates the following classes:<ul>

    80 <section id="GUID-B9CD5974-18AA-5581-8BA5-8A1F2CFBC4E7"><title>Build</title> <p><xref href="GUID-3100800B-B2F7-50EF-BD4C-3C345ECCB2A5.dita">The Symbian build process</xref> describes

    76 <section id="GUID-B9CD5974-18AA-5581-8BA5-8A1F2CFBC4E7"><title>Build</title> <p>The Symbian build process describes how to build this example. </p> <p>The <codeph>SecureServer</codeph> example builds

    81 how to build this example. </p> <p>The <codeph>SecureServer</codeph> example

    77 the following binaries in the standard location (<filepath>\epoc32\release\winscw\&lt;build_variant&gt;</filepath>) for Carbide.c++. </p> <ul>

    82 builds the following binaries in the standard location (<filepath>\epoc32\release\winscw\&lt;build_variant&gt;</filepath>)

    78 <li id="GUID-AAFBE9F2-D78B-53FD-8A3C-EF9A43EA6052"><p> <filepath>secureclient.exe</filepath>: This is the client executable file. It starts the server and shows

    83 for Carbide.c++. </p> <ul>

    79 the behaviour of the client. </p> </li>

    84 <li id="GUID-AAFBE9F2-D78B-53FD-8A3C-EF9A43EA6052"><p> <filepath>secureclient.exe</filepath>:

    80 <li id="GUID-758E4591-2A54-5868-A73A-FCE5C31A2C70"><p> <filepath>secureserver.dll</filepath>: This is the DLL that contains the code for the server. This executable

    85 This is the client executable file. It starts the server and shows the behaviour

    81 file must be built before <filepath>secureclient.exe</filepath> file. </p> </li>

    86 of the client. </p> </li>

    87 <li id="GUID-758E4591-2A54-5868-A73A-FCE5C31A2C70"><p> <filepath>secureserver.dll</filepath>:

    88 This is the DLL that contains the code for the server. This executable file

    89 must be built before <filepath>secureclient.exe</filepath> file. </p> </li>