IT Setup Guide
Everything your IT team needs to approve and deploy MapVS across your organisation.
Overview
MapVS (ValueStream) is a SaaS platform for planning, recording, tracking, and analysing value stream maps. It handles process data including step names, durations, resources, and optional screenshots. No on-premise installation is required.
The platform is hosted at mapvs.com and accessible via any modern web browser.
Domain Whitelisting
All traffic is outbound HTTPS only (port 443). No inbound ports or VPN tunnels are required.
| Service | Domain | Port | Purpose |
|---|---|---|---|
| Web App + API | mapvs.com |
443 | Main application, API, file uploads |
| Tailwind CSS | cdn.tailwindcss.com |
443 | CSS framework |
| Google Fonts | fonts.googleapis.com |
443 | Font stylesheets |
| Google Fonts (static) | fonts.gstatic.com |
443 | Font files (WOFF2) |
| HTMX | unpkg.com |
443 | HTMX library |
| jsDelivr CDN | cdn.jsdelivr.net |
443 | Alpine.js, Chart.js, Swagger UI |
| Stripe | js.stripe.com |
443 | Payment processing (optional, billing pages only) |
File Upload Proxy Configuration
MapVS accepts CSV and Excel file uploads via HTTPS POST to mapvs.com/import/upload. Some corporate proxies block multipart file uploads by default. Below are configuration instructions for common proxy vendors.
Zscaler Internet Access (ZIA)
- Navigate to Administration > Web Policy > URL & Cloud App Control
- Add a custom URL category for
mapvs.com - In File Type Control, create an exception rule:
- Action: Allow
- File types: CSV, TSV, TXT, XLSX
- URL category: your MapVS category
- Direction: Upload
- Under SSL Inspection, ensure
mapvs.comis not being inspected, or add it to the SSL bypass list if the upload still fails - Save and activate the policy
Netskope
- Navigate to Policies > Real-time Protection
- Create a new policy:
- Destination: custom URL list containing
mapvs.com - Activity: Upload
- File type: CSV, TSV, TXT, XLSX
- Action: Allow
- Destination: custom URL list containing
- If DLP scanning is enabled, add an exception for the MapVS URL list or configure a DLP profile that allows process data files
- Apply and save
Palo Alto Networks (Prisma Access / GlobalProtect)
- In Objects > Custom URL Category, create a category containing
mapvs.com - In Policies > Security, add or modify a rule:
- Source: your user zone/group
- Destination: the MapVS URL category
- Application: web-browsing, ssl
- File Blocking Profile: create a profile that allows CSV/TXT/XLSX upload to mapvs.com
- Action: Allow
- If SSL Decryption is in use, consider adding
mapvs.comto the decryption exclusion list - Commit the configuration
Generic Proxy / Firewall
- Allow HTTPS (port 443) to
mapvs.com - Allow
Content-Type: multipart/form-datafor POST requests tomapvs.com/import/*andmapvs.com/data/*/import - If file type filtering is active, allow: .csv, .tsv, .txt, .xlsx
- Maximum upload size: 50 MB
- If SSL inspection is in use and causes certificate errors, add
mapvs.comto the bypass list
Workaround: Paste-based import
If file uploads remain blocked after proxy configuration, users can paste CSV data, JSON data, or use a Google Sheets link directly on the import page. These methods do not require multipart file upload and work through any proxy.
Security & Compliance
Encryption in Transit
TLS 1.2+ enforced (TLS 1.3 preferred)
Encryption at Rest
AES-256 encrypted database and file storage
HSTS
Strict-Transport-Security header enforced
CSRF Protection
Token-based CSRF on all state-changing requests
Rate Limiting
Per-IP and per-user rate limits on all endpoints
Password Hashing
bcrypt with per-user salt
XSS Prevention
Jinja2 auto-escaping, Content Security Policy headers
SQL Injection Prevention
SQLAlchemy ORM with parameterised queries
For a comprehensive security review, see our Security Questionnaire with 50+ pre-answered questions for your InfoSec team.
API Access
Base URL
https://mapvs.com/api/v1
Authentication
API key via Authorization: Bearer <key>
Rate Limits
100 requests/minute (Starter), 500/min (Pro), 2000/min (Team)
Documentation
Data Residency
Current Region
Sydney, Australia (DigitalOcean SGP1/SYD1)
Planned Regions
US East, EU (Frankfurt) — on roadmap
Backups
Daily automated backups, 30-day retention
Data Deletion
Users can export and permanently delete all data from Account Settings
Browser Requirements
90+
88+
14+
90+
- JavaScript must be enabled
- Cookies must be enabled (session authentication)
- For Web Recorder: Screen Capture API support (Chrome or Edge recommended)
- Internet Explorer is not supported
Desktop App (Electron)
Download Size
~150 MB
Outbound Network
HTTPS to mapvs.com:443
Inbound Ports
None required
Platform Requirements
macOS 11 (Big Sur) or later
Permission required: System Preferences > Privacy & Security > Screen Recording
Windows 10 or later
No special permissions. Admin rights may be required for installation depending on group policy.
Ubuntu 20.04+ or equivalent
No special permissions required.
Data is stored locally in the user profile directory and synced to MapVS on demand. No always-on connection is needed.
Mobile App
iOS
iOS 15+ · Available via TestFlight
Android
Android 11+ · Available via Play Store
- Camera permission required (for step photos)
-
Network: HTTPS to
mapvs.com:443 - Offline capable — syncs when connected
Single Sign-On (Enterprise)
- SSO available on the Enterprise plan
- SAML 2.0 support (planned)
Contact enterprise@mapvs.com for SSO setup and enterprise onboarding.
Contact
For IT onboarding assistance, security questionnaires, or enterprise deployment planning:
General Support
Enterprise / Security