Bitbucket Authentication

If you are still using the classic UI, please refer to the classic UI article

MantisHub supports single sign-on (SSO) with Bitbucket. This allows you to access your MantisHub account using your Bitbucket login credentials.

As well as adding convenience this can also provide extra security. Bitbucket supports two-factor authentication (2FA), so you may wish to have your users access MantisHub with either of these for a higher level of data security.

Enabling Bitbucket SSO

To enable the ability to authenticate MantisHub login via Bitbucket, see our Configuring AuthHub article and follow the steps to install and configure AuthHub.

Make sure 'Bitbucket' is selected under Federation Provider in the AuthHub Settings.

You'll now see the option at the bottom of your login screen to connect into MantisHub with Bitbucket.

When you click on Bitbucket, it will require you to allow MantisHub to access your account. You'll need to allow access on the consent forms displayed. This should be a one time prompt.

The registered email in MantisHub for a user, must match a verified email address (primary or secondary) with Bitbucket.

The default setting allows users to log in using either their Bitbucket account OR with their MantisHub credentials. It is recommended to allow this for a test phase to make sure all works fine. Once the testing is completed, you can configure further AuthHub options such as:

• Force Lists - requires a subset or all users to use Bitbucket login by configuring the list of domains that are forced to use AuthHub authentication.
• Allow password login - allows a subset of users to login using their MantisHub credentials. This overrides the force list.
• Auto Provisioning - automatic creation of a MantisHub account on successful authentication to your provider.

For details on how to configure these options, read our Configuring AuthHub for SSO article.