Add VPN configuration tools and agent documentation
Created comprehensive VPN setup tooling for Peaceful Spirit L2TP/IPsec connection and enhanced agent documentation framework. VPN Configuration (PST-NW-VPN): - Setup-PST-L2TP-VPN.ps1: Automated L2TP/IPsec setup with split-tunnel and DNS - Connect-PST-VPN.ps1: Connection helper with PPP adapter detection, DNS (192.168.0.2), and route config (192.168.0.0/24) - Connect-PST-VPN-Standalone.ps1: Self-contained connection script for remote deployment - Fix-PST-VPN-Auth.ps1: Authentication troubleshooting for CHAP/MSChapv2 - Diagnose-VPN-Interface.ps1: Comprehensive VPN interface and routing diagnostic - Quick-Test-VPN.ps1: Fast connectivity verification (DNS/router/routes) - Add-PST-VPN-Route-Manual.ps1: Manual route configuration helper - vpn-connect.bat, vpn-disconnect.bat: Simple batch file shortcuts - OpenVPN config files (Windows-compatible, abandoned for L2TP) Key VPN Implementation Details: - L2TP creates PPP adapter with connection name as interface description - UniFi auto-configures DNS (192.168.0.2) but requires manual route to 192.168.0.0/24 - Split-tunnel enabled (only remote traffic through VPN) - All-user connection for pre-login auto-connect via scheduled task - Authentication: CHAP + MSChapv2 for UniFi compatibility Agent Documentation: - AGENT_QUICK_REFERENCE.md: Quick reference for all specialized agents - documentation-squire.md: Documentation and task management specialist agent - Updated all agent markdown files with standardized formatting Project Organization: - Moved conversation logs to dedicated directories (guru-connect-conversation-logs, guru-rmm-conversation-logs) - Cleaned up old session JSONL files from projects/msp-tools/ - Added guru-connect infrastructure (agent, dashboard, proto, scripts, .gitea workflows) - Added guru-rmm server components and deployment configs Technical Notes: - VPN IP pool: 192.168.4.x (client gets 192.168.4.6) - Remote network: 192.168.0.0/24 (router at 192.168.0.10) - PSK: rrClvnmUeXEFo90Ol+z7tfsAZHeSK6w7 - Credentials: pst-admin / 24Hearts$ Files: 15 VPN scripts, 2 agent docs, conversation log reorganization, guru-connect/guru-rmm infrastructure additions Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,100 @@
|
||||
-- GuruRMM Clients and Sites Schema
|
||||
-- Adds multi-tenant support with clients, sites, and site-based agent registration
|
||||
|
||||
-- Clients table (organizations/companies)
|
||||
CREATE TABLE clients (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
name VARCHAR(255) NOT NULL,
|
||||
code VARCHAR(50) UNIQUE, -- Optional short code like "ACME"
|
||||
notes TEXT,
|
||||
is_active BOOLEAN DEFAULT TRUE,
|
||||
created_at TIMESTAMPTZ DEFAULT NOW(),
|
||||
updated_at TIMESTAMPTZ DEFAULT NOW()
|
||||
);
|
||||
|
||||
CREATE INDEX idx_clients_name ON clients(name);
|
||||
CREATE INDEX idx_clients_code ON clients(code);
|
||||
|
||||
-- Trigger for clients updated_at
|
||||
CREATE TRIGGER update_clients_updated_at
|
||||
BEFORE UPDATE ON clients
|
||||
FOR EACH ROW
|
||||
EXECUTE FUNCTION update_updated_at_column();
|
||||
|
||||
-- Sites table (locations under a client)
|
||||
CREATE TABLE sites (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
client_id UUID NOT NULL REFERENCES clients(id) ON DELETE CASCADE,
|
||||
name VARCHAR(255) NOT NULL,
|
||||
-- Site code: human-friendly, used for agent registration (e.g., "BLUE-TIGER-4829")
|
||||
site_code VARCHAR(50) UNIQUE NOT NULL,
|
||||
-- API key hash for this site (all agents at site share this key)
|
||||
api_key_hash VARCHAR(255) NOT NULL,
|
||||
address TEXT,
|
||||
notes TEXT,
|
||||
is_active BOOLEAN DEFAULT TRUE,
|
||||
created_at TIMESTAMPTZ DEFAULT NOW(),
|
||||
updated_at TIMESTAMPTZ DEFAULT NOW()
|
||||
);
|
||||
|
||||
CREATE INDEX idx_sites_client ON sites(client_id);
|
||||
CREATE INDEX idx_sites_code ON sites(site_code);
|
||||
CREATE INDEX idx_sites_api_key ON sites(api_key_hash);
|
||||
|
||||
-- Trigger for sites updated_at
|
||||
CREATE TRIGGER update_sites_updated_at
|
||||
BEFORE UPDATE ON sites
|
||||
FOR EACH ROW
|
||||
EXECUTE FUNCTION update_updated_at_column();
|
||||
|
||||
-- Add new columns to agents table
|
||||
-- device_id: unique hardware-derived identifier for the machine
|
||||
ALTER TABLE agents ADD COLUMN device_id VARCHAR(255);
|
||||
|
||||
-- site_id: which site this agent belongs to (nullable for legacy agents)
|
||||
ALTER TABLE agents ADD COLUMN site_id UUID REFERENCES sites(id) ON DELETE SET NULL;
|
||||
|
||||
-- Make api_key_hash nullable (new agents will use site's api_key)
|
||||
ALTER TABLE agents ALTER COLUMN api_key_hash DROP NOT NULL;
|
||||
|
||||
-- Index for looking up agents by device_id within a site
|
||||
CREATE UNIQUE INDEX idx_agents_site_device ON agents(site_id, device_id) WHERE site_id IS NOT NULL AND device_id IS NOT NULL;
|
||||
|
||||
-- Index for site lookups
|
||||
CREATE INDEX idx_agents_site ON agents(site_id);
|
||||
|
||||
-- Registration tokens table (optional: for secure site code distribution)
|
||||
CREATE TABLE registration_tokens (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
site_id UUID NOT NULL REFERENCES sites(id) ON DELETE CASCADE,
|
||||
token_hash VARCHAR(255) NOT NULL,
|
||||
description VARCHAR(255),
|
||||
uses_remaining INTEGER, -- NULL = unlimited
|
||||
expires_at TIMESTAMPTZ,
|
||||
created_at TIMESTAMPTZ DEFAULT NOW(),
|
||||
created_by UUID REFERENCES users(id) ON DELETE SET NULL
|
||||
);
|
||||
|
||||
CREATE INDEX idx_reg_tokens_site ON registration_tokens(site_id);
|
||||
CREATE INDEX idx_reg_tokens_hash ON registration_tokens(token_hash);
|
||||
|
||||
-- Function to generate a random site code (WORD-WORD-####)
|
||||
-- This is just a helper; actual generation should be in application code
|
||||
-- for better word lists
|
||||
CREATE OR REPLACE FUNCTION generate_site_code() RETURNS VARCHAR(50) AS $$
|
||||
DECLARE
|
||||
words TEXT[] := ARRAY['ALPHA', 'BETA', 'GAMMA', 'DELTA', 'ECHO', 'FOXTROT',
|
||||
'BLUE', 'GREEN', 'RED', 'GOLD', 'SILVER', 'IRON',
|
||||
'HAWK', 'EAGLE', 'TIGER', 'LION', 'WOLF', 'BEAR',
|
||||
'NORTH', 'SOUTH', 'EAST', 'WEST', 'PEAK', 'VALLEY',
|
||||
'RIVER', 'OCEAN', 'STORM', 'CLOUD', 'STAR', 'MOON'];
|
||||
word1 TEXT;
|
||||
word2 TEXT;
|
||||
num INTEGER;
|
||||
BEGIN
|
||||
word1 := words[1 + floor(random() * array_length(words, 1))::int];
|
||||
word2 := words[1 + floor(random() * array_length(words, 1))::int];
|
||||
num := 1000 + floor(random() * 9000)::int;
|
||||
RETURN word1 || '-' || word2 || '-' || num::text;
|
||||
END;
|
||||
$$ LANGUAGE plpgsql;
|
||||
Reference in New Issue
Block a user