Dave's Blog : IIS7

Where is Execute Permission in the UI?

davcox — Fri, 05 Sep 2008 17:26:00 GMT

A lot has changed in the IIS7 UI from IIS6, sometimes it can be hard to find out where to set certain things such as the execute permission for CGI's and ISAPI's. Yesterday, I was trying to get a CGI to execute, but couldn't find where to set it. In IIS7...(read more)

Accessing custom properties at runtime through managed modules (part 2)

davcox — Wed, 21 Nov 2007 19:53:00 GMT

Ok, now I want to do something in my managed module during runtime that will only read from my custom configuration properties.

I need someplace to start ... like a starter kit! :)
http://www.iis.net/downloads/default.aspx?tabid=34&i=1302&g=6

This helps me get started, but it doesn’t tell me about the other events to get callbacks on as my module runs ... I realized finally that an IIS managed module is really an ASP.net module as far as it's ability to interface with the IIS pipeline. So I took a look at the ASP.net integration articles.

Finally, I found this article:
http://www.iis.net/articles/view.aspx/IIS7/Hosting-Web-Applications/ASP-NET/ASP-NET-Integration-with-IIS7?Page=3

I have my modules working, the starter kit was very helpful to get my Visual studio project setup properly. Athough it didn’t have a reference to Microsoft.Web.Administration which may be a common issue; something to add for future starter kits. This is an important issue that I realized later. Most asp.net modules will be using System.Configuration which does not support the custom properties you add through IIS and the custom schema we've described. Instead, you must use Microsoft.Web.Administration to access this kind of configuration. These two API's unfortunately don't always play well together, so you need to know when you're using which one and why.

Ok, now to deploy my module … seems hard to find a good example of doing this … probably some arcane appcmd command that would do it. I’ll copy and paste config for now … oops, the web.config default in the starter kit didn’t have preCondition="managedHandler" in there …

Ok, I copied my module to the test machine and am trying to make requests ... but it gives me an error saying that it cannot read configuration! Hmm, why is this? What would be different about using the same configuration code in a console (running as the Administrator) and in the IIS pipeline (running as Network Service). Well, the permission's were set properly, both of them can read configuration. But I didn't realize that ServerManager object (in Microsoft.Web.Administration) opens up config for write access, which is not allowed!

I have to use WebConfigurationManager instead of ServerManager …and luckily MSDN helps me: http://msdn2.microsoft.com/en-us/library/system.web.configuration.webconfigurationmanager.aspx

And I found out later that Carlos had just blogged about this! but the search engines had not yet found this great blog post:
http://blogs.msdn.com/carlosag/archive/2007/09/28/IIS7ManagedConfigurationAPI.aspx This is where Carlos goes into some detail about the difference between using design-time and run-time API's (which he implemented).

Great!! Now my module is working ... here is a code snippet:

using System;
using System.Collections.Generic;
using System.IO;
using System.Web;
using System.Diagnostics;
using Microsoft.Web.Administration;

namespace MyIIS7Modules
{
public class PonyModule : IHttpModule
{

