Skip to main content
Skip table of contents

Data Sources

A data source defines the connection to data you want to fetch. One data source can be used in multiple field configurations. The use of variables helps you to keep your data source as flexible as possible.

The app allows you to connect to:

Variables

Variables are the key to making your data source more flexible and versatile. You can use specifically defined variables as placeholders which can be used in field configurations later on.

A variable is defined with surrounding curly brackets:{}

Example:

CODE
https://myapi.com?query={var1}

Variables can be used in fields like:

  • URL - URL/REST, Salesforce, Local Jira

  • Post Body - URL/REST, Local Jira

  • SQL Query - database

Examples of how to use variables in an issue context can be found in the Context Filter section.

Test Connection

After creating a data source you can check if the connection has successfully been established by clicking on Test connection. a test dialog appears. This should open a test dialog window, where you can fill in some sample data for your previously defined variables and start the test. The results with a response by the URL should be displayed immediately.

Note: shortened raw result from XXX to XXX only affects the displayed results in the simulation as a way to reduce traffic. Your original date source is not being affected nor shortened by this procedure.

Security Recommendations (warning)

For best practices when connecting to an external source, we recommend the following steps:

  1. Use a dedicated user account: Create a dedicated user account with limited permissions for connecting to the external data source. Grant read-only access to the specific data required by the app.

  2. Restrict IP access: Configure the external data source to accept connections only from specific IP addresses. You can find the IP addresses to allow further below.

  3. Rotate passwords regularly: Change the password for the dedicated user account every six months, or more frequently if required by your organization's security policies.

  4. Enable secure communication: If the external data source supports HTTPS or SSL/TLS, ensure that these options are enabled to encrypt data transmitted between the app and the data source.

  5. Monitor access and usage: Regularly review logs and reports from the external data source to identify suspicious activity, such as unauthorized access or data exfiltration.

Add IP’s to Allowlist

In case you need to allow an IP to let external data access your infrastructure, please add the following IP addresses to your allowlist:

Global / US:

  • 23.20.133.116

  • 3.223.177.5

Global / EU / DE:

  • 18.194.7.117

  • 3.124.29.165

Please visit our Data Residency section to find out your region.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.