CSP Gateway Configuration Guide - InterSystems Documentation

Table of Contents
About this Book ..................................................................................................................................... 1
1 Introduction to the CSP Gateway ..................................................................................................... 3
1.1 Who Should Read this Document .............................................................................................. 3
1.2 CSP Documentation ................................................................................................................... 3
1.3 Supported Web Servers ............................................................................................................. 4
1.4 Configuring the Web Server and the CSP Gateway ................................................................... 5
1.5 Gateway Management Module configuration ........................................................................... 5
1.6 File Types Served by CSP ......................................................................................................... 5
1.7 Enable Sticky Sessions on Hardware Load Balancer on High Availability Solutions ............... 6
1.8 Conventions Used in this Document .......................................................................................... 6
1.8.1 Gateway components and physical installation paths ...................................................... 7
1.9 Configuring the CSP Gateway for Ensemble ............................................................................. 8
1.10 Minimal Apache Web Server or Private Web Server ................................................................ 8
1.10.1 Building the Private Web Server .................................................................................... 9
1.10.2 Managing the Private Web Server ................................................................................ 10
2 CSP Gateway Operation and Configuration ................................................................................. 11
2.1 CSP Web Gateway Management Page ..................................................................................... 11
2.1.1 Security Considerations with CSP Web Gateway Management Page ........................... 12
2.1.2 Checking System Status ................................................................................................. 13
2.1.3 Closing Connections Manually ...................................................................................... 14
2.1.4 Testing Server Connections ............................................................................................ 15
2.1.5 Viewing the Event Log ................................................................................................... 16
2.1.6 Viewing HTTP Trace ...................................................................................................... 16
2.1.7 Configuring Default Parameters .................................................................................... 16
2.1.8 Configuring Server Access ............................................................................................. 24
2.1.9 Configuring Application Access .................................................................................... 28
2.1.10 About CSP Gateway Page ............................................................................................ 32
2.2 CSP Gateway and Security ....................................................................................................... 33
2.2.1 Gateway Security Parameters ......................................................................................... 33
2.2.2 Minimal Connection Security ........................................................................................ 34
2.2.3 Simple Username- and Password-based Authentication ................................................ 34
2.2.4 Kerberos-based Authentication and Data Protection ..................................................... 35
2.2.5 SSL-based Authentication and Data Protection ............................................................. 37
2.3 CGI Environment Variables ...................................................................................................... 37
2.4 HTTP Response Headers ......................................................................................................... 39
2.5 Making a CSP Page the Home Page for the Web Server ......................................................... 40
2.5.1 Internet Information Services ......................................................................................... 40
2.5.2 Sun Web Servers ............................................................................................................ 41
2.5.3 Apache Servers ............................................................................................................... 41
2.6 Compressing the Response to Requests for CSP Forms (GZIP/ZLIB) .................................... 42
2.6.1 Installing the GZIP/ZLIB Library .................................................................................. 42
2.6.2 Using the GZIP/ZLIB Library ....................................................................................... 43
2.6.3 Specifying Compression for Individual Pages ............................................................... 44
2.6.4 Specifying Compression for All Pages within an Application Path ............................... 44
2.6.5 Monitoring ..................................................................................................................... 44
2.7 CSP Page Output Caching ........................................................................................................ 44
CSP Gateway Configuration Guide
iii