Connection Details Screen v2

The Connection details screen manages a Connection's shared identity and its value in each Site Environment. Open Connections, then select a Connection or create a new Connection.

Page actions

Action	Behaviour
Save changes	Saves the shared Connection fields and every Environment value you have permission to access. A Connection name and Node are required.
Delete	Opens a confirmation dialog that requires yes. Deleting removes the Connection and its values from every Environment.
Relationships	Opens relationships for the Connection and currently selected Environment in a new tab. This action appears when the subscription includes Relationships.
Audit trail	Opens the Connection audit trail in a new tab. This action appears when the subscription includes Audit Trail.
Help	Opens the help article for the Connection's Node.

Delete, Relationships, and Audit trail are unavailable until the Connection has a key. Help is unavailable until a Node is selected.

Shared fields

Field	Description
Connection name	Required Site-scoped display name.
Connection key	Read-only identifier displayed after the Connection has been saved. Use the copy control when a Workflow, API, or agent requires the key.
Host Cluster Key	Cloud or local Cluster placement. This field appears only when the selected Node supports local execution. You can clear a local selection to return to Cloud Cluster.
Node	Node and version that define the Connection contract. Click the field to choose a Node while creating the Connection. The Node cannot be replaced after the Connection receives a key.

If a newer version of the same Node is published, the screen shows a latest-version badge and Update to latest. Updating changes the in-memory Node version and reloads its Connection Property definition. Save and test the Connection after reviewing the changed fields.

Flowgear rejects an unknown Cluster, an unknown Node version, or a Node that does not support the selected Cluster.

Environment selector

The Environment segmented control lists every Environment in the Site. Select an Environment to edit its Connection values.

The selector is unavailable until a Node has been selected. If you do not have access to the selected Environment, the Properties area displays No permission and does not load.

The selector controls which values are shown; it does not limit Save changes to that one Environment. Saving attempts each Environment you can access. If some Environment saves succeed and others fail, the Console reports both sets in a partial-save warning. Review and retry the failed Environments before treating the Connection change as complete.

Connection Properties

The selected Node version supplies the fields, labels, descriptions, default values, and conditional display rules. Missing values receive the Node-defined defaults.

The screen supports these Property controls:

Property definition	Control and behavior
String	Single-line text input.
Masked	Password input containing a redacted value on load. Leaving that value unchanged preserves the stored secret.
Boolean	Checkbox.
Integer, double, or single	Numeric input. Clearing the field currently sets its value to 0.
Enum	Searchable single-select menu.
Multiselect enum	Searchable flag selection. The field summarizes additional selections after the first three labels.
Multiline	Read-only summary field with Edit value. Editing opens a full-screen code editor with Confirm and Close; closing with changes prompts you to save or discard them.
Public certificate	Upload control for a binary DER .crt or .cer certificate containing only a public key.
Public/private certificate	Upload control for a .pfx certificate. The Console asks for its password, which can be blank and is not stored by the platform.
Hidden	Excluded from the main form. Use Show internal properties to reveal supported internal fields.
Conditional	Displayed only when its associated enum Property has the required value.
Large	Not rendered as an ordinary field. The Node can populate it through a supported Connection Method such as metadata acquisition.

After a certificate is saved, the screen displays its thumbprint and subject with a remove action. Removing it updates the current Environment's value after you save the Connection.

Connection Methods

The screen displays only the methods declared by the selected Node version:

Action	Behaviour
Test	Tests the persisted Connection in the selected Environment. The screen reloads the Connection afterward because the test can refresh credentials.
Acquire Metadata	Retrieves provider metadata and reloads the Connection. The acquired value can be stored as a large internal Property.
Connect your Account	Starts the Node's OAuth flow, returns to the same Connection and Environment, retrieves the resulting Connection Properties, then refreshes the page state.

Connection Methods do not run while the page has unsaved changes. Click Save changes first. This prevents a test, metadata request, or OAuth redirect from using stale values or discarding local edits.

Save behavior

For a new Connection, the Console creates one shared header and separate value objects for your assigned Environments. The first successful save supplies the Connection key, and the page redirects to the permanent Connection route.

Each accessible Environment is saved separately. The same name, Node version, folder, and Cluster are included with every save, while the Property value belongs to that Environment. A successful save preserves unchanged masked values and applies any certificate changes.

If every Environment save succeeds, the Console shows one success alert. If every save fails, it shows the first error. If only some succeed, it shows a warning naming the successful and failed Environments. Because a partial save can persist the shared header and some Environment values, correct it explicitly rather than assuming the operation was rolled back.

Permissions

You need Connection read and write permissions, plus access to the relevant Environment, to create or edit values. The Connections explorer applies separate permissions for listing, renaming, deleting, and managing folders.

Environment-scoped permissions can leave an Environment visible in the selector but prevent its value from loading or saving. Ask a Site administrator to update your Environment assignment when you need to configure that value.