.TH LCMAPS_LOCALACCOUNT.MOD 8 "February 25, 2013" .SH NAME lcmaps_localaccount.mod \- LCMAPS plugin to switch user identity .SH SYNOPSIS .B lcmaps_localaccount.mod .RB [ -gridmapfile .IR gridmapfile ] .SH DESCRIPTION This plugin is an Acquisition Plugin and will provide the LCMAPS system with Local Account credential information. To do this it needs to look up the Distinguished Name (DN) from a user's certificate in the gridmapfile. If this DN is found in the gridmapfile the plugin knows the mapped local (system) account username. By knowing the username of the local account the plugin can gather additional information about this account. The plugin will resolve the UID, GID and all the secondary GIDs. When this has been done and there weren't any problems detected, the plugin will add this information to a datastructure in the Plugin Manager. The plugin will finish its run with a .BR LCMAPS_MOD_SUCCESS . This result will be reported to the Plugin Manager which started this plugin and it will forward this result to the Evaluation Manager, which will take appropriate actions for the next plugin to run. Normally this plugin would be followed by an Enforcement plugin that can apply these gathered credentials in a way that is appropriate to a system administration's needs. .SH OPTIONS .TP .BI -gridmapfile " gridmapfile" When this option is set it will override the default path of the gridmapfile. It is advised to use an absolute path to the gridmapfile to avoid usage of the wrong file(path). .SH RETURN VALUES .TP .B LCMAPS_MOD_SUCCESS Success. .TP .B LCMAPS_MOD_FAIL Failure. .SH NOTES Since version 1.6.0 the localaccount plugin supports grid-mapfile entries with multiple usernames, separated by a comma without whitespace. This can be used in combination with specifying a \fB requested username \fR (such as by gsissh), to pick any of these accounts. When no \fB requested username\fR is specified, the first is used. This requires LCMAPS version 1.6.0 or newer. .SH BUGS Please report any errors to the Nikhef Grid Middleware Security Team . .SH "SEE ALSO" .BR lcmaps.db (5), .BR lcmaps (3). .SH AUTHORS LCMAPS and the LCMAPS plug-ins were written by the Grid Middleware Security Team .