diff --git a/docs/config_dnat.md b/docs/config_dnat.md index bdb736eb20..664e5a51d0 100644 --- a/docs/config_dnat.md +++ b/docs/config_dnat.md @@ -67,6 +67,7 @@ Dynamic Source NAT is configured from the network-interface using the following - [`local-ip`](config_command_guide.md#configure-authority-router-node-device-interface-network-interface-dynamic-source-nat-local-ip): For packets ingressing this interface, the IP that is source NAT'ed to the `remote-ip`. - [`remote-ip`](config_command_guide.md#configure-authority-router-node-device-interface-network-interface-dynamic-source-nat-remote-ip): For packets ingressing this interface, the IP where the `local-ip` will be source NAT'ed. `remote-ip` must use the /32 prefix. +- [`applies-to-local-breakout`](config_command_guide.md#configure-authority-router-node-device-interface-network-interface-dynamic-source-nat-applies-to-local-breakout): Whether the dynamic source NAT applies to local breakout sessions. Default is `false`. Set to `true` when IDP is enabled on traffic that also requires Dynamic Source NAT — IDP processes traffic as local breakout sessions, so without this flag the NAT rules are not applied to that traffic. ## Show Commands diff --git a/docs/ts_idp.md b/docs/ts_idp.md index c9f50f262b..7ac4a72417 100644 --- a/docs/ts_idp.md +++ b/docs/ts_idp.md @@ -59,6 +59,18 @@ Beginning with SSR version 6.1.4-R2, traffic destined for IDP will temporarily b Additionally, services configured for IDP and their status (passing through IDP or not, and why), and when the IDP will be operational are reported in the `show idp application status` command. +## IDP and Dynamic Source NAT + +When IDP is enabled on a service that also uses [`dynamic-source-nat`](config_dnat.md), traffic processed by IDP may not be source-NATed as expected. IDP processes traffic as local breakout sessions, and by default `dynamic-source-nat` does not apply to local breakout sessions (`applies-to-local-breakout` defaults to `false`). + +To apply source NAT in scenarios where IDP is also required, set `applies-to-local-breakout true` on the `dynamic-source-nat` configuration for each node: + +```text +config authority router node device-interface network-interface dynamic-source-nat 0.0.0.0/0 local-ip 0.0.0.0/0 +config authority router node device-interface network-interface dynamic-source-nat 0.0.0.0/0 remote-ip /32 +config authority router node device-interface network-interface dynamic-source-nat 0.0.0.0/0 applies-to-local-breakout true +``` + ## Show Commands Each of the commands listed below, and the subcommands for each, provide additional details for IDP visibility. Use the links to learn more about each command.