Symbian3/PDK/Source/GUID-A05B7A4D-EAE1-4E92-9337-8CA1CC5C0FAD.dita
changeset 1 25a17d01db0c
child 3 46218c8b8afa
equal deleted inserted replaced
0:89d6a7a84779 1:25a17d01db0c
       
     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 concept
       
    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
       
    12 <concept id="GUID-A05B7A4D-EAE1-4E92-9337-8CA1CC5C0FAD" xml:lang="en"><title>WMDRM
       
    13 Engine Overview</title><shortdesc>WMDRM Engine is a component of WMDRM collection. It provides interfaces
       
    14 to perform WMDRM implementations, such as managing WMDRM licenses and decrypting
       
    15 WMDRM content. Applications that require WMDRM functionality must interact
       
    16 with WMDRM plug-ins and Camese components by implementing the interfaces provided
       
    17 by WMDRM engine.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
       
    18 <section id="GUID-B4A696C6-F075-499D-B4C1-5058DA10930C"><title>Required Background</title><p>Before
       
    19 you start, you must understand the following:</p><ul>
       
    20 <li><p><xref href="GUID-84B6389A-55CC-53EB-8725-65F753FD7217.dita">Content Access
       
    21 Framework (CAF) Overview</xref></p></li>
       
    22 <li><p>Helix multimedia framework </p></li>
       
    23 <li><p>MTP Framework</p></li>
       
    24 </ul></section>
       
    25 <section id="GUID-3396F235-AE9D-40B5-89CA-5B652AF80A6C"><title>Key concepts</title><ul>
       
    26 <li><b>Camese</b>: It is the Over-the-air (OTA) download protocol for WMDRM
       
    27 licenses.</li>
       
    28 <li><b>Secure clock</b>: The clock is for use by secure DRM applications which
       
    29 has TCB capability. For more information, see <xref href="GUID-CD506806-FC59-547A-B5CD-03314DF847F7.dita#GUID-CD506806-FC59-547A-B5CD-03314DF847F7/GUID-CD506806-FC59-547A-B5CD-03314DF847F7#GUID-CD506806-FC59-547A-B5CD-03314DF847F7#GUID-CD506806-FC59-547A-B5CD-03314DF847F7#GUID-CD506806-FC59-547A-B5CD-03314DF847F7#GUID-CD506806-FC59-547A-B5CD-03314DF847F7#GUID-CD506806-FC59-547A-B5CD-03314DF847F7#GUID-CD506806-FC59-547A-B5CD-03314DF847F7#GUID-CD506806-FC59-547A-B5CD-03314DF847F7#GUID-CD506806-FC59-547A-B5CD-03314DF847F7#GUID-CD506806-FC59-547A-B5CD-03314DF847F7#GUID-CD506806-FC59-547A-B5CD-03314DF847F7#GUID-CD506806-FC59-547A-B5CD-03314DF847F7#GUID-CD506806-FC59-547A-B5CD-03314DF847F7#GUID-CD506806-FC59-547A-B5CD-03314DF847F7#GUID-CD506806-FC59-547A-B5CD-03314DF847F7#GUID-CD506806-FC59-547A-B5CD-03314DF847F7#GUID-CD506806-FC59-547A-B5CD-03314DF847F7#GUID-CD506806-FC59-547A-B5CD-03314DF847F7#GUID-CD506806-FC59-547A-B5CD-03314DF847F7#GUID-CD506806-FC59-547A-B5CD-03314DF847F7#GUID-CD506806-FC59-547A-B5CD-03314DF847F7#GUID-CD506806-FC59-547A-B5CD-03314DF847F7#GUID-CD506806-FC59-547A-B5CD-03314DF847F7#GUID-CD506806-FC59-547A-B5CD-03314DF847F7">Date and Time Handling Overview</xref>.</li>
       
    30 </ul></section>
       
    31 <section id="GUID-39DA53FB-F762-4B79-82C5-E5A849CCB94A"><title>Description</title> 
       
    32      <p>WMDRM Engine comprises the following five sub-components:<ul>
       
    33 <li><p><b>WMDRM CAF Agent</b>: WMDRM CAF Agent implements the CAF Agent interface
       
    34 and plug-in. It allows obtaining rights status information and metadata, and
       
    35 provides a way to delete the data storage as an agent-specific functionality.<note> It
       
    36 does not provide functionality to read the decrypted data from ASF content
       
    37 files due to their packetized nature.</note></p></li>
       
    38 <li><p><b>ASF</b>: ASF is used to read data from ASF files by WMDRM CAF Agent
       
    39 and WMDRM Over The Air (OTA) plug-in.</p></li>
       
    40 <li><p><b>WMDRM Porting Kit Server</b>: WMDRM Porting Kit Server allows you
       
    41 to access functions of the porting kit without the need for DRM capability.
       
    42 For example, to add new usage rights or to check the rights status. It also
       
    43 allows you to access the device certificate and unique id from WMDRM Key Storage.
       
    44 It implements the UI functionality required to be displayed, when license
       
    45 store becomes full or needs to be deleted.</p><note>Symbian platform does
       
    46 not provide implementation of WMDRM Porting Kit Server. Device creators must
       
    47 provide their own implementation for WMDRM Porting Kit Server. </note></li>
       
    48 <li><p><b>WMDRM Server</b>: The WMDRM Server includes the following functionalities: <ul>
       
    49 <li><p>It manages porting kit data in an encrypted form using SQL database.</p></li>
       
    50 <li><p>It implements the data storage functionality and an anti-rollback clock
       
    51 needed for enforcement of time-based licenses.</p></li>
       
    52 <li><p>It provides data store state functionality for WMDRM Porting Kit Server.
       
    53 The state information of data store is used to inform the device user to continue
       
    54 synchronizing WMDRM contents to the phone, when the data store runs out of
       
    55 space.</p></li>
       
    56 <li><p>It provides data storage deletion functionality for WMDRM Porting Kit
       
    57 Server and WMDRM CAF Agent.</p></li>
       
    58 </ul></p></li>
       
    59 <li><p><b>WMDRM File Server</b>: The WMDRM File Server has TCB capability
       
    60 and includes the following functionalities:<ul>
       
    61 <li><p>It manages encrypted files in the path <codeph>c:\sys\private\200b180\</codeph> </p></li>
       
    62 <li><p>It handles low level file server interaction </p></li>
       
    63 <li><p>It handles data backwards compatibility and updates the secure time.
       
    64 The <i>secure time</i> can be set using System Static Functions API. </p></li>
       
    65 </ul></p></li>
       
    66 </ul><fig id="GUID-F470FE96-4BB5-489F-88F1-BDD6291BEB69">
       
    67 <image href="GUID-21562C58-896C-48B0-A574-975E1326A93A_d0e146438_href.jpg" placement="inline"/>
       
    68 </fig></p><note>To make the WMDRM content
       
    69 fully functional, device creators must license the WMDRM porting kit from
       
    70 Microsoft and integrate it.</note>     </section>
       
    71 
       
    72 </conbody></concept>