FortiOS Configuration Helper

Enhanced syntax support and productivity features for FortiOS configuration files in Visual Studio Code.

✨ Features

🎨 Enhanced Syntax Highlighting

• FortiOS-specific keywords - Automatically updated from latest FortiOS versions
• IP Address highlighting - Distinguishes private vs public IPs with different colors
• Configuration blocks - Clear visual distinction for config sections
• String literals with proper escape sequence handling

📁 Code Structure & Navigation

• Code Folding - Collapse/expand config/end and edit/next blocks
• Bracket Matching - Highlights matching FortiOS keywords when clicked
• Document Outline - Hierarchical tree view of configuration sections in dedicated sidebar
• Advanced Filtering - Smart filter with regex support, presets, and search history
• Go to Definition - Jump to profile definitions from references
• Find All References - Locate all usages of security profiles

⚡ Productivity Features

• Smart Code Completion - Context-aware suggestions for FortiOS commands
• Comment Toggle - Support for both # (FortiOS) and ! (Cisco ASA) styles
• Configuration Summary - Overview panel with device info, policy counts, and risk analysis
• Auto-indent - Proper indentation for nested configuration blocks

🔄 Automated Maintenance

• RSS-based Updates - Automatically monitors FortiOS releases and updates keywords
• GitHub Actions Integration - Daily checks for new FortiOS versions
• Zero-maintenance - Keywords stay current without manual intervention

🚀 Getting Started

Installation

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
3. Search for "FortiOS Configuration Helper"
4. Click Install

Usage

1. Open any .conf or .cfg file
2. The extension automatically activates for FortiOS configuration files
3. Click the 🛡️ FortiOS Explorer icon in the left activity bar to access advanced features:
   • Configuration Outline with smart filtering
   • Configuration Summary with risk analysis
   • Filter presets and search history
4. Enjoy enhanced syntax highlighting and productivity features!

📋 Supported File Types

• .conf - FortiOS configuration files
• .cfg - FortiOS configuration files

🔧 Available Commands

📖 Features in Detail

Code Folding

Collapse complex configuration sections for better readability:

config system global ⏵
    # Collapsed content
end

config firewall policy ⏵
    # Collapsed content  
end

FortiOS Explorer & Advanced Filtering

Dedicated FortiOS Sidebar:

1. Open a FortiOS configuration file (.conf or .cfg)
2. Look for the 🛡️ shield icon in the left activity bar
3. Click the FortiOS Explorer icon to reveal specialized configuration management tools

Configuration Outline with Advanced Filtering: Navigate large configurations with powerful filtering capabilities:

• 🔧 System Configuration
  • Global Settings
  • Interface Configuration
• 🛡️ Security Policies
  • Firewall Policies
  • Security Profiles

Smart Filter Features:

• Text Search - Simple keyword filtering (system, interface, policy)
• Regex Support - Advanced patterns like (policy|firewall) or port[0-9]+
• Filter Presets - One-click filters for common configuration types:
  • 🔧 System Configuration
  • 🔌 Network Interfaces
  • 🛡️ Security Policies
  • 🛣️ Routing Configuration
  • 👥 User & Authentication
  • 🔒 VPN Settings
  • 📋 Logging Configuration
  • 🛡️ Web Filter & Security
• Search History - Remembers your recent searches (up to 15)
• Quick Filter UI - Dropdown with presets and history for fast access

Filter Usage:

🔍 Filter: Enter text or select from history
🔎 Quick Filter: Choose preset or recent search  
🗑️ Clear: Remove active filters

Smart Completion

Context-aware suggestions based on your current configuration section:

• Type set in a firewall policy → suggests policy-specific options
• Type set in system global → suggests global system options

Profile Navigation

• Go to Definition: F12 on profile references jumps to definition
• Find References: Shift+F12 shows all profile usages

🔄 Automatic Updates

This extension features RSS-based automatic keyword monitoring:

• Monitors FortiOS firmware RSS feed daily
• Auto-updates syntax highlighting for new FortiOS versions
• Creates pull requests when new keywords are detected
• Ensures compatibility with latest FortiOS releases

🎯 Use Cases

Perfect for:

• Network Engineers managing FortiGate firewalls
• Security Administrators reviewing FortiOS configurations
• DevOps Teams maintaining infrastructure-as-code for FortiOS
• Consultants analyzing client FortiGate configurations
• Students learning FortiOS configuration syntax

🛠️ Development

Building from Source

git clone https://github.com/testpilot031/fortios-config-studio.git
cd fortios-config-studio
npm install
npm run compile

Available Scripts

• npm run compile - Compile TypeScript
• npm run watch - Watch mode compilation
• npm run lint - Run ESLint
• npm run test - Run extension tests
• npm run rss-monitor - Check for FortiOS updates

📝 Contributing

Contributions are welcome! Please feel free to submit:

• Bug reports via Issues
• Feature requests
• Pull requests

Adding New Keywords

Keywords are automatically maintained via RSS monitoring, but manual updates are supported:

npm run update-keywords-manual

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Links

• GitHub Repository
• VS Code Marketplace
• Issue Tracker

📸 Screenshots

Syntax Highlighting

Document Outline

Configuration Summary

Happy FortiOS Configuration Editing! 🚀