<?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-C893C9E6-47B8-5149-9808-0274C61CF3D7" xml:lang="en"><title>OCSP-SWI
Integration</title><abstract><p>The Symbian platform provides the ability to validate and manage <xref href="GUID-C676C4E6-93AF-59E9-886D-74D59F154490.dita">X.509</xref> certificates.
This ability is integrated into the software installation process to provide
Secure Software Install (SWI) with the functionality of performing certificate
checking at installation time. During installation, SWI checks whether the
certificates associated with the application to be installed have been revoked.
It performs this check by using Online Certificate Status Protocol (OCSP). </p><p>You
can configure SWI to enable or disable the revocation status check of certificates.
In addition, SWI can also be configured to supply the OCSP client with a default
Uniform Resource Identifier (URI) for the OCSP server.</p></abstract><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>You can configure SWI to enable or disable the revocation status check
of certificates. In addition, SWI can also be configured to supply the OCSP
client with a default Uniform Resource Identifier (URI) for the OCSP server. </p>
<section><title>Installing software based on OCSP check</title> <p>SWI validates
the certificate in the install file. As part of validation, it carries out
revocation check, depending on the setting of the <codeph>OcspEnabled</codeph> parameter
in the <codeph>swipolicy.ini</codeph> file. If the revocation check option
is not enabled, a warning is displayed giving options to carry out revocation
check, to continue without revocation check or to cancel the installation.
If the option is enabled, all certificates in the chain except the <xref href="GUID-2800C486-2FB4-5C5C-990F-CC1A290F7E0C.dita">root</xref> are
checked. </p> <p> <b>Note:</b> For details on how certificates are validated,
see <xref href="GUID-A3B58436-07E4-565B-800B-86435D205461.dita">Certificate Validation
in PKIX</xref>. </p> <p>The results of revocation check decide whether the
application can be installed. The following are the scenarios associated with
the certificate revocation check: </p> <ul>
<li id="GUID-EE8C335A-B74D-56D3-9DC5-8E7D9D9C8EB8"><p>If the OCSP client indicates
that no certificates are revoked and the operation completes successfully
with no errors or warnings, the software can be installed. </p> </li>
<li id="GUID-0F861436-15DE-56C7-A06D-C93C30829313"><p>If OCSP indicates that
any of the certificates is revoked or if the signature on the OCSP response
is invalid, a security error is issued and the software cannot be installed. </p> </li>
<li id="GUID-F8A8F1FB-DC90-58B0-98B7-8EFE4255A2D6"><p>If the revocation status
of a certificate cannot be determined (because of reasons like lack of network
access or OCSP responder error), SWI behaves as if the software were unsigned.
The setting of the <codeph>AllowUnsigned</codeph> parameter in the <codeph>swipolicy.ini</codeph> file
determines whether the unsigned software can be installed or not. If the parameter
value is true, SWI issues a warning before installing but allows installation
of the software. Otherwise it issues an error and does not allow installation. </p> </li>
</ul> <p> <b>Note:</b> For details of the various parameters in <codeph>swipolicy.ini</codeph>,
see <xref href="GUID-F8C2E97C-35EC-5437-BC6B-E2A622D2DC4D.dita">Secure Software
Install Reference</xref>. </p> </section>
</conbody><related-links>
<link href="GUID-90DF40EF-7D3F-551D-9957-A3756317A254.dita"><linktext>Online Certificate
Status Protocol</linktext></link>
</related-links></concept>