Skip to main content
Applies to:
  • Plan - Enterprise
  • Deployment - SaaS, BYOC
  • Use case - Let members identify their permission groups and find project-group owners without granting additional project permissions

Summary

Grant one permission group Read access to another so its members can inspect the Members tab. This lets them identify who to contact without receiving the permissions that the other group grants.

What is happening

Access to a permission group is separate from membership in that group. Granting Read access lets someone view its membership. It does not add them to the group or grant its project-creation or administrative permissions. For example, your organization might have custom permission groups named Project A Owners, Project A Engineers, and Project A Viewers. Assume Project A Owners can create projects in the relevant project group, while Project A Engineers cannot. You can let Engineers identify an Owner to contact without granting Engineers project-creation permissions.
These are custom groups with permissions configured by your organization. The built-in Engineers group already grants project creation across the organization. See Built-in permission groups.

Fix or suggestion

Grant access to the relevant permission groups

Members of the Owners permission group can configure this access by default. To let another member configure it, grant the Manage access permission on the relevant permission group in Settings > Permissions.
  1. Go to Settings > Permissions.
  2. Under Permission groups, hover over Project A Owners, then click the manage access icon ().
  3. Select the Permission groups tab.
  4. Search for Project A Engineers, then click the edit icon () next to it.
  5. Select Read, then click Save.
  6. Repeat for Project A Engineers and Project A Viewers if the team also needs to inspect membership of those groups.

View membership

As a member of Project A Engineers:
  1. Go to Settings > Permissions.
  2. Click Project A Owners, then select the Members tab.
  3. Find a member to contact about creating a project.
  4. Open the other groups you have Read access to and check their Members tabs to find your own membership.

How to confirm it worked

  • Confirm a member of Project A Engineers can open the relevant groups and inspect their Members tabs.
  • Confirm the member’s existing project-creation permissions are unchanged. For this example, a member who previously lacked project-creation permissions should still be unable to create a project.
Effective permissions combine direct grants and permissions inherited through groups. If the member can create projects, review all sources of their access. To grant project access, add the member to a permission group that provides Read access to the intended projects. Direct permissions can also provide project access. SSO authentication does not by itself synchronize permission-group membership. Domain mappings can assign a permission group when someone first joins an organization. To automate ongoing membership changes, see SCIM provisioning. When permission-group synchronization is enabled, members need membership in both the organization’s mapped IdP group and the IdP group mapped to the relevant Braintrust permission group. Change SCIM-managed membership in your identity provider.
SCIM provisioning requires an Enterprise plan and private-preview access. It is available to a limited set of customers, and behavior can change during the preview. Contact Braintrust to request access.

Notes

For more details, see Manage access to a permission group and Manage group membership.