summaryrefslogtreecommitdiff
path: root/docs/user-management.markdown
blob: 98691dddda0e36d223eda9b85884c48d047c4cc1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
User management
===============

Group of users
--------------

Kanboard use a basic permission system, there is two kind of users:

- Administrators
- Standard users

Administrator have access to everything. By example, they can add or remove projects.

There is also permissions defined at the project level, users can be seen as:

- Project member
- Project manager

Project managers have more privileges than a simple user member.

Local and remote users
----------------------

- A local user is an account that use the database to store credentials. Local users use the login form for the authentication.
- A remote user is an account that use an external system to store credentials. By example, it can be LDAP, Github or Google accounts. Authentication of these users can be done through the login form or not.

Add a new user
--------------

To add a new user, you must be administrator.

1. From the dashboard, go to the menu **User Management**
2. On the top, you have a link **New local user** or **New remote user**
3. Fill the form and save

![New user](http://kanboard.net/screenshots/documentation/new-user.png)

When you create a **local user**, you have to specify at least those values:

- **username**: This is the unique identifier of your user (login)
- **password**: The password of your user must have at least 6 characters

For **remote users**, only the username is mandatory. You can also pre-link Github or Google accounts if you already know their unique id.

Edit users
----------

When you go to the **users** menu, you have the list of users, to modify a user click on the **edit link**.

- If you are a regular user, you can change only your own profile
- You have to be administrator to be able to edit any users

Remove users
------------

From the **users** menu, click on the link **remove**. This link is visible only if you are administrator.

If you remove a specific user, **tasks assigned to this person will be unassigned** after the operation.