Configuring IIS4 for WebCatalog

Microsoft IIS version 4.x no longer uses the Windows Registry to store its configration settings, which means that WebCatalog's installer program cannot automatically configure it for you. So you must manually configure IIS4 using the Microsoft Management Console.

The following instructions will guide you through configuring a suffix mapping (so that IIS knows to send .tpl files through WebCatalog) and an ISAPI filter (so WebCatalog can intercept username/password requests from remote browsers).

First, open the Microsoft Management Console. You should see a screen similar to the following:



Use the mouse to select your web server's computer name (hilited as "alpha" in the picture above). Now right-click to choose the properties for this computer. You should see a dialog similar to the following:



Click the Edit button for the WWW Service Master Properties, and on the following page click the "Home Directory" tab, and you should see the following:



Click the "Configuration" button to bring up the following dialog:



Your configuration will not have the ".tpl" entries yet; you need to add those now. Click the "Add" button, and enter ".tpl" for the file extension, and either type the full path to $WebCat.dll (similar to what you see in the window above) or use the Browse button to find $WebCat.dll. Note: your Windows Explorer may be configured to 'hide' files with extension ".dll", and thus may not show you $WebCat.dll when you navigate to that folder. In that case, either type the full path, or change the options on Explorer so it doesn't hide .dll files.

There is a bug in IIS which allows certain sensitive data to be downloaded using an obscure "$DATA" command. You can overcome this security breach by creating a ".tpl::$DATA" suffix mapping like the one shown in the screen above. WebCatalog will then intercept and prevent such data from being viewed from your site.

Next you will need to set up WebCatalog as an IIS Filter so it can intercept passwords from remote browsers. Click OK on the screen shown above, then click the "ISAPI Filters" tab to see the screen shown below:



Click the "Add" button to see the following screen:



Type "WebCatalog" into the Filter Name, and then either type or browse to $WebCat.dll (the same one you used in the previous suffix mapping dialogs). Apply all changes, then restart IIS, and you should be ready to go!