第五十七章 IIS 7 或更高版本的替代选项 (Windows) - 替代选项 1：使用 ISAPI 模块

替代选项 1：使用 ISAPI 模块 (CSPms*.dll)

如果 Web Gateway DLL 无法支持本机模块接口，请使用此选项（推荐选项）。这是为早期版本的 IIS 提供的默认（且性能最佳）解决方案。

默认情况下，IIS 7 不运行 ISAPI 扩展、ISAPI 过滤器或 CGI 模块。此选项需要 ISAPI 扩展服务。

按照安装 ISAPI 和 CGI 服务（如果需要）中的说明安装和配置 ISAPI 扩展服务。

Web 服务器应配置为能够识别文件类型并将它们传递到 Web 网关进行处理。

启用 ISAPI 扩展

DLLs: CSPms.dll and CSPmsSys.dll

在使用这些扩展之前，必须将它们注册为“允许”的应用程序。这是在 Internet 信息服务 (IIS) 管理器控制面板中完成的。

1. 打开 Internet 信息服务 (IIS) 管理器窗口。
2. 在左侧面板中，突出显示 [MACHINE_NAME] ([machine_name]\[user_name])。
3. 在中间面板中，双击 ISAPI 和 CGI 限制。
4. 在右侧面板中，选择“添加”。
5. 在“添加 ISAPI 或 CGI 限制”对话框中，输入以下详细信息：
   • ISAPI 或 CGI 路径：C:\Inetpub\CSPGateway\CSPms.dll
   • 说明：WebGateway运行时
   • 允许执行扩展路径：选择
   • 选择确定

映射 IRIS 文件扩展名

选择以下配置方法之一：

• 提供来自 IRIS 的所有内容（包括静态内容）。将 * 映射到 Web 网关。请参阅映射其他文件类型。
• 从 Web 服务器提供静态内容。仅将文件类型映射到Web 网关。

如果从 Web 服务器提供静态文件，请将文件类型映射到 Web Gateway ISAPI 扩展，如下所示：

Extension	Binary
*.csp	C:\Inetpub\CSPGateway\CSPms.dll
*.cls	C:\Inetpub\CSPGateway\CSPms.dll
*.zen	C:\Inetpub\CSPGateway\CSPms.dll
*.cxw	C:\Inetpub\CSPGateway\CSPms.dll

1. 打开 Internet 信息服务 (IIS) 管理器窗口。
2. 在左侧面板中，展开顶层以显示“网站”部分，然后显示“默认网站”部分。突出显示默认网站部分：

[MACHINE_NAME] ([machine_name]\[user_name])
            Web Sites
                    Default Web Site

注意：这会激活整个网站的 CSP。要将 CSP 的使用限制为特定虚拟子目录（例如 /csp/），请在创建映射之前将控制重点放在相应的子目录（在“默认网站”下）上。对要提供 CSP 内容的每个虚拟子目录重复此过程。

3. 在中间面板中，双击“处理程序映射”图标。
4. 在右侧面板中，选择“添加脚本映射”。
5. 在“添加脚本映射”对话框中，输入：

• Request Path: *.csp

• Executable: C:\Inetpub\CSPGateway\CSPms.dll

• Name: WebGateway_csp

6. 选择请求限制。

• 清除：仅当请求映射到时才调用处理程序
• 选择“确定”返回“添加脚本映射”对话框。
• 选择确定。

7. 此时可能会提示如下：

• “想启用此 ISAPI 扩展吗？如果是，我们会将扩展添加为 ISAPI 和 CGI限制列表中的“允许”条目。如果延期已经存在，我们会允许。”
• 选择是。
• 稍后可以找到允许的应用程序列表，如下所示：
• 在左侧面板中，突出显示：

[MACHINE_NAME] ([machine_name]\[user_name])

• 在中间面板中，双击 ISAPI 和 CGI 限制。
• 如果 Web Gateway ISAPI 组件未包含在允许的应用程序列表中，请添加它们。
• 如果 Web Gateway ISAPI 组件未包含在允许的应用程序列表中，请添加它们。
• 可以在“说明”字段中添加自己选择的文本。例如：

WebGatewayManagement for CSPmsSys.dll

WebGatewayRunTime for CSPms.dll

8. 重复上述过程：使用“添加脚本映射”对话框输入以下两个映射：

• Request Path: *.cls

• Executable: C:\Inetpub\CSPGateway\CSPms.dll

• Name: WebGateway_cls

• Request Path: *.zen

• Executable: C:\Inetpub\CSPGateway\CSPms.dll

• Name: WebGateway_zen

• Request Path: *.cxw

• Executable: C:\Inetpub\CSPGateway\CSPms.dll

• Name: WebGatewayManagement

操作和管理 Web 网关

要访问 Web Gateway 的系统管理套件，请将浏览器指向以下位置之一：

http://<ip_address>/csp/bin/Systems/Module.cxw

http://<ip_address>/csp/bin/CSPmsSys.dll