a8f8151e28f68fae6686187a7e77c537ff559752
[freeside.git] / htdocs / docs / passwd.html
1 <head>
2   <title>fs_passwd</title>
3 </head>
4 <body>
5   <h1>fs_passwd</h1>
6 You may use fs_passwd/fs_passwd as a "passwd", "chfn" and "chsh" replacement on your shell machine(s) to cause password, gecos and shell changes to update your freeside machine.  This can pose a security risk if not configured correctly.  <b>Do not use this feature unless you understand what you are doing!</b>
7 <br><br>Currently it is assumed that the the crypt(3) function in the C library is the same on the Freeside machine as on the target machine.
8 <ul>
9   <li>Create a freeside account on the shell machine(s).
10   <li>Append the identity.pub from the freeside user on your freeside machine to the authorized_keys file of the newly created freeside user on the shell machine(s).
11   <li>Copy fs_passwd/fs_passwd to /usr/local/bin on the shell machine(s).  (chown freeside, chmod 4755).  You may link it to passwd, chfn and chsh as well.
12   <li>Copy fs_passwd/fs_passwdd to /usr/local/sbin on the shell machine(s).  (chown freeside, chmod 500)
13   <li>Create /usr/local/freeside on the shell machine(s). (chown freeside, chmod 700)
14   <li>Run an iteration of "fs_passwd/fs_passwd_server shell.machine" as the freeside user for each shell machine (this is a daemon process).
15 </ul>
16 </body>