第三十四章 配置服务器访问
本页介绍如何配置`` 网关连接的应用程序。对于这些配置任务,可以使用 Web Gateway
管理页面。其他文章介绍了如何配置默认设置和服务器。
每个Web
应用程序都必须配置其 CSP
文件的路径。每个路径的配置标识负责运行应用程序的 IRIS
服务器。用于指定故障转移和负载平衡的可选指令包含在应用程序路径的配置中。首次启动 Web Gateway
时,会自动配置默认应用程序路径 root
(/)。继承应用于应用程序路径。例如,如果 CSP
请求要求 /Accounts/Invoices
中的文件,并且 /Accounts/Invoices
没有配置,则 Web Gateway
将使用为 /Accounts
定义的配置。如果未定义,则使用默认路径 /
的配置。
添加应用程序路径
要配置应用程序的路径:
- 在
Web
网关管理页面主菜单上,选择应用程序访问。 - 选择添加应用程序。请注意,许多参数都有默认设置。
- 在应用程序路径文本框中输入应用程序的唯一路径。此路径是出现在应用程序
URL
中的路径。
注意:IRIS
安装会创建一个新的/csp
配置。如果已将/csp
配置为应用程序,当安装新版本的 IRIS
时,配置将被覆盖。要维护应用程序配置,请输入/csp
以外的路径。
/csp
下的任何目录都可以正常工作,例如/csp/myapplication
,但是路径不能包含任何点(句点),因为这些会导致Web
网关不明确。在此示例中:/csp/samples/menu.csp/csp/aaa/bbb/ccc.cls
,Web
网关可能会将其解释为对/CSP/samples/menu.CSP/CSP/AAA/BBB/CCC.cls
的请求或对/CSP/samples/menu.CSP
(其中PATH_INFO
为/CSP/AAA/BBB/CCC.cls
)的REST
请求。在web
服务器环境中工作的Web
网关无法解决这些歧义。
CSP
区分大小写。在配置CSP
时,请指定一致的路径名。
- 为此应用程序输入其他配置路径和服务器参数(如下表所述)。
- 完成后,选择保存配置。对应用程序配置所做的更改将在为该应用程序路径创建新用户会话时生效。现有用户不受影响。
应用程序路径配置参数
这组基本参数如下:
-
Service Status - 通过应用程序路径启用和禁用对应用程序的访问(默认为启用)。
-
Web Server Physical Path -
web
服务器上相应目录的路径。此设置对于Microsoft
IIS
系统尤其重要,在这些系统中,配置的每个路径都必须在web
服务器配置下设置为虚拟目录。IIS
中定义的每个虚拟目录都必须有一个与之关联的物理路径。IIS
的这一附加配置过程的目的是允许使用执行权限定义系统间IRIS(特别是CSP
引擎)使用的路径。默认情况下拒绝执行(以及对CSP
引擎的访问)。 -
Extra CGI Environment Variables - 每个请求返回到
IRIS
环境的附加CGI
环境变量的逗号分隔列表。每个请求都会自动发送常用的CGI
环境变量。输入通配符(*
),指示web网关在每次请求时将Web
服务器提供的所有环境变量发送到IRIS
服务器。 -
Process with this class - 用指定的类处理此路径中的文件。这允许在
CSP
中构建自己的请求处理程序。 -
GZIP Compression - 对该路径中返回的所有
CSP
页面启用或禁用GZI
P压缩(默认为禁用)。 -
GZIP Minimum File Size - 调用
GZIP
压缩的最小响应大小(以字节为单位)。默认值为500
字节。 -
GZIP Exclude File Types - 这是从
GZIP
压缩中排除的文件类型列表。要排除的文件可以按MIME
类型(如image/jpeg
)或通用扩展名(如jpeg
)列出。- 默认情况下,这些常见的(本机压缩)图像文件被排除在外:
GZIP
排除文件类型:jpeg gif ico png gz zip mp3 mp4 tiff
- 用空格分隔附加类型或扩展名。
- 默认情况下,这些常见的(本机压缩)图像文件被排除在外:
-
Response Size Notification - 此参数提供对
Web
网关用来通知客户端每个响应中包含的数据量的方法的可配置控制。- 如果使用
HTTP KeepAlive
连接,Web
客户端通常需要某种形式的响应大小通知。在这些情况下,如果正在使用HTTP v1.1
,Web
网关默认使用分块传输编码。如果使用早期的HTTP
协议,它会缓冲从IRIS
接收的响应数据,并生成一个content-length
标头。此外,在整个响应适合一个输出缓冲区的情况下,将生成内容长度标头,而不是使用分块传输。 - 在有些情况下,需要指示
Web
网关专门使用一种或另一种方法。例如,在使用HTTP v1.1
但某些中介(如代理)无法正确支持分块传输的情况下。此外,虽然所有web
客户端都应支持不发送任何形式的大小通知(例如,关闭连接事件用作响应终止符的情况),但建议所有响应都应附带某种形式的大小通知,这是一种“良好做法”。事实上,有些客户需要这样做。 - 提供了以下选项:
- 分块传输编码和内容长度(默认)
- 分块传输编码
- 内容长度
- 此参数补充了一个复选框,用于指示Web网关始终为所有请求生成大小通知,而不管是否使用了
KeepAlive
。 - 与分块响应相反,指定内容长度标头的HTTP响应的大小限制为
500
千字节。如果超过此限制,CSP
日志中会显示一条警告消息: - 警告:无法为此超大响应生成
“Content-Length
”标头指令(当前大小:大小;允许的最大缓冲大小:50000
0)
- 如果使用
-
KeepAlive - 启用或禁用此路径的
HTTP
保持活动连接。默认情况下没有操作,在这种情况下,保持活动状态由每个请求的HTTP
响应标头决定。 -
Non-Parsed Headers - 启用或禁用此路径的非解析头协议。默认启用,在这种情况下,
HTTP
响应头直接流回客户端。如果禁用此属性,响应标头将提交回宿主web
服务器。这使web服务器有机会解析标题并调用可能指示的任何输出过滤器。例如,Apache
集团的mod_deflate
设施。请注意,对于Apache web
服务器,如果启用了keep-alive
,则无论未解析的头设置如何,响应头都会提交回Apache
。