The CardSpace Control adds all the page elements needed to activate your user's Information Card Selector (Windows CardSpace) and
request Identity Claims. Just drop the control onto your web page, pick the image to display and specify which claims you wish to receive.
The CardSpace Control inserts the required <Object>
tag, hidden fields and JavaScript required to make it all work.
Design-time properties
Properties are available for just about everything you will need in requesting Identity
Claims. Full intellisense support is available to help you design your web page
in Source View. If you prefer the designer, you'll find the Properties Panel to
be invaluable.
 |
Show/hide other controls
Specify a Css class for all the page elements which should be hidden if the user's
browser does not support Identity Card selection. Do the same for those that should
only be shown if support is available.
Pick your image
The CardSpace Control includes several sizes of Microsoft's official
Card Space Icon. If you like, you can specify the url of your own image instead.
Required/Optional Claims
Any of the standard system-provided claim types can be requested
as either optional or required. Just toggle the property as shown here.
Custom Claims
If you are issuing or requiring managed cards, just list the Uri
for your custom claims, set the Issuer Policy and Privacy properties.
Context Help
As you select each property, its description will be displayed at
the bottom of the Properties Panel.
|
Events
In addition to base control events, the CardSpace Control raises the following
events which you can use to programmatically handle arriving Identity Claims:
-
ClaimsPresented - Provides a claims object
-
ClaimsPresentedError - Provides the claims object plus the exception
The Claims Object
The Claims Object is a convenient container for passing around the identity information
provided by your users. It includes properties for each of the standard system-provided claims
as well as a dictionary of user-defined claims which correspond to those requested.
As shown here, intellisense will help you quickly locate the claim whose value you
wish to retrieve.
Support
If you need help getting the CardSpace Control to work on your web site, please visit our
Support Forum.
The complete API for the CardSpace Controls is available
here.