harbor/docs/1.10/working_with_projects/add_users.md

56 lines
3.1 KiB
Markdown
Raw Normal View History

2019-11-01 14:15:48 +01:00
# Assign Users to a Project
2019-12-13 15:08:40 +01:00
You can add individual users to an existing project and assign a role to them. You can add an LDAP/AD or OIDC user to the project members if you use LDAP/AD or OIDC authentication, or a user that you have already created if you use database authentication. If you use LDAP/AD or OIDC authentication, you can add groups to projects and assign a role to the group.
2019-11-01 14:15:48 +01:00
2019-12-13 15:08:40 +01:00
For more information about users and roles in Harbor, see [User Permissions By Role](../administration/managing_users/user_permissions_by_role.md).
2019-11-01 14:15:48 +01:00
2019-12-13 15:08:40 +01:00
## Add Individual Members to Projects
2019-11-01 14:15:48 +01:00
2019-12-13 15:08:40 +01:00
1. Log in to the Harbor interface with an account that has at least project administrator privileges.
1. Go to **Projects** and select a project.
1. Select the **Members** tab and click **+User**.
2019-11-01 14:15:48 +01:00
2019-12-13 15:08:40 +01:00
![browse project](../img/project_members.png)
1. Enter the name of an existing database, LDAP/AD, or OIDC user and select a role for this user.
2019-11-01 14:15:48 +01:00
2019-12-13 15:08:40 +01:00
![browse project](../img/new_add_member.png)
1. Optionally select one or more members, click **Action**, and select a different role for the user or users, or select **Remove** to remove them from the project.
2019-11-01 14:15:48 +01:00
2019-12-13 15:08:40 +01:00
![browse project](../img/new_remove_update_member.png)
2019-11-01 14:15:48 +01:00
2019-12-13 15:08:40 +01:00
## Add LDAP/AD Groups to Projects
1. Log in to the Harbor interface with an account that has at least project administrator privileges.
1. Go to **Projects** and select a project.
1. Select the **Members** tab and click **+Group**.
![Add group](../img/add_group.png)
1. Select **Add an existing user group to project members** or **Add a group from LDAP to project member**.
![Screenshot of add group dialog](../img/ldap_group_addgroup_dialog.png)
- If you selected **Add an existing user group to project members**, enter the name of a group that you have already used in Harbor and assign a role to that group.
- If you selected **Add a group from LDAP to project member**, enter the LDAP Group DN and assign a role to that group.
Once an LDAP group has been assigned a role in a project, all LDAP/AD users in this group have the privileges of the role you assigned to the group. If a user has both user-level role and group-level role, these privileges are merged.
If a user in the LDAP group has admin privilege, the user has the same privileges as the Harbor system administrator.
## Add OIDC Groups to Projects
To be able to add OIDC groups to projects, your OIDC provider and Harbor instance must be configured correctly. For information about how to configure OIDC so that Harbor can use groups, see [OIDC Provider Authentication](#oidc_auth).
1. Log in to the Harbor interface with an account that has at least project administrator privileges.
1. Go to **Projects** and select a project.
1. Select the **Members** tab and click **+Group**.
![Add group](../img/add_group.png)
1. Enter the name of a group that already exists in your OIDC provider and assign a role to that group.
2019-11-01 14:15:48 +01:00
2019-12-13 15:08:40 +01:00
![Add group](../img/add_oidc_group.png)
**NOTE**: Unlike with LDAP groups, Harbor cannot check whether OIDC groups exist when you add them to a project. If you mistype the group name, or if the group does not exist in your OIDC provider, Harbor still creates the group.
2019-11-01 14:15:48 +01:00
## What to Do Next
TBD