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 a project, users must be assigned to the project.

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

Abstract

An outside contributor is a user who is assigned to a project but isn't a member of the workspace that owns the project. To add outside contributors, your workspace must have them enabled.

An outside contributor is a user who is assigned to a project but isn't a member of the workspace that owns the project. To add outside contributors, your workspace must have them enabled.

Admins and owners only

You need to be a project admin or a workspace owner to be able to add outside contributors 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. Go to the Contributors tab.

    team-people-tab.png

  5. Click Add Contributor.

  6. Select Add outside contributor

  7. Type their email address and select their role.

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

  8. Click Next.

  9. Configure product access by enabling one or more toggles and then selecting a role in the dialog.

    • Admin access allows the contributor to manage all aspects of the project. Note that this gives full access to an outside contributor!

    • If a project has a CI configuration and a Release Management app, the contributor can have access to both products, with different roles.

  10. Click Confirm access.

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 cheatsheets here: Roles and permissions for Bitrise CI.

  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.

workspace