Accessing test assets from a server project

HCL OneTest™ Server projects manage access to your test assets, which are stored in a Git repository. Projects are either public by default or private. Private projects are not discoverable by other users. You can either add your own project or you can request to be a member of another public project.

When you add your own project, you can configure it now or later. Configuring the project includes adding details about the project, adding one or more Git repositories, optionally adding secrets, and classifying encrypted datasets. To run test assets that are associated with an encrypted dataset, you must categorize the encrypted datasets by creating a classification.

Repository considerations for a server project

To collaborate with other project stakeholders, you can open test assets from a local clone of the Git repository, pull project test assets from a Git repository, and push changes made to your local test assets to a Git repository. Before you add a project and add a repository to that project, you must consider some information about repositories.

Consider the following sections about using Git repositories with HCL OneTest Server. For more information about installing, setting up, and using Git, see the Git documentation.


You must install Git or upgrade the version if you already have installed Git.

Repositories and user identities

After you install Git, you must set up your Git repository and set up access for members. You must ensure that the repository contains your test assets.

Optionally, you can use a command line utility or Git tool to access the repository, upload your test assets, fetch or pull from the repository, push to the repository, clone the repository, and other operations you want to perform in Git.

Local and shared repositories

After you create a remote or shared repository in Git, you can create a local version of the repository by cloning the remote repository. You must ensure that your test assets are available in the remote repository and are also cloned to the local repository.

Alternatively, if your test assets are on your local system, you can set up a Git repository in the bare mode, add the project files to the local repository, and then commit and push from the local repository to the remote repository in Git by using your preferred method.
Note: While copying the test assets from your local system to the repository, you must ensure that you copy the entire project that contains the test assets.

User authentication for the Git repository

The administrator can set up different types of authentication for accessing the Git repository. HCL OneTest Server supports the following authentication types:
  • HTTP with user name and password
  • HTTP without user name and password
  • HTTPS with user name and password
  • HTTPS without user name and password
  • SSH with SSH key and passphrase
  • SSH with SSH key and without a passphrase

Based on the authentication type that is set for a repository, you must provide the same authentication values in HCL OneTest Server when you add a repository.

Test assets

You must complete the following tasks in the desktop client where you are authoring your test before you check in and commit the test assets to the Git repository.
Test type Task More information

API suite in HCL OneTest API

Change the local stub to a remote stub. See Running tests.
Add the library files. See Running tests.

Adding details to a server project

The first step is to add a server project and provide some details about it.

Before you begin

To add one or more projects to manage access to your test assets, you must log in to HCL OneTest Server by providing the application URL in a browser.

If you are a new user, and LDAP and Active Directory are not configured, you must first sign up by completing a form that specifies user information such as an email, user name, and password, then you can log in by using that information.

About this task

You add a project and give it a name and description.


  1. Log in to HCL OneTest Server.
  2. From the Home page, add a project. Give it a name and if you want, add a description. The Details page is displayed.
  3. Decide if you want a public project, which is the default, or a private project.

Adding repositories to a server project

As a project owner, you can add repositories to a server project. When you add new repositories, you can access the test assets available in the respective repository.

To gain access to the repository, there are three types of authentication, which are HTTPS, HTTP and SSH. Based on the type of authentication, you must provide the credentials to access the repository.

Before you begin

  • You must have added a project on HCL OneTest Server.
  • You must have permission to access the repository.
  • In the case of SSH authentication, you must have an appropriate deploy key and passphrase, if applicable.
To add one or more repositories, you must log in to HCL OneTest Server by providing the application URL in a browser.

About this task

A project can contain one or more repositories. When you add a repository to your project, you clone the repository. Based on the authentication type, you can provide the necessary details such as a Git URL, deploy key and passphrase.

After you log in, from the Home page, you can add one or more repositories to your project by following these steps.


  1. Click the Repositories tab.
  2. Add a Git repository URL.
  3. Click the Expand icon Expand Git credentials icon to open a page and enter the required credentials. If the Git repository uses SSH authentication, you must provide the SSH key. If the Git repository uses HTTP basic authentication, you must provide a user name and password.
  4. Click Add.
    A copy of your existing Git repository is cloned.
    Note: Depending on the size of the repository you are cloning, it can take a few to several minutes to clone a copy of the repository.
    You can work with that repository by completing the following tasks:
    • Editing the settings
    • Selecting a folder to scope the access to a subset of the repository
    • Changing the credentials
    • Removing references to the repository
  5. Optional: Repeat the steps to add another repository.

Adding secrets to a server project

If you are working with an API suite and the project test asset contains environment variables that are required for the test runs, you must configure the environment variables as secrets in a secrets collection by using the Secrets tab. Configuring secrets enable the API suite to run correctly on HCL OneTest Server.

Adding data security to a server project

If you are working with test assets other than an API suite and the project test asset contains encrypted datasets, you must configure the project in HCL OneTest Server by using the Data Security tab.

Adding users to a server project

As a project owner, you can add users to your server project so they can access your test assets.

Before you begin

You own a project.

About this task

As a project owner, you can add other users to your public or private project. For example, a large number of test assets must be run and you want your test team to help run them and see the results.


  1. Add one or more users to be members of your project. Click the Settings icon Settings icon on the Project card in the list of My Projects or click Configure in the navigation when the project is already open.
  2. Add users by entering the user name of the user you want to add. You can add a partial name and then press Enter to see the user that you want to add.
  3. Select that user and then assign a role. Click Viewer, Tester, or Owner. When you add a user, the default role is Viewer.

    The added user after logging in can see the owner's project in their list of My Projects.

  4. Repeat the applicable steps to add another user.

What to do next

You can add or remove roles to one or more projects that you own. All users can request to be a member of another public project.