urlscan.io logo urlscan.io
SecurityTrails logo

support.atlassian.com Open in urlscan Pro
143.204.98.66  Public Scan

Back to summary
Submitted URL: https://click.e.atlassian.com/?qs=0210e55cc6dedf3a87f9ffacc7b4661d825123bc6b994787c39d55174d08cf02d29837ddecfcd4b6b33ff0bd9a23...
Effective URL: https://support.atlassian.com/bitbucket-cloud/docs/app-passwords/?utm_source=alert-email&utm_medium=email&utm_campaign=bitbuck...
Submission: On February 07 via api from DE — Scanned from DE

Form analysis 1 forms found in the DOM

<form><span class="fieldset">
    <p><input type="checkbox" value="check" id="chkMain" checked="" class="legacy-group-status optanon-status-checkbox"><label for="chkMain">Active</label></p>
  </span></form>

Text Content

Cookie Notice

This site uses cookies to improve your browsing experience, perform analytics
and research, and conduct advertising. To change your preferences, click Cookie
Settings. Otherwise, clicking on the the website, closing the banner, or
clicking Accept all Cookies indicates you agree to our use of cookies on your
device. Atlassian Cookies and Tracking Notice


Close
Accept all Cookies
Cookie Settings


 * Your Privacy

 * Strictly Necessary Cookies

 * Performance and Analytics Cookies

 * Functional Cookies

 * Targeting Cookies

 * Atlassian Cookies and Tracking Notice

Privacy Preference Centre

Active

Always Active



Save Settings

Allow All



BITBUCKET SUPPORT

 * Products
 * Get started
 * Documentation
 * Resources

 * Contact
 * 
 * Log in
 * 

 * 
 * Log in
 * 

Cloud
Data Center and Server
 * Jira Software
 * Jira Service Management
 * Jira Work Management
 * Jira Align
 * Confluence
 * Trello
 * Bitbucket
 * Opsgenie
 * Statuspage
 * Halp
 * Advanced Roadmaps for Jira
 * Team Calendars
 * Questions for Confluence
 * Atlassian Cloud

 * Get started with Bitbucket Cloud
   
   New to Bitbucket Cloud? Check out our get started guides for new users.

 * Get started with Bitbucket Cloud
   
   New to Bitbucket Cloud? Check out our get started guides for new users.

 * Create and manage workspaces in Bitbucket Cloud
   
   A workspace contains projects and repositories. Learn how to create a
   workspace, control access, and more.

 * Set up and work on repositories in Bitbucket Cloud
   
   Whether you have no files or many, you'll want to create a repository. These
   topics will teach you everything about repositories.

 * Build, test, and deploy with Pipelines
   
   Pipelines is an integrated CI/CD service built into Bitbucket. Learn how to
   build, test, and deploy code using Pipelines.

 * Manage your plans and settings in Bitbucket Cloud
   
   Learn how to manage your plans and billing, update settings, and configure
   SSH and two-step verification.

 * Integrate Bitbucket Cloud with apps and other products
   
   Learn how to integrate Bitbucket Cloud with Jira, Marketplace apps, and use
   the Atlassian for VS Code extension.

 * Build third-party apps with Bitbucket Cloud REST API
   
   Learn everything you need to know about how to build third-party apps with
   Bitbucket Cloud REST API, as well as how to use OAuth.

 * Get advisories and other resources for Bitbucket Cloud
   
   Access security advisories, end of support announcements for features and
   functionality, as well as common FAQs.

 * Tutorials
   
   Become a member of our fictitious team when you try our tutorials on Git,
   Sourcetree, and pull requests.

 * Create and manage projects in Bitbucket Cloud
   
   Projects makes it easier for members of a workspace to collaborate by
   organizing your repositories into projects.

 * Documentation
   
   Usage and admin help

 * Community
   
   Answers, support and inspiration

 * System Status
   
   Cloud services health

 * Suggestions and bugs
   
   Feature suggestions and bug reports

 * Marketplace
   
   Product apps

 * Billing & licensing
   
   Frequently asked questions

