Skip to main content

Managing user access to a project

Abstract

To collaborate on a project, users must be part of the project's team. You can add Workspace groups to an project from the Workspace settings' Team page or from the project settings page.

Each Bitrise project is owned by a Workspace - but this doesn't mean that all members belonging to that Workspace have access to a given project. In order to be able to collaborate on an project, users must be part of the project's team.

A project's team consists of all users invited to work on the project. There are three ways to add users to a project's team:

Similarly, there are two ways to revoke access to a project:

Adding an outside contributor to a project team

An outside contributor is a user who is a part of a project's team but isn't a member of the Workspace that owns the project.Workspace groups

Admins and owners only

You need to be an Admin on the project's team or one of the Owners of the Workspace that owns the project to be able to add new team members to a project.

  1. Open your project on Bitrise with a user that has the Admin role on the project.

  2. On the main page of the project, click on the Project settings button.

    project-settings-button.png

  3. From the menu on the left, select Collaboration.

  4. Make sure that you are on the People tab.

    team-people-tab.png

  5. Click Add Contributor.

  6. Type their email address and select their role.

    If they are not registered on Bitrise, we will send out an invitation email for them.

  7. Click Save.

Adding Workspace groups to a project team

To assign users from a Workspace to a certain project, the most convenient way is to assign their group to the project's team. Assigning a Workspace group a user role means that all users in the group will have the same role on the project's team.

Example 1. An project team consisting of Workspace groups

Let’s say the Workspace called TestSpace owns a project called TestProject. TestOrg has the following groups:

  • Group Alpha: they are assigned to TestProject with an Admin role. Members of this group can assign other groups to the project or add outside contributors, change project settings, manage roles and workflows.

  • Group Beta: they are assigned to TestProject with a Developer role. Members of this group can run builds, view build logs and view builds.

  • Group Gamma: they are assigned to TestProject with a Tester/QA role. They can only view builds.


There are two ways to assign Workspace groups to a Bitrise project's team:

  • You can assign it from the Collaboration menu of the Workspace settings page.

  • You can assign it on the Project settings page of the project.

Assigning a group from the Workspace's profile settings page

  1. Log in to Bitrise, and select Bitrise CI from the left navigation menu.

  2. In the upper right corner, click the profile image to open the dropdown menu.

  3. Select the Account settings option.

    account-settings.png

  4. On the left, select Collaboration from the menu options and make sure you are on the Groups tab.

    members_group.png

  5. Choose the group you wish to assign, and click the dropdown menu indicated by the 3_dots.png symbol.

  6. Select Assign access to projects.

  7. You can find the project(s) you need and select the appropriate role for the group, or you can select a role for the group for all current projects using the radio buttons.

    Assign_access.png

    Role cheatsheets

    You can check out the role cheatsheet on the User roles on project teams, or find it on any project’s Team tab.

  8. Click Save changes to finalize changes.

Assigning a group from the Project settings page

  1. Go to the project’s page on bitrise.io.

  2. Click Project Settings.

  3. On the left, select Collaboration from the menu options.

  4. Make sure that you are on the Groups tab.

  5. Click on Grant access for group.

    new_team_grant.png

  6. Find the group you wish to add and select the role for the group using the dropdown menus.

  7. Click Save.

Revoking access to a project from a group

  1. Open your project on Bitrise with a user that has the Admin role on the project.

  2. On the main page of the project, click on the Project settings button.

    project-settings-button.png

  3. From the menu on the left, select Collaboration.

  4. Go to the Group tab.

  5. Search for the group you would like to remove and click "remove_png.png".

    remove-group.png

  6. Click Remove in the dialog to revoke the group's access from the project.

Revoking access to a project from a single user

  1. Open your project on Bitrise with a user that has the Admin role on the project.

  2. On the main page of the project, click on the Project settings button.

    project-settings-button.png

  3. From the menu on the left, select Collaboration.

  4. Go to the People tab.

  5. Find the user you would like to remove and click "remove_png.png".

    Remove_group.png

  6. Click Remove in the dialog.

In this section:

A project on Bitrise represents a Git repository that stores source code and has been connected to Bitrise to be able to run builds on it. As such, a Bitrise project isn't necessarily an actual mobile application: it's just the code on which you run builds with Bitrise.

A Workspace is an environment that allows you to manage your Bitrise apps and the team members working on the apps. You can create multiple Workspaces, and you can be invited to Workspaces by other Bitrise users. To be able to add apps and run builds, you either need to be part of a Workspace, or you have to be an outside contributor on an app's team.