Retrieving secrets from DevOps Test Hub

After you have configured IBM® DevOps Test Integrations and APIs (Test Integrations and APIs) to access the IBM DevOps Test Hub (Test Hub), you can retrieve secrets from a secret collection from a project in a team space on Test Hub and use the secrets in Test Integrations and APIs tests.

You must have configured Test Integrations and APIs to access Test Hub. For instructions, see Accessing DevOps Test Hub.

  1. Open the Environment Editor in one of the following ways:
    • Click the Environment icon image of the icon in the main toolbar.
    • Click the arrow next to the Environment icon in the main toolbar and select the Edit Environments option.
      image of the menu option to edit an environment.
    • Select the Project > Edit Environments menu option.
  2. Select the environment in which you want to run the tests from the environments that are visible to you in the left panel.
    The name of the selected environment is displayed as the Current Environment.
  3. Click the Secrets tab.
  4. Click the Override secret collection name check box and enter the name of the secrets collection that is in the project in your team space on Test Hub in the text box.
    The Environment Editor window is displayed similar to the following example screen:
    image of the environments editor window.
    The name of the collection (in this example is test_env) is what you created in your project in your team space on Test Hub.
    Note:

    If you create a secrets collection in Test Hub and name it the same as the name of the test environment in Test Integrations and APIs, you need not use the override option.

  5. Click the Properties tab.
  6. Create a new environment variable or tag by clicking New, and enter the following details:
    1. In the Variable Name field, enter the name for the environment variable.
      As an example, the details of the secrets collection (with the name test_env) configured in Test Hub project is shown in the following image:
      Image of the secrets collection page from the server.

    2. In the Variable Value field, enter the identifier of the secret in the format: secret://<Identifier>. For example, secret://dbcred.
      The identifier is the name of the secret you created under the secret collection in the project in your team space on Test Hub.
    3. Enter a description in the Variable Description field to enable you to identify environment variable easily.
      The following image is shown as an example with the entered details:
      Image of the new environment variable window.

      The following image is shown as an example of the Environment Editor window with the set tag:
      Image of the Environment Editor window.

    4. Click OK to save the environment variable or tag.

You have configured Test Integrations and APIs to retrieve secrets from Test Hub and use the secrets in tests in the selected environment.