# Sign-in codes for Bitbucket Cloud, Buildkite, and SourceHut

[Read this guide on KeySigner](https://keysigner.io/integrations/guides/set-up-developer-account-sign-in-codes/)

Set up a KeySigner code for a test account, save the provider’s recovery codes, and check that you can sign in again from a fresh browser.

## Before you start

**KeySigner on iPhone or Mac with Sign-in codes**

- Use a test account with a confirmed email and working Git access. Keep the original browser session open and save Bitbucket’s recovery codes separately.
- Use a test account that signs in directly to Buildkite. Save the recovery codes before proceeding to the setup QR code.
- Use a test account and keep the original browser session open. Save the recovery codes when SourceHut activates the method.

## Data and access

- **Shared or checked**. Bitbucket Cloud, Buildkite or SourceHut receives the code for the test account. The provider returns the recovery material through its own setup.
- **Check separately**. Repository, pipeline and API access still follow their own permissions. Keep the recovery material outside the test authenticator.

## 1. Open your account’s setup QR code

Use a test account you control and keep the original browser session open. Confirm the email or username before opening the provider’s two-factor settings.

**Check.** You can see a QR code in the provider’s settings for the intended test account.

### Find your provider’s settings

- **[Bitbucket Cloud](https://support.atlassian.com/bitbucket-cloud/docs/enable-two-step-verification/)**. Confirm your email and meet Bitbucket’s Git access requirements first. In Bitbucket, open Personal Bitbucket settings, then Two-step verification under Security. Use the Bitbucket setup screen for this check. Atlassian account security has its own settings.
- **[Buildkite](https://buildkite.com/docs/platform/tutorials/2fa)**. In Personal Settings, open Two-Factor Authentication and start setup. Save the recovery codes before proceeding to the QR code. Use a test account that signs in directly to Buildkite.
- **[SourceHut](https://meta.sr.ht/security)**. Open your SourceHut account’s Security page and choose Enable TOTP to display the QR code. Have a separate place ready to save your recovery codes as soon as setup completes.

## 2. Scan the QR code in KeySigner

In Accounts, choose Add (+), then Sign-in codes and backup. Unlock Sign-in codes, choose Add account, and scan the QR code. Check the issuer and account before saving. Keep the QR code and setup key private.

![KeySigner for Mac, with options to scan a QR code, pick an image, or enter a setup link.](https://keysigner.io/integrations/guides/set-up-a-time-based-sign-in-code/keysigner-add-account.png)

The KeySigner setup screen on Mac. Use your test account’s QR code.

**Check.** The saved entry in KeySigner matches the provider and account shown in your original browser.

## 3. Confirm the code and save recovery codes

Choose Show code in KeySigner and complete the required approvals. Enter the current code in the provider’s setup form. Save the provider’s recovery codes somewhere you can reach independently of KeySigner. Buildkite displays them before you scan. Bitbucket and SourceHut display them after you confirm the code.

**Check.** The provider shows two-factor verification as enabled and you can find the recovery codes without opening KeySigner.

## 4. Try a fresh browser sign-in

Open a private browser window. Sign in to the same provider as the same test user and enter a new code when prompted. Keep the original session open until the provider accepts the new code.

**Check.** The provider accepts a new code for the same account. For Bitbucket, also confirm your existing Git access still works with a read-only operation against your test repository.

## Check your result

Record the account, the provider that accepted the code, and where you stored recovery codes. This check covers the test user’s browser sign-in. Review repository permissions, runner credentials, and API access separately.

### What we tested

**Tested on November 18, 2026.** In a local KeySigner vault test, an independent verifier accepted a current authenticator code and refused an expired code and the wrong account. The Bitbucket and Buildkite steps follow provider documentation. The SourceHut steps follow its published account settings code. Verify each hosted account with a fresh browser sign-in.

[How to verify your setup](https://keysigner.io/integrations/verify-a-setup/)

## If you get stuck

### The code is rejected or there’s no code prompt

Check the saved account and the device clock. If the timer is nearly out, wait for the next code. If the browser opens an existing session or sends you to an identity provider, check which account is handling sign-in. For Bitbucket, check whether the prompt is from Bitbucket or your Atlassian account.

## Tools in this guide

- [Bitbucket](https://keysigner.io/integrations/bitbucket/)
  - [Check requirements for signed commits](https://support.atlassian.com/bitbucket-cloud/docs/require-signed-commits)
  - [Setup requirements](https://keysigner.io/integrations/setup-requirements/#bitbucket)
- [Buildkite](https://keysigner.io/integrations/buildkite/)
  - [Configure an approval step in a pipeline](https://buildkite.com/docs/pipelines/configure/step-types/block-step)
  - [Setup requirements](https://keysigner.io/integrations/setup-requirements/#buildkite)
- [SourceHut](https://keysigner.io/integrations/sourcehut/)
  - [Review which operations need repository access](https://docs.sourcehut.org/git.sr.ht/#type-AccessMode)
  - [Setup requirements](https://keysigner.io/integrations/setup-requirements/#sourcehut)

## Setup instructions

- [Set up two-step verification for an Atlassian account](https://support.atlassian.com/atlassian-account/docs/manage-two-step-verification-for-your-atlassian-account/)
- [Read about SourceHut account recovery](https://sourcehut.org/blog/2020-03-04-when-you-lose-2fa/)
- [Read about SourceHut’s authenticator recovery codes](https://sourcehut.org/blog/2020-09-15-whats-cooking-september-2020/)
- [Check Bitbucket and SourceHut merge approvals](https://keysigner.io/integrations/guides/check-code-merge-approvals/)
- [Check a Buildkite release approval](https://keysigner.io/integrations/guides/test-a-release-approval-gate/)
- [Set up a time-based sign-in code in KeySigner](https://keysigner.io/integrations/guides/set-up-a-time-based-sign-in-code/)

[More guides for this task](https://keysigner.io/integrations/tasks/set-up-sign-in-codes/)
