thinknagent 0.1.11 → 0.1.12

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.
Files changed (3) hide show
  1. package/Readme.md +12 -1
  2. package/package.json +1 -1
  3. package/tncproject +0 -0
package/Readme.md CHANGED
@@ -181,6 +181,17 @@ Role is assigned by the room Owner at approval time and can be changed anytime f
181
181
 
182
182
  ---
183
183
 
184
+ ## Security & Privacy
185
+
186
+ The agent is designed with a "zero-trust" approach to protect your server's credentials, logs, and shell sessions.
187
+
188
+ - 🔒 **Double-Gate Authorization**: New agents connect in `PENDING` mode. They cannot stream metrics or logs until explicitly approved by the room Owner. Upon approval, they receive a signed HMAC `agentToken` for secure reconnection.
189
+ - 🛡️ **Remote Shell Environment Insulation**: Spawning a shell strips all server environment variables, passing only a safe allowlist (`PATH`, `HOME`, `SHELL`, `TERM`, `LANG`). Your database credentials, cloud API keys, and environment secrets remain completely safe.
190
+ - 🚫 **Path Traversal & Sensitive File Blocks**: Log files are verified using absolute path checking. They must belong to allowed directories (`/var/log`, `/home`, `/root`, `/tmp`) and are explicitly blocked if they contain sensitive directories or files like `.ssh/id_rsa`, `.env`, `/etc/passwd`, `/etc/shadow`, etc.
191
+ - 💬 **SSL Transport**: All WebSocket and HTTP traffic between the agent and the server is encrypted using HTTPS/WSS.
192
+
193
+ ---
194
+
184
195
  ## Auth Flow
185
196
  thinknagent init
186
197
  → generates agentId
@@ -241,7 +252,7 @@ pm2 startup
241
252
 
242
253
  **Using systemd:**
243
254
  ```bash
244
- sudo nano /etc/systemd/system/app.service
255
+ sudo nano /etc/systemd/system/thinknagent.service
245
256
  ```
246
257
 
247
258
  ```ini
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "thinknagent",
3
- "version": "0.1.11",
3
+ "version": "0.1.12",
4
4
  "description": "ThinkNCollab server agent — metrics, logs, alerts, shell bridge",
5
5
  "main": "lib/agent.js",
6
6
  "author": "ThinkNCollab Team <team@thinkncollab.com>",
package/tncproject DELETED
Binary file