This document explains how to configure Drupal as an Identity Provider (IdP) for the Bitbucket application using the miniOrange SAML IDP module. This will allow users to log in and access Bitbucket using Drupal credentials. The module is compatible with Drupal 7, Drupal 8, Drupal 9, and Drupal 10.

Obtain SAML IDP Metadata from Drupal:

• Once the module is installed, navigate to the Configuration tab from the top navigation bar and click on the miniOrange SAML IDP Configuration.

• Navigate to the IDP Metadata tab and download the metadata file. (This is required in order to configure the Bitbucket as a SAML SP)

Set up SAML SSO Application in Bitbucket:

• Log in to your Bitbucket site as an administrator.
• From the top navigation bar open your profile menu and select Atlassian Marketplace.

• Search for the mO Bitbucket SAML SSO and click the Free trial button to install the application.

• After successful installation, open the configurations of the application from the left navigation panel (Administration → ADD-ONS → miniOrange Single Sign-On)
• Navigate to the SAML tab and select the Configured IDPs option.
• Click on the Add New IDP button

• Select the Quick Setup option

• Select the Custom IDP.

• On the Service Provider Metadata section, select the By providing a metadata URL/File to the IDP option from the dropdown. Download the metadata (This will require further configuring Drupal as IdP) and click on the Proceed button.

• After proceeding, the section to Configure your Identity Provider appears. Select the option as follows:
  • Would you like to customize the name of your IDP? → Yes
  • Custom IDP Name → Drupal (This can be any relevant name)
  • You need to configure your IDP's metadata on Bitbucket. How would you like to add this metadata? → I have a file which contains the metadata
  • Then upload the metadata file of Drupal downloaded in the earlier steps. Scroll down to the button and click on the Save button.

• Click the Proceed button when the setting has been successfully saved.
• Keep the default settings for the User Profile and User Groups section and click the Save and Proceed button.
• In the Troubleshooting section click on the Finish Quick Setup button to complete the setup.

Configuring Drupal as SAML Identity Provider (IdP):

• Go to the Drupal site. Navigate to the Service Provider Setup tab of the miniOrange SAML IDP module.
• Click on the Upload SP Metadata.

• Upload the metadata file downloaded from the Bitbucket.

• Now click on the Test link to verify your configuration. If your configurations are correct then you will get the homepage of the Bitbucket site in the test configuration window.

You have successfully configured the SAML SSO between Bitbucket as SAML SP and Drupal as SAML IDP.