OpenAPI 3.0.3 and 3.1 full support

.gitignore

@@ -258,5 +258,10 @@ $RECYCLE.BIN/
 
 # Windows shortcuts
 *.lnk
+.vscode/launch.json
+Pode.sln
+examples/FileBrowser/wwwFiles/
+examples/PetStore/data/PetData.json
+
 packers/choco/pode.nuspec
 packers/choco/tools/ChocolateyInstall.ps1

docs/Hosting/RunAsService.md

@@ -81,3 +81,55 @@ To stop the service afterwards, you can use the following:
 ```powershell
 sudo systemctl stop pode-server
 ```
+### Using Ports Below 1024
+
+#### Introduction
+
+Traditionally in Linux, binding to ports below 1024 requires root privileges. This is a security measure, as these low-numbered ports are considered privileged. However, running applications as the root user poses significant security risks. This article explores methods to use these privileged ports with PowerShell (`pwsh`) in Linux, without running it as the root user.
+There are different methods to achieve the goals.
+Reverse Proxy is the right approach for a production environment, primarily if the server is connected directly to the internet.
+The other solutions are reasonable after an in-depth risk analysis.
+
+#### Using a Reverse Proxy
+
+A reverse proxy like Nginx can listen on the privileged port and forward requests to your application running on an unprivileged port.
+
+**Configuration:**
+
+* Configure Nginx to listen on port 443 and forward requests to the port where your PowerShell script is listening.
+* This method is widely used in web applications for its additional benefits like load balancing and SSL termination.
+
+#### iptables Redirection
+
+Using iptables, you can redirect traffic from a privileged port to a higher, unprivileged port.
+
+**Implementation:**
+  * Set up an iptables rule to redirect traffic from, say, port 443 to a higher port where your PowerShell script is listening.
+
+  * `sudo iptables -t nat -A PREROUTING -p tcp --dport 443 -j REDIRECT --to-port 8080`
+
+**Benefits:**
+  * This approach doesn't require changing the privileges of the PowerShell executable or script.
+
+#### Using `setcap` Command
+
+The `setcap` utility can grant specific capabilities to an executable, like `pwsh`, enabling it to bind to privileged ports.
+
+**How it Works:**
+  * Run `sudo setcap 'cap_net_bind_service=+ep' $(which pwsh)`. This command sets the `CAP_NET_BIND_SERVICE` capability on the PowerShell executable, allowing it to bind to any port below 1024.
+
+**Security Consideration:**
+  * This method enhances security by avoiding running PowerShell as root, but it still grants significant privileges to the PowerShell process.
+
+#### Utilizing Authbind
+
+Authbind is a tool that allows a non-root user to bind to privileged ports.
+
+**Setup:**
+  * Install Authbind, configure it to allow the desired port, and then start your PowerShell script using Authbind.
+  * For instance, `authbind --deep pwsh yourscript.ps1` allows the script to bind to a privileged port.
+
+**Advantages:**
+  * It provides a finer-grained control over port access and doesn't require setting special capabilities on the PowerShell binary itself.
+
+

docs/Tutorials/Configuration.md

@@ -68,18 +68,19 @@ A "path" like `Server.Ssl.Protocols` looks like the below in the file:
 }
 ```
 
-| Path                           | Description                                                             | Docs                                       |
-| ------------------------------ | ----------------------------------------------------------------------- | ------------------------------------------ |
-| Server.Ssl.Protocols           | Indicates the SSL Protocols that should be used                         | [link](../Certificates)                    |
-| Server.Request                 | Defines request timeout and maximum body size                           | [link](../RequestLimits)                   |
-| Server.AutoImport              | Defines the AutoImport scoping rules for Modules, SnapIns and Functions | [link](../Scoping)                         |
-| Server.Logging                 | Defines extra configuration for Logging, like masking sensitive data    | [link](../Logging/Overview)                |
-| Server.Root                    | Overrides root path of the server                                       | [link](../Misc/ServerRoot)                 |
-| Server.Restart                 | Defines configuration for automatically restarting the server           | [link](../Restarting/Types/AutoRestarting) |
-| Server.FileMonitor             | Defines configuration for restarting the server based on file updates   | [link](../Restarting/Types/FileMonitoring) |
-| Web.Static.ValidateLast | Changes the way routes are processed.                                   | [link](../Routes/Utilities/StaticContent)  |
-| Web.TransferEncoding           | Sets the Request TransferEncoding                                       | [link](../Compression/Requests)            |
-| Web.Compression                | Sets any compression to use on the Response                             | [link](../Compression/Responses)           |
-| Web.ContentType                | Define expected Content Types for certain Routes                        | [link](../Routes/Utilities/ContentTypes)   |
-| Web.ErrorPages                 | Defines configuration for custom error pages                            | [link](../Routes/Utilities/ErrorPages)     |
-| Web.Static                     | Defines configuration for static content, such as caching               | [link](../Routes/Utilities/StaticContent)  |
+| Path                             | Description                                                             | Docs                                       |
+| -------------------------------- | ----------------------------------------------------------------------- | ------------------------------------------ |
+| Server.Ssl.Protocols             | Indicates the SSL Protocols that should be used                         | [link](../Certificates)                    |
+| Server.Request                   | Defines request timeout and maximum body size                           | [link](../RequestLimits)                   |
+| Server.AutoImport                | Defines the AutoImport scoping rules for Modules, SnapIns and Functions | [link](../Scoping)                         |
+| Server.Logging                   | Defines extra configuration for Logging, like masking sensitive data    | [link](../Logging/Overview)                |
+| Server.Root                      | Overrides root path of the server                                       | [link](../Misc/ServerRoot)                 |
+| Server.Restart                   | Defines configuration for automatically restarting the server           | [link](../Restarting/Types/AutoRestarting) |
+| Server.FileMonitor               | Defines configuration for restarting the server based on file updates   | [link](../Restarting/Types/FileMonitoring) |
+| Web.OpenApi.DefaultDefinitionTag | Define the primary tag name for OpenAPI ( 'default' is the default)     | [link](../OpenAPI/OpenAPI)                 |
+| Web.Static.ValidateLast          | Changes the way routes are processed.                                   | [link](../Routes/Utilities/StaticContent)  |
+| Web.TransferEncoding             | Sets the Request TransferEncoding                                       | [link](../Compression/Requests)            |
+| Web.Compression                  | Sets any compression to use on the Response                             | [link](../Compression/Responses)           |
+| Web.ContentType                  | Define expected Content Types for certain Routes                        | [link](../Routes/Utilities/ContentTypes)   |
+| Web.ErrorPages                   | Defines configuration for custom error pages                            | [link](../Routes/Utilities/ErrorPages)     |
+| Web.Static                       | Defines configuration for static content, such as caching               | [link](../Routes/Utilities/StaticContent)  |