Users and Roles in LDAP

Owned by Nicolás Palombo (Unlicensed)
Last updated: 27 Oct, 2008Version comment
3 min read
Unknown macro: {scrollbar}

(warning) Note
This HowTo shows more details on settings over LDAP

In this case, the definitions of users and roles are performed with the commonly used LDAP tools. The characteristics users and roles created in the LDAP server must have so they can be used by O3 Server are detailed below.

User Requirements

In order to ensure the proper operation of O3 Server over an LDAP repository, it is necessary that all created users in it meet the following conditions.

  • Users must be created in the context or directory identified by the Search Base Path parameter.
  • All users will be assigned the objectclass attribute, withe the humanParticipant value besides other values this attribute might have.
  • All users will be assigned the uid attribute whose value will be the login to connect to O3 Server.
  • All users will be assigned the cn value whose value will be the real username.
    This means it does not need to match the value assigned to uid.
  • Each user will have an assigned set of roles.
    This is done through the specification of the assignedRoles attribute, whose value must be the list of roles.
    This list will contain the names of the roles involved, separated by ":" (colon). This list must also finish in ":" (colon)
  • For a user to have administrator rights in O3 Server, they will need to have been assigned the specified role by the Administrator Role parameter.

Role Requirements

In order to ensure the proper operation of O3 Server over an LDAP repository, all roles created in it must meet the following conditions:

  • Roles must be created in the context or directory identified by the Search Base Path parameter.(refer to the "LDAP Parameters" section for a detail on parameters)
  • All users will be assigned the objectclass attribute, withe the ftorganizationalrole value besides other values this attribute might have.
  • All users will be assigned the cn value whose value will be the role name.
  • All users will be assigned the description attribute, whose value will be the role name.

Example of an LDAP database to be used by O3

What follows is an example of the directory entry structure in an LDAP used by O3.

c=uy
   o=IdeaSoft
      cn=Directory Administrators
      ou=Groups
      ou=People
        uid=admin
        uid=user
        uid=o3user

Besides, it is known that existing entries within the ou=People context or directory have the following attributes:

uid=user
   cn=Usuario estándar de O3
   objectClass=humanparticipant
   assignedRoles=o3user

uid=admin
   cn=Usuario Administrador de O3
   objectClass=humanparticipant
   assignedRoles=o3admin

uid=o3admin
   cn=o3admin
   description=Rol de Administradores de O3
   objectClass=ftorganizationalrole

uid=o3user
   cn=o3user
   description=Rol de Usuarios de O3
   objectClass=humanparticipant

By establishing as Search Base Path the "ou=People, o=IdeaSoft, c=uy" context or directory, the O3 Server will interpret "uid=user" entries as a user with the "user" login and name "O3 Standard User"  with an associated role "o3user"

In the same way, it will understand the "uid=admin" entry as a user with "admin" login and name "O3 Administrator User" with an associated role "o3admin". As "o3admin" was declared in the Administrator Role parameter, this user will have administrator rights. 

Entries "uid=o3admin" and "uid=o3user" are interpreted as roles in the same way.

Unknown macro: {scrollbar}