Symbian3/SDK/Source/GUID-B1B3C5E6-9F38-5A55-A30E-4C7591B446CC.dita
changeset 7 51a74ef9ed63
parent 0 89d6a7a84779
equal deleted inserted replaced
6:43e37759235e 7:51a74ef9ed63
       
     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 reference
       
    11   PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
       
    12 <reference id="GUID-B1B3C5E6-9F38-5A55-A30E-4C7591B446CC" xml:lang="en"><title>Certificate
       
    13 Store Human-Readable File Formats</title><shortdesc>This section provides details of the human-readable form of the
       
    14 following certificate store files: </shortdesc><prolog><metadata><keywords/></metadata></prolog><refbody>
       
    15 <section><ul>
       
    16 <li id="GUID-16491000-D0D0-520A-B34F-EAA564D3F026"><p><xref href="GUID-B1B3C5E6-9F38-5A55-A30E-4C7591B446CC.dita#GUID-B1B3C5E6-9F38-5A55-A30E-4C7591B446CC/GUID-1CC16061-C0BA-5039-BABC-797279366531">File certificate store</xref>  </p> </li>
       
    17 <li id="GUID-B475B679-D428-5E43-8A1C-4200663A0ACD"><p><xref href="GUID-B1B3C5E6-9F38-5A55-A30E-4C7591B446CC.dita#GUID-B1B3C5E6-9F38-5A55-A30E-4C7591B446CC/GUID-A8DABE5B-AF91-5775-8FBB-00B85E656D12">SWI certificate store</xref>  </p> </li>
       
    18 <li id="GUID-5081908D-4031-595C-A962-CB53990361FE"><p><xref href="GUID-B1B3C5E6-9F38-5A55-A30E-4C7591B446CC.dita#GUID-B1B3C5E6-9F38-5A55-A30E-4C7591B446CC/GUID-015E1FBA-AD2D-5BB0-8D5D-5F9C537A127D">Certificate client files</xref>  </p> </li>
       
    19 </ul><note> For details of the fields that make up these certificate store
       
    20 files, see <xref href="GUID-46D6DF29-38F7-5842-9FDD-82754AE8D9A0.dita">Human-Readable
       
    21 File Formats Reference</xref>.</note> </section>
       
    22 <section id="GUID-1CC16061-C0BA-5039-BABC-797279366531"><title>File certificate
       
    23 store</title> <p>Use the <codeph>--hfilecertstore</codeph> command-line option
       
    24 to specify the file certificate store in human-readable form. The file certificate
       
    25 store has the following format: </p> <codeblock id="GUID-39C9F9C1-7909-5BE6-9295-E1F2FDB2148A" xml:space="preserve">
       
    26 StartCertStoreEntries
       
    27 
       
    28             StartEntry "Root5CA"
       
    29 
       
    30                         Deletable true
       
    31 
       
    32                         Format EX509Certificate
       
    33 
       
    34                         CertOwnerType ECACertificate
       
    35 
       
    36                         SubjectKeyId auto
       
    37 
       
    38                         IssuerKeyId auto
       
    39 
       
    40                         StartApplicationList
       
    41 
       
    42                                     # Entry 1
       
    43 
       
    44                                                     Application "Server Authentication"
       
    45 
       
    46                         EndApplicationList
       
    47 
       
    48                         Trusted true
       
    49 
       
    50                         DataFileName "root5ca.pem"
       
    51 
       
    52             EndEntry
       
    53 
       
    54 EndCertStoreEntries
       
    55 </codeblock> <p> <b>Notes:</b>  </p> <ul>
       
    56 <li id="GUID-A2A73C93-6B0F-5122-8839-33095714286C"><p>All the fields are mandatory
       
    57 and must be in the specified order. </p> </li>
       
    58 <li id="GUID-9F2D2186-207C-56C9-8C43-8687ECE5030A"><p>Text outside quotes
       
    59 is not case-sensitive. </p> </li>
       
    60 </ul> </section>
       
    61 <refsyn id="GUID-A8DABE5B-AF91-5775-8FBB-00B85E656D12"><title>SWI certificate
       
    62 store</title> <p>Use the <codeph>--hswicertstore</codeph> command-line option
       
    63 to specify the Software Install (SWI) certificate store in human-readable
       
    64 form. The SWI certificate store is of the following format: </p> <codeblock id="GUID-E7504CCF-7CAD-550B-8567-CF89480D4C05" xml:space="preserve">
       
    65 StartSwiCertStoreEntries
       
    66 
       
    67             StartEntry "SymbianA"    
       
    68 
       
    69                         Format EX509Certificate
       
    70 
       
    71                         CertOwnerType ECACertificate
       
    72 
       
    73                         SubjectKeyId auto
       
    74 
       
    75                         IssuerKeyId auto
       
    76 
       
    77                         StartApplicationList
       
    78 
       
    79                                     # Entry 1
       
    80 
       
    81                                                     Application "SW Install"
       
    82 
       
    83                                     # Entry 2
       
    84 
       
    85                                                     Application "SW Install OCSP Signing"
       
    86 
       
    87                         EndApplicationList
       
    88 
       
    89                         Trusted true
       
    90 
       
    91                         DataFileName "cert.der"
       
    92 
       
    93                         CapabilitySet { TCB CommDD PowerMgmt MultimediaDD ReadDeviceData 
       
    94 WriteDeviceData DRM TrustedUI ProtServ DiskAdmin NetworkControl 
       
    95 AllFiles SwEvent NetworkServices LocalServices ReadUserData 
       
    96 WriteUserData Location SurroundingsDD UserEnvironment }
       
    97 
       
    98                         Mandatory false
       
    99 
       
   100                         SystemUpgrade false
       
   101 
       
   102             EndEntry
       
   103 
       
   104 EndSwiCertStoreEntries
       
   105 </codeblock> <p> <b>Note:</b>  </p> <ul>
       
   106 <li id="GUID-4C4BFD71-F93B-5BC1-981F-75D7D39714CE"><p>All the fields are mandatory
       
   107 and must be in the specified order. </p> </li>
       
   108 <li id="GUID-A0FC27EF-5D48-5EB1-A395-1B719C6D0399"><p>Text outside quotes
       
   109 is not case-sensitive. </p> </li>
       
   110 </ul> </refsyn>
       
   111 <refsyn id="GUID-015E1FBA-AD2D-5BB0-8D5D-5F9C537A127D"><title>Certificate
       
   112 client files</title> <p>Use the <codeph>–hcertclients</codeph> command-line
       
   113 option to specify the certificate client files in human-readable form. A certificate
       
   114 client file has the following format: </p> <codeblock id="GUID-3B21193B-EA11-5A8A-9FED-004A21CB392D" xml:space="preserve">
       
   115 
       
   116 StartClientInfo
       
   117 
       
   118         # Entry 1
       
   119 
       
   120         Uid 0x100042ab
       
   121 
       
   122         Name "SW Install"
       
   123 
       
   124         # Entry 2
       
   125 
       
   126         Uid 0x1000a8b6
       
   127 
       
   128         Name "SW Install OCSP Signing"
       
   129 
       
   130         # Entry 3
       
   131 
       
   132         Uid 0x101f9b28
       
   133 
       
   134         Name "MIDlet Installation"
       
   135 
       
   136         # Entry 4
       
   137 
       
   138         Uid 0x1000183d
       
   139 
       
   140         Name "Server Authentication"
       
   141 
       
   142 EndClientInfo
       
   143 
       
   144 </codeblock> <p> <b>Important:</b>  </p> <ul>
       
   145 <li id="GUID-496D4072-75FD-5598-BC43-A5895392D15B"><p>All the fields are mandatory
       
   146 and must be in the specified order. </p> </li>
       
   147 <li id="GUID-B500E6D5-3D42-5847-B075-B6EFFEA75A22"><p>Only one entry is allowed
       
   148 for each UID. </p> </li>
       
   149 </ul> </refsyn>
       
   150 </refbody><related-links>
       
   151 <link href="GUID-FF6F26C7-0037-5117-9232-6FAFFA152F0C.dita"><linktext>Certificate
       
   152 Store Binary Files</linktext></link>
       
   153 </related-links></reference>