Skip to content

Bitbucket authentication

Zide connects to Bitbucket to provide issue tracking, pull requests, releases, actions, and other features.

You can authenticate Zide with a personal access token.

Authenticate with a personal access token

To authenticate with a personal access token, complete the following steps.

  1. Open Settings.
  2. In Settings, click Git Accounts.
  3. In Git Accounts, click Connect account.
  4. In the Connect a Git hosting account dialog, click Bitbucket Cloud.
  5. In the Connect to Bitbucket Cloud dialog, enter your account email in the Atlassian account email field.
  6. Enter your Atlassian API Token in the API Token field. To generate a personal access token, see the Create an API Token Bitbucket documentation.
  7. Click Connect. Zide is now connected to your Bitbucket account.

Zide validates the token format and checks it against the Bitbucket API.

Tokens

Tokens are stored securely in the native keychain of the following operating systems:

  • Windows: Data Protection API
  • macOS: Keychain
  • Linux: Secret Service (GNOME Keyring, KWallet, KeePassXC, or another libsecret provider)

Account metadata such as the username, avatar URL, and auth method is stored in Zide’s local SQLite database. Tokens remain in the operating system’s secure credential store.

Personal access tokens do not expire unless they are revoked manually on Bitbucket.