Before ingesting Keboola metadata into Dawiso, prepare your account for authentication using one of the following token types:

  • Organizational-level token: Grant access to all projects associated with your organization.
  • Project-level token: Grant access to a specific Keboola project.

Connection prerequisites

  • An active Keboola account
  • Administrator access to your organization and projects in Keboola

Organizational-level token

An organizational-level token grants Dawiso access to all projects associated with your account. During data source setup, you can select which projects you’d like to scan.

  1. In Keboola, in the top-right, click your profile and select Account Settings.
  2. In the left menu, select Access Tokens.
  3. In the top-right, click + New token.
  4. Name the token (e.g., DawisoToken) and set for how long the token will be valid.
  5. Click Create token. The token will be displayed in a green banner on the top of the page. Copy the value and store somewhere safe, it will be displayed only once.

For more information on managing organization settings, including creating and managing organization-level tokens, refer to the Account section of Keboola’s documentation.

Warning

The API token value is displayed only once. Copy and save it immediately, otherwise you will need to generate a new token.

Project-level token

A project-level token is recommended when you do not have permissions to generate an organization-level token.

  1. In Keboola, navigate to your project.
  2. In the top-right click your profile and select Project Settings.
  3. Switch to the API Tokens tab and click + NEW TOKEN.
  4. Provide the following information when creating the token
    1. Token name: Choose a descriptive name, e.g., DawisoProjectToken.
    2. Description: For example, the purpose of the token.
    3. Access level: Select between full and restricted access.
    4. Components & Buckets: You can select which components and buckets the token, in other words Dawiso, can access.
  5. In the top-right, click CREATE. The token will be displayed once. Copy the value and store somewhere safe.

To learn more about creating and managing project-level tokens, refer to the API Tokens section of Keboola’s documentation.

Tip

Although the API token value will be displayed once right after creation, if you need to access it later, you can share it by sending it via email.

Listing multiple project-level tokens

Dawiso allows you to use multiple project-level tokens. During Keboola connection setup (Organization/Projects configuration step), provide multiple tokens using a JSON based on this sample:

[
    {
      "id": 1,
      "name": "Project 1",
      "token": "project_1_token"
    },
    {
        "id": 2,
        "name": "Project 2",
        "token": "project_2_token"
      }
]
  • The value of the “name” key will be used as the Project name displayed in Dawiso.