Import Upstream version 1.8.5
[hcoop/debian/openafs.git] / src / afsweb / README
CommitLineData
805e021f
CE
1Copyright 2000, International Business Machines Corporation and others.
2All Rights Reserved.
3
4This software has been released under the terms of the IBM Public
5License. For details, see the LICENSE file in the top-level source
6directory or online at http://www.openafs.org/dl/license10.html
7
8AFS Web Security Pack for the Apache Web Server, Version 1.0
9
10
11Release Notes
12
13I. Introduction
14
15The AFS Web Security Pack is an extension available for selected Web servers
16that enables system administrators to provide secure access via a
17Web browser to documents stored in the AFS filespace. This document
18provides information specific to this release of the AFS Web Security Pack.
19
20Note: Due the long filenames and file extensions used for the AFS Web
21Secure distribution files, download of the AFS Web Secure product to
22a PC sometimes results in incorrect filenames. Note that all AFS Web
23Secure distribution files are g-zipped tar files, even if the *.tar.gz
24file extension is lost during the download process.
25
26II. Installation Prerequisites
27
28Note: If you have installed a previous version of the AFS Web Security Pack,
29you must first remove the previous version, including any modifications made
30to your Apache Web server configuration and runtime configuration files
31before installing this version of the product.
32
33Your system must meet the following software and disk space requirements
34to install this version of the AFS Web Security Pack.
35
36Operating system: Solaris 2.5.1, AIX 4.2x, AIX 4.3, or AIX 4.3.1
37Web server: Apache 1.2.6 or Apache 1.3.1
38AFS (client): AFS Client 3.4a
39Disk Space: 650 KB
40
41Note: Due to security considerations, OpenAFS strongly recommends that the
42AFS Web Security Pack be used only on a server enabled with Secure Sockets
43Layer (SSL).
44
45
46IV. Known Defects and Limitations
47
48* Due to a preexisting problem in the AFS UNIX product, the Apache
49server Fancy Indexing option does not function as expected when AFS
50directories are displayed. If the Fancy Indexing option is enabled
51on the Apache server, when a user initially browses an ACL-protected
52directory (with "system:anyuser l" access), the user is able to see
53file details for directories and links, but not for files. Once the
54user selects a file and enters a username and password, details for
55the files are then displayed. This problem is not caused by the AFS Web
56Security Pack or the Apache server, but is due to a defect in the UNIX-based
57AFS code. We are working to address this problem and will make an
58announcement when a corrected version is available. In the interim,
59please be aware of this limitation as you use the AFS Web Security Pack.
60
61*If the AFS Web Security Pack is used on the Apache server version 1.3.1, user
62directories cannot be directly accessed through the use of a special character
63such as a tilde (~) despite use of the Apache server User Directory directive.
64
65VII. AFS Web Security Pack Documentation
66
67Postscript and HTML versions of the documentation for the AFS Web Security
68Pack are available in the doc directory.
69
70VIII. Additional Information about Apache and SSL
71
72The following sites on the World Wide Web provide additional information
73about the Apache Web Server and SSL.
74
75* Apache Home Page http://www.apache.org
76* Stronghold Home http://www.c2.net
77* Stronghold International http://www.int.c2.net
78* Apache-SSL Home http://www.apache-ssl.org
79* SSLeay FAQ http://www.psy.uq.edu.au:8080/~ftp/Crypto/