Skip to content

Configuring IIS

Jump to bottom Edit New page
Sebastien Lambla edited this page Feb 4, 2012 · 1 revision

Configuring IIS hosting

By default, the OpenRasta HTTP module that intercepts communication ignores certain paths and will not be triggered.

Ignored paths

The HTTP module ignores both the root of the site (path /) as well as any directory that exists according to the current virtual path provider. This is not usually an issue, as default documents often implicitly trigger aspx files that then cause .net (and OpenRasta) to handle the request.

OpenRasta also ignores requests for paths that have already been registered with a handler.

Configuration

In certain scenarios (such as highly customized IIS installations), overriding the defaults is possible (since 2.1) with the following settings.

  • openrasta.hosting.aspnet.paths.root = enable Allows processing of the root (/) path.
  • openrasta.hosting.aspnet.paths.directories = all Allows processing of directories that exist on the file system.
  • openrasta.hosting.aspnet.paths.handlers = all Allows processing of requests handled by an existing IHttpHandler

Those values can be set in the web.config file's AppSettings section.

For example, to enable handler overriding:

<configuration>
  <appSettings>
    <add key="openrasta.hosting.aspnet.paths.handlers" value="all"/>
  </appSettings>
  ...
 </configuration
Add a custom footer
Add a custom sidebar
Clone this wiki locally