n8n-nodes-mat-framework 1.0.0 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +16 -18
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,10 +1,12 @@
|
|
|
1
1
|
|
|
2
2
|
# MAT Framework n8n Community Node
|
|
3
|
+
|
|
3
4
|
This repository provides the official community node that integrates MAT Framework with n8n. The node enables n8n workflows to securely trigger and monitor network-impacting automations executed inside MAT Framework.
|
|
4
5
|
|
|
5
6
|
All execution logic, governance, policy enforcement, and auditing are handled entirely within MAT.
|
|
6
7
|
|
|
7
8
|
## Documentation
|
|
9
|
+
|
|
8
10
|
Full documentation, configuration guides, compatibility notes, and release information are available at:
|
|
9
11
|
|
|
10
12
|
https://iquall.net/mat-n8n/
|
|
@@ -15,16 +17,11 @@ For production deployments, always refer to the official documentation page abov
|
|
|
15
17
|
|
|
16
18
|
The node acts as a thin client over MAT’s northbound API layer. It does not execute automation logic itself. All execution, governance, policy enforcement, and auditing are handled by MAT.
|
|
17
19
|
|
|
18
|
-
High-level flow
|
|
19
|
-
n8n Workflow
|
|
20
|
-
↓
|
|
21
|
-
MAT Community Node
|
|
22
|
-
↓
|
|
23
|
-
MAT Framework API
|
|
24
|
-
↓
|
|
25
|
-
Network / OSS / BSS Domains
|
|
20
|
+
**High-level flow**:
|
|
26
21
|
|
|
27
|
-
|
|
22
|
+
n8n Workflow > MAT Community Node > MAT Framework API > Network Domains
|
|
23
|
+
|
|
24
|
+
**What this Node does**:
|
|
28
25
|
- Triggers MAT automations or Bricks
|
|
29
26
|
- Pass structured input parameters
|
|
30
27
|
- Retrieves execution results
|
|
@@ -33,6 +30,7 @@ Network / OSS / BSS Domains
|
|
|
33
30
|
The node acts strictly as a thin client over MAT’s REST API. All authorization and validation are enforced server-side by MAT.
|
|
34
31
|
|
|
35
32
|
## Prerequisites
|
|
33
|
+
|
|
36
34
|
- A running MAT Framework instance (SaaS or On-Prem)
|
|
37
35
|
- A valid API token
|
|
38
36
|
- Network connectivity between n8n and your MAT tenant
|
|
@@ -43,6 +41,7 @@ The node acts strictly as a thin client over MAT’s REST API. All authorization
|
|
|
43
41
|
This node does not execute automation logic locally and does not bypass MAT controls. All RBAC, CI/CD validation, approval gates, maintenance windows, and audit logging are enforced server-side within MAT.
|
|
44
42
|
|
|
45
43
|
When triggering a workflow:
|
|
44
|
+
|
|
46
45
|
1. n8n sends a request to MAT API.
|
|
47
46
|
2. MAT validates authentication and permissions.
|
|
48
47
|
3. MAT registers a Job internally.
|
|
@@ -56,6 +55,12 @@ The node does not bypass:
|
|
|
56
55
|
- Closed-loop policies
|
|
57
56
|
- Audit logging
|
|
58
57
|
|
|
58
|
+
Security Notes:
|
|
59
|
+
- The node stores credentials in n8n’s encrypted credential store.
|
|
60
|
+
- API tokens should be scoped according to least privilege.
|
|
61
|
+
- All sensitive execution logic remains server-side in MAT.
|
|
62
|
+
- No network configuration logic resides in this repository.
|
|
63
|
+
|
|
59
64
|
## Error Handling
|
|
60
65
|
Errors returned by the node fall into two categories:
|
|
61
66
|
- Transport errors (network, timeout, TLS)
|
|
@@ -66,14 +71,7 @@ MAT-side execution errors include:
|
|
|
66
71
|
- Invalid workflow ID
|
|
67
72
|
- Parameter validation error
|
|
68
73
|
- Policy restriction
|
|
69
|
-
|
|
70
|
-
All execution logs remain traceable inside MAT.
|
|
71
|
-
|
|
72
|
-
## Security Notes
|
|
73
|
-
- The node stores credentials in n8n’s encrypted credential store.
|
|
74
|
-
- API tokens should be scoped according to least privilege.
|
|
75
|
-
- All sensitive execution logic remains server-side in MAT.
|
|
76
|
-
- No network configuration logic resides in this repository.
|
|
74
|
+
- All execution logs
|
|
77
75
|
|
|
78
76
|
## Development
|
|
79
77
|
This node is implemented in TypeScript and follows n8n community node structure.
|
|
@@ -83,4 +81,4 @@ This repository does not include the MAT Engine, automation workflows or SLA/sup
|
|
|
83
81
|
|
|
84
82
|
## License
|
|
85
83
|
Proprietary License.
|
|
86
|
-
|
|
84
|
+
The full license text is included in the published package as the `LICENSE` file.
|