Security, versioning and teamwork
n8n is a single place with access to many systems at once — which makes security sharper here than in an ordinary application. One leaked credential means access to several systems.
The main layers:
- Credentials — in a credential object rather than a node parameter, with least privilege
- The encryption key — the key protecting credentials; managed separately and rotated
- External secret vaults — the option to keep credentials in a centralised store outside n8n
- Access control — who can sign in, and what they can see and change
- Webhook protection — authentication for endpoints on the open internet
- Treating incoming data as untrusted — a webhook body must never go straight into a query or a command
| Risk | How it arises | How to prevent it |
|---|---|---|
| A key ending up in a workflow export | The token was typed into a node parameter | Always use a credential — its value is not included in an export |
| An unprotected webhook | Authentication was left as "None" | Basic, header or JWT auth; signature verification and IP restrictions where possible |
| SQL injection | Incoming data was concatenated into the query with an expression | `$1`, `$2` tokens and the Query Parameters field |
| Sensitive data lingering in the execution history | Personal data passes between nodes and is stored | Tune execution data saving in workflow settings; drop sensitive fields early |
| Excessive permission | The credential was granted more than it needs | Do not request write access when reading is enough; create a dedicated service user |
Versioning and teamwork. n8n workflows are visual, but they change and break like code. So the same questions arise: who changed what, how do we roll back, how do we promote something tested in dev to production.
n8n offers several mechanisms:
- Change history — viewing and restoring a workflow's previous versions
- Saving and publishing versions — a change does not go live the moment you save it
- Export and import — moving a workflow as JSON, or whole folders and projects with the
.n8nppackage format - Git-based source control and environments — on Business and Enterprise plans; n8n instances are linked to Git branches and changes move by push and pull
Source control also enables review: comparing a change with a visual diff and submitting it for approval before publishing.
Set team conventions on day one. Naming ([Prod] Daily CRM sync), a folder and tag structure, an error workflow assigned to every workflow. Establishing these across 5 workflows is easy; across 80 it becomes its own project. In interviews, the answer to "how would you manage n8n in a team?" starts exactly here.
📚 Sources and documentation
- Administerofficialdocs.n8n.io
Access control, credential security, change management and monitoring.
- Source control and environmentsofficialdocs.n8n.io
Git-based environments; available on Business and Enterprise plans.
- Manage users and accessofficialdocs.n8n.io
- View change historyofficialdocs.n8n.io
- Export and importofficialdocs.n8n.io