You signed in with another tab or window.Reload to refresh your session.You signed out in another tab or window.Reload to refresh your session.You switched accounts on another tab or window.Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: _docs/administration/add-users.md
+62-6Lines changed: 62 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,12 +1,14 @@
1
1
---
2
-
title:"Adding usersto Codefresh accounts"
2
+
title:"Managing usersand teams in Codefress"
3
3
description:""
4
4
group:administration
5
5
toc:true
6
6
---
7
7
8
-
Once you have created a Codefresh account, you can add any number of users to collaborate on repositories, workflows, and pipelines.
8
+
Once you have created a Codefresh account, you can add any number of users to collaborate on repositories, workflows, and pipelines, and teams of users.
9
9
10
+
11
+
##Users in Codefresh
10
12
Adding a user requires assigning a role to define access to account resources, and optionally, selecting an SSO provider:
11
13
12
14
***Role**: Defines the user's access level to the resources in the account.
@@ -17,7 +19,7 @@ on clusters, docker registries, git integrations, shared configurations etc.
17
19
***SSO**: By default, SSO is not enabled for users. If required, explicitly select the SSO provider. For an overview of SSO, see[Single Sign on]({{site.baseurl}}/docs/administration/single-sign-on/).
18
20
19
21
20
-
##Add a user toan account
22
+
###Add a user toa Codefresh account
21
23
1. In the Codefresh UI, on the toolbar, click the**Settings** icon and then select**Account Settings**.
22
24
1. From the sidebar, from Access & Collaboration, select[**Users & Teams**](https://g.codefresh.io/account-admin/collaborators/users){:target="\_blank"}.
23
25
1. Select**Users**, and then select**+[Add User]**.
@@ -29,16 +31,70 @@ on clusters, docker registries, git integrations, shared configurations etc.
29
31
30
32
31
33
32
-
33
-
34
-
##Manage users in an account
34
+
###Manage users in a Codefresh account
35
35
36
36
Once you add a user to an account, you can do the following to manage that user:
37
37
* For invitations pending accept, select**Resend**.
38
38
* To edit the user's email address, select**Edit**.
39
39
* To remove the user account, select**Delete**.
40
40
41
41
42
+
43
+
##Teams in Codefresh
44
+
45
+
###Create a team in Codefresh
46
+
47
+
Create a team in Codefresh and then assign users to the team. You can assign the same user to multiple teams, as in most companies, users have overlapping roles.
48
+
>By default there are two teams,*users* and*admins* with users[invited as collaborators]({{site.baseurl}}/docs/accounts/invite-your-team-member/).
49
+
50
+
Teams allow you to enforce access control through ABAC.
51
+
52
+
>Only Enterprise customers can add new teams. Other Codefresh plans can only use the predefined*Users* and*Admin* teams.[Contact us](https://codefresh.io/contact-us/) if you wish to upgrade to an Enterprise plan.
53
+
54
+
1. In the Codefresh UI, on the toolbar, click the**Settings** icon and then select**Account Settings**.
55
+
1. From the sidebar, from Access & Collaboration, select[**Users & Teams**](https://g.codefresh.io/account-admin/collaborators/users){:target="\_blank"}.
56
+
1. Select**Teams**, and then select**Create a Team**.
57
+
1. Enter the**Team Name**.
58
+
>The team name can include only lower-case alphanumeric characters and hyphens, without spaces.
59
+
60
+
See the screenshot below for some sample team names.
1. Hover over the team and click the**Settings** icon.
74
+
1. Click**Invite to team**, type the email address of the user to invite, and then click**Add**.
75
+
1. To change the name of the team, click**Edit** and type the new name.
76
+
77
+
##Define session timeouts and domain restrictions for user accounts
78
+
As an administrator, you can also define session timeouts to automatically log out users who have inactive for the specified duration, and restrict invitations to specific email domains.
79
+
80
+
>The maximum inactivity duration you can set is 30 days. Inactive users are warned 90 seconds before the last 15 minutes.
81
+
82
+
1. In the Codefresh UI, on the toolbar, click the**Settings** icon and then select**Account Settings**.
83
+
1. From the sidebar, from Access & Collaboration, select[**Users & Teams**](https://g.codefresh.io/account-admin/collaborators/users){:target="\_blank"}.
84
+
1. Select**Security**.
85
+
1. For**User Session**, add the timeout duration in minutes/hours/days.
1. To restrict invitations to specific email domains, in the**Email domains** field below User Invitations, type in the domains, one per line.
97
+
42
98
##Troubleshoot add users
43
99
44
100
*[User is prompted to enter an organization name](https://support.codefresh.io/hc/en-us/articles/360020177959-User-is-prompted-to-enter-an-organization-name)