Skip to content
Datablast Docs

Overview

Scope: This guide covers the Connections page located at pages/client/[id]/connections/index.vue. It explains what each field means, where to obtain required credentials, and typical workflows for creating, editing, and deleting connections.

1. Purpose

Section titled “1. Purpose”

The Connections dashboard lets you link external services (e.g. Slack, Discord, AWS) to your Datablast client. Once connected you can:

  • Trigger notifications (Slack / Discord)
  • Access cloud resources (AWS / GCP / Snowflake)
  • Query databases (PostgreSQL / MySQL)

2. Connections List

Section titled “2. Connections List”

Connections list

  • View name, type, description and last modified date.
  • Filter by provider (e.g. BigQuery, Slack, Snowflake).
  • Toggle activation status.

3. Supported Connection Types

Section titled “3. Supported Connection Types”

Each provider has a dedicated guide:

4. Creating a Connection

Section titled “4. Creating a Connection”

Create connection form

  1. Select provider template – fields adjust automatically.
  2. Enter credentials & test connection.
  3. Save; credentials are encrypted using KMS.
  4. A success message appears and the connection status changes to Connected.

5. Editing / Rotating Credentials

Section titled “5. Editing / Rotating Credentials”

Edit connection

  • Hover a connection ➜ click the ellipsis (⋮) ➜ Edit.
  • Secret fields are masked by default; click Reveal to view.
  • Update the credential (e.g. rotate a Slack token) and Update Connection.
  • History sidebar shows previous revisions.

6. Deleting a Connection

Section titled “6. Deleting a Connection”
  • Ellipsis (⋮) ➜ Delete. Confirm the prompt.
  • Delete action requires confirmation dialog to avoid accidental loss.
  • Deleting removes credentials but does not delete resources on the provider side.

7. Filtering & Search

Section titled “7. Filtering & Search”
  • Connection Status – All | Connected | Not Connected
  • Connection Type – multi-select dropdown to show only specific services.

8. Best Practices

Section titled “8. Best Practices”
  • Use service accounts over personal credentials.
  • Rotate keys regularly and leverage environment-specific connections.

9. FAQ

Section titled “9. FAQ”

The form says “Connected” but messages don’t arrive

Section titled “The form says “Connected” but messages don’t arrive”
  • Verify the token/key is correct and still active.
  • Check provider-side permission scopes (e.g. Slack webhook must access the channel).
  • Use Edit → Update to re-save credentials.

Can I add multiple connections of the same type?

Section titled “Can I add multiple connections of the same type?”

Yes. Click Add Connection in the expanded card. Each entry appears in the details list.

Is my secret data encrypted?

Section titled “Is my secret data encrypted?”

Credentials are stored via the backend’s secure vault module; only hashed references are persisted in the database.

8. Change Log

Section titled “8. Change Log”
DateAuthorNotes
2025-07-07Docs TeamInitial version

Created with ❤️ for Datablast developers.