|
1 | 1 | # Bitbucket Data Center / Server Integration Setup |
2 | 2 | ## Private Packagist Cloud |
3 | 3 |
|
| 4 | +<div class="row column"> |
| 5 | + <div class="callout success"> |
| 6 | + <p> |
| 7 | + This guide explains how to set up an OAuth integration for Private Packagist Cloud with Bitbucket Data Center / Server. |
| 8 | + If you use their public service on bitbucket.org, these instructions are not relevant to you. |
| 9 | + </p> |
| 10 | + <p>If you are using our Self-Hosted product, please <a href="/docs/self-hosted/bitbucket-server-integration-setup.md">use this guide</a>.</p> |
| 11 | + </div> |
| 12 | +</div> |
| 13 | + |
4 | 14 | <div class="row column"> |
5 | 15 | <div class="callout warning"> |
6 | 16 | <p>Note: Application Links using OAuth 2 are available since Bitbucket Data Center / Server v7.21. If you are using an older Bitbucket Data Center / Server version then consult the <a href="/docs/cloud/bitbucket-server-oauth1-integration-setup.md">Bitbucket Data Center / Server OAuth 1 setup guide</a>.</p> |
7 | 17 | </div> |
8 | 18 | </div> |
9 | 19 |
|
10 | | -## Initial Setup |
11 | | -From the organization settings page, select the "Integrations" subtab. |
12 | | -Hit the "Add Integration" button on the integrations listing page to get to the form below. |
13 | | -To set up a Bitbucket Data Center / Server integration with Private Packagist, start by selecting "Bitbucket Data Center / Server" |
14 | | -as the platform, enter the URL of your on-premise Bitbucket Data Center / Server into the base URL field and select OAuth 2 as the OAuth version as seen in the example below. |
| 20 | +To allow your users to authenticate to Private Packagist Self-Hosted with their Bitbucket Data Center / Server account, you'll |
| 21 | +first need to create an integration in Private Packagist. This document walks you through the required steps. |
15 | 22 |
|
16 | | - |
| 23 | +## Open the Add Integration form |
| 24 | +From the organization settings page, select the "Integrations" subtab. Hit the "Add Integration" button on the integrations listing page to get to the form below. |
| 25 | +To set up a Bitbucket Data Center / Server integration with Private Packagist start by selecting "Bitbucket Data Center / Server" as the platform, enter |
| 26 | +the URL of your on-premise Bitbucket server into the base URL field and select OAuth 2 as the OAuth version as seen in the example below. |
17 | 27 |
|
18 | | -Copy the content from the "Callback URL / Redirect URL" field and follow the link to set up an Application Link. |
| 28 | +A link to create a new OAuth application on your Bitbucket Data Center / Server instance will automatically be displayed. |
| 29 | + |
| 30 | + |
19 | 31 |
|
20 | 32 | ## Configure Application link |
21 | | -Click on the link to setup an Application Link on Bitbucket Data Center / Server and select "External application" as type and "Incoming" as direction. |
| 33 | +Do not submit the integration form yet, but copy the content from the "Callback |
| 34 | +URL / Redirect URL" and follow the setup link to your Bitbucket Data Center / Server instance. The fields |
| 35 | +Client ID and Client Secret remain empty for now. |
| 36 | + |
| 37 | +In Bitbucket Data Center / Server, click on the "Create link" button and select "External application" as type and "Incoming" as direction. |
22 | 38 |
|
23 | | - |
| 39 | + |
24 | 40 |
|
25 | 41 | After you click the button to continue, enter a name and the content from the "Callback URL / Redirect URL" from the Private Packagist form. |
26 | 42 | Select Repositories "Read" as application permission and save the form. |
27 | 43 |
|
28 | | - |
| 44 | + |
| 45 | + |
| 46 | +Once the form is saved, Bitbucket Data Center / Server will show you the Client ID and secret. |
29 | 47 |
|
30 | 48 | ## Finish the Setup |
| 49 | +Copy and paste the "Client ID" and "Client Secret" values back into the Private |
| 50 | +Packagist integration form and submit the form with the "Create Integration" |
| 51 | +button. |
31 | 52 |
|
32 | | -Once the form is saved, Bitbucket Data Center / Server will show you the Client ID and secret. |
33 | | -Copy them over to Private Packagist and save the integration. |
| 53 | + |
| 54 | + |
| 55 | +You'll be redirected back to the list of integrations. |
| 56 | + |
| 57 | +### Share the GitHub Enterprise login link |
| 58 | + |
| 59 | +The final step is sharing your organization-specific login link with your users. Look for the "Login link" button next to |
| 60 | +your newly created GitHub Enterprise integration on the integrations page, and copy the URL. |
| 61 | + |
| 62 | + |
| 63 | + |
| 64 | +This link presents the option to authenticate with your Bitbucket Data Center / Server account and can now be used to log in to Private Packagist. |
34 | 65 |
|
35 | 66 | ## Configure Bitbucket Server plugins |
36 | 67 |
|
|
0 commit comments