Creating a Provisioning XML Document For The Root Certificate

4/8/2010

To create a provisioning XML file that will provision the device with the root certificate you must complete the following steps:

Note

Your provisioning XML must not contain Byte Order Markers (BOM). Use a text editor that does not insert BOMs when saving files in UTF-8 format.

To create a provisioning XML document

1. Add the following XML code to a document:

   <wap-provisioningdoc> 
      <characteristic type="CertificateStore"> 
        <characteristic type="STORELOCATION"> 
          <characteristic type="CERTHASH"> 
             <parm name="EncodedCertificate" value="BASE64ENCODEDCERT"/> 
          </characteristic> 
        </characteristic> 
      </characteristic> 
   </wap-provisioningdoc>
   

2. Replace STORELOCATION with ROOT.

3. In Windows Explorer, double-click the exported root certificate.

4. Choose the Details tab.

5. Choose Thumbprint in the list box, select the text, and then press CTRL+C.

6. In the XML code, to add the root certificate thumbprint to the provisioning XML, replace CERTHASH with the copied text.

7. Delete the spaces in the thumbprint text.

8. Open the exported root certificate using a text editor.

9. Delete BEGIN CERTIFICATE and END CERTIFICATE, and then remove line breaks from the remaining text. This text is the encoded contents of the root certificate.

10. Select the text, and then press CTRL+C.

11. In the XML code, to add the root certificate to the provisioning XML, replace BASE64ENCODEDCERT with the copied text. The completed provisioning XML document will appear as shown in the following example.

    <wap-provisioningdoc>
       <characteristic type="CertificateStore">
          <characteristic type="ROOT">
             <characteristic type="{hash of certificate}"> 
                <parm name="EncodedCertificate" value="{encoded hash of certificate}"/>
             </characteristic>
          </characteristic>          
       </characteristic>
    </wap-provisioningdoc>
    

    For information about the provisioning file syntax for different OMA Client Provisioning versions, see OMA Client Provisioning Files.

12. Save the XML document as an ASCII file named _setup.xml.

See Also

Tasks

Installing a Root Certificate

Reference

CertificateStore Configuration Service Provider