Difference between revisions of "Sysadmin/Add shell account"

From Sugar Labs
Jump to navigation Jump to search
(remote-useradd should no longer be run as root)
 
(15 intermediate revisions by 2 users not shown)
Line 1: Line 1:
Users normally follow the [[Sysadmin/Shell account request]].
+
'''Users looking for a Sugar Labs account should go to [[Service/Account]].'''
The account requests arrive to a support queue on our RT system ([[Machine/treehouse/rt]]).
 
  
 
== Guidelines ==
 
== Guidelines ==
  
Ask users to follow diligently the [[Sysadmin/Shell_account_request]] procedure.
+
Ask users to follow diligently the [[Service/shell#Requesting_a_shell_account]] procedure.
  
Users should briefly motivate their request. "I'd like to distribute some
+
Users should briefly motivate their request. A sufficient justification could be:
Sugar-related files on people.sugarlabs.org" would suffice.
+
"I have these Sugar-related files that I'd like to distribute on people.sugarlabs.org".
  
 
'''Shell accounts shouldn't be granted to untrusted individuals without referrals.'''
 
'''Shell accounts shouldn't be granted to untrusted individuals without referrals.'''
Line 17: Line 16:
  
 
  system-useradd <username> <first_name> <last_name> <email>
 
  system-useradd <username> <first_name> <last_name> <email>
 +
 +
* Note that accents in the first_name or last_name would break the script.
 +
* '''NOTE: You have to become root with 'sudo -i'. Prefixing the command with sudo won't work because it doesn't switch $HOME to /root, which is necessary to make the ldap commands source <code>/root/.ldaprc</code>.'''
  
 
At some point the script will prompt you to paste the user's ssh key.
 
At some point the script will prompt you to paste the user's ssh key.
Line 24: Line 26:
 
The email is also copied to ~user/welcome, in case they loose the
 
The email is also copied to ~user/welcome, in case they loose the
 
original message.
 
original message.
 +
 +
== Adding accounts on other machines ==
 +
 +
Please '''do not create accounts directly with useradd!''' Instead, copy the existing credentials from sunjammer:
 +
 +
* Log into sunjammer, forwarding your ssh keys with the ssh-agent:
 +
 +
ssh -A sunjammer
 +
 +
* Run this shell script to create a user and copy the credentials from sunjammer:
 +
 +
remote-useradd <remotehost> <user> <groups...>
 +
 +
Needless to say, remote-useradd requires your ssh key to be already installed in the remote server.
 +
 +
Typically, you'll want to add users to groups <tt>sudo</tt>, <tt>adm</tt>, <tt>libvirtd</tt> and <tt>docker</tt>.
  
 
== See also ==
 
== See also ==
 
* [[Sysadmin/User_management]] -- all other operations on user accounts
 
* [[Sysadmin/User_management]] -- all other operations on user accounts
 
* [[Service/Account]] -- Account information for users
 
* [[Service/Account]] -- Account information for users
 +
* [[Service/shell]] -- ssh access to shell.sugarlabs.org
 +
* [[Machine/sunjammer]] -- shell account server

Latest revision as of 03:32, 24 June 2015

Users looking for a Sugar Labs account should go to Service/Account.

Guidelines

Ask users to follow diligently the Service/shell#Requesting_a_shell_account procedure.

Users should briefly motivate their request. A sufficient justification could be: "I have these Sugar-related files that I'd like to distribute on people.sugarlabs.org".

Shell accounts shouldn't be granted to untrusted individuals without referrals. Shell accounts that are known to be unused should be disabled with system-userdel.

Account creation on shell.sugarlabs.org

To create an account, become root on Machine/sunjammer and type:

system-useradd <username> <first_name> <last_name> <email>
  • Note that accents in the first_name or last_name would break the script.
  • NOTE: You have to become root with 'sudo -i'. Prefixing the command with sudo won't work because it doesn't switch $HOME to /root, which is necessary to make the ldap commands source /root/.ldaprc.

At some point the script will prompt you to paste the user's ssh key. You can skip this part and edit ~user/.ssh/authorized_keys manually.

The procedure automatically sends a welcome email to the user. The email is also copied to ~user/welcome, in case they loose the original message.

Adding accounts on other machines

Please do not create accounts directly with useradd! Instead, copy the existing credentials from sunjammer:

  • Log into sunjammer, forwarding your ssh keys with the ssh-agent:
ssh -A sunjammer
  • Run this shell script to create a user and copy the credentials from sunjammer:
remote-useradd <remotehost> <user> <groups...>

Needless to say, remote-useradd requires your ssh key to be already installed in the remote server.

Typically, you'll want to add users to groups sudo, adm, libvirtd and docker.

See also