Skip to content

Commit 64a1910

Browse files
committed
more style fixes
1 parent d697a7c commit 64a1910

File tree

1 file changed

+19
-16
lines changed

1 file changed

+19
-16
lines changed

src/segment-app/iam/labels.md

Lines changed: 19 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -3,53 +3,56 @@ title: Using Label-Based Access Control
33
plan: iam
44
---
55

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.
77

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.
910

1011
> info ""
1112
> All workspaces include labels for `Dev` (development) and `Prod` (production) environments. Business Tier customers can create an unlimited number of labels.
1213
1314
## Custom environments
1415

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.
1617

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.
1819

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.
2021

2122
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.
2223

2324
> 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.
2526
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.
2728

2829
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.
2930

3031
![Screenshot of the Select Sources popup, with the Assign Source Admin to: All Sources in Workspace including future Sources option selected.](images/labels-access-mgmt.png)
3132

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.
3337
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.
3639

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.
3841

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.
4043

41-
## Labels FAQ
44+
## FAQ
4245

4346
##### 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.
4548

4649
##### What resources can I assign a label to?
4750

48-
Labels currently only apply to Sources and Spaces.
51+
You can apply labels to sources and spaces.
4952

5053
##### Where can I assign labels?
5154

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.
5356

5457
##### Where can labels be used?
5558

0 commit comments

Comments
 (0)