Add Firewall application.

Signed-off-by: Manuel Ullmann <manuel.ullmann@rediecon.com>

Author: Manuel Ullmann

Source/NETworkManager.Converters/BoolArrayToFwRuleCategoriesConverter.cs

@@ -0,0 +1,53 @@
+using System;
+using System.Globalization;
+using System.Linq;
+using System.Windows.Data;
+using NETworkManager.Models.Network;
+using NETworkManager.Localization.Resources;
+
+
+namespace NETworkManager.Converters;
+
+public class BoolArrayToFwRuleCategoriesConverter : IValueConverter
+{
+    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
+    {
+        if (targetType != typeof(string)) return null;
+        const int expectedLength = 3;
+        var fallback = GetTranslation(Enum.GetName(NetworkProfiles.NotConfigured), false);
+        if (value is not bool[] { Length: expectedLength } boolArray)
+            return fallback;
+        var result = string.Empty;
+        var numSelected = boolArray.CountAny(true);
+        switch (numSelected)
+        {
+            case 0:
+                return fallback;
+            case < 2:
+                return GetTranslation(Enum.GetName(typeof(NetworkProfiles),
+                    Array.FindIndex(boolArray, b => b)), false);
+        }
+
+        if (boolArray.All(b => b))
+            return Strings.All;
+            
+        for (var i = 0; i < expectedLength; i++)
+        {
+            if (boolArray[i])
+                result += $", {GetTranslation(Enum.GetName(typeof(NetworkProfiles), i), true)}";
+        }
+
+        return result[2..];
+
+    }
+
+    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
+    {
+        throw new NotImplementedException();
+    }
+
+    private static string GetTranslation(string key, bool trimmed)
+    {
+        return Strings.ResourceManager.GetString(trimmed ? $"{key}_Short3" : key, Strings.Culture);
+    }
+}

Source/NETworkManager.Converters/EmptyToIntMaxValueConverter.cs

@@ -0,0 +1,34 @@
+using System;
+using System.Globalization;
+using System.Windows.Data;
+
+namespace NETworkManager.Converters;
+
+public class EmptyToIntMaxValueConverter : IValueConverter
+{
+    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
+    {
+        const int fallback = int.MaxValue; 
+        if (targetType == typeof(int))
+        {
+            if (value is not string strValue)
+                return fallback;
+            if (string.IsNullOrWhiteSpace(strValue))
+                return fallback;
+            if (!int.TryParse(strValue, out int parsedIntValue))
+                return fallback;
+            return parsedIntValue;
+        }
+
+        if (targetType != typeof(string))
+            return null;
+        if (value is not int intValue)
+            return null;
+        return intValue is fallback ? string.Empty : intValue.ToString();
+    }
+
+    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
+    {
+        return Convert(value, targetType, parameter, culture);
+    }
+}

Source/NETworkManager.Converters/FirewallRuleProgramConverter.cs

@@ -0,0 +1,42 @@
+using System;
+using System.Globalization;
+using System.IO;
+using System.Windows.Data;
+using NETworkManager.Models.Firewall;
+
+namespace NETworkManager.Converters;
+
+/// <summary>
+/// Convert a program reference to a string and vice versa.
+/// </summary>
+public class FirewallRuleProgramConverter : IValueConverter
+{
+    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
+    {
+        if (targetType == typeof(FirewallRuleProgram))
+        {
+            if (value is not string program)
+                return null;
+            if (string.IsNullOrWhiteSpace(program))
+                return null;
+            try
+            {
+                var exe = new FirewallRuleProgram(program);
+                return exe;
+            }
+            catch (FileNotFoundException)
+            {
+                return null;
+            }
+        }
+
+        if (targetType != typeof(string))
+            return null;
+        return value is not FirewallRuleProgram prog ? null : prog.ToString();
+    }
+
+    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
+    {
+        return Convert(value, targetType, parameter, culture);
+    }
+}

Source/NETworkManager.Converters/IntZeroToFalseConverter.cs

@@ -0,0 +1,26 @@
+using System;
+using System.Globalization;
+using System.Windows.Data;
+
+namespace NETworkManager.Converters;
+/// <summary>
+/// Convert a value of 0 to the boolean false.
+/// </summary>
+public class IntZeroToFalseConverter : IValueConverter
+{
+    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
+    {
+        return value switch
+        {
+            null => false,
+            int i => i is not 0,
+            bool boolean => boolean ? 1 : 0,
+            _ => false
+        };
+    }
+
+    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
+    {
+        return Convert(value, targetType, parameter, culture);
+    }
+}

Source/NETworkManager.Converters/NETworkManager.Converters.csproj

@@ -20,6 +20,7 @@
         <Compile Include="..\GlobalAssemblyInfo.cs" Link="Properties\GlobalAssemblyInfo.cs" />
     </ItemGroup>
     <ItemGroup>
+        <ProjectReference Include="..\NETworkManager.Interfaces\NETworkManager.Interfaces.csproj" />
         <ProjectReference Include="..\NETworkManager.Localization\NETworkManager.Localization.csproj" />
         <ProjectReference Include="..\NETworkManager.Models\NETworkManager.Models.csproj" />
         <ProjectReference Include="..\NETworkManager.Profiles\NETworkManager.Profiles.csproj" />