Products
Get started
Documentation
Resources
 * Log in to account
 * Contact support
 * Evaluator resources
 * Training & Certification
 * Cloud Migration Center
 * GDPR guides
 * Enterprise services
 * Atlassian Partners
 * Developers
 * User groups
 * Automation for Jira
 * Atlassian.com

Bitbucket Cloud

Documentation

 * 
   Get started with Bitbucket Cloud
   * 
     Get started with version control
     * Types of version control
     * DVCS workflows for Bitbucket
     * Find the command line
     * Install and set up Git
     * Git commands
   * 
     Get started setting up a repository
     * Create a repository in Bitbucket Cloud
     * Import a repository
     * Clone a repository
   * 
     Get started working on a repository
     * Push code to Bitbucket
     * Pull code from Bitbucket
     * Create an issue in Bitbucket Cloud
     * Create or edit a wiki page
   * 
     Get started with branches and pull requests
     * Create and push a branch
     * Check out a branch in Bitbucket Cloud
     * Create a pull request for review
     * Review a pull request
     * Merge a pull request in Bitbucket Cloud
 * 
   Create and manage workspaces in Bitbucket Cloud
   * What is a workspace?
   * Create your workspace
   * Grant access to a workspace
   * Organize workspace members into groups
   * Control access to private content in a workspace
   * Change a workspace ID
   * Transfer repositories and groups to a workspace
 * 
   Set up and work on repositories in Bitbucket Cloud
   * Search in Bitbucket Cloud
   * 
     Set up your repositories
     * Create a repository
     * Add unversioned code to a repository
     * Import or convert code from an existing tool
     * Import a repository from GitHub or GitLab
   * 
     Work on a repository
     * README content
     * Markup comments
     * Split a repository in two
     * Snippets overview
     * Clone a Git repository
     * Push updates to a repository
   * 
     Branch or fork your repository
     * Branch a repository
     * Fork a repository
     * List branches in a repository
     * Check out a branch
     * Manage unmerged branches
   * 
     Learn how to use commits
     * Add, edit, and commit to source files
     * Configure your DVCS username for commits
     * Repository tags
   * 
     Use pull requests for code review
     * Try the new pull request experience in Bitbucket
     * Create a pull request
     * Review code in a pull request
     * Check build status in a pull request
     * Merge a pull request
     * Resolve merge conflicts
     * Decline a pull request
   * 
     Use Smart Mirroring for Bitbucket Cloud
     * Work with Bitbucket Smart Mirroring
     * Troubleshoot Bitbucket Smart Mirroring
   * 
     Manage large files with Git Large File Storage (LFS)
     * Use Git LFS with Bitbucket
     * Use Git LFS with existing Bitbucket repositories
     * Use BFG to migrate a repo to Git LFS
     * Current limitations for Git LFS with Bitbucket
     * Troubleshoot Git LFS in Bitbucket
     * Storage policy for Git LFS with Bitbucket
     * Workflow for Git feature branching
     * Limits for viewing content and diffs
   * 
     Configure repository settings
     * Set repository privacy and forking options
     * Grant repository access to users and groups
     * Add access keys
     * Map existing commits to username aliases
     * Link to a web service
     * Transfer repository ownership
     * Reduce repository size
     * Maintain a Git repository
     * Delete a repository
     * Pull request and merge settings
     * Git fast forwards and branch management
     * Use branch permissions
     * Suggest or require checks before a merge
     * Exclude files from pull request diffs
     * Change the remote URL to your repository
     * Manage webhooks
     * Event payloads
     * Troubleshoot webhooks
     * Create and trigger a webhook tutorial
   * 
     Use wikis to store documents
     * Create a wiki
     * Clone a wiki
     * Special support for Creole
     * Macro reference for Creole markup
     * Make a wiki private or public
     * Use syntax highlighting in a wiki
     * Add images to a wiki page
     * Add a table of contents to a wiki
   * 
     Understand Bitbucket issues
     * Use the issue tracker
     * Enable an issue tracker
     * Configure defaults for issue fields
     * Export or import issue data
     * Export or import issue data in Bitbucket
     * Issue import and export data format
     * Make the tracker private or public
     * Resolve issues automatically when users push code
     * Set email preferences for an issue tracker
     * Highlight syntax and mark up issues
   * Code Insights
 * 
   Build, test, and deploy with Pipelines
   * 
     Get started with Bitbucket Pipelines
     * Limitations of Bitbucket Pipelines
   * 
     Use Pipelines in different software languages
     * Javascript (Node.js) with Bitbucket Pipelines
     * Java with Bitbucket Pipelines
     * Laravel with Bitbucket Pipelines
     * PHP with Bitbucket Pipelines
     * Python with Bitbucket Pipelines
     * Ruby with Bitbucket Pipelines
   * 
     Access Pipelines deployment guides
     * Deploy to AWS with S3
     * Deploy to AWS with CodeDeploy
     * Deploy to AWS with Elastic Beanstalk
     * Deploy to AWS EKS (Kubernetes)
     * Deploy a Lambda function update to AWS
     * Deploy to Amazon ECS
     * Deploy to Firebase
     * Deploy to Google Cloud
     * Deploy to Heroku
     * Deploy to Kubernetes
     * Deploy to Microsoft Azure
     * Deploy to npm
     * Deploy with pull requests
     * Deploy using SCP
     * Deploy build artifacts to Bitbucket Downloads
     * Publish and link your build artifacts
     * Build and push a Docker image to a container registry
   * 
     Configure your pipeline
     * View your pipeline
     * Configure bitbucket-pipelines.yml
     * Use glob patterns on the Pipelines yaml file
     * YAML anchors
     * Use artifacts in steps
     * Use Docker images as build environments
     * Run Docker commands in Bitbucket Pipelines
     * Push back to your repository
     * Specify dependencies in your Pipelines build
     * Use AWS ECR images in Pipelines with OpenID Connect
   * 
     Deployments
     * Set up and monitor deployments
     * Bitbucket deployment guidelines
     * Concurrency control
     * Deploy on AWS using Bitbucket Pipelines OpenID Connect
   * 
     Steps
     * Set up or run parallel steps
   * Pipeline triggers
   * Variables and secrets
   * Caches
   * Databases and service containers
   * 
     Use pipes in Bitbucket Pipelines
     * What are pipes?
     * Write a pipe for Bitbucket Pipelines
     * Advanced techniques for writing pipes
   * 
     Integrations
     * Integrate Jira and Pipelines
     * Integrate Pipelines with resource servers using OIDC
     * Integrate Slack with Pipelines
     * Pipes
   * 
     Troubleshooting
     * Set a new value for the Pipelines build number
     * Troubleshoot AWS pipes
   * 
     Bitbucket Pipelines FAQs
     * Generate support logs
     * Debug pipelines locally with Docker
     * Bitbucket pipelines Alpha program
     * Pipelines help and feedback
     * Troubleshoot problems in Pipelines
     * Infrastructure changes in Bitbucket Pipelines
   * Bitbucket Pipelines integrations
   * 
     Runners
     * Adding a new runner in Bitbucket
     * Configure your runner in bitbucket-pipelines.yml
     * Set up runners for Linux
     * Pipelines runners frequently asked questions
     * Troubleshooting runners
   * 
     Testing
     * Cross-platform testing in Bitbucket Pipelines
     * Test reporting in Pipelines
 * 
   Manage your plans and settings in Bitbucket Cloud
   * Manage your plan and billing
   * Bitbucket Cloud Premium plan
   * 
     Manage Bitbucket and account settings
     * Access your personal settings
     * Update your username
     * Delete an account
     * Set email aliases
     * Manage email notifications for watched objects
     * Organize groups for your repositories
     * 
       App passwords
     * Control access to your private content
     * Upgrade to Atlassian account
     * Keyboard shortcuts
   * 
     Configure SSH and two-step verification
     * Set up an SSH key
     * Set up additional SSH keys
     * Troubleshoot SSH issues
     * Enable two-step verification
 * 
   Integrate Bitbucket Cloud with apps and other products
   * 
     Integrate Bitbucket and Jira
     * Connect Bitbucket Cloud to Jira Software Cloud
     * Connect Bitbucket Cloud to Jira Software Server
     * Use Jira Software Cloud projects in Bitbucket Cloud
     * Create Jira issues from Bitbucket
     * Transition Jira issues during a pull request merge
     * Configure automatic team invitations
     * Enable Smart Commits
     * Use Smart Commits
     * Synchronize an account
     * Troubleshoot connections with Jira Software
   * 
     Use Bitbucket Cloud with Marketplace apps
     * Bitbucket Cloud apps overview
     * Integrate Bitbucket Cloud with Slack
     * Integrate Trello boards in Bitbucket
     * Integrate another application through OAuth
     * Install Cloud IDE add-ons
     * Integrate your build system with Bitbucket Cloud
     * Hyperlink to source code in Bitbucket
     * Enable Bitbucket Cloud development mode
   * 
     Use the Atlassian for VS Code extension
     * Get started with VS Code
     * Jira issues in VS Code
     * Bitbucket pull requests in VS Code
     * Bitbucket Cloud pipelines in VS Code
     * Bitbucket Cloud issues in VS Code
   * 
     Security
     * Add and configure security with Snyk
 * 
   Build third-party apps with Bitbucket Cloud REST API
   * API request limits
   * 
     Use OAuth on Bitbucket Cloud
     * Troubleshoot OAuth requests
     * OAuth consumer examples
   * 
     Use Bitbucket REST API version 1
     * groups Endpoint
     * group-privileges Endpoint
     * invitations Endpoint
     * users Endpoint - 1.0
     * invitations Resource
 * 
   Get advisories and other resources for Bitbucket Cloud
   * 
     Access security advisories for Bitbucket Cloud
     * Security Advisory: Changes to how apps are installed by URL
     * Security Advisory - 2016-06-17 - Password Resets
   * 
     View end of support announcements for Bitbucket Cloud
     * End of support for AWS CodeDeploy app removal - 2019-12-03
   * 
     Read FAQs about Bitbucket Cloud
     * What is a slug?
     * Why does the wrong username show in my commit messages?
     * What kind of limits do you have on repository/file size?
     * What version of Git do you support?
     * How is DVCS different from other version control systems?
     * Publishing a Website on Bitbucket Cloud
     * Why is my repository in 'read-only' mode?
     * How can I remove a redirect URL from my deleted repository?
     * How secure is my code? Is the service reliable?
     * Do I need to run git gc (housekeeping) on my repository?
     * Does Bitbucket backup my repositories?
     * Which browsers does Bitbucket support?
     * Can I push multiple heads to the same branch?
     * What are the guidelines for academic licenses?
     * Can I use markup in commit messages?
     * Can I claim an account with no activity?
     * Can I restore a deleted repository or commits?
     * What are the IP addresses to configure a corporate firewall?
     * What libraries do Bitbucket Cloud use?
 * 
   Tutorials
   * 
     Tutorial: Learn Bitbucket with Git
     * Create a Git repository
     * Copy your Git repository and add files
     * Pull changes from your Git repository on Bitbucket Cloud
     * Use a Git branch to merge a file
   * 
     Tutorial: Learn Bitbucket with Sourcetree
     * Create a new repository
     * Copy your repository and add files
     * Pull changes from your repository on Bitbucket
     * Use Sourcetree branches to merge an update
   * 
     Tutorial: Learn about Bitbucket pull requests
     * Create a repository (and add a reviewer)
     * Clone and make a change on a new branch
     * Create a pull request to merge your change
 * 
   Create and manage projects in Bitbucket Cloud
   * 
     Configure project settings
     * Add an access key to a project
     * Add default reviewers to a project
     * Add repositories to a project
     * Configure a project's branching model
     * Find and share projects
     * Manage and edit existing projects
     * Set up a merge strategy for a project
     * Updating project details
   * Create a project

