n8n-nodes-salto-ks

This is a community node for n8n that allows you to receive real-time events from a Salto KS SignalR stream.

This trigger node handles the complete OAuth2 authentication flow, including automatic token refresh, to maintain a persistent and reliable connection.

Installation

Follow the n8n community node installation guide to install this node. The package name on NPM is n8n-nodes-salto-ks.

Configuration

1. Credentials

After installing the node, create a new "Salto KS" credential from the n8n credentials section. You will be prompted for the following information, which you can obtain from your Salto KS account:

• Identity Server URL: The URL of the Salto authentication server (e.g., https://account.saltos.com).
• Client ID
• Client Secret
• Username
• Password
• Scope (optional, defaults to user_api.full_access)

2. Trigger Node

Add the "Salto KS" node as the starting trigger for your workflow. Configure the following parameters in the node's properties panel:

• Environment: Select the Salto KS environment to connect to (e.g., Production, Test).
• Channel: Choose the event channel to listen on (e.g., Entries, Incidents).
• Site ID: The ID of the site for which you want to receive events.
• User ID (optional): Filter events for a specific user.

Features

• Real-time Event Streaming: Listens to a SignalR hub and triggers your workflow the moment an event occurs.
• Automatic Reconnection: Implements an exponential backoff strategy to automatically reconnect if the connection is lost.
• Robust Authentication: Handles the complete Salto KS OAuth2 password grant flow, including automatic token refresh in the background.
• Clean Shutdown: The connection is properly terminated when the workflow is deactivated, preventing duplicate triggers.

Compatibility

This node has been tested with n8n version 1.23.0 and later.