smeserver-lazy_admin_tools/root/usr/sbin/lat-ibays

371 lines
13 KiB
Plaintext
Raw Normal View History

#!/usr/bin/perl -w
#==============================================================================
# lat-users
# =========
# 0.9.0 (2004-09-08)
# (c)2003-2004 Altiplano bvba
#==============================================================================
package esmith;
use strict;
use esmith::db;
use esmith::util;
use Getopt::Long;
use Pod::Usage;
my %conf;
tie %conf, 'esmith::config';
my %accounts;
tie %accounts, 'esmith::config', '/home/e-smith/db/accounts';
my ($Hlp, $Cml, $Frc, $Inp);
my $Add =0;
my $Del =0;
#==============================================================================
# Main
#==============================================================================
# Analyze commandline options
GetOptions ("help" => \$Hlp,
"add" => \$Add,
"delete" => \$Del,
"force" => \$Frc,
"command-line=s" => \$Cml,
"input-file=s" => \$Inp);
if ( $Hlp ) { &PrintPod(9); exit; }
# We need one argument or the other, but not both
if ((($Cml && $Inp) || (! $Cml && ! $Inp)) ||
($Add + $Del != 1))
{ &PrintPod(1); exit; }
my @records;
if ($Inp) {
open(LIST,"< $Inp") || die "Can't find $Inp.\n";
@records = grep(!/(^\s*#)|(^\s*$)/,<LIST>);
close(LIST); }
elsif ($Cml) { @records=($Cml); }
else { &PrintPod(1); exit; }
# Add ibays
if ($Add) {
# Process each ibay
foreach my $record (@records)
{
my @fields=split(/\|/,$record);
for (my $cnt=0; $cnt <= $#fields; ++$cnt) { for ($fields[$cnt]) { s/^\s+//; s/\s+$//; }}
my $ibayname = $fields[0];
my $password = ""; if ($fields[5]) { $password = $fields[5] }
my $uid;
if ($fields[7]) { $uid = $fields[7]; }
else { $uid = &FindUid;}
if (&TestUid($uid)) {
my %ibay;
if ( $fields[1] ) { $ibay{'Name'} = $fields[1] } else { $ibay{'Name'} = $ibayname }
if ( $fields[2] ) { $ibay{'Group'} = $fields[2] } else
{die "We need a valid group to create '$ibayname'.\a\n";}
if ( $fields[3] ) { $ibay{'UserAccess'} = $fields[3] } else { $ibay{'UserAccess'} = "wr-admin-rd-group" }
if ( $fields[4] ) { $ibay{'PublicAccess'} = $fields[4] } else { $ibay{'PublicAccess'} = "local-pw" }
if ( $fields[5] ) { $ibay{'PasswordSet'} = "yes" } else { $ibay{'PasswordSet'} = "no" }
if ( $fields[6] ) { $ibay{'CgiBin'} = $fields[6] } else { $ibay{'CgiBin'} = "disabled" }
$ibay{'Uid'} = $uid;
$ibay{'Gid'} = $uid;
if (&ValidArguments(\%ibay, $ibayname, $password)) {
print "Creating ibay '$ibayname' (Uid:$uid).\n";
db_set(\%accounts, $ibayname, 'ibay', \%ibay);
system("/sbin/e-smith/signal-event", "ibay-create", $ibayname) == 0 or
die ("An error occurred while creating ibay '$ibayname'.\n");
# Set password
if ($ibay{'PasswordSet'} eq 'yes') { esmith::util::setIbayPassword($ibayname, $password); }
}
}
}
}
# Delete ibays
if ($Del) {
&ExpandWildCard; # Check for wildcards and expand if necessary
foreach my $record (@records)
{
my @fields=split(/\|/,$record);
for (my $cnt=0; $cnt <= $#fields; ++$cnt) { for ($fields[$cnt]) { s/^\s+//; s/\s+$//; }}
my $ibayname = $fields[0];
my $password = ""; if ($fields[5]) { $password = $fields[5] }
if ((db_get(\%accounts, $ibayname)) &&
(db_get_type(\%accounts, $ibayname)) eq "ibay") {
my $yn = 'yes';
if (! $Frc) {
print "Do you want to delete ibay '$ibayname'?\n";
print "All files in this ibay will be deleted! [yes/NO/all] ";
$yn = <STDIN>;
if ($yn =~ /^a/i) { $Frc = -1; $yn="yes"; }
}
if ($yn =~ /^y/i) {
print "Deleting ibay '$ibayname'.\n";
db_delete(\%accounts, $ibayname);
system("/sbin/e-smith/signal-event", "ibay-delete", $ibayname) == 0
or die ("An error occurred while deleting ibay '$ibayname'.\n");
}
}
else { print "Can't find ibay '$ibayname'.\n\a";}
}
}
#==============================================================================
# Subroutines
#==============================================================================
# Find an unused Uid/Gid
sub FindUid {
open(ACC,"/home/e-smith/db/accounts") || die "Can't find /home/e-smith/db/accounts";
my @recs = grep(/Uid\|\d*/,<ACC>);
close(ACC);
open(PWD,"/etc/passwd") || die "Can't find /etc/passwd";
my @pwds = grep(/\:\d*\:/,<PWD>);
close(PWD);
open(GRP,"/etc/group") || die "Can't find /etc/group";
my @grps = grep(/\:\d*\:/,<GRP>);
close(GRP);
my $newuid=db_get(\%conf, 'MinUid');
do { ++$newuid;} until ((! grep(/Uid\|$newuid\D/,@recs)) &&
(! grep(/\:$newuid\:/,@pwds)) &&
(! grep(/\:$newuid\:/,@grps)));
return $newuid;
}
#==============================================================================
# Test the uid/gid for availability and legality
sub TestUid {
open(ACC,"/home/e-smith/db/accounts") || die "Can't find /home/e-smith/db/accounts";
my @recs = grep(/Uid\|\d*/,<ACC>);
close(ACC);
open(PWD,"/etc/passwd") || die "Can't find /etc/passwd";
my @pwds = grep(/\:\d*\:/,<PWD>);
close(PWD);
open(GRP,"/etc/group") || die "Can't find /etc/group";
my @grps = grep(/\:\d*\:/,<GRP>);
close(GRP);
if (! ($_[0] =~ /^\d*$/)) {
print "Error: A user ID should contain only numbers.\a\n";
return 0;
}
elsif ( $_[0] < db_get(\%conf, 'MinUid')) {
print "Error: The user ID should be greater or equal to ".&FindUid."\a\n";
return 0;
}
elsif ((grep(/Uid\|$_[0]\D/,@recs)) or
(grep(/\:$_[0]\:/,@pwds)) or
(grep(/\:$_[0]\:/,@grps))) {
print "Error: The uid/gid '$_[0]' is already in use\a\n";
return 0;
}
else { return 1 };
}
#==============================================================================
# Test the various arguments for their validity
sub ValidArguments {
my $href = $_[0];
my $nm =$_[1];
my $pw =$_[2];
my $ret = 1;
if (db_get(\%accounts, $nm)) {
print "An account with the name '$nm' already exists on this server.\n\a";
$ret = 0;
}
if ( ! ( $nm =~ /^[a-z][a-z\-\_\d\.]*$/ )) {
print "Can't create ibay '$nm'. ";
print "The name contains illegal characters.\n";
print "The name should contain only lower-case letters, numbers, hyphens, periods and \n";
print "underscores, and should start with a lower-case letter.\n\a";
$ret = 0;
}
if (not defined(db_get(\%accounts, $href->{'Group'})) &&
(db_get_type(\%accounts, $href->{'Group'} ) ne "ibay" )) {
print "Can't create ibay '$href->{'Name'}'. ";
print "The group '".$href->{'Group'}."' does not exist.\n\a";
$ret = 0;
}
if ( ! ($href->{'UserAccess'} =~ /^wr-admin-rd-group$|^wr-group-rd-everyone$|^wr-group-rd-group$/)) {
print "Can't create ibay '$href->{'Name'}'. ";
print "User access must be either 'wr-admin-rd-group', \n'wr-group-rd-everyone' or 'wr-group-rd-group'.\n\a";
$ret = 0;
}
if ( ! ($href->{'PublicAccess'} =~ /^local$|^local-pw$|^global$|^global-pw$|^global-pw-remote|^none$/)) {
print "Can't create ibay '$href->{'Name'}'.\n";
print "Public access must be either 'local', 'local-pw', 'global', 'global-pw', 'global-pw-remote', or 'none'.\n\a";
$ret = 0;
}
if ( ! ($href->{'CgiBin'} =~ /^(disabled)$|^(enabled)$/)) {
print "Can't create ibay '$href->{'Name'}'. ";
print "The CGI-Bin must be either 'disabled' or 'enabled'.\n\a";
$ret = 0;
}
return $ret;
}
#==============================================================================
# Test for wildcards in the ibayname. If any wildecards are found, the array
# @records is expanded with the ibay names that meet the conditions.
sub ExpandWildCard {
my $ctrec = 0;
foreach my $record (@records)
{
my @fld=split(/\|/,$record);
for (my $cnt=0; $cnt <= $#fld; ++$cnt) { for ($fld[$cnt]) { s/^\s+//; s/\s+$//; }}
if ($fld[0] =~ /\*|\?/) { # Does it contain the wildcards?
$fld[0] =~ s/\*/\.\*/g; # Replace * with .* to allow for grep.
$fld[0] =~ s/\?/\./g; # Replace ? with . to allow for grep.
open USRS, "</home/e-smith/db/accounts" or die "Can't open /home/e-smith/db/accounts: $!";
my @match = grep /^$fld[0]\=ibay\|/i, <USRS>;
close(USRS);
my $cu = 0;
foreach my $tst (@match) {
$tst =~ /\=/; $tst = $`;
for (my $cnt=1; $cnt <= $#fld; ++$cnt) { $tst = $tst." | ".$fld[$cnt]; };
if ($cu == 0 ) {
$records[$ctrec] = $tst;
$cu =1;
}
else {
push(@records, $tst);
}
}
}
++$ctrec;
}
}
#==============================================================================
# Print the pod text as a help screen
sub PrintPod {
my ($verbose, $message) = @_;
pod2usage(-verbose => $verbose, -message => $message, -exitval => 64);
}
#==============================================================================
=pod
=head1 NAME
B<lat-ibays> - The lazy administrator's tool to create ibays
=head1 DESCRIPTION
Creates or deletes ibays on Mitel's SME servers (5.x/6.x).
This tool is functionally equivalent to the 'Information bays' option in the server-manager, but can be run from the command line or called from an other script.
It allows you, for example, to create an i-bay as part of an installation script, or delete i-bays on a remote machine via an ssh console.
See F</usr/doc/lazy-admin-tools/example.ibays> for the format of the input file.
=head1 SYNOPSIS
B<lat-ibays> -a -c "ibay | descr | group | useraccess | publicaccess | password | cgi-bin | uid"
B<lat-ibays> -a -i /path/to/ibays.list
B<lat-ibays> -d [-f] -c "Ibay"
B<lat-ibays> -d [-f] -i /path/to/ibays.list
=head1 OPTIONS
The following options are supported:
=over 4
=item B<-a>, B<--add>
Add an ibay to the server
=item B<-c 'Arguments'>, B<--command-line='Arguments'>
Take arguments from the command line. See below for the various arguments that are accepted.
=item B<-d>, B<--delete>
Delete an ibay from the server. Wildcards (* and ?) are accepted.
=item B<-f>, B<--force>
Don't prompt before deleting.
=item B<-h>, B<--help>
Extended help for this tool
=item B<-i FILE>, B<--input-file=FILE>
Use the information from FILE to create or delete ibays.
=back
=head2 Arguments:
Ibay* : Must contain only lower-case letters, numbers, hyphens,
periods and underscores, and should start with a lower-
case letter. Wildcards (* and ?) can only be used to
delete ibays!
Descr. : Free text description of the ibay.
Group* : Must be an existing group on the server.
UserAccess : wr-admin-rd-group (default)
wr-group-rd-everyone
wr-group-rd-group
PublicAcc. : local (default)
local-pw
global
global-pw
global-pw-remote
none
Passd : Password for the ibay in clear-text (dangerous!).
CGI : enabled
disabled (default)
uid : User ID. If omitted, the first available uid will used.
* mandatory field
=head1 EXAMPLES
B<lat-ibays -a -c "library | Hogwarts' library | griffindor">
Creates the i-bay 'library' for user group 'griffindor'.
B<lat-ibays -a -i "/root/ibays.list">
Creates the i-bays defined in F</root/ibays.list>.
Please refer to F</usr/doc/lazy-admin-tools/example.users> for an example of an input file.
B<lat-ibays -d -f -c "class*">
Deletes all ibays that start with 'class'. All ibays and their files are deleted without prompting (-f).
B<lat-ibays -a -c "library | Hogwarts' library | griffindor | wr-group-rd-group | local-pw | quidditch | enabled | 8003">
Creates the i-bay 'library' for user group 'griffindor'. Password is 'quiddich', cgi is enabled and the group ID is set to 8003.
=head1 SEE ALSO
lat-group(8), lat-pseudonyms(8), lat-users(8), lat-quota(8), lat-domains(8), lat-hosts(8), lat-procmail(8), lat-pptp(8), lat-dump(8)
=head1 VERSION
Version 0.9.0 (2004-09-08). The latest version is hosted at B<http://www.contribs.org/contribs/mblotwijk/>
=head1 COPYRIGHT
(c)2003-2004, Altiplano bvba (B<http://www.altiplano.be>). Released under the terms of the GNU license.
=head1 BUGS
Please report bugs to <Bugs@Altiplano.Be>
=cut
#==============================================================================