Kognita.Connect Bitbucket
Kognita connects to Bitbucket via OAuth. After authorizing, Kognita can list and access repositories across your Bitbucket account and workspaces.
The connection is at the organization level in Kognita. Once connected, all projects in your Kognita organization can add repos from that Bitbucket account.
Part 1 — Connect your Bitbucket account
Open Git connections
In the dashboard sidebar, click Git connections.
Click Connect next to Bitbucket
Click Connect in the Bitbucket row. Kognita will build an OAuth authorization URL and redirect you to Bitbucket.
Grant access on Bitbucket
Bitbucket will show an OAuth confirmation page listing the permissions Kognita is requesting — read access to your repositories and account information. Click Grant access.
Connection confirmed
Bitbucket redirects you back to Kognita. The Bitbucket row will show connected with your Bitbucket username.
Part 2 — Add Bitbucket repos to a project
Open a project
Select a project from the sidebar or create a new one with + New project.
Click + Add repo
From the project detail page, click + Add repo in the top-right corner.
Select Bitbucket as the provider
In the modal, click the Bitbucket provider button. Kognita will load the list of repositories accessible through your connected Bitbucket account, including repos from all workspaces you are a member of.
Select a repository
Use the search box to find your repo. Results show the full workspace/repo path. Private repos are labeled private. Click the repo you want to add.
Confirm the branch and add
The branch field auto-fills with the default branch. Update it if needed, then click Add. The repo is added to your project with not indexed status.
Index the repositories
Click Index all, confirm in the modal, and wait a few minutes. Kognita indexes every repository in the project together. Status updates to indexed when processing is complete.
Troubleshooting
Repositories from a workspace aren't showing
Make sure the Bitbucket account you authorized is a member of that workspace. Bitbucket workspace membership is required to list its repositories through OAuth.
I authorized with the wrong Bitbucket account
Go to Git connections and click Disconnect next to Bitbucket, then Connect again. You'll be redirected to Bitbucket where you can log in with the correct account.
The OAuth redirect failed or timed out
Try clicking Connect again from Git connections to start a fresh authorization flow. Make sure pop-up blockers aren't interfering with the redirect.
How do I revoke access?
In Bitbucket, go to your account Settings → Apps and features → Authorized applications and revoke Kognita. Also disconnect from Kognita's Git connections panel to remove the connection record.