Editing SimTX API v24/Packets/ForwardedClientAddress

{{SimTX API v24 navigation}}
{{SimTX packet v24
| name = ForwardedClientAddress
| id = 11
| hex = 0x0B
| direction = c2s
| session = [[SimTX API v24/Receiver session|Receiver]]
| size = 2 + address length
| permission = <code>proxy.forward_client_ip</code>
| group = receiver
}}
'''ForwardedClientAddress''' lets a trusted proxy, such as a web receiver that relays SimTX to browsers, tell the server the real address of the person it is serving. The server then applies per-IP limits, wideband budgets and bans to that address instead of the proxy's. Ordinary clients never send it.

== Layout ==
{| class="wikitable"
! Field !! Type !! Description
|-
| <code>packetId</code> || <code>u8</code> || Always <code>11</code>.
|-
| <code>address</code> || <code>UTF</code> || Client IP address as text, 1–64 characters after trimming.
|}

== Rules ==
* Only valid on receiver connections (roles 1 and 6), and only as the '''first''' packet after the handshake, before the [[SimTX API v24/Packets/ReceiverSessionRequest|ReceiverSessionRequest]].
* The connection must be authenticated with an account that holds <code>proxy.forward_client_ip</code>. Otherwise the server closes the connection.
* An invalid address, or an address that is banned, closes the connection.
* The connection count limit of 32 per IP address still applies to the proxy's own address.

{{SimTX API v24 navbox}}
[[Category:SimTX API v24]]