# Reference: server.security

URL: https://scalws.com/docs/reference/server-security/
Source: `docs/reference/schema` in the ScalWS repository

<h3 id="server.security.per_ip"><code>server.security.per_ip</code></h3>

| | |
|---|---|
| Syntax | `per_ip: {...}` |
| Default | `none` |
| Context | `server.security` |
| Reload | adding or removing it needs a restart; its values apply on reload |

Limits per client address (IPv6 clients grouped per /64); absent: no per-client limits.


<h3 id="server.security.per_ip.burst"><code>server.security.per_ip.burst</code></h3>

| | |
|---|---|
| Syntax | `burst: <integer>` |
| Default | `requests_per_second` |
| Context | `server.security.per_ip` |
| Reload | applies on reload |

Requests a client may send at once above the rate; default: the rate itself.


<h3 id="server.security.per_ip.max_connections"><code>server.security.per_ip.max_connections</code></h3>

| | |
|---|---|
| Syntax | `max_connections: <integer>` |
| Default | `none` |
| Context | `server.security.per_ip` |
| Reload | applies on reload |

Open connections allowed per client address.


<h3 id="server.security.per_ip.requests_per_second"><code>server.security.per_ip.requests_per_second</code></h3>

| | |
|---|---|
| Syntax | `requests_per_second: <integer>` |
| Default | `none` |
| Context | `server.security.per_ip` |
| Reload | applies on reload |

Sustained requests per second per client address (429 beyond).


<h3 id="server.security.per_ip.table_size"><code>server.security.per_ip.table_size</code></h3>

| | |
|---|---|
| Syntax | `table_size: <integer>` |
| Default | `65536` |
| Context | `server.security.per_ip` |
| Reload | needs a restart |

Number of addresses tracked at once (bounded memory).