diff -r 89d6a7a84779 -r 25a17d01db0c Symbian3/PDK/Source/GUID-EFF8D1A1-00D5-5F96-8285-414DC0044AB8.dita --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Symbian3/PDK/Source/GUID-EFF8D1A1-00D5-5F96-8285-414DC0044AB8.dita Fri Jan 22 18:26:19 2010 +0000 @@ -0,0 +1,104 @@ + + + + + +Setting +Use PoliciesA use policy denotes the security check required to use the key. +The use policy associated with the key is of type TSecurityPolicy. +The policy can be set to check capabilities or the Secure ID associated with +the calling process. The calling process should have a WriteUserData capability. +

The following steps explain the process of setting a use policy +for a key:

 + +Create a file system +session using an RFs object. + + +Create an object of type CUnifiedKeyStore using CUnifiedKeyStore::NewL() or CUnifiedKeyStore::NewLC(). + + +Initialise the member functions and keystore using the asynchronous +function CUnifiedKeyStore::Initialize(). + + +List all keys in the keystore using the CUnifiedKeyStore::List() function. +Retrieve the handle of the key for which the use policy needs to be set. + + +Set the use policy for the key using the CUnifiedKeyStore::SetUsePolicy() function. + + +

Use policy is set for the selected key.

+Example

The +following code snippet shows how to set use policy for a key.

// Create a file system session object +RFs iFs; +CleanupClosePushL(&iFs); + + +... + + +// Initialise the keystore and member functions +CUnifiedKeyStore* keyStore = CUnifiedKeyStore::NewL(fs); +keyStore->Initialize(iStatus); //iStatus is a TRequestStatus object + + +... + + + +// Retrieve the handle of the key for which use policy has to be set +TCTKeyAttributeFilter filter.iUsage = EPKCS15UsageAll; +RPointerArray<CCTKeyInfo> iKeys; // This variable will contain the result of the set use policy operation +keyStore->List(iKeys, filter, iStatus); + + +... + + + +// Retrieve the key handle of the appropriate key +_LIT(KLabel,”keylabel”); + +// Select the key with the label you are looking for +TInt keyIndex; +for (TInt j = 0; j < iKeys.Count(); j++) + { + if (iKeys[j]->Label() == KLabel) + { + keyIndex = j; + break; + } + } + + +... + + + +// Set the use policy + +TSecurityPolicy usePolicy; +TUint secureId = 0x101FFFFF; +TCapability caps[3]; +caps[0] = ECapabilityWriteUserData; +caps[1] = ECapabilityDRM; +caps[2] = ECapabilityReadUserData; + +usePolicy = TSecurityPolicy(TSecureId(secureId), caps[0], caps[1], caps[2]); +keyStore->SetUsePolicy(*iKeys, usePolicy, iStatus); + + +// Clean up +CleanupStack::PopAndDestroy(); // iFs + +Set Management +Policies + \ No newline at end of file