Skip to main content
Skip table of contents

Data Sources

A data source defines the connection to the data you want to fetch. A data source can be used in multiple field configurations later. Variables help you to keep the data source as flexible as possible.

The app supports to following types to connect to:

Variables

To make a data source more flexible and reusable you can use variables. Those defined variables act as placeholders and can be used later in a field configuration.

A variable is defined with single curly brackets for example: {var1}

Variables are supported in the following fields:

  • URL - URL/REST, Salesforce, Local Jira

  • Post Body - URL/REST, Local Jira

  • SQL Query - database

Test Connection

After creating a data source you can verify that the connection can be established. After clicking on Test connection a test dialog appears. Here you can fill in some sample data for your previously defined variables and start the test. You get a immediate response about the success of the test and the response returned by the url.

The message shortened raw result from XXX to XXX is just a way to reduce traffic and only shortens the result only in the simulation.

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.