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/segment-app/iam/labels.md
+19-16Lines changed: 19 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,53 +3,56 @@ title: Using Label-Based Access Control
3
3
plan: iam
4
4
---
5
5
6
-
Labels allow workspace owners to assign permissions to users to grant them access to groups. Groups represent collections of [sources](/docs/connections/sources/), or collections of Spaces.
6
+
Labels let workspace owners assign permissions to users by organizing resources into groups. Groups can represent collections of [sources](/docs/connections/sources/) or Spaces.
7
7
8
-
To create or configure labels in your Segment workspace, go to **Settings > Admin**, then click the Label Management tab. Only workspace owners can manage labels for the entire workspace.
8
+
9
+
To create or configure labels in your Segment workspace, go to **Settings > Admin**, then click the Label Management tab. Only Workspace Owners can manage labels for the entire workspace.
9
10
10
11
> info ""
11
12
> All workspaces include labels for `Dev` (development) and `Prod` (production) environments. Business Tier customers can create an unlimited number of labels.
12
13
13
14
## Custom environments
14
15
15
-
By default, all workspaces include labels for Dev (development) and Prod (production) environments. Workspace owners can configure what these labels are applied to, and can create up to five custom environments.
16
+
By default, all workspaces include labels for `Dev` (development) and `Prod` (production) environments. Workspace Owners can configure what these labels are applied to, and can create up to 5 custom environments.
16
17
17
-
Labels must be in`key:value` format, both the key and value must begin with a letter, and they can only contain letters, numbers, hyphens or dashes.
18
+
Labels must use the`key:value` format. Both the key and value must begin with a letter, and they can only contain letters, numbers, hyphens, or dashes.
18
19
19
-
To apply labels to Sources and Spaces, click the **Assign Labels** tab from the Labels screen. In the screen that appears, select the Sources and Spaces to apply the label to.
20
+
To apply labels to sources and spaces, click the **Assign Labels** tab from the Manage Labels screen. In the screen that appears, select the sources and spaces to apply the label to.
20
21
21
22
Once a label is in use (either assigned to a resource or used to restrict permissions on a user), the label cannot be deleted. You must first manually remove the label from any resources and permissions before you can delete it.
22
23
23
24
> info ""
24
-
> While only Workspace Owners can bulk-edit labels, Source and Space admins can edit the labels on the sources and spaces they have access to. To do this, go to the **Settings** tab for each item.
25
+
> While only Workspace Owners can bulk-edit labels, source and space admins can edit the labels on the sources and spaces they have access to. To do this, go to the **Settings** tab for each item.
25
26
26
-
Workspace owners can also grant specific [Roles](/docs/segment-app/iam/roles/)access to specific labels. For example, you might give a Source Admin access to only Sources that have the `Prod` label.
27
+
Workspace Owners can also grant specific [role access](/docs/segment-app/iam/roles/) to specific labels. For example, you might give a Source Admin access to only sources that have the `Prod` label.
27
28
28
29
Permissions can then be assigned to users in Access Management by label, on the Source Admin, Source Read-Only, Engage Admin, Engage User and Engage Read-Only users.
29
30
30
31

31
32
32
-
## Custom Labels
33
+
## Custom labels
34
+
35
+
> info ""
36
+
> All Segment workspaces can create up to 5 custom labels. Additional label types (in addition to environment labels) are available to Segment Business Tier accounts.
33
37
34
-
> note ""
35
-
> **Note**: All Segment workspaces can create up to five custom labels. Additional label types (in addition to environment labels) are available to Segment Business Tier accounts.
38
+
To create additional custom labels, a Workspace Owner can create new key types in the Manage Labels screen. The Workspace Owner can customize any combination of labels to mirror how resources should be partitioned in their organization.
36
39
37
-
To create additional custom labels, a workspace owner can create new key types in the Labels screen. The workspace owner can customize any combination of labels to mirror how resources should be partitioned in their organization. For example, some organizations may prefer to restrict access on their Sources and Spaces by brand or product area while other organizations may find it more useful to restrict their resources by tech stack or engineering department.
40
+
For example, some organizations may prefer to restrict access on their sources and spaces by brand or product area, while other organizations may find it more useful to restrict their resources by tech stack or engineering department.
38
41
39
-
When you create a new key, it becomes available in the Sources page as a column type that can be used to organize sources.
42
+
When you create a new key, it becomes available in the S ources page as a column type that can be used to organize sources.
40
43
41
-
## Labels FAQ
44
+
## FAQ
42
45
43
46
##### Where can I create labels?
44
-
Workspace owners can create labels for sources and Spaces from the Segment workspace **Settings** -> **Admin**-> **Labels**.
47
+
You can create labels for sources and spaces from Segment workspace by going to **Settings -> Admin**and then clicking the **Label Management** tab.
45
48
46
49
##### What resources can I assign a label to?
47
50
48
-
Labels currently only apply to Sources and Spaces.
51
+
You can apply labels to sources and spaces.
49
52
50
53
##### Where can I assign labels?
51
54
52
-
Workspace owners can assign bulk assign labels to sources and Spaces using the "Assign Labels" tab in the **Labels** screen. Source admins and Space admins can edit the labels on their individual resources in the "Settings" tab.
55
+
You can assign labels to sources and spaces using the **Assign Labels** tab in the **Manage Labels** screen. Source Admins and Space Admins can edit the labels on their individual resources in the **Settings** tab.
0 commit comments