        public void Init(HttpApplication application)
        {
            // Subscribe to the BeginRequest event
            //
            application.BeginRequest += new EventHandler(this.CheckForPony);

}

public void Dispose() { }

public void CheckForPony(Object source, EventArgs e)
{

HttpApplication application = (HttpApplication)source;
HttpContext context = application.Context;

string HttpUrl = application.Request.Url.ToString().ToLower();

            /// if this is a PONY request, then let's handle it, otherwise just continue
            if (HttpUrl.Contains("pony"))
            {

                // Get the custom configuration section from that file
                ConfigurationSection section = WebConfigurationManager.GetSection("ENC-Pony");
                bool PonyAnswer = (bool)section.GetAttributeValue("CanIHaveAPonyPlease");

application.Response.StatusCode = 200;

                if (PonyAnswer)
                {
                    ResponseEntity += ("<H1>" + section.GetAttributeValue("YesResponse") + "</H1><BR>");

At a later date, I'll post my entire module with a brief overview of it's capabilities and how to use it.

Dave

Accessing custom properties at runtime through managed modules (part 1)

davcox — Wed, 21 Nov 2007 19:25:00 GMT

Following on my last post in developing my module for app-building week, I want to talk about how I wrote the code for my managed module (C# code). So far, I have custom configuration schema that could be accessed through various built-in tools and I know that I can access custom configuration through managed code, but I needed to find some samples.

So I searched iis.net for some articles, tools and forum posts about this problem.

I found this article first:

http://www.iis.net/articles/view.aspx/IIS7/Extending-IIS7/Extending-IIS7-Configuration/Extending-IIS7-Schema-and-Accessing-the-custom-sec?Page=2
This example isn’t so detailed for a c# newbie like myself and I needed an example to access collections.
I found an example of code accessing collections here: http://forums.iis.net/t/1026445.aspx

And another one here:

http://www.iis.net/articles/view.aspx/IIS7/Extending-IIS7/Using-Microsoft-Web-Administration/Accessing-Configuration-Sections-using-Microsoft-W

With these examples, I was able to write a little console application that would read and write my configuration. A good start.

Here is my code:

using System;
using Microsoft.Web.Administration;

namespace PonyConsole
{
    class Program
    {
        static void Main(string[] args)
        {
            // Initialize the server manager used to administer the sections
            ServerManager serverManager = new ServerManager();

// Get the applicationHost.config file
Configuration config = serverManager.GetApplicationHostConfiguration();

// Get the custom configuration section from that file
ConfigurationSection section = config.GetSection("ENC-Pony");

// Output the default value of the booleanProperty
Console.WriteLine(section.GetAttributeValue("CanIHaveAPonyPlease"));

// Set the new value of the booleanProperty
section.SetAttributeValue("CanIHaveAPonyPlease", true);

// add an item to the collection
ConfigurationElementCollection collection = section.GetCollection("ponies");

            ConfigurationElement newElement = collection.CreateElement();
            newElement.SetAttributeValue("PonyLocation", "HttpLink");
            newElement.SetAttributeValue("value", "c:\\pic");
            collection.Add(newElement);

            // Update the config file with the changes that you have made
            serverManager.CommitChanges();
            Console.WriteLine("Finished writing ... ");

// Output the default value of the booleanProperty
Console.WriteLine(section.GetAttributeValue("CanIHaveAPonyPlease"));

Console.WriteLine("YesResponse is: " + section.GetAttributeValue("YesResponse"));
Console.WriteLine("NoResponse is: " + section.GetAttributeValue("NoResponse"));

foreach (ConfigurationElement element in section.GetCollection("ponies"))
{

                Console.WriteLine(element.GetAttribute("PonyLocation").Value);
                Console.WriteLine(element.GetAttribute("value").Value);
            }
        }
    }
}

At this point I had successfully written code using our new managed interface to read and write to my custom configuration properties. Very exciting ... next post is how do I make this work in the context of an IIS pipeline module.

Adding simple custom schema to IIS Configuration

davcox — Wed, 31 Oct 2007 16:27:00 GMT

Let's see if I can get 2 blog posts written in the same month! :)

As I was talking last post, our team had an app-building week (everyone will see the results over the next couple months; there were some VERY cool tools that I'm excited for people to see). I wanted to document part of my journey on getting a custom schema added.

One thing that I noted is that it's important to make sure your schema file is well-formed XML, or all sorts of tools will choke in various ways.

I looked at the existing iis_schema.xml for examples of various elements that I could use. Also, this IIS.net article is extremely helpful in getting started: http://www.iis.net/articles/view.aspx/IIS7/Extending-IIS7/Extending-IIS7-Configuration/Extending-IIS7-Schema-and-Accessing-the-custom-sec

I ended up creating this schema:

I wanted to automate adding my custom Section to the IIS config system, so I saw that MVolo has a tool to do just that; it works great. It's really just adding one line to applicationhost.config, but it's easier said than automated.

The line that needs to be added to the <configSections> element is:

Here is the iisschema.exe tool which will let you add this line item automatically.

http://mvolo.com/blogs/serverside/archive/2007/08/04/IISSCHEMA.EXE-_2D00_-A-tool-to-register-IIS7-configuration-sections.aspx
http://www.harbar.net/archive/2007/08/08/IISSCHEMA.EXE--A-tool-to-register-IIS7-configuration-sections.aspx

At this point, I could read and write configuration through tools like appcmd and the rest of the configuration stack (including the UI Configuration Editor module).

The next post will be how to develop a managed module that runs in the IIS pipeline.