Atlassian Support
/
Bitbucket
/
Resources
/
Manage your plans and settings in Bitbucket Cloud
/
Manage Bitbucket and account settings
Cloud
Data Center and Server




APP PASSWORDS

App passwords are substitute passwords for a user account which you can use for
scripts and integrating tools to avoid putting your real password into
configuration files.

App passwords are designed to be used for a single purpose with limited
permissions, so they don't require two-step verification (2SV). This means app
passwords can be used by users with 2SV make API calls to their Bitbucket
account, and to integrate Bitbucket with other tools like Sourcetree and Bamboo.


ABOUT APP PASSWORDS

Some important points about app passwords:

 * You cannot view an app password or adjust permissions after you create the
   app password.

Why?

Because app passwords are encrypted on our database and cannot be viewed by
anyone. They are essentially designed to be disposable. If you need to change
the scopes or lost the password just create a new one.

 * You cannot use them to log in to your Bitbucket account at bitbucket.org.

 * You cannot use app passwords to manage workspace actions.

App passwords are tied to an individual account's credentials and should not be
shared. If you're sharing your app password you're essentially giving direct,
authenticated access to everything that password has been scoped to do with the
Bitbucket APIs.

 * You can use them for API call authentication, even if you don't have two-step
   verification enabled.

 * You can set permission scopes (specific access rights) for each app password.


