Skip to content

Commit aa10763

Browse files
authored
doc(AIP-4114): Add Firewall and IP Address Guidance. (#1482)
1 parent 5209e64 commit aa10763

1 file changed

Lines changed: 14 additions & 0 deletions

File tree

aip/auth/4114.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -130,12 +130,26 @@ the user. The default value **should** be "true" as of May 3, 2024. Users who
130130
wish to disable DCA feature **must** explicitly set this environment variable
131131
to "false".
132132

133+
### Firewall and IP Address Guidance
134+
135+
For any given GCP service, its mTLS endpoint has a different IP address compared
136+
to the non-mTLS endpoint but is expected to fall within the same IP range. The
137+
GCP guidance for IP range management is on a service by service basis. See
138+
[Compute Engine IP Range Documentation][3] for example. In the unlikely event
139+
that an end-user has configured firewall rules based on exact IP addresses
140+
instead of an IP range, they may be impacted by the "auto" mTLS endpoint
141+
upgrade behavior. The best-practice recommendation in this case would be to
142+
avoid adding rules that expect exact IP address matches, and instead use
143+
range-based IP rules following public GCP documentation.
144+
133145
## Changelog
134146

135147
- **2024-11-25*: GOOGLE_API_USE_CLIENT_CERTIFICATE should default to "true" as of May 3, 2024.
148+
- **2025-02-20*: Add Firewall and IP Address Guidance
136149

137150
<!-- prettier-ignore-start -->
138151
[0]: https://google.aip.dev/auth/4110
139152
[1]: https://cloud.google.com/endpoint-verification/docs/overview
140153
[2]: https://cloud.google.com/beyondcorp-enterprise/docs/enable-cba-enterprise-certificates
154+
[3]: https://cloud.google.com/compute/docs/faq#find_ip_range
141155
<!-- prettier-ignore-end -->

0 commit comments

Comments
 (0)