Source/NETworkManager.Converters/PortRangeToPortSpecificationConverter.cs

@@ -0,0 +1,60 @@
+using System;
+using System.Collections.Generic;
+using System.Globalization;
+using System.Linq;
+using System.Windows.Data;
+using NETworkManager.Models.Firewall;
+using NETworkManager.Settings;
+
+namespace NETworkManager.Converters;
+
+/// <summary>
+/// Converts a port range or port to an instance of FirewallPortSpecification. 
+/// </summary>
+public class PortRangeToPortSpecificationConverter : IValueConverter
+{
+    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
+    {
+        char portDelimiter = SettingsManager.Current.Firewall_UseWindowsPortSyntax ? ',' : ';';
+        if (targetType == typeof(List<FirewallPortSpecification>))
+        {
+            if (value is not string input)
+                return null;
+            const char rangeDelimiter = '-';
+            List<FirewallPortSpecification> resultList = [];
+            var portList = input.Split(portDelimiter);
+            foreach (var port in portList)
+            {
+                if (port.Contains(rangeDelimiter))
+                {
+                    var portRange = port.Split(rangeDelimiter);
+                    if (!int.TryParse(portRange[0], out var startPort))
+                        return null;
+                    if (!int.TryParse(portRange[1], out var endPort))
+                        return null;
+                    resultList.Add(new FirewallPortSpecification(startPort, endPort));
+                }
+                else
+                {
+                    if (!int.TryParse(port, out var portNumber))
+                        return null;
+                    resultList.Add(new FirewallPortSpecification(portNumber));
+                }
+            }
+            return resultList;
+        }
+
+        if (targetType != typeof(string))
+            return null;
+        if (value is not List<FirewallPortSpecification> portSpecs)
+            return string.Empty;
+        string result = portSpecs
+            .Aggregate("", (current, portSpecification) => current + $"{portSpecification}{portDelimiter} ");
+        return result.Length > 0 ? result[..^2] : string.Empty;
+    }
+
+    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
+    {
+        return Convert(value, targetType, parameter, culture);
+    }
+}

Source/NETworkManager.Documentation/DocumentationIdentifier.cs

@@ -134,7 +134,12 @@ public enum DocumentationIdentifier
     ///     ARP Table documentation page.
     /// </summary>
     ApplicationArpTable,
-
+    
+    /// <summary>
+    /// Firewall documentation page.
+    /// </summary>
+    ApplicationFirewall,
+    
     /// <summary>
     ///     Settings\General documentation page.
     /// </summary>

Source/NETworkManager.Documentation/DocumentationManager.cs

@@ -1,5 +1,6 @@
 using System.Collections.Generic;
 using System.Linq;
+using System.Reflection.Metadata;
 using System.Windows.Input;
 using NETworkManager.Models;
 using NETworkManager.Settings;
@@ -96,6 +97,9 @@ public static class DocumentationManager
 
         new DocumentationInfo(DocumentationIdentifier.ApplicationArpTable,
             @"docs/application/arp-table"),
+        
+        new DocumentationInfo(DocumentationIdentifier.ApplicationFirewall,
+            @"docs/application/firewall"),
 
         new DocumentationInfo(DocumentationIdentifier.SettingsGeneral,
             @"docs/settings/general"),

Source/NETworkManager.Interfaces/ViewModels/IFirewallRuleViewModel.cs

@@ -0,0 +1,30 @@
+using NETworkManager.Models.Firewall;
+
+namespace NETworkManager.Interfaces.ViewModels;
+
+/// <summary>
+/// Interface to allow converters and validators access to the firewall rule view model,
+/// in this case validating with the other network profile checkboxes.
+/// </summary>
+public interface IFirewallRuleViewModel
+{
+    public bool NetworkProfileDomain { get; }
+    
+    public bool NetworkProfilePrivate { get; }
+    
+    public bool NetworkProfilePublic { get; }
+    
+    public List<FirewallPortSpecification>? LocalPorts { get; }
+    
+    public List<FirewallPortSpecification>? RemotePorts { get; }
+    
+    public FirewallRuleProgram? Program { get; }
+    
+    public int MaxLengthName { get; }
+    
+    public string? UserDefinedName { get; }
+    
+    public bool NameHasError { get; set; }
+    
+    public bool HasError { get; }
+}

Source/NETworkManager.Interfaces/ViewModels/IFirewallViewModel.cs

@@ -0,0 +1,22 @@
+using System.Collections.ObjectModel;
+using System.Windows.Input;
+
+namespace NETworkManager.Interfaces.ViewModels;
+
+public interface IFirewallViewModel
+{
+    public ObservableCollection<IFirewallRuleViewModel> FirewallRulesInterface { get; }
+    
+    public ICommand ExpandAllProfileGroupsCommand { get; }
+    
+    public ICommand CollapseAllProfileGroupsCommand { get; }
+    
+    public int MaxLengthHistory { get; }
+    
+    public static IFirewallViewModel? Instance { get; set; }
+
+    public static void SetInstance(IFirewallViewModel? viewModel)
+    {
+        Instance = viewModel;
+    }
+}