What is a Repository?
A repository is any system that houses the artifacts that can be used in an integration. Repositories can be systems used as part of the software delivery process, like Micro Focus (HPE ALM), CA Agile Central, Jira, etc., or repositories can be more generic databases, like MySQL or Oracle.
A repository connection is a connection to a specific instance of a given repository that permits Tasktop to communicate with that repository. To configure a repository connection, users will need to provide base credentials such as a server URL, a username, and a password.
A standard repository is a software lifecycle tool such as Jira or ALM that contains artifacts such as defects or requirements.
Check out the video below to learn how to create a new repository connection:
Before You Begin
Connecting to a Standard Repository
Creating a New Connection
To create a repository connection, select Repositories at the top of the screen.
Click + New Repository Connection.
Select the logo of the repository you would like to connect to in your integration.
Uploading External Files
For certain repositories, such as Microsoft Azure DevOps Server (TFS), external files must be uploaded before navigating to the New Repository Connection screen. If so, you will see a screen similar to the one below. If you do not see this screen, you can disregard this section.
To upload the files, a system administrator (a user with file system access to the machine that hosts Tasktop) must add the files to the designated directory:
- On Windows, the default folder is
- On Linux, the
connector-requirementscan be found in the Tasktop installation directory
- If needed, the user can change the location in which Tasktop looks for the files. This is done by changing the system property
Once uploaded, select the file from the options available and click Use File.
New Repository Connection Screen
After selecting the repository, the New Repository Connection screen will appear.
To connect to a repository, you must populate the following fields:
- Name: This is the name you will give to your Repository Connection. This is how it will be referenced throughout the Tasktop Application.
- URL: This is the URL used to access the repository.
- Authentication Details (see authentication section below for more details).
Note: You may see additional fields on the Repository Connection screen depending on which repository you are connecting to. See our Connector Documentation for repository-specific information. Any required fields will be marked with an asterisk.
This functionality should only be used under the guidance of Tasktop support.
On the Repository Connection screen, you'll see a Throttling Settings field. This field can be used to reduce the load placed on a repository when rate limiting or server overload is causing performance delays. It does this by limiting the number of API calls Tasktop processes per minute for the repository. This field will default to blank/not set unless a value is specified.
Note: Caution should be used when setting this value. The ideal value for Throttling Settings is highly dependent on each customer's unique environment. Determining the appropriate value is best achieved through experimentation, using feedback from performance monitoring to tune the value, and making adjustments as necessary. Setting the value too high can potentially cause significant performance degradation when using the Tasktop application.
On the Repository Connection screen, you will also notice a Connection Security checkbox. This will default to unchecked (requiring secure connections). If unchecked, your connection must start with HTTPS and have SSL certificate validation enabled. If either condition is not met, Tasktop will not connect and provide an error message. If you choose to check the Allow insecure connections... checkbox, these restrictions will be lifted.
Note: If allowing insecure connections, please ensure that that configuration aligns with your organization's security policy and the associated risks are understood and accepted.
Tasktop Cloud users must connect to external repositories via HTTPS.
Installing a Certificate for HTTPS
To install a certificate for HTTPS, please follow instructions below:
- Get the public certificate from the third party tool.
- Copy the certificate to
- Stop Tasktop.
- Open a command prompt and navigate to directory
- Type "
keytool -import -file certfilename -alias reponame -keystore cacerts" (e.g., "
keytool -import -file c:\somedir\filename -alias Jira -keystore cacerts".
- You will be asked for the keystore password which is likely changeit unless it has already been changed.
- You will be asked if you want to trust the certificate to which you reply y.
- You should see a message stating the certificate was imported. If not, something has gone wrong.
- Start Tasktop.
We recommend that you create a new user within your external tool, to be used only for your Tasktop integration. This is the user information you will enter when setting up your repository connection within Tasktop Hub. By creating a new user, you will ensure that the correct permissions are granted, and allow for traceability of the modifications that are made by the synchronization.
In general, your Tasktop user account should have sufficient permissions to create, read, and update artifacts in your repository. However, depending on the use case, your user may need different permissions. For example, if you are only interested in flowing data out of your repository, your user may not need to have full CRUD access, as the create and update permissions may not be needed.
Please see our Connector Documentation for repository-specific information regarding user permissions.
Your user should have a secure password. Please be aware that Tasktop will not allow you to save a repository connection utilizing a weak password, such as tasktop.
Note: For most repositories, you will see a username and password field in the Authentication section. However, some repositories include additional Authentication options.
For most scenarios, you will select Standard Authentication. This is where you will enter the username and password used to access the repository. We recommend creating login credentials specifically for Tasktop to access your repository.
Tasktop currently supports the following SSO implementations:
- CA Siteminder/CA Single Sign-On (HTTP POST)
- CA Siteminder/CA Single Sign-On (Login Form)
- Script (HTTP cookies)
- X.509 Certificate
The HTTP Post option will generate the authentication form for you to fill in. Only the first 3 fields are required.
The Single Sign-On (Login Form) option will allow you to enter the URL for your SSO login form.
Once the URL is entered, Tasktop will auto-generate the fields that must be populated to connect to the repository.
Script (HTTP cookies)
This method is not available for Tasktop Hub Cloud instances.
To use the Script (HTTP cookies) authentication method, a system administrator (a user with file system access to the machine that hosts Tasktop) must add the script(s) to the designated directory:
- On Windows, the default folder is
- On Linux, the authentication-scripts can be found at the Tasktop installation directory
- If needed, the user can change the location in which Tasktop looks for the scripts. This is done by changing the system property
Once uploaded, select the script from the options available under the Cookie Script field. The script will be executed by the machine that hosts Tasktop. The script is stored in the Tasktop database, but is written to disk upon Tasktop startup and deleted from disk upon Tasktop shutdown.
Since Tasktop supports both Windows and Linux, please ensure that your script is able to be executed on the appropriate operating system: .bat for windows or shell script for Linux.
The Cookie Script will be executed and the standard out (and standard error) must read as a \n separated list of key/value pairs themselves separated by Cookie Key/Value Delimiter (default is =).
The Cookie Domain and Cookie Path arguments will then be used in the construction of a cookie for each of those key values pairs.
Note: As Tasktop creates a copy of the script when the repository configuration is saved, changing the script in the directory will have no direct effect on existing repositories. For changes to a script to take effect, the user must go to the target repository connection and update the configuration.
To use the X.509 Certificate authentication method, select the X.509 Certificate to upload from your local machine. The certificate is stored in the Tasktop database, but is written to disk upon Tasktop startup and deleted from disk upon Tasktop shutdown.
Some repositories allow for additional authentication methods. Please see our Connector Documentation for repository-specific information regarding authentication methods.
If Tasktop is installed behind a firewall, you may need to connect to external repositories (e.g. hosted or cloud ALM tools) through a proxy. To create a connection to such external repositories in Tasktop, you can make Tasktop connect through your proxy by configuring the proxy settings when creating a new repository connection. It is recommended to create login credentials specifically for Tasktop on the proxy server.
Note that the Proxy Location must be a URL in order for the proxy connection to work. If a .pac script is used in your browser, you will need to open the script and find the URL/port to enter in the Location field.
To use a proxy server, check the user proxy server box and fill in your proxy details in the Proxy Server section on the New Repository Screen:
Manual Change Detection
Tasktop's default global change detection settings can be found on the General (Settings) screen. However, if you'd like to override the global defaults, you can configure repository-specific change detection and full scan intervals on this screen.
Note that you can also set integration-level change detection on the Change Detection screen.
- The Change Detection Interval is the time between polling requests to detect only changed artifacts. This defaults to 1 minute on the General (Settings) screen, but can be customized as desired.
- The Full Scan Interval is the time between polling requests to detect changed artifacts, in which all artifacts that have previously synchronized in the integration are scanned.
Note: For Hub Cloud instances, we recommend setting the change detection interval to at least 1 minute and the full scan interval to at least 24 hours.
When configuring change detection settings, integration-level change detection has the highest precedence, followed by repository-level change detection, and then global change detection. This means that if integration-level change detection is configured, the integration-level setting will always be used (even if repository-level or global settings are configured). If no overrides are set, change detection will default to the global settings.
You can learn more about change detection and full scan styles in our FAQ here.
Note: In general, we recommend that you do not configure the Additional Settings unless you have consulted with Tasktop Support.
Additional settings you can configure on the Repository Connection screen include:
- Connection Toggle
- Repository Query
- Event Rate Limit
- Concurrency Limit
The Connection Toggle can be used to disable individual repository connections, stopping all traffic going into a repository. Additionally, you can use this option to schedule your repository connections to be disabled during mandatory credential updates to prevent user lockout.
Learn more in the section below.
If you plan to utilize a repository query, select the Repository Query checkbox.
Note: Repository Queries are advanced functionality, and should only be used when you are truly unable to filter as desired using the built-in Tasktop functionality of Repositories, Collections, and Artifact Filtering. You can learn more about repository queries here.
When setting an Event Rate Limit, you can choose to limit:
- All events
- Only full scan events: If this is selected, only low priority events occurring during a full scan will be limited. High priority events, such as artifact updates, will continue without impact.
Note that the rate set is a maximum rate; Tasktop may process items at a lower rate depending on the event load.
Tasktop's default event rate limit is applied to full scan (observe) events only, at 200 events per minute.
Note: Caution should be used when setting this value. The ideal Event Rate Limit is highly dependent on each customer's unique environment. Determining the appropriate value is best achieved through experimentation, using feedback from performance monitoring to tune the value, and making adjustments as necessary. Setting the value too low when there is a large number of projects configured in your collections and a low Change Detection Polling Interval setting can potentially cause Tasktop to be unable to process artifact changes.
If you notice that Tasktop is placing too high a load on your repository, we recommend first modifying the Event Rate Limit. If that is insufficient, or if the source of the high server load is specifically due to having too many open connections on the external repository, the Concurrency Limit can be modified. We recommend starting with a value between 3-10 and engaging with support to determine an appropriate value for your unique environment.
Note: Caution should be used when setting this value. The ideal Concurrency Limit is highly dependent on each customer's unique environment. Determining the appropriate value is best achieved through experimentation, using feedback from performance monitoring to tune the value, and making adjustments as necessary. Setting the value too low when there is a large number of projects configured in your collections and a low Change Detection Polling Interval setting can potentially cause Tasktop to be unable to process artifact changes.
Toggling your Repository Connection
To enable or disable a repository connection, click the toggle on the Repositories screen or on the Repository Connection screen.
On the Repository Connection screen, you can also schedule a repository connection to be disabled on a certain date or time.
Note: The entered date/time should be in the following format MMM DD, YYYY hh:mm A (e.g., Apr 01, 2022 05:00 PM)
If you choose to disable a repository connection, a pop-up will appear confirming you'd like to proceed.
Once confirmed, all elements associated with the repository connection will be disabled until the connection is enabled.
Note: This pop-up will not appear if scheduling the repository connection to be disabled.
Once the connection has been disabled, the repository must be up and running to enable the connection again. If not, you'll see an error message at the bottom of the screen.
Testing your Repository Connection
To test your repository connection, click the Test Connection button on the Repository Connection screen, or click the icon on the Repositories screen.
You will see a success or failure message to confirm whether Tasktop was able to connect to your repository.
When your repository fails to connect, you will also see an error message at the bottom of the screen with additional details on the source of the failure.
Viewing Associated Configuration Elements
To view associated configuration elements (such as collections or integrations that utilize the repository connection you are viewing), click the Associated Elements tag in the upper right corner of the screen.