Annotation of loncom/enrollment/Autoupdate.pl, revision 1.28

1.1       raeburn     1: #!/usr/bin/perl
                      2: #
                      3: # Automated Userinfo update script
1.28    ! raeburn     4: # $Id: Autoupdate.pl,v 1.27 2023/12/06 23:46:16 raeburn Exp $
1.1       raeburn     5: #
                      6: # Copyright Michigan State University Board of Trustees
                      7: #
                      8: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
                      9: #
                     10: # LON-CAPA is free software; you can redistribute it and/or modify
                     11: # it under the terms of the GNU General Public License as published by
                     12: # the Free Software Foundation; either version 2 of the License, or
                     13: # (at your option) any later version.
                     14: #
                     15: # LON-CAPA is distributed in the hope that it will be useful,
                     16: # but WITHOUT ANY WARRANTY; without even the implied warranty of
                     17: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                     18: # GNU General Public License for more details.
                     19: #
                     20: # You should have received a copy of the GNU General Public License
                     21: # along with LON-CAPA; if not, write to the Free Software
                     22: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
                     23: #
                     24: # /home/httpd/html/adm/gpl.txt
                     25: #
                     26: # http://www.lon-capa.org/
                     27: #
                     28:     use strict;
                     29:     use lib '/home/httpd/lib/perl';
                     30:     use localenroll;
1.24      raeburn    31:     use GDBM_File;
1.1       raeburn    32:     use Apache::lonnet;
                     33:     use Apache::loncommon;
1.4       raeburn    34:     use Apache::lonlocal;
1.11      raeburn    35:     use Apache::lonuserutils();
1.5       raeburn    36:     use LONCAPA::Configuration;
1.2       raeburn    37:     use LONCAPA;
1.1       raeburn    38: 
1.5       raeburn    39:     my $perlvarref = LONCAPA::Configuration::read_conf('loncapa.conf');
1.19      raeburn    40:     exit if (ref($perlvarref) ne 'HASH');
                     41:     my $logfile = $perlvarref->{'lonDaemons'}.'/logs/autoupdate.log';
                     42:     exit if ($perlvarref->{'lonRole'} ne 'library');
1.10      raeburn    43:     my $hostid = $perlvarref->{'lonHostID'};
1.19      raeburn    44: 
1.6       raeburn    45:     my @info = ('inststatus','lockedname','internalname','lastname',
1.14      raeburn    46:                 'firstname','middlename','generation','id','permanentemail');
1.6       raeburn    47:     # Initialize language handler
                     48:     &Apache::lonlocal::get_language_handle();
