IIS Connector

Blazix IIS connector module:

Blazix ISAPI Connector

Steps to install the connector.

Download the connector from the link above. The Blazix server can be on any platform, either on the same machine as the IIS server, or on a different machine.
Place the downloaded file in the "/scripts" folder of the IIS server (typically this is located in C:\Inetpub\scripts). If you do not have a "/scripts" folder, create one. Make sure your "/scripts" has executable (including scripts) permission. You can also use a different folder from /scripts, but you must make sure it has the executable and scripts permissions, and you must specify the URL for the DLL in the configuration file.
Create a configuration file. The configuration file must have the exact same pathname as the connector DLL, but it must have a ".ini" extension instead of the .dll extension. For instance, if the connector DLL is c:\Inetpub\scripts\BlazixIsapi.dll, the configuration file will be c:\Inetpub\scripts\BlazixIsapi.ini.
The configuration file contains several commands, each command on one line. The commands are of the form
```
key: value
```
The "key" can be one of "Host", "Port", "URL" or "ConnectorURL". The "URL" can be repeated multiple times.
The "Host" and "Port" keys specify where the Blazix server is running. If the Blazix server is running on the same machine as the IIS server, Host can be specified as "localhost".
The URL keys specify the URLs which are to be passed to the Blazix server. Typically all .jsp files will be passed to Blazix. In addition, any servlet URLs will also be passed to Blazix. If you are using Blazix Authentication, also specify "/j_security_check" and the URL which is to be used for reporting authentication failure.
The URL keys can start or end with the * character, which serves as a wildcard.
A sample BlazixIsapi.ini file is shown below
```
Host: myhost
Port: 800
URL: *.jsp
URL: /myservlet1
URL: /myservlet2
URL: /myapp/*
URL: /j_security_check
URL: /LoginFailed.html
```
The ConnectorURL key specifies the URL to the BlazixIsapi.dll. It defaults to /scripts/BlazixIsapi.dll, so it is not required if you have installed the DLL in the /scripts folder.
Add the BlazixIsapi.dll as an ISAPI filter. To do this, select the web-site (not the "/scripts" folder, but the entire web-site) in IIS manager, and right-click "Properties". Go to the "ISAPI Filters" tab and add a new filter. Specify a filter name such as "Blazix Connector" and specify the path to the BlazixIsapi.dll module.

Note: Changes to the BlazixIsapi.ini file will require stopping and restarting the IIS server (and may require rebooting since IIS tends not to free up the ISAPI libraries even when the web-server is stopped.)