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: src/pages/how-to/add-users-to-your-network.mdx
+45-26Lines changed: 45 additions & 26 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,3 @@
1
-
2
1
# Add users to your network
3
2
4
3
Whether you have a network for personal use or manage your company's corporate network, you'd probably want to invite
@@ -7,12 +6,14 @@ people to your account and join your NetBird network.
7
6
There are three ways of adding users to a NetBird account - indirect, direct, and via IdP (Identity Provider) sync.
8
7
9
8
## Indirect user invites
9
+
10
10
This way of adding users is managed by the NetBird system and doesn't require administrator input.
11
11
It works only for organizations with private domains.
12
12
13
13
Whenever a new user signs up with a private domain (e.g., @netbird.io),
14
14
NetBird creates a new account and associates it with the netbird.io organization (domain) automatically.
15
-
Every consequent user signup with the same @netbird.io domain in their email address will end up under the same organization.
15
+
Every consequent user signup with the same @netbird.io domain in their email address will end up under the same
16
+
organization.
16
17
17
18
<Note>
18
19
This feature isn't available in the self-hosted setup. By default, all users are joining the same network instead.
@@ -31,9 +32,12 @@ Public domains are the ones of the public email providers like Gmail.
31
32
</Note>
32
33
33
34
## Direct user invites
35
+
34
36
As the name stands, this way of inviting users is straightforward and works through the web UI.
35
-
To invite a new user, proceed to `Team` then select the `Users` tab and click the <buttonname="button"className="button-6">Invite User</button> button.
36
-
A window will appear, allowing you to specify the name and email address of the user you want to invite. Optionally, you could select a set of groups with which you want this user to be associated.
37
+
To invite a new user, proceed to `Team` then select the `Users` tab and click
38
+
the <buttonname="button"className="button-6">Invite User</button> button.
39
+
A window will appear, allowing you to specify the name and email address of the user you want to invite. Optionally, you
40
+
could select a set of groups with which you want this user to be associated.
37
41
38
42
The invited users will receive an email invitation that they have to confirm.
39
43
After logging in to the system, they will join your network automatically.
@@ -45,6 +49,14 @@ After logging in to the system, they will join your network automatically.
45
49
<Note>
46
50
If a user already has a NetBird account, you can't invite them.
47
51
This is a limitation that is likely to be removed in future versions.
52
+
53
+
You can mitigate this issue with those approaches:
54
+
- invite an aliased email (most email providers support those),
- ask the user to log in and delete his/her organization (if it's the only user in the organization),
57
+
- ask the user organization's Admin/Owner to delete their user account,
58
+
- (optionally) transfer the Owner and/or Admin role to somebody else at user's ogranization first,
59
+
48
60
</Note>
49
61
50
62
## Identity Provider (IdP) Sync
@@ -60,30 +72,36 @@ button.
60
72
See the [Provision Users and Groups From Your Identity Provider](/how-to/idp-sync) section for more details.
61
73
62
74
## Manage user roles
63
-
NetBird has five user roles - `Owner`, `Admin`, `Network Admin`, `Auditor` and `User`. The roles allow you to control the level of access to the management API of your account.
64
75
65
-
-`Owner` role - has full access to the account and can manage all aspects of the account. There can be only one account owner in NetBird. Users with the owner role can delete their organization account. See the [Delete NetBird account](/how-to/delete-account) section for more.
66
-
-`Admin` role - has full access to the account except that administrators can't delete or update the role of the Owner user and delete the organization account.
67
-
-`Network Admin` role - has access to manage network configurations, including access policies, DNS settings, networks, and network routes, but they can only view user and device information and general settings.
68
-
-`Auditor` role - can read all configurations but not modify any of them.
69
-
-`User` role - has limited access to the account, allowing users to view peers they own and others they can connect to. Users can create personal access tokens for programmatic access.
0 commit comments