Bitbucket SSO Azure Ad

Published
Length
3 min read

Luis Felipe Dias

All posts

You set up bitbucket sso azure ad by linking your directory to your workspace. This link lets your team log in with one central identity and password. Most teams start by mapping broad directory groups to default repo roles. When those groups grant wide write rights, engineers gain too much control over production code. How bitbucket sso azure ad works in practice Single sign-on relies on a trust link between your identity provider and your code host. You register the code host as an enterpri

Azure RBAC + Bitbucket Pipelines Security: the complete guide

Architecture patterns, implementation strategies, and security best practices. Delivered to your inbox.

Free white paper. No spam. Unsubscribe anytime.

You set up bitbucket sso azure ad by linking your directory to your workspace. This link lets your team log in with one central identity and password. Most teams start by mapping broad directory groups to default repo roles. When those groups grant wide write rights, engineers gain too much control over production code.

How bitbucket sso azure ad works in practice

Single sign-on relies on a trust link between your identity provider and your code host. You register the code host as an enterprise app inside your directory. Then you exchange trust metadata and public certificates between the two platforms. This step lets the code host check login tokens signed by your directory.

When an engineer tries to log in, the code host sends them to Microsoft. The directory checks their password and runs any required multi-factor prompts. After a good check, the directory sends a signed token back to the browser. That token holds claims like the user email, name, and group memberships.

Teams also use provisioning protocols to sync users and groups on a set schedule. When HR removes a person from the directory, the sync drops their workspace seat. You can map directory groups straight to project roles or repo permissions. This design keeps you from managing local user lists by hand inside the workspace.

What directory login solves and what it leaves open

Central login stops password reuse and gives admins one place to cut off accounts. It makes sure every person passes multi-factor checks before they see your web dashboard. Group sync also helps auditors see who belongs to each engineering team right now.

Yet single sign-on only checks who a person is at the front door. Once an engineer logs in, they hold standing permissions across every assigned project. A single login does not inspect what commands or queries a user runs next. Also, Git operations from a laptop terminal often bypass browser login flows.

Engineers create personal tokens or SSH keys to pull and push code from terminals. Those local keys stay active even while browser sessions expire every day. Pipelines and build servers inside your workspace also hold wide secrets for database servers. Directory login cannot pause a risky database query or rewrite sensitive data in results.

Azure RBAC + Bitbucket Pipelines Security: architecture patterns and best practices

Continue reading? Get the full guide.

Free. No spam. Unsubscribe anytime.

Why standing repository roles create risk for production

Workspace groups often bundle read, write, and admin rights into a few broad buckets. Teams do this because managing fine rules for hundreds of repos takes too much time. Soon, every developer in a core group can change build scripts or read secrets.

When build scripts hold database credentials, repo write access equals direct database control. An engineer can edit a pipeline file to run any command against production systems. The directory log only shows a routine morning login to the code host. It does not record the exact commands or data queries run during that session.

To reduce risk, teams must look past the initial browser login check. You need controls that check individual requests and commands right when they run. Separating workspace login from runtime database and server actions keeps production safe.

Check database and API queries on the wire

Identity tools, roles, and network rules decide who opens a session. Setup alone cannot check what each query does or mask sensitive values in a response once a session starts. When workflows touch Postgres, MySQL, SQL Server, MongoDB, ClickHouse, Kubernetes APIs, SSH, or internal HTTP APIs, hoop.dev sits inline in the wire protocol beside those services as an open-source proxy, a sidecar for your Postgres or API. On every query an AI agent or engineer runs against production, hoop.dev decides to pass, mask, block, or hold it for human review.

Your login details and client tools stay as they are while hoop.dev guardrails refuse bad deletes or drops before they run, and hoop.dev data masking rewrites matched sensitive values in responses in memory. Furthermore, hoop.dev holds SOC 2 Type II, is MIT licensed, and writes every query and decision to an audit trail that generates evidence for HIPAA, GDPR, and PCI DSS. See the source on GitHub.

Frequently asked questions

Does Azure AD single sign-on cover Git command line pushes?

No, browser single sign-on only covers the web interface login flow. Command line Git pushes still use SSH keys or personal app tokens.

How do directory groups map to repository permissions?

You sync directory groups to your workspace using automated user provisioning. Then you assign those synced groups to specific project or repo roles.

What happens to active keys when we disable a user in Azure AD?

Disabling the user stops new web logins right away. Once the directory sync runs, the workspace deactivates the account and blocks its keys.

Save the open-source gateway.

hoop is MIT-licensed infrastructure for controlling how AI agents reach production data. Star hoophq/hoop so you can inspect it, deploy it, or share it when your team starts governing agent access.