diff --git a/server_admin/images/bitbucket-app-page.png b/server_admin/images/bitbucket-app-page.png new file mode 100644 index 0000000000..dc44519712 Binary files /dev/null and b/server_admin/images/bitbucket-app-page.png differ diff --git a/server_admin/images/bitbucket-developer-applications.png b/server_admin/images/bitbucket-developer-applications.png new file mode 100644 index 0000000000..f586e65177 Binary files /dev/null and b/server_admin/images/bitbucket-developer-applications.png differ diff --git a/server_admin/images/bitbucket-register-app.png b/server_admin/images/bitbucket-register-app.png new file mode 100644 index 0000000000..6b7a95eaf3 Binary files /dev/null and b/server_admin/images/bitbucket-register-app.png differ diff --git a/server_admin/keycloak-images/bitbucket-add-identity-provider.png b/server_admin/keycloak-images/bitbucket-add-identity-provider.png new file mode 100644 index 0000000000..3a6075f73c Binary files /dev/null and b/server_admin/keycloak-images/bitbucket-add-identity-provider.png differ diff --git a/server_admin/rhsso-images/bitbucket-add-identity-provider.png b/server_admin/rhsso-images/bitbucket-add-identity-provider.png new file mode 100644 index 0000000000..3b2e742eab Binary files /dev/null and b/server_admin/rhsso-images/bitbucket-add-identity-provider.png differ diff --git a/server_admin/topics.adoc b/server_admin/topics.adoc index dd44c61a58..e2eb3def93 100644 --- a/server_admin/topics.adoc +++ b/server_admin/topics.adoc @@ -73,6 +73,7 @@ include::topics/identity-broker/social/microsoft.adoc[] include::topics/identity-broker/social/paypal.adoc[] include::topics/identity-broker/social/stack-overflow.adoc[] include::topics/identity-broker/social/openshift.adoc[] +include::topics/identity-broker/social/bitbucket.adoc[] include::topics/identity-broker/social/gitlab.adoc[] include::topics/identity-broker/oidc.adoc[] include::topics/identity-broker/saml.adoc[] diff --git a/server_admin/topics/identity-broker/social/bitbucket.adoc b/server_admin/topics/identity-broker/social/bitbucket.adoc new file mode 100644 index 0000000000..53f91b097b --- /dev/null +++ b/server_admin/topics/identity-broker/social/bitbucket.adoc @@ -0,0 +1,35 @@ +==== Bitbucket +There are a number of steps you have to complete to be able to login to Bitbucket. + +First, open the `Identity Providers` left menu item and select `Bitbucket` from the `Add provider` drop down list. This will bring you to the `Add identity provider` page. + +.Add Identity Provider +image:{project_images}/bitbucket-add-identity-provider.png[] + +Before you can click `Save`, you must obtain a `Client ID` and `Client Secret` from Bitbucket. + +NOTE: You will the `Redirect URI` from this page in a later step, which you will provide to Bitbucket when you register {project_name} as a client there. + +.Add a New App +To enable login with Bitbucket you must first register an application project in +https://confluence.atlassian.com/bitbucket/oauth-on-bitbucket-cloud-238027431.html[OAuth on Bitbucket Cloud]. + +NOTE: Bitbucket often changes the look and feel of application registration, so what you see on the Bitbucket site may differ. If in doubt, see the Bitbucket documentation. + +image:images/bitbucket-developer-applications.png[] + +Click the `Add consumer` button. + +.Register App +image:images/bitbucket-register-app.png[] + +Copy the `Redirect URI` from the {project_name} `Add Identity Provider` page and enter it into the `Authorization callback URL` field on the Bitbucket `Register a new OAuth application` page. + +On the same page, mark the `Email` and `Read` boxes under `Account` to allow your application to read user email. + +.Bitbucket App Page +image:images/bitbucket-app-page.png[] + +When you are done registering, click `Save`. This will open the application management page in Bitbucket. Find the client ID and secret from this page so you can enter them into the {project_name} `Add identity provider` page. ++ ++To finish, return to {project_name} and enter them. Click `Save`.