rBuilder:Manage Permissions

From rPath Wiki

rBuilder Appliance (rBA) project owners can modify user-group-based permissions for anonymous users, watchers, and members of a project. A project owner can click Manage Repository Permissions to make these modifications and to add and manage additional groups.

User groups, simply called groups, are associated with each user on a project. There also exists a default anonymous group to cover all users not signed in to rBuilder and a group automatically created for each watcher and member on a project.

Permissions Entries

The permissions that can be managed are displayed in a table form. The entries in the table align with the following headers.

• Mirror: The group can or cannot mirror the repository contents associated with the designated label and trove.
• Label: The row on the permission table refers to this designated label. For more information about identifying labels, see the technical overview Repository-Based System Management Using Conary.
• Trove: The row on the permission table refers to this designated trove for the label indicated. For more information about identifying troves, see the technical overview Repository-Based System Management Using Conary.
• Write: The group can or cannot write (commit and cook) to the repository contents associated with the designated label and trove.
• Capped: This is a placeholder for a feature that is not currently active.
• Admin: The group is or is not allowed to access this group permissions page and modify permissions.
• X: Used to delete the row on the permission table.
• E: Used to edit the row on the permission table.

Modify a Permission Entry

Use the following steps to modify permissions for a group on a project.

1. Navigate to the rBuilder project.
2. Click Manage Repository Permissions from the Project Resources panel.
3. Review the current permissions for the group you wish to modify to verify where changes should be made.
4. Click E on the right of the row for the permissions you wish to change.
5. Select a value from the Label drop-down list. Choose ALL to apply the permissions to all labels.
6. Type a value for the Trove drop-down list. Type ALL to apply the permissions to all troves associated with the chosen label.
7. Toggle the checkbox for Write access to permit or revoke write access to this repository area.
8. Toggle the checkbox for Admin access to permit or revoke access to repository permissions management.
9. Click Add.
10. View the permission entry on the permissions page to verify the changes were made.

Add a Group

Use the following steps to add a new group on a project and set that group's initial members and permission.

1. Navigate to the rBuilder project.
2. Click Manage Repository Permissions from the Project Resources panel.
3. Click Add Group below the table of permissions.
4. Type the name of the group.
5. Select initial users. Hold down the Shift key while clicking to select multiple users.
6. Select whether the group can mirror. (Additional permissions can be modified after the group is created.)
7. Click Add Group.
8. View the permissions page to verify the new entry was created correctly.