Skip to main content

The service credential user

Abstract

The service credential is a user whose connected Git provider account (GitHub, GitLab or Bitbucket) is used to access those services for the purposes of Bitrise builds.

The service credential is a user whose connected Git provider account (GitHub, GitLab or Bitbucket) is used to access those services for the purposes of Bitrise builds.

You need to set a service credential user to:

By default, the user who added the app to Bitrise is set as the service credential user. Even if you change it, it should always be a user who has access to the app's repository.

It isn't mandatory to have a service credential user: you can use the No service credential user setting to not have one. You'll still be able to run builds and trigger builds automatically but Bitrise won't be able to send build status reports to your Git provider, you won't be able to use the Selective builds feature or to store the bitrise.yml file in your repository.

Changing the service credential user

The service credential user can be changed at any time but no Bitrise user can set someone else as the service credential user.

Role requirement

To change the service credential user, you need to have Admin role on the app's team.

If you want the app to use another user's credentials, that user must log in to Bitrise and do the following:

  1. Go to your Workspace's Dashboard.

  2. Select the app where you want to change the service credential user

  3. Click on App Settings.

  4. On the left, select Integrations from the menu options.

  5. Scroll down to the Service credential user part.

  6. Click Change to YOUR_USERNAME.

    servicecredentialuser.png

  7. To confirm, click Set service credential user.

In this section:

An app 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 app isn't necessarily an actual application: it's just the code on which you run builds with Bitrise.

The bitrise.yml file stores your entire build configuration for an app. It specifies your stack and the build triggers, and defines the Workflows of the app. When you make changes on the graphical UI of our Workflow Editor, you actually modify the bitrise.yml file.

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.