Skip to main content

Configuring HTTPS authorization

Abstract

For private projects, you can authorize Bitrise to access your repository via an HTTPS URL, using a Personal Access Token. This is necessary for Bitrise to be able to clone your repository to the virtual machine when starting a new build.

For private projects, you can authorize Bitrise to access your repository via an HTTPS URL, using a Personal Access Token. This is necessary for Bitrise to be able to clone your repository to the virtual machine when starting a new build. You can set up authorization:

To configure authorization for a repository with HTTPS URL on the Project settings page:

  1. Create a Personal Access Token at your Git provider and save it.

    Fine-grained access

    The Personal Access Token needs to have read access to the repository. We recommend using fine-grained Personal Access Tokens that do not have any additional rights to the repository or your Git provider account.

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

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

    project-settings-button.png
  4. Make sure you have an HTTPS URL: on the left, select General, and in the Basic settings section, find the Repository URL.

  5. On the left, select Integrations.

  6. Select the Git provider tab.

  7. In the Personal Access Token card, click Add.

    https-credentials.png
  8. In the dialog, add the Personal Access Token.

    Bitbucket username

    If your repository is on Bitbucket, you'll also have to provide your Bitbucket username.

    change-https-credentials-popup.png
  9. Once done, click Save changes.