CSP Gateway Configuration Guide - InterSystems Documentation

Web Servers for Microsoft Windows
By the CSPFileTypes directive
The CSPFileTypes directive works for requests for files that have extensions (such /csp/menu.csp). It does not work for
requests for files that do not have file extensions (such as/csp/menu).
This parameter is processed by the Gateway’s Apache modules and can be globally defined at the server definition level
(in httpd.conf) or restricted within the definition for a location or directory block.
By file type: The following directive requests that files of type .xxx and .yyy be processed by CSP.
CSPFileTypes .xxx .yyy
By location: The following requests that files of type .xxx and .yyy be processed by CSP but only for locations under /csp
(including subdirectories, such as /csp/samples and so on).
CSPFileTypes .xxx .yyy
Using the wildcard character, the following requests that all files under path /csp (and /csp/samples and so on) be processed
by CSP.
CSPFileTypes *
By MIME type
In addition to recognizing the file extensions listed above, CSP can also recognize files for the following MIME types:
application/x-csp
and
text/csp
For example, to add the file extension xxx to the list of files processed by CSP, use:
LoadModule csp_module_sa /cache-install-dir/csp/bin/CSPa22.dll
AddType application/x-csp csp cls zen xxx
One of the problems with using MIME types to associate types of file with CSP is that Apache checks to ensure that the
path to the resource (that is, the hosting directory) physically exists, and returns a file not found error if it does not.
It does not, however, check to ensure that the file requested physically exists – which is appropriate for resources served
by CSP since they are served by Caché and are virtual as far as the web server is concerned. The “By MIME type” approach
is therefore only suitable for cases where the application’s path structure can be replicated on the web server.
3.4.2.2 Operating and Managing the Gateway with Apache API
To access the CSP Gateway’s CSP Web Gateway Management page, point your browser at:
http://localhost:/csp/bin/Systems/Module.cxw
Notice the use of the cxw file extension. This extension prevents Apache attempting to load and run these DLLs through
the Apache Group ISAPI interface. Also, remember that URL paths and files names are case-sensitive under Apache.
If you see an Unauthorized User error message, refer to the section on “security considerations”.
The CSP engine is automatically invoked for requested files that contain a .csp, .cls, or .zen extension. For example:
http://localhost:/csp/samples/menu.csp
72 CSP Gateway Configuration Guide