mirror of
https://github.com/desktop/desktop
synced 2024-08-27 12:11:00 +00:00
Add guide for authentication to Bitbucket
This commit is contained in:
parent
b838cfeed1
commit
40b129c80b
33
docs/integrations/bitbucket.md
Normal file
33
docs/integrations/bitbucket.md
Normal file
|
@ -0,0 +1,33 @@
|
|||
# Authenticating to Bitbucket with GitHub Desktop
|
||||
|
||||
## Creating a Personal Access Token in Bitbucket
|
||||
|
||||
To authenticate against Bitbucket repositories you will need to create a personal access token.
|
||||
|
||||
1. Go to your Bitbucket account and select **Bitbucket settings** in the user profile dropdown.
|
||||
|
||||
2. Select **App passwords**
|
||||
|
||||
3. Under **App passwords** click **Create app password**
|
||||
|
||||
![](https://user-images.githubusercontent.com/721500/54833905-603d9f00-4c95-11e9-8cd7-62a294542022.png)
|
||||
|
||||
4. Under the **Details** section in **Add app password** enter a label for your password
|
||||
|
||||
5. Under **Permissions** select `read` and `write` in the **Repositories** section to ensure that GitHub Desktop has the correct read/write access to your GitLab repositories.
|
||||
|
||||
6. Click **Create** to create a new token, and then copy the token to your clipboard.
|
||||
|
||||
![](https://user-images.githubusercontent.com/721500/54833912-63d12600-4c95-11e9-805c-6208aaccad20.png)
|
||||
|
||||
## Cloning your Bitbucket repository in GitHub Desktop
|
||||
|
||||
1. Open GitHub Desktop and go to **File** > **Clone Repository** > **URL**. Enter the Git URL of your Bitbucket repository. Make sure you enter the correct URL, which should have the following structure:
|
||||
|
||||
`https://bitbucket.com/<username>/<repository>`
|
||||
|
||||
2. You will receive an `Authentication Failed` error. Enter your Bitbucket username and paste in the token you just copied to your clipboard as your password. Click **Save and Retry** to successfully clone the repository to your local machine in GitHub Desktop.
|
||||
|
||||
![](https://user-images.githubusercontent.com/721500/54832263-36cf4400-4c92-11e9-8937-6617a0a564b5.png)
|
||||
|
||||
- **Note:** Your Bitbucket credentials will be securely stored on your local machine so you will not need to repeat this process when cloning another repository from Bitbucket.
|
Loading…
Reference in a new issue