Managing claims and their scope in SDL Tridion's Ambient Data Framework 2013

Question

Can anybody explain how to setup my custom claims both for REQUEST and SESSION scope using the Ambient Data Framework API. I need a claim that once it is set it stays set until the session is gone. (I need this for a .NET application).

I tried to setup a few claims in Ambient Data Framework from my .net application in the same way I used to do in 2011, but this application uses the 2013 Content Delivery API. I used the following code:

AmbientDataContext.CurrentClaimStore.Put(
          new Uri("taf:claim:jaimesideas:blogurl"), 
          "http://jaimesantosalcon.blogspot.com");

However after doing it the claim will only be "alive" for the duration of the Request I set the claim in. So I checked the documentation and couldn't find anything explaining how to set up your own claims other than by creating your own cartridge. Do I need a cartridge always I have to setup claims? If so, What method should I overwrite from the AbstractClaimProcessor class? How does that cartridge and config file look like?

Thank you!

Here is my configuration file:

jsa_cartidge.xml

Answer 1

Unfortunately, you cannot set a claim's scope to SESSION through code. The only way to define that a claim's scope is SESSION and not REQUEST is via the claim definition configuration xml.

We have fixed this for the next service pack release (2013 SP1).

I have not tried it, but you might be able to define a claim through a simple ADF cartridge (using the xml configuration to set the scope of the claim to SESSION) and then update the claim's value through code as needed?

Something along these lines:

<ClaimDefinition Uri="taf:claim:jaimesideas:blogurl" 
                 Scope="SESSION" Description="Something" />

Answer 2

I wrote a post with an example on how to add your custom claims to ADF within your Application

Managing claims and their scope in SDL Tridion's Ambient Data Framework 2013