CREATE AN APP PASSWORD

To create an app password:

 1. From your avatar in the bottom left, click Personal settings.

 2. Click App passwords under Access management.

 3. Click Create app password.

 4. Give the app password a name related to the application that will use the
    password.

 5. Select the specific access and permissions you want this application
    password to have.

 6. Copy the generated password and either record or paste it into the
    application you want to give access. The password is only displayed this one
    time.


ADD AN APP PASSWORD TO SOURCETREE OR ANOTHER APPLICATION

To add your app password to Sourcetree:

 1. Go to the tab where you'll add or edit your account details:
    
    1. (Windows) Go to Tools > Options. From the Options dialog, select the
       Authentication tab.
    
    2. (macOS) Go to Sourcetree > Preferences. From the dialog that options,
       select the Accounts tab.

 2. Click to Edit your account details or Add a new one.

 3. From Authentication or Auth Type, select Basic, and enter your Username if
    it's not already there.

 4. Enter the app password you just created as your Password. If you're on
    Windows, you'll need hit Refresh Password first.

 5. Click OK or Save to save your account details.

To add your app password to another application, see the application's
documentation for how to apply the app password.


REVOKE AN APP PASSWORD

To revoke an app password, select the password and click Revoke. Then confirm
that you want to revoke the password.


USING AN APP PASSWORD

An app password is a substitute password for the user account where you
configure it, so you simply use it when authenticating with Bitbucket:

 * username: your normal Bitbucket username

 * password: the app password.

This applies to direct API access (e.g. via curl with HTTP authentication) as
well as for tools that integrate with Bitbucket via the HTTP API. As mentioned
above, you cannot log in to the Bitbucket web interface with an app password.

Was this helpful?

Yes
No
It wasn't accurate

It wasn't clear

It wasn't relevant
Provide feedback about this article


ADDITIONAL HELP

Ask the Community
 * Manage Bitbucket and account settings
 * Show more
 * Manage email notifications for watched objects
 * Organize groups for your repositories

 * App passwords

 * Control access to your private content
 * Upgrade to Atlassian account
 * Show more

On this pageAbout app passwordsCreate an app passwordAdd an app password to
Sourcetree or another applicationRevoke an app passwordUsing an app password
CommunityQuestions, discussions, and articles
 * Privacy Policy
 * Terms of Use
 * Security
 * 2022 Atlassian