Adding Encrypted Properties to the Profile Service

The following procedures are to add new profile properties that can be encrypted.

Caution

• Do not mark properties with preexisting data as encryptable. Otherwise, the preexisting data will be lost.

Step 1: Add a new property for the key index

Step 2: Add a profile level custom attribute

Step 3: Add encrypted properties to a profile

Step 1: Add a new property for the key index

1. Open Commerce Server Manager.
2. Expand Commerce Server Manager, expand Global Resources, expand Profile Catalog, expand Profile Definitions, and then click User Object.
3. In the right pane, click Profile System in the Properties list.
4. Click Add in the right pane.
5. In the Add-Web Page Dialog box, select Add a new property.
6. Click OK.
7. In the Attributes section, type the following:

   Use this	To do this
   Name	Type the name (for example, KeyIndex).
   Display Name	Type the name to be displayed in the Custom Attributes tab (for example, KeyIndex).
   Description	Type the description of the KeyIndex custom attribute.
   Type	Select Number.
   Type Reference	Select as blank. Cannot be a JoinKey, PrimaryKey, DualKey, or HashingKey.

8. Click AdvancedAttributes section, and type the following:

   Use this	To do this
   Active	Clear the Yes check box.
   Map to Data	Click ellipsis button [...] to create data member of type number if it has not already been created.

9. Click Apply, and then click on the toolbar.

Step 2: Add a profile level custom attribute

1. Right-click your profile (for example, User Object) and select Properties.
2. Click Custom Attributes tab.
3. Click New.
4. In the Custom Attribute dialog box, type the following:

   Use this	To do this
   Name	Type KeyIndex.
   Display Name	Type the name to be displayed (for example, KeyIndex).
   Description	Type the description of the KeyIndex custom attribute.
   Value	Type Key Index. This should be the same property name as the profile created in the earlier step, Step 1: Add a new property for the key index.

5. Click OK in the Custom Attribute dialog box.
6. Click Apply in the User Object Properties dialog box, and then click OK.

Step 3: Add encrypted properties to a profile

1. Click Add on the right pane.

2. In the Add-Web Page Dialog box, select Add a new property.

3. Click OK.

4. In the Attributes section, do the following:

   Use this	To do this
   Name	Type the property name.
   Display Name	Type the name to be displayed.
   Description	Type the description of KeyIndex custom attribute.
   Type	Select Password or String.

5. In the Advanced Attributes section, do the following:

   Use this	To do this
   Map to data	Click the ellipsis button [...] to map the property to a data member.
   Key type	Leave this blank. The key type cannot be a UniqueKey, JoinKey, PrimaryKey, DualKey, or HashingKey.
   Encrypted	Select one of the encryption types from the drop-down list.
   Exported	Clear the Yes check box.
   Multi-valued	Optional.
   Searchable	Clear the Yes check box.
   Hashing Key	Clear the Yes check box.

   ****Note

   • In the Custom Attributes section, encrypted properties cannot be marked as displaycolumn or friendlyname (for use in the profile editors only).
   • You cannot create a custom attribute at the property level with a name of EncryptedType (case insensitive).
   • Encrypted properties are limited to 795 Unicode characters.

6. Click the Apply button, and then click on the toolbar.

Copyright © 2005 Microsoft Corporation.
All rights reserved.