Installing the Ambient Data Framework in a .NET Web application

To install the Ambient Data Framework for a Content Delivery .NET Web application, copy JAR files, copy a configuration file, and modify Web.config.

Procedure

  1. Copy the following files from the installation media to the bin\lib\ folder of your Web application:
    • From the Content Delivery\roles\api\java\lib\ folder: cd_ambient.jar
    • From the Content Delivery\roles\api\java\third-party-lib\ folder: json-smart.jar
  2. Copy the file Tridion.ContentDelivery.AmbientData.dll from one of the following folders to the bin\ folder of your Web application:
    • If you have a 32-bit .NET Framework, copy from Content Delivery\roles\api\dotNet\x86\.
    • If you have a 64-bit .NET Framework, copy from Content Delivery\roles\api\dotNet\x86_64\.
  3. Copy cd_ambient_conf_sample.xml from the Content Delivery\resources\configurations\ folder to your bin\config folder and rename the file to cd_ambient_conf.xml.
  4. Open cd_ambient_conf.xml for editing.
  5. Find the <Security> section and enclose it in comments. This element is only needed if you intend to set up OAuth authentication.
  6. Save and close cd_ambient_conf.xml.
  7. Open Web.config for editing in the root folder of this Web application.
  8. To enable the Ambient Data Framework, do the following:
    Application Pool in Classic Mode

    Ensure the presence of the following inside the <httpModules> section inside the <system.web> section (create an <httpModules> element if it does not yet exist):

    <add type="Tridion.ContentDelivery.AmbientData.HttpModule" 
    	name="Tridion.ContentDelivery.AmbientData.HttpModule" />

    To enable the Ambient Data Framework for static Web pages, also do the following:

    • Ensure the presence of the following inside the <handlers> section inside the <system.webServer> section (create a <handlers> section if it does not yet exist):

      <remove name="StaticFile" />
      <add name="StaticFile" path="" verb="" modules="IsapiModule,StaticFileModule,DefaultDocumentModule,DirectoryListingModule"
        scriptProcessor="c:\PATH\TO\DOTNET\aspnet_isapi.dll" resourceType="Either" requireAccess="Read" preCondition="bitness64" />

      where c:\PATH\TO\DOTNET\ is the path to your .NET Framework root folder, for example, C:\Windows\Microsoft.NET\Framework64\v4.0.30319\.

      If you run 32-bit .NET, remove the preCondition attribute.

    • Ensure the presence of the following inside the <httpHandlers> section inside the <system.web> section (create an <httpHandlers> section if it does not yet exist):

      <add verb="GET" path="*" type="System.Web.StaticFileHandler" />
    Application Pool in Integrated Mode

    Add the following inside the <modules> section inside the <system.webServer> section (create a <modules> element if it does not yet exist):

    <add type="Tridion.ContentDelivery.AmbientData.HttpModule" 
    	name="Tridion.ContentDelivery.AmbientData.HttpModule" />
  9. Save and close Web.config.
  10. Restart the Web application.