Configure HP ALM credentials in Bumblebee — username/password and username/API key.

Overview

Bumblebee stores ALM credentials in the server-side alm-mappings.xml configuration. This keeps credentials off CI job configurations and out of source control.

Credentials can be specified at URL, domain, or project level.

Username / Password

Project Level

<?xml version="1.0" encoding="UTF-8"?>
<mappings>
  <url url="http://server_name:port/qcbin">
    <domain name="DEFAULT">
      <project name="my_project">
        <credentials username="qcuser" encrypted_password="fd4OMOXLJjkMR6e64RJh3Q==" />
      </project>
    </domain>
  </url>
</mappings>

Domain Level

<domain name="DEFAULT">
  <credentials username="qcuser" encrypted_password="fd4OMOXLJjkMR6e64RJh3Q==" />
  <project name="my_project" />
</domain>

URL Level

<url url="http://server_name:port/qcbin">
  <credentials username="qcuser" encrypted_password="fd4OMOXLJjkMR6e64RJh3Q==" />
  <domain name="DEFAULT">
    <project name="my_project" />
  </domain>
</url>

When credentials are configured server-side, alm_user and alm_encrypted_pass are not required in client-side configurations. Client-side values will override server-side values if specified.

Username / API Key

ALM supports API key authentication as a more secure alternative to passwords. Generate an API key in ALM and use it in Bumblebee's alm-mappings.xml.

Generating an API Key in ALM

ALM API key generation step 1

ALM API key generation step 2

Configuring API Key in alm-mappings.xml

<?xml version="1.0" encoding="UTF-8"?>
<mappings>
  <url url="http://server_name:port/qcbin">
    <domain name="DEFAULT">
      <project name="my_project">
        <credentials
          username="qcuser"
          client_id="your-api-key-client-id"
          secret="your-api-key-secret" />
      </project>
    </domain>
  </url>
</mappings>

API key credentials can also be set at domain or URL level using the same <credentials> element with client_id and secret attributes.

Getting the Encrypted Password

Use the Bumblebee web portal to encrypt a plain-text password. Navigate to the Password Encryption tool in the portal and enter your ALM password — the portal returns the encrypted value to paste into alm-mappings.xml.

ALM Credentials