Create Keboola connection

To create a connection to your system, follow these steps:

1. Navigate to Settings  > Data Ingestion > Connections.
2. In the top-right corner, click New connection, find your system, and click Connect.

General configuration

In the general connection configuration step:

1. Name your connection for easier identification in Dawiso. Use a unique and descriptive name like the combination of the server name and your local environment naming (e.g., server1_prod).
2. Provide a description (purpose of the connection).
3. Select a Connection type.
   • Shared: Source is accessible from the public internet and you can share your credentials with Dawiso.
   • Private: Source is not accessible from the public internet and you cannot share your credentials with Dawiso. For more information, see the Create a private connection article.
4. Click Next.

Connection configuration

First, define the API endpoints:

1. Management & Storage: URL of your Keboola stack, e.g., https://connection.keboola.com. The list of available stacks and endpoints can be found in Keboola’s official documentation.
2. [Optional] Queue: To scan jobs and execution history, also provide the Keboola Queue API endpoint, e.g., https://queue.keboola.com. List of available Queue endpoints can be found in Keboola’s official documentation.

To authenticate the connection provide the following information:

1. Id: Login to your Keboola account with administrator-level access.
2. Token: There are two types of tokens that can be used (for more information, see Prepare for Keboola integration):
   • Project-level token: Scan one project. To scan multiple projects, use the Projects field instead.
   • Organization-level token: Scan all projects in the organization or selected ones. You can filter which projects to scan in the Create Keboola data source step.
3. [Optional] Projects: Scan multiple projects using their project-level tokens defined in the JSON from Prepare for Keboola integration, e.g.:

[
  {
    "id": 1,
    "name": "Project 1",
    "token": "project_1_token"
  },
  {
    "id": 2,
    "name": "Project 2",
    "token": "project_2_token"
  }
]

Optional and additional settings

Configure Optional and Additional Settings for your connection. These settings are fully optional:

• Optional settings: Specify options supported by the provider in JSON format.
• Additional Settings: Recommended to leave empty unless our Dawiso support team suggests otherwise. Here, you can add a JSON formatted list of additional settings for troubleshooting or advanced connection configuration.

When adding optional settings, make sure the value is in a valid JSON.

Test and save connection

If your connection is shared, click on Test connection and wait for a few seconds.

• If successful, there will be a green checkmark next to the button.
• In case of failure, there will be a red error icon. Hover over it for a detailed error message. For more information, see the troubleshooting section. You are still able to save your connection.

Finally, Save the connection and proceed to the next step: using the connection to create a data source. During this process, you will specify what metadata to ingest.