Keydra Documentation
GitHubToggle Dark/Light/Auto modeToggle Dark/Light/Auto modeToggle Dark/Light/Auto modeBack to homepage

Initial Bitbucket Setup

To use Bitbucket for your config source, read on. If needed, you can create a free account here.

Setup a configuration repository

  1. Create a new private repository in Bitbucket. Let’s call it KeydraConfiguration.
Create a Bitbucket repository
  1. Clone your new repo locally. Click the Clone button at the top right of your new repo’s Source page, and paste into your terminal.

    Note: You may need to setup an SSH key for this, see here for help if needed.

    git clone git@bitbucket.org:<your BB username>/keydraconfiguration.git
    cd keydraconfiguration

Create app credentials

  1. Create App password for your Bitbucket user. Click your user avatar in the bottom left corner, then Personal settings > App passwords. Click the blue Create app password button.
Create a App password
  1. Call the App password keydra, and minimum permissions. Click Create.
Configure App password permissions
  1. You’ll be shown a password, which you’ll only see once! In another tab, login to the AWS Console and navigate to the Secrets Manager service.

  2. Click the orange Store a new secret button.

Store a secret
  1. Choose a secret type of Other type of secrets, and add a plaintext secret as follows (substituting your details).
    {
    "password": "<the password from step 3>",
    "username": "<your bb username>"
    }
  1. You can leave encryption settings as default, or update to your needs. Click Next.

  2. Call your secret keydra/bitbucket.

  3. Auto rotation is not required (Keydra will do this), so just click Next on the next screen, then Store on the one after.