dFlow~IQ
dFlow~IQ manualChapter 02 · Application guide

Create workspaces and connect securely

Create, open and manage workspace files; configure Kafka and Schema Registry authentication; and validate TLS before doing operational work.

DOCUMENTED VERSIONdFlow~IQ Community 1.0

First-party product documentation. Instructions are verified against the dFlow~IQ desktop implementation. Labels appear exactly as they do in the application where practical.

02.1

Create a workspace

  1. From Home, select Create or choose File → New workspace.
  2. Enter Workspace Name and choose Select Project Location.
  3. Enter one or more Bootstrap Servers.
  4. Choose Kafka Authentication and complete its required fields.
  5. Optionally open Schema Registry and enter its URL and authentication.
  6. Run both connection tests, then select Create Project.

Saving performs Kafka validation and, when a Registry URL exists, Registry validation before writing <workspace-name>-dflowiq-project.json.

02.2

Configure Kafka authentication

No Auth

Use only where the cluster listener requires no credentials.

SASL/PLAIN

Enter Username and Password. Use it with TLS for remote or sensitive environments.

SASL/SCRAM

Enter Username and Password for the cluster's SCRAM-SHA-256 identity.

Confirm the exact mechanism with the Kafka administrator. A correct password for PLAIN does not imply a SCRAM identity exists.

02.3

Configure Schema Registry

Schema Registry URL

Enter the complete HTTP or HTTPS endpoint.

No Auth

Use when the Registry permits unauthenticated access.

Basic Auth Credentials

Enter the Registry-specific Username and Password.

When Basic Auth is selected, the connection test checks that unauthenticated access is actually rejected.

02.4

Add TLS trust

  1. Open Settings → Connections & TLS.
  2. Enable SSL/TLS for Kafka when required.
  3. Select Configure certificate validation.
  4. Choose a readable JKS, PEM, CRT or CER trust file, or leave the path blank to use JVM defaults.
  5. Select Save settings and re-run the connection tests.

Bypass SSL handshake validation disables certificate and hostname verification. Use it only for isolated, temporary diagnosis and never with production credentials.

02.5

Open, remove and delete workspaces

  • Home → Open selects a dFlow~IQ project JSON file.
  • Add Workspace → Open selects a directory and searches for project files nearby.
  • Remove closes the workspace from the session but preserves its file.
  • Delete removes the session entry, Recent item and project JSON file permanently.

The workspace action dialog requires typing Remove or Delete exactly. Verify the selected environment before confirming Delete.

Documentation reference

Current dFlow~IQ Community desktop implementation and bundled UI labels, reviewed 13 August 2026. Product behaviour takes precedence if a later release differs from this page.