$Id: README,v 1.1 1998/08/31 04:02:11 tpot Exp $

Config::Access -- Perform simple text-file based access control

The Config::Access module controls access to resources via simple
text-based configuration files.  The configuration files are very
similar to the ones used in the well-known TCP wrappers program by
Wietse Venema <wietse@wzv.win.tue.nl>.

The following scripts form a simple example of using the
Config::Access module.  The access controls for the example
correspond to the "mostly closed" model of the TCP wrappers.

cat > test.pl << 'EOF'
#!/usr/bin/perl

use strict;
use Config::Access;

my($access) = Config::Access->new("example");
my($user) = getpwuid($UID);

if (!$access->access_query("beans", $user)) {
    print("Access to service 'beans' denied for user ", $user, "\n");
}

if ($access->access_query("ham", $user)) {
    print("Access to service 'ham' allowed for user ", $user, "\n");
}
EOF

cat > example.allow << 'EOF'
# Example allow file.  Allow all users to service 'ham' and only
# selected users to service 'beans'.
beans: tpot, markus
ham: ALL
EOF

cat > example.deny << 'EOF'
# Example deny file.  Deny all clients access to all services unless
# specifically allowed above.
ALL: ALL
EOF

Config::Access is a side-effect of a project at work, and as such, the
intellectual property is owned by the CRC for Advanced Computational
Systems and the following license applies.  Basically, Config::Access
is free for non-commercial use but if you want to include it in a
commercial product, you must negotiate with the CRC for Advanced
Computational Systems.

    Copyright (c) 1995,1996,1997,1998 ANU and CSIRO on behalf of the
    participants in the CRC for Advanced Computational Systems
    ('ACSys').

    ACSys makes this software and all associated data and
    documentation ('Software') available free of charge for
    non-commercial purposes only.  You may make copies of the Software
    but you must include all of this notice on any copy.

    The Software was developed for research purposes and ACSys does
    not warrant that it is error free or fit for any purpose.  ACSys
    disclaims any liability for all claims, expenses, losses, damages
    and costs any user may incur as a result of using, copying or
    modifying the Software.

Please send any comments/suggestions on this module to Tim.Potter@anu.edu.au