1.1       raeburn    49:     # find out which users we need to examine
                     50:     my @domains = sort(&Apache::lonnet::current_machine_domains());
                     51:     foreach my $dom (@domains) {
1.27      raeburn    52:         my %domconfig = &Apache::lonnet::get_dom('configuration',['autoupdate','usercreation'],
1.1       raeburn    53:                                                  $dom);
                     54:         #only run if configured to
                     55:         my $run_update = 0;
                     56:         my $settings;
1.24      raeburn    57:         my $allowed_inactivity;
                     58:         my $check_unexpired;
1.1       raeburn    59:         if (ref($domconfig{'autoupdate'}) eq 'HASH') {
                     60:             $settings = $domconfig{'autoupdate'};
1.2       raeburn    61:             if ($settings->{'run'} eq '1') {
1.1       raeburn    62:                 $run_update = 1;
                     63:             }
1.24      raeburn    64:             if ($settings->{'lastactive'} =~/^\d+$/) {
                     65:                 $allowed_inactivity = 86400 * $settings->{'lastactive'};
                     66:             }
                     67:             if ($settings->{'unexpired'}) {
                     68:                 $check_unexpired = 1;
                     69:             }
1.1       raeburn    70:         }
                     71:         next if (!$run_update);
1.7       albertel   72:         open(my $fh,">>$logfile");
1.17      raeburn    73:         print $fh ("********************\n".&Apache::lonlocal::locallocaltime(time).' '.&mt('Autoupdate messages start for domain: [_1]',$dom).' --'."\n");
1.9       raeburn    74:         # get courseIDs for domain
1.10      raeburn    75:         my %courses=&Apache::lonnet::courseiddump($dom,'.',1,'.','.','.',1,[$hostid],'.');
1.2       raeburn    76:         # get user information
1.27      raeburn    77:         my (%users,%instusers,%instids,%counts,@idrules);
1.20      raeburn    78:         my $dir = $Apache::lonnet::perlvar{lonUsersDir}.'/'.$dom;
1.24      raeburn    79:         &descend_tree($dom,$dir,0,\%users,\%courses,$allowed_inactivity,$check_unexpired);
1.25      raeburn    80:         my $resp = &localenroll::allusers_info($dom,\%instusers,\%instids,\%users,\%counts);
1.22      raeburn    81:         if ($resp ne 'ok') {
                     82:             print $fh &mt('Problem retrieving institutional data for users in domain: [_1].',$dom)."\n".
                     83:                       &mt('Error: [_1].',$resp)."\n".
                     84:                       "-- \n".&Apache::lonlocal::locallocaltime(time).' '.
                     85:                       &mt('Autoupdate messages end')."\n*******************\n\n";
1.25      raeburn    86:             close($fh);
1.22      raeburn    87:             next;
1.25      raeburn    88:         } else {
                     89:             if (keys(%counts)) {
                     90:                 foreach my $key (sort(keys(%counts))) {
                     91:                     if ($counts{$key} ne '') {
                     92:                         print $fh "Count for $key = $counts{$key}\n";
                     93:                     }
                     94:                 }
                     95:             }
1.22      raeburn    96:         }
1.20      raeburn    97:         my (%unamechg,%possnames);
1.1       raeburn    98:         my @types = ('active','future');
                     99:         my @roles = ('st');
                    100:         my @cdoms = ($dom);
1.27      raeburn   101:         if (ref($domconfig{'usercreation'}) eq 'HASH') {
                    102:             if (ref($domconfig{'usercreation'}{'id_rule'}) eq 'ARRAY') {
                    103:                 @idrules = @{$domconfig{'usercreation'}{'id_rule'}};
                    104:             }
                    105:         }
1.18      raeburn   106:         foreach my $uname (sort(keys(%users))) {
1.1       raeburn   107:             my %userhash = &Apache::lonnet::userenvironment($dom,$uname,@info);
1.2       raeburn   108:             my (@inststatuses);
                    109:             if (!$userhash{'internalname'}) {
                    110:                 if (defined($instusers{$uname})) {
1.26      raeburn   111:                     (my $insttypechg,@inststatuses) =
1.2       raeburn   112:                        &affiliations_check(\%userhash,$instusers{$uname});
                    113:                     if ($insttypechg) {
1.13      raeburn   114:                         my $inststatusstr = join(':',map { &escape($_) } (@inststatuses));
1.2       raeburn   115:                         my %statushash = ( inststatus => $inststatusstr );
                    116:                         my $statusres = &Apache::lonnet::put('environment',\%statushash,$dom,$uname);
                    117:                     }
                    118:                 }
                    119:             }
1.1       raeburn   120:             if (!$userhash{'lockedname'} && !$userhash{'internalname'}) {
1.2       raeburn   121:                 if (defined($instusers{$uname})) {
                    122:                     my (@fields,%changes,$changed);
                    123:                     if (@inststatuses > 0) {
                    124:                         foreach my $type (@inststatuses) {
                    125:                             if (ref($settings->{fields}{$type}) eq 'ARRAY') {
                    126:                                 foreach my $field (@{$settings->{fields}{$type}}) {
                    127:                                     if (!grep(/^\Q$field\E$/,@fields)) {
                    128:                                         push(@fields,$field);
                    129:                                     }
                    130:                                 }
1.26      raeburn   131:                             }
1.2       raeburn   132:                         }
                    133:                     } else {
                    134:                         if (ref($settings->{fields}{'default'}) eq 'ARRAY') {
                    135:                             @fields = @{$settings->{fields}{'default'}};
1.1       raeburn   136:                         }
                    137:                     }
1.26      raeburn   138:                     foreach my $field (@fields) {
1.2       raeburn   139:                         if ($userhash{$field} ne $instusers{$uname}{$field}) {
1.27      raeburn   140:                             # Do not change student/employee ID when field is modifiable
                    141:                             # but institutional data is absent or does not match rules
                    142:                             # defined for IDs for institutional users in domain
                    143:                             if ($field eq 'id') {
                    144:                                 if ($instusers{$uname}{$field} eq '') {
                    145:                                     $instusers{$uname}{$field} = $userhash{$field};
                    146:                                     next;
                    147:                                 } elsif (@idrules > 0) {
                    148:                                     my %idchecks;
1.28    ! raeburn   149:                                     if (&localenroll::id_check($dom,$instusers{$uname}{$field},
        !           150:                                                                \@idrules,\%idchecks) eq 'ok') {
1.27      raeburn   151:                                         my $matches;
                    152:                                         foreach my $result (values(%idchecks)) {
                    153:                                             if ($result) {
                    154:                                                 $matches = 1;
                    155:                                                 last;
                    156:                                             }
                    157:                                         }
                    158:                                         if ($matches) {
                    159:                                             $changed = 1;
                    160:                                         } else {
                    161:                                             $instusers{$uname}{$field} = $userhash{$field}; 
                    162:                                             next;
                    163:                                         }
                    164:                                     }
                    165:                                 }
                    166:                             } else {
                    167:                                 $changed = 1;
                    168:                             }
                    169:                             if ($field eq 'id') {
                    170:                                 $changes{'id'} = 1;
                    171:                             } elsif ($field eq 'lastname' || $field eq 'firstname' || $field eq 'middlename' || $field eq 'generation') {
                    172:                                 $changes{'fullname'} = 1;
                    173:                             }
                    174:                         }
                    175:                     }
                    176:                     # Do not change name information when lastname and firstname are modifiable
                    177:                     # but institutional data is absent for both components of a user's name.
                    178:                     if ($changed) {
                    179:                         if ($changes{'fullname'}) {
                    180:                             my %modifiable;
                    181:                             map { $modifiable{$_} = 1; } @fields;
                    182:                             if (($modifiable{'lastname'}) && ($modifiable{'firstname'}) &&
                    183:                                 ($instusers{$uname}{'lastname'} eq '') && ($instusers{$uname}{'firstname'} eq '')) {
                    184:                                 if ($changes{'fullname'}) {
                    185:                                     undef($changes{'fullname'});
                    186:                                 }
                    187:                                 if ($changes{'id'}) {
                    188:                                     foreach my $field ('lastname','firstname','middlename','generation') {
                    189:                                         $instusers{$uname}{$field} = $userhash{$field};
                    190:                                     }
                    191:                                 } else {
                    192:                                     undef($changed);
1.1       raeburn   193:                                 }
                    194:                             }
1.9       raeburn   195:                         }
1.1       raeburn   196:                     }
                    197:                     # Make the change
                    198:                     if ($changed) {
                    199:                         my %userupdate;
1.14      raeburn   200:                         foreach my $item ('lastname','firstname','middlename','generation','id',
                    201:                                           'permanentemail') {
                    202:                             $userupdate{$item} = $userhash{$item};
                    203:                         }
1.1       raeburn   204:                         foreach my $field (@fields) {
1.2       raeburn   205:                             $userupdate{$field} = $instusers{$uname}{$field};
1.1       raeburn   206:                         }
1.16      raeburn   207:                         my $modresult = &Apache::lonnet::modifyuser($dom,$uname,$userupdate{'id'},undef,undef,$userupdate{'firstname'},$userupdate{'middlename'},$userupdate{'lastname'},$userupdate{'generation'},1,$hostid,$userupdate{'permanentemail'},undef,\@fields);
1.2       raeburn   208:                         if ($modresult eq 'ok') {
1.9       raeburn   209:                             print $fh "User change: $uname:$dom; New values: 1.Name: $userupdate{'firstname'} $userupdate{'middlename'} $userupdate{'lastname'} $userupdate{'generation'}; 2. StuID: $userupdate{'id'}; 3. Email: $userupdate{'permanentemail'}.\n";
                    210:                             if ($settings->{'classlists'} == 1) {
1.1       raeburn   211:                                 if ($changes{'id'} || $changes{'fullname'}) {
1.26      raeburn   212:                                     my %roleshash =
1.1       raeburn   213:                                         &Apache::lonnet::get_my_roles($uname,
1.4       raeburn   214:                                                   $dom,'userroles',\@types,\@roles,\@cdoms);
1.10      raeburn   215:                                     foreach my $item (keys(%roleshash)) {
1.1       raeburn   216:                                         my ($cnum,$cdom,$role) = split(/:/,$item);
                    217:                                         my ($start,$end) = split(/:/,$roleshash{$item});
1.9       raeburn   218:                                         if (&Apache::lonnet::is_course($cdom,$cnum)) {
1.26      raeburn   219:                                             my $result =
1.11      raeburn   220:                                                 &Apache::lonuserutils::update_classlist($cdom,$cnum,$dom,$uname,\%userupdate);
1.9       raeburn   221:                                             if ($result eq 'ok') {
                    222:                                                 print $fh "Classlist change: $uname:$dom - class -> $cnum:$cdom\n";
                    223:                                             } else {
                    224:                                                 print $fh "Error - $result -during classlist update for $uname:$dom in $cnum:$cdom\n";
                    225:                                             }
1.1       raeburn   226:                                         }
                    227:                                     }
                    228:                                 }
                    229:                             }
1.9       raeburn   230:                         } else {
                    231:                             print $fh "User change detected for $uname:$dom. Error during update: $modresult\n";
1.1       raeburn   232:                         }
                    233:                     }
1.2       raeburn   234:                 } else {
                    235:                     # check if the username has changed
                    236:                     if (defined($instids{$userhash{'id'}})) {
                    237:                         if (ref($instids{$userhash{'id'}}) eq 'ARRAY') {
                    238:                             foreach my $name (@{$instids{$userhash{'id'}}}) {
                    239:                                 if (!exists($users{$name})) {
                    240:                                     push(@{$possnames{$uname}},$name);
                    241:                                 }
                    242:                             }
                    243:                         } else {
                    244:                             if (!exists($users{$instids{$userhash{'id'}}})) {
                    245:                                 $unamechg{$uname} = $instids{$userhash{'id'}};
1.7       albertel  246:                                 print $fh (&mt('Username change to [_1] detected for [_2] in domain [_3].',$unamechg{$uname},$uname,$dom)."\n");
1.2       raeburn   247:                             }
                    248:                         }
                    249:                     }
1.1       raeburn   250:                 }
                    251:             }
                    252:         }
1.4       raeburn   253:         if (keys(%possnames) > 0) {
                    254:             foreach my $uname (keys(%possnames)) {
                    255:                 my $altnames = join(' or ',@{$possnames{$uname}});
1.7       albertel  256:                 print $fh (&mt('Possible username change to [_1] detected for [_2] in domain [_3].',$altnames,$uname,$dom)."\n");
1.4       raeburn   257:             }
                    258:         }
1.9       raeburn   259:         print $fh ("-- \n".&Apache::lonlocal::locallocaltime(time).' '.&mt('Autoupdate messages end')."\n*******************\n\n");
1.6       raeburn   260:         close($fh);
1.1       raeburn   261:     }
                    262: 
                    263: sub descend_tree {
1.24      raeburn   264:     my ($dom,$dir,$depth,$alldomusers,$coursesref,$allowed_inactivity,$check_unexpired) = @_;
1.1       raeburn   265:     if (-d $dir) {
                    266:         opendir(DIR,$dir);
                    267:         my @contents = grep(!/^\./,readdir(DIR));
                    268:         closedir(DIR);
                    269:         $depth ++;
                    270:         foreach my $item (@contents) {
1.23      raeburn   271:             if (($depth < 4) && (length($item) == 1)) {
1.24      raeburn   272:                 &descend_tree($dom,$dir.'/'.$item,$depth,$alldomusers,$coursesref,
                    273:                               $allowed_inactivity,$check_unexpired);
1.19      raeburn   274:             } elsif (-e $dir.'/'.$item.'/passwd') {
1.20      raeburn   275:                 if (ref($coursesref) eq 'HASH') {
1.21      raeburn   276:                     next if (exists($coursesref->{$dom.'_'.$item}));
1.20      raeburn   277:                 }
1.24      raeburn   278:                 if ($allowed_inactivity) {
                    279:                     my $now = time;
                    280:                     my $aclog = $dir.'/'.$item.'/activity.log';
                    281:                     my $roledb = $dir.'/'.$item.'/roles.db';
                    282:                     if (-e $aclog) {
                    283:                         my $lastac=(stat($aclog))[9];
                    284:                         if (($now - $lastac) > $allowed_inactivity) {
                    285:                             if (-e $roledb) {
                    286:                                 my $lastrolechg=(stat($roledb))[9];
                    287:                                 next if (($now - $lastrolechg) > $allowed_inactivity);
                    288:                             } else {
                    289:                                 next;
                    290:                             }
                    291:                         }
                    292:                     } elsif (-e $roledb) {
                    293:                         my $lastrolechg=(stat($roledb))[9];
                    294:                         next if (($now - $lastrolechg) > $allowed_inactivity);
                    295:                     } else {
                    296:                         next;
                    297:                     }
                    298:                 }
                    299:                 if ($check_unexpired) {
                    300:                     my $roledb = $dir.'/'.$item.'/roles.db';
                    301:                     my $unexpired = 0;
                    302:                     my $now = time;
                    303:                     if (-e $roledb) {
                    304:                         my $roleshash = &LONCAPA::tie_user_hash($dom,$item,'roles',&GDBM_READER()) or next;
                    305:                         if (ref($roleshash)) {
                    306:                             while (my ($key,$value) = each(%$roleshash)) {
                    307:                                 next if ($key =~ /^rolesdef/);
                    308:                                 my ($role,$roleend,$rolestart) = split(/\_/,$value);
                    309:                                 next if ($role =~ /^gr\//);
                    310:                                 if (!$roleend || $roleend > $now) {
                    311:                                     $unexpired = 1;
                    312:                                     last;
                    313:                                 }
                    314:                             }
                    315:                             &LONCAPA::untie_user_hash($roleshash);
                    316:                             next unless ($unexpired);
                    317:                         } else {
                    318:                             next;
                    319:                         }
                    320:                     } else {
                    321:                         next;
                    322:                     }
                    323:                 }
1.9       raeburn   324:                 $$alldomusers{$item} = '';
1.1       raeburn   325:             }
                    326:         }
                    327:     }
                    328: }
                    329: 
1.2       raeburn   330: sub affiliations_check {
                    331:     my ($userhash,$insthashref) = @_;
                    332:     my (@inststatuses,$insttypechg);;
                    333:     if (ref($insthashref) eq 'HASH') {
1.8       raeburn   334:         if (ref($insthashref->{'inststatus'}) eq 'ARRAY') {
                    335:             @inststatuses = @{$insthashref->{'inststatus'}};
1.2       raeburn   336:         }
                    337:     }
1.12      raeburn   338:     my @currstatuses = map { &unescape($_); } (split(/:/,$userhash->{'inststatus'}));
1.2       raeburn   339:     foreach my $status (@inststatuses) {
                    340:         if (!grep/^\Q$status\E/,@currstatuses) {
                    341:             $insttypechg = 1;
                    342:         }
                    343:     }
                    344:     if (!$insttypechg) {
                    345:         foreach my $status (@currstatuses) {
                    346:             if (!grep/^\Q$status\E/,@inststatuses) {
                    347:                 $insttypechg = 1;
                    348:             }
                    349:         }
                    350:     }
                    351:     return ($insttypechg,@inststatuses);
                    352: }
                    353: 

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>