<?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 concept
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-30647807-A0D2-4D96-975A-BF1800749977" xml:lang="en"><title>Configuring the application’s
platform security settings in the emulator</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>You can adjust certain security settings in the emulator. The emulator's
platform security settings are all enabled by default.</p>
<p>Typical use cases include: </p>
<ul>
<li><p>Turning platform security diagnostics on or off</p></li>
<li><p>Turning platform security enforcement on or off</p></li>
<li><p>Disabling a set of capabilities</p></li>
</ul>
<p>Important implementation considerations include:</p>
<ul>
<li><p>You need to use the emulator to set platform security settings.
The feature is not available on production mobile devices.</p></li>
</ul>
<section id="GUID-25876C58-7EE1-46F3-8800-E0CD398170B6"><title>Configuring the settings in the emulator</title>
<p>You can enable or disable platform security settings in the emulator
through the <b>Tools &gt; Preferences</b> menu or by editing the <codeph>epoc.ini</codeph> file.
The following illustration shows the options you have in the <b>Platform security</b> tab
of the Preferences window.</p>
<fig id="GUID-F4DDFC46-AF97-45B5-816C-D4F94182BA2C"><title>Preferences window in the emulator</title><image href="GUID-11E35C60-12DF-4014-AB3F-0314D8536AC0_d0e11022_href.png"/></fig>
<p>To set the platform security settings:</p>
<ol>
<li id="GUID-6ECF89E5-CCF5-431D-9A38-3A472F3B628F"><p>In the emulator,
open the <b>Tools &gt; Preferences</b> menu and go to the <b>Platform Security</b> tab.</p>
<p>Alternatively, open the <codeph>epoc.ini</codeph> file which is located
in the <codeph>...\Epoc32\Data\</codeph> folder on your computer.</p></li>
<li id="GUID-26508845-D52B-476F-96AC-BE3AB0F64124"><p>Modify the
desired settings:</p>
<ul>
<li><p>To allow platform security to emit a diagnostics message
when a check fails, tick the <b>Enable security debug messages</b> checkbox
in the Platform Security tab. </p><p>To enable this setting in the <codeph>Epoc.ini</codeph> file,
include the line <codeph>PlatSecDiagnostics ON</codeph>. To disable this setting,
modify the line to <codeph>PlatSecDiagnostics OFF</codeph>. </p><p>When
the settings is enabled, the diagnostics messages are logged to <xref format="" href="http://wiki.forum.nokia.com/index.php/Epocwind.out" scope="external"><codeph>epocwind.out</codeph></xref> in
a Windows temporary directory. The following is an example of a diagnostics
message:</p>
<codeblock id="GUID-FE9A46AF-D0A4-40D7-847D-9BF67FE1BFBD" xml:space="preserve">153.600	*PlatSec* WARNING - Capability check would have failed - A 
Message (function number=0x00000000) from Thread 
Screenshot[20000555]0002::screenshot, sent to Server !MsvServer, was checked by 
Thread !MsvServer[1000484b]0001::!MsvServer and was found to be missing the 
capability: ReadUserData.</codeblock>
</li>
<li><p>To enable platform security to take action after a check
fails and a diagnostics message is sent,  tick the <b>Perform capability checks</b> checkbox
in the Platform Security tab.</p><p>To enable this setting in the <codeph>Epoc.ini</codeph> file,
include the line <codeph>PlatSecEnforcement ON</codeph>. To disable this setting,
modify the line to <codeph>PlatSecEnforcement OFF</codeph>.</p></li>
<li><p>To disable a check for specific capabilities, choose the
ones you wish to disable in the <b>Granted capabilities for all applications:</b> list
in the Platform Security tab.</p><p>To disable a check in the <codeph>Epoc.ini</codeph> file,
include <codeph>PlatSecDisabledCaps</codeph>, followed by the capabilities
to be disabled. For example, <codeph>PlatSecDisabledCaps ReadUserData+WriteUserData+UserEnvironment</codeph>.</p>
</li>
</ul>
</li>
</ol>
<p>For more details on the settings you can determine, see <xref href="jar:GUID-35228542-8C95-4849-A73F-2B4F082F0C44.jar!/html/SDL_93/doc_source/ToolsAndUtilities93/Emulator/emulator-ref/EpocIniSyntax.guide.html#Emulator%2dref%2esyntax%2dini%2eplatsec" format="application/java-archive">Emulator configuration file: epoc.ini</xref>.</p>
</section>
<section id="GUID-BFB4DE7F-AC98-42AB-8763-FBA6D390D92A"><title>Additional information on platform security settings in the
emulator</title>
<p>For information on troubleshooting options, see <xref href="http://wiki.forum.nokia.com/index.php/How_to_troubleshoot_Platform_Security_issues" scope="external">How to troubleshoot Platform Security issues</xref>.</p>
<p>For more information on the emulator, see the <xref href="jar:GUID-35228542-8C95-4849-A73F-2B4F082F0C44.jar!/html/SDL_93/doc_source/ToolsAndUtilities93/Emulator/emulator/index.html#emulator%2etoc" format="application/java-archive">Emulator
guide</xref>.</p>
</section>
</conbody></concept>