Setting up Bitbucket Access

Iguana X needs to have the ability to create Git repos on a cloud Git host like bitbucket. This means we need to create an App password with the correct permissions. Iguana will use your Bitbucket Username and created App Password to authenticate with Bitbucket. This is required to be configured by each User added to the Iguana X instance.

In Iguana X, navigate to Settings → Bitbucket.

This is what you will most likely see initially:

  1. Configure your Git credentials by following this page: Author Info

  2. Now you will need an account with bitbucket. If you don’t have one create a free one by following these steps: Creating a Free Bitbucket Account

This video shows how to create an App Password in Bitbucket and set the required permissions:

BitbucketAppPassword.mp4

Here is a closer look at the permissions you need to grant your App Password for Iguana:

16eb5a55-d5f1-409a-858f-68eb87cb3b73.png

You can also access Bitbucket’s documentation on App Passwords by clicking the more information link:

Screen Shot 2024-01-12 at 2.12.21 PM.png

The Bitbucket GUI will only show you this once - if you forget it you will need to generate a fresh one.

2580f54e-0447-41da-876e-c5535c12c5fe.png

Click on the ellipsis in the second section - Bitbucket Username/App Password - to add your Bitbucket Username and App Password.

333e54aa-ea5e-4969-9972-ea50e588587d.png

IguanaX failed to register ssh key?

Visit this page: Updating Bitbucket ssh Host Key

This shows how the key has been registered with bitbucket.

GIT makes use of SSH (Secure SHell) program for communicating to cloud hosts like Bitbucket securely.

SSH is commonly authenticated using a public/private key encryption. This works by you as a client generating:

  • A key pair

    • A private key

    • And an associated public key

  • Registering the public key with counter parties like SSH that you want to communicate with.

Only the holder of the private key is able to prove to the holders of the public key that they are who they say they are.

So it’s important to keep your private key’s safe and confidential and not share them. The public key needs to be shared however.

Iguana X invokes the ssh-keygen tool to generate these keys. This is part of OpenSSH which is part of Windows 10 onwards. For some older windows server operating systems we instead look to find these tools as part of the GIT installation.

But what if your company needs to use another platform like github or gitlabs?