Security
The host's Security tab is where you configure how incoming web traffic is protected. This page covers the practical configuration steps. For how the underlying protections work, see the Security overview.
Note
Security settings can also be applied at the group level and inherited by every host in the group. See Groups.
The tab has a menu on the left with three panes. Select one to configure it:
TurboShield - traffic filtering, bot controls and attack detectionFirewall - the IP allow-list, GeoIP filtering and the open portsWeb Application Firewall - block requests matching known attack patterns
TurboShield
TurboShield protects your applications against malicious web traffic and Distributed Denial of Service (DDoS) attacks - attempts to overwhelm your site with so many requests that it goes offline. It applies rate limits, a cap on how many requests one visitor can make. It adds bot controls, which tell good automated visitors from bad ones. It also detects attack behavior and temporarily bans the source. You can enable or disable it per host and choose a protection level. For everything it does and every setting, see What is TurboShield? and Configure TurboShield.
Throttled visitors receive a soft 429 (Too Many Requests) response rather than being banned at the firewall, so legitimate traffic recovers automatically once it slows down. This matters for you because it means search engines and real customers are not locked out when traffic spikes. Bans, which only follow clear attack behavior, always expire on their own.
To configure TurboShield:
- Open the host's Security tab and select TurboShield.
- Enable TurboShield.
- Select a protection level. The default is
medium. - Save your changes.
Tip
Start with medium and only raise the level if you observe abusive traffic. Switch to attack temporarily while an attack is in progress, then return to your normal level.
For details on how TurboShield evaluates traffic, see the Security overview.
Firewall
The Firewall pane holds everything about which networks and ports reach the server. It contains the IP allow-list and GeoIP filtering, with the port lists behind Advanced Settings.
TurboStack manages the firewall for you: the ports your applications need are opened automatically when you publish, and the monitoring and management addresses it needs are always allowed. You only change something here when you have a reason to.
IP allow-list
The IP allow-list (firewall_whitelist) lets you define trusted Internet Protocol (IP) addresses, and ranges of them, that bypass rate-limiting and blocking. An IP address is the network address of a device or office, such as 203.0.113.10. A range is written in Classless Inter-Domain Routing (CIDR) notation, such as 203.0.113.0/24, which means a block of addresses. This is useful for office networks, monitoring services, and integration partners that should never be throttled or blocked.
A trusted IP is also allowed through the host firewall, so it can reach ports that are otherwise closed to the public.
- Open the host's Security tab and select Firewall.
- Add each trusted IP address or CIDR range to the
firewall_whitelist. - Save your changes.
Warning
Validate every source before adding it. Wide ranges grant unrestricted access and can expose your host to abuse. Add the narrowest range that meets your need.
GeoIP filtering
GeoIP filtering lets you allow or block web traffic based on the visitor's country.
Warning
Country-based filtering carries a high risk of false positives. Visitors using VPNs, mobile networks, or proxies may be misidentified by country. Test carefully before relying on GeoIP rules in production.
Open ports
Advanced Settings in the Firewall pane holds the two port lists. Both show
Default (Auto Managed) until you set them, which means TurboStack decides which ports to open from
the services the host runs.
Set these only to open a port for a service of your own that TurboStack does not know about. Setting a list replaces the automatic one, so it must include every port you still need.
Warning
TurboStack recommends leaving both lists on their auto-managed defaults. Restricting the ports by
hand can break the server in ways that are hard to trace, because a service that needs a port it
no longer has simply fails. If you do set a list, keep it as small as your own service requires,
and prefer restricting who may reach that port with the
Trusted proxies and CDNs
When a content delivery network (CDN) or reverse proxy sits in front of the server, requests arrive
from the proxy rather than the visitor. Cloudflare and Akamai are recognised automatically. For your own proxy, list its
addresses in remote_trusted_proxies so the real visitor address is restored in the logs and the
security rules, and the proxy itself is not blocked.
Note
remote_trusted_proxies has no field on the Security tab yet. Set it in the
Source (YAML) view or over the API. See
the security parameters.
Web Application Firewall
The Web Application Firewall (WAF) inspects each incoming web request against a managed set of rules and blocks ones that match known attack patterns. TurboStack uses Imunify for this, which also scans the files on the host for malware. It works at the application layer, which is layer 7 of the Open Systems Interconnection (OSI) network model, so it can inspect the content of a request. This is a deeper level than the network firewall, which filters traffic at the network layer (layer 3). Working at layer 7 lets the WAF stop application-level attacks from the OWASP Top 10. That is the Open Worldwide Application Security Project's industry list of the most common web application risks. The two most common patterns it stops are:
- SQL injection - an attacker tries to smuggle database commands through a form or URL to read or change your data.
- Cross-site scripting (XSS) - an attacker tries to inject malicious code into your pages so it runs in your visitors' browsers.
The WAF also applies virtual patches. A virtual patch closes a known, exploited vulnerability at the firewall before the application itself is patched. This means a newly disclosed leak can be blocked immediately, instead of waiting for an application update.
You do not write these rules yourself; TurboStack maintains them. You choose whether the WAF is on and where it sends alerts.
- Open the host's Security tab and select Web Application Firewall.
- Enable the Web Application Firewall.
- Enter a notification email address. TurboStack sends WAF security alerts, such as malware detections, to this address.
- Save your changes.
Tip
Keep the WAF enabled. If a rule ever blocks a legitimate request in your application (a false positive), contact support to adjust it rather than turning the whole WAF off.
Related
- Security overview
- Security parameters (YAML)
- Groups - apply these settings to many hosts at once
- Advanced settings
- Threat Center - the findings, rather than the configuration
- SSH access