Difference between revisions of "Luma"

From Nuclear Physics Group Documentation Pages
Jump to navigationJump to search
 
(3 intermediate revisions by the same user not shown)
Line 39: Line 39:
 
*"Common name" should be the person's actual name.  
 
*"Common name" should be the person's actual name.  
 
*"Valid until" should be set to some date after the current date otherwise the account won't work. A year from the current date should be fine.
 
*"Valid until" should be set to some date after the current date otherwise the account won't work. A year from the current date should be fine.
*"Primary Group" for npg users should be npg (gid 5012). To set the user's group memberships click "Manage group memberships". If you want to assign the user to a group does not already exist see the section below about [[Luma#Adding_Groups|Adding Groups]]
+
*"Primary Group" for npg users should be npg (gid 5012). To set the user's group memberships click "Manage group memberships". If you want to assign the user to a group does not already exist add a new group using the instructions [[Add_a_new_user_or_group#Adding_Groups|here]].
 
*Remember that the user's home folder should be set to /net/home/username (make sure you created the folder beforehand).
 
*Remember that the user's home folder should be set to /net/home/username (make sure you created the folder beforehand).
 
*Click "Change password..." to set a password for the user. Select '''crypt''' from the hash algorithm drop down so that the password isn't stored in plaintext.
 
*Click "Change password..." to set a password for the user. Select '''crypt''' from the hash algorithm drop down so that the password isn't stored in plaintext.
Line 47: Line 47:
  
 
'''Important''': Luma will not create the user's home or mail directories for you. After you add the user to [[LDAP]] you need to make sure to create them and assign the correct permissions to them before the user tries to log in. Home and mail folders are located on [[Gourd]] in /home and /mail. Use these commands (as root) to create the new folders and to assign the correct permissions:
 
'''Important''': Luma will not create the user's home or mail directories for you. After you add the user to [[LDAP]] you need to make sure to create them and assign the correct permissions to them before the user tries to log in. Home and mail folders are located on [[Gourd]] in /home and /mail. Use these commands (as root) to create the new folders and to assign the correct permissions:
<br/><br/>
+
 
 
  mkdir /home/newuser /mail/newuser
 
  mkdir /home/newuser /mail/newuser
 
  chown newuser:npg /home/newuser
 
  chown newuser:npg /home/newuser
 
  chown newuser:mail /mail/newuser
 
  chown newuser:mail /mail/newuser
 
== Adding Groups ==
 
 
Luma does not provide a convenient way to create new LDAP groups. An add group option exists but it won't allow you to set a gid number above 99. If you want your new user to have a private group for your user (or any group that doesn't already exist) you need to create it before creating the user account. As odd as it sounds the simplest way I've found to do that is by doing it [[LDAP#Changing_Items_the_.22hard.22_way:_ldapadd_.26_ldapmodify|"hard" way]] using the ldapadd command with an ldif file.
 
 
Here's a sample LDIF file that should get you a basic group:
 
 
dn: cn=newgroup,ou=Group,dc=physics,dc=unh,dc=edu
 
cn: newgroup
 
gidNumber: 6000
 
objectClass: posixGroup
 
 
Just change the name "newgroup" to your new group's name, and set the gidNumber to something reasonable like one above the highest currently used gid number. To quickly find out the highest gid currently in use login to [[Einstein]] and execute this command:
 
 
getent group | awk -F':' '{print $3}' | sort -n
 
 
Ignore the highest gid number (something like 4294967294). This is a system group used by NFS. Go with the one right before that.
 

Latest revision as of 23:34, 22 November 2010

Luma is a Python & QT based graphical utility for managing data stored in LDAP servers. With it you can manage the LDAP database on Einstein, including adding, editing and deleting user accounts and groups. Luma uses a modular design that consists of several plugins that each provides a different way of working with an LDAP database. The Browser and User Management plugins are the most useful, and this article will focus on their use with respect to the LDAP database on Einstein.

Configuring Luma to work with Einstein

Luma Settings

The following settings will enable you to access LDAP on Einstein with administrator privileges. I shouldn't have to tell you that you need to be EXTREMELY CAREFUL when accessing LDAP with these settings.

  • Start Luma and choose Settings -> Edit Server List.. (or press Ctrl+E). This should open the Server settings dialogue.
  • Click Add... and then enter a name for your connection into the prompt (I just use einstein.unh.edu). The new server should appear in the Server list after you click OK.
  • Click the server you just created to expand its options, and then select Network options.
  • Enter the following network settings (use the encrypted LDAP port for greater security):
    1. Hostname: einstein.unh.edu
    2. Port: 636
    3. Encryption: SSL (Secure Socket Layer)
  • Select Authentication. Uncheck Anonymous bind and enter these authentication settings:
    1. Mechanism: Simple
    2. Bind as: cn=root,dc=physics,dc=unh,dc=edu
    3. DO NOT enter a password here. Luma will store the password in plaintext in your home folder. Just leave it blank so that Luma will prompt you each time you access LDAP.
  • Select LDAP Options
    1. Uncheck "Use Base DNs provided by the server" and then click Edit BaseDN list
    2. In the Custom: box enter dc=physics,dc=unh,dc=edu and then click Add, and then click OK.

User Management with Luma

Luma allows you to manage user accounts in two ways. You can use the Browser plugin to navigate through the LDAP tree to the entry you want to change and edit it within the browser. The user management plugin allows you to add, edit and delete user accounts. The easiest way to add a new user account is via the User Management plugin. To access user accounts via this plugin follow these instructions:

  • Select User management from the main screen.
  • Select einstein.unh.edu from the server drop-down.Luma will prompt you for your password. If you used the above setup instructions you will need to use the administrator password for LDAP.
  • The box in the bottom left of the window should be populated with a list of existing user accounts. From here you can edit or delete existing accounts as well as add new ones.
  • Changes will NOT be saved until you click the save button at the top of the screen. Exiting Luma will abandon your unsaved changes.

Adding Users

Select Location
New User Screen

Follow these instructions to create a new LDAP user account with Luma:

Click the Add button in the User Management plugin to add a new user account. First you must select the location in the LDAP database to store the new account. The location for user accounts should be ou=People,dc=physics,dc=unh,dc=edu@einstein.unh.edu. You can either enter this directly or navigate to it by expanding the LDAP tree structure. After this click Next and you will be presented with the add new user screen.

  • "User ID" should be the username for the new account.
  • "Common name" should be the person's actual name.
  • "Valid until" should be set to some date after the current date otherwise the account won't work. A year from the current date should be fine.
  • "Primary Group" for npg users should be npg (gid 5012). To set the user's group memberships click "Manage group memberships". If you want to assign the user to a group does not already exist add a new group using the instructions here.
  • Remember that the user's home folder should be set to /net/home/username (make sure you created the folder beforehand).
  • Click "Change password..." to set a password for the user. Select crypt from the hash algorithm drop down so that the password isn't stored in plaintext.
  • Click Add.. underneath Mail to add an e-mail address. It's a good idea to add a non-npg e-mail address so we have a secondary way to contact users if Einstein is unavailable for some reason.

Once you've filled out the form just click Finish and the new user will be saved to the LDAP database. The account should now be accessible from all NPG machines.

Important: Luma will not create the user's home or mail directories for you. After you add the user to LDAP you need to make sure to create them and assign the correct permissions to them before the user tries to log in. Home and mail folders are located on Gourd in /home and /mail. Use these commands (as root) to create the new folders and to assign the correct permissions:

mkdir /home/newuser /mail/newuser
chown newuser:npg /home/newuser
chown newuser:mail /mail/newuser