Skip to content

Commit 00f057d

Browse files
scotthartscotthart
authored
feat(networksecurity): update library (#16122)
1 parent a393a27 commit 00f057d

270 files changed

Lines changed: 88722 additions & 15 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎CHANGELOG.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,10 @@ the APIs in these libraries are stable, and are ready for production use.
1616

1717
- [Data Analytics API with Gemini](/google/cloud/geminidataanalytics/README.md)
1818

19+
### Updated Libraries
20+
21+
- [Network Security API] has been updated with several additional services ([#16122](https://github.com/googleapis/google-cloud-cpp/pull/16122))
22+
1923
## v3.5.0 - 2026-05
2024

2125
### [Bigtable](/google/cloud/bigtable/README.md)

‎ci/abi-dumps/google_cloud_cpp_networksecurity.expected.abi.dump.gz‎

2.14 MB
Binary file not shown.

‎generator/generator_config.textproto‎

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3113,6 +3113,62 @@ service {
31133113
retryable_status_codes: ["kUnavailable"]
31143114
}
31153115
3116+
service {
3117+
service_proto_path: "google/cloud/networksecurity/v1/dns_threat_detector.proto"
3118+
additional_proto_files: ["google/cloud/networksecurity/v1/common.proto"]
3119+
product_path: "google/cloud/networksecurity/v1"
3120+
initial_copyright_year: "2026"
3121+
retryable_status_codes: ["kUnavailable"]
3122+
}
3123+
3124+
service {
3125+
service_proto_path: "google/cloud/networksecurity/v1/sse_realm.proto"
3126+
additional_proto_files: ["google/cloud/networksecurity/v1/common.proto"]
3127+
product_path: "google/cloud/networksecurity/v1"
3128+
initial_copyright_year: "2026"
3129+
retryable_status_codes: ["kUnavailable"]
3130+
}
3131+
3132+
service {
3133+
service_proto_path: "google/cloud/networksecurity/v1/firewall_activation.proto"
3134+
additional_proto_files: ["google/cloud/networksecurity/v1/common.proto"]
3135+
product_path: "google/cloud/networksecurity/v1"
3136+
initial_copyright_year: "2026"
3137+
retryable_status_codes: ["kUnavailable"]
3138+
}
3139+
3140+
service {
3141+
service_proto_path: "google/cloud/networksecurity/v1/intercept.proto"
3142+
additional_proto_files: ["google/cloud/networksecurity/v1/common.proto"]
3143+
product_path: "google/cloud/networksecurity/v1"
3144+
initial_copyright_year: "2026"
3145+
retryable_status_codes: ["kUnavailable"]
3146+
}
3147+
3148+
service {
3149+
service_proto_path: "google/cloud/networksecurity/v1/address_group.proto"
3150+
additional_proto_files: ["google/cloud/networksecurity/v1/common.proto"]
3151+
product_path: "google/cloud/networksecurity/v1"
3152+
initial_copyright_year: "2026"
3153+
retryable_status_codes: ["kUnavailable"]
3154+
}
3155+
3156+
service {
3157+
service_proto_path: "google/cloud/networksecurity/v1/security_profile_group_service.proto"
3158+
additional_proto_files: ["google/cloud/networksecurity/v1/common.proto"]
3159+
product_path: "google/cloud/networksecurity/v1"
3160+
initial_copyright_year: "2026"
3161+
retryable_status_codes: ["kUnavailable"]
3162+
}
3163+
3164+
service {
3165+
service_proto_path: "google/cloud/networksecurity/v1/mirroring.proto"
3166+
additional_proto_files: ["google/cloud/networksecurity/v1/common.proto"]
3167+
product_path: "google/cloud/networksecurity/v1"
3168+
initial_copyright_year: "2026"
3169+
retryable_status_codes: ["kUnavailable"]
3170+
}
3171+
31163172
# Network Services (aka Traffic Director)
31173173
service {
31183174
service_proto_path: "google/cloud/networkservices/v1/network_services.proto"

‎google/cloud/networksecurity/doc/environment-variables.dox‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,10 +9,46 @@ environment variables are convenient when troubleshooting problems.
99

1010
<!-- inject-endpoint-env-vars-start -->
1111

12+
- `GOOGLE_CLOUD_CPP_ADDRESS_GROUP_SERVICE_ENDPOINT=...` overrides the
13+
`EndpointOption` (which defaults to "networksecurity.googleapis.com")
14+
used by `MakeAddressGroupServiceConnection()`.
15+
16+
- `GOOGLE_CLOUD_CPP_DNS_THREAT_DETECTOR_SERVICE_ENDPOINT=...` overrides the
17+
`EndpointOption` (which defaults to "networksecurity.googleapis.com")
18+
used by `MakeDnsThreatDetectorServiceConnection()`.
19+
20+
- `GOOGLE_CLOUD_CPP_FIREWALL_ACTIVATION_ENDPOINT=...` overrides the
21+
`EndpointOption` (which defaults to "networksecurity.googleapis.com")
22+
used by `MakeFirewallActivationConnection()`.
23+
24+
- `GOOGLE_CLOUD_CPP_INTERCEPT_ENDPOINT=...` overrides the
25+
`EndpointOption` (which defaults to "networksecurity.googleapis.com")
26+
used by `MakeInterceptConnection()`.
27+
28+
- `GOOGLE_CLOUD_CPP_MIRRORING_ENDPOINT=...` overrides the
29+
`EndpointOption` (which defaults to "networksecurity.googleapis.com")
30+
used by `MakeMirroringConnection()`.
31+
1232
- `GOOGLE_CLOUD_CPP_NETWORK_SECURITY_ENDPOINT=...` overrides the
1333
`EndpointOption` (which defaults to "networksecurity.googleapis.com")
1434
used by `MakeNetworkSecurityConnection()`.
1535

36+
- `GOOGLE_CLOUD_CPP_ORGANIZATION_ADDRESS_GROUP_SERVICE_ENDPOINT=...` overrides the
37+
`EndpointOption` (which defaults to "networksecurity.googleapis.com")
38+
used by `MakeOrganizationAddressGroupServiceConnection()`.
39+
40+
- `GOOGLE_CLOUD_CPP_ORGANIZATION_SECURITY_PROFILE_GROUP_SERVICE_ENDPOINT=...` overrides the
41+
`EndpointOption` (which defaults to "networksecurity.googleapis.com")
42+
used by `MakeOrganizationSecurityProfileGroupServiceConnection()`.
43+
44+
- `GOOGLE_CLOUD_CPP_SECURITY_PROFILE_GROUP_SERVICE_ENDPOINT=...` overrides the
45+
`EndpointOption` (which defaults to "networksecurity.googleapis.com")
46+
used by `MakeSecurityProfileGroupServiceConnection()`.
47+
48+
- `GOOGLE_CLOUD_CPP_SSE_REALM_SERVICE_ENDPOINT=...` overrides the
49+
`EndpointOption` (which defaults to "networksecurity.googleapis.com")
50+
used by `MakeSSERealmServiceConnection()`.
51+
1652
<!-- inject-endpoint-env-vars-end -->
1753

1854
@see google::cloud::EndpointOption

‎google/cloud/networksecurity/doc/main.dox‎

Lines changed: 19 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -22,12 +22,26 @@ which should give you a taste of the Network Security API C++ client library API
2222
## Main classes
2323

2424
<!-- inject-client-list-start -->
25-
The main class in this library is
26-
[`networksecurity_v1::NetworkSecurityClient`](@ref google::cloud::networksecurity_v1::NetworkSecurityClient). All RPCs are exposed
27-
as member functions of this class. Other classes provide helpers, configuration
28-
parameters, and infrastructure to mock
29-
[`networksecurity_v1::NetworkSecurityClient`](@ref google::cloud::networksecurity_v1::NetworkSecurityClient) when testing your
25+
This library offers multiple `*Client` classes, which are listed below. Each one
26+
of these classes exposes all the RPCs for a service as member functions of the
27+
class. This library groups multiple services because they are part of the same
28+
product or are often used together. A typical example may be the administrative
29+
and data plane operations for a single product.
30+
31+
The library also has other classes that provide helpers, configuration
32+
parameters, and infrastructure to mock the `*Client` classes when testing your
3033
application.
34+
35+
- [\c networksecurity_v1::AddressGroupServiceClient](@ref google::cloud::networksecurity_v1::AddressGroupServiceClient)
36+
- [\c networksecurity_v1::DnsThreatDetectorServiceClient](@ref google::cloud::networksecurity_v1::DnsThreatDetectorServiceClient)
37+
- [\c networksecurity_v1::FirewallActivationClient](@ref google::cloud::networksecurity_v1::FirewallActivationClient)
38+
- [\c networksecurity_v1::InterceptClient](@ref google::cloud::networksecurity_v1::InterceptClient)
39+
- [\c networksecurity_v1::MirroringClient](@ref google::cloud::networksecurity_v1::MirroringClient)
40+
- [\c networksecurity_v1::NetworkSecurityClient](@ref google::cloud::networksecurity_v1::NetworkSecurityClient)
41+
- [\c networksecurity_v1::OrganizationAddressGroupServiceClient](@ref google::cloud::networksecurity_v1::OrganizationAddressGroupServiceClient)
42+
- [\c networksecurity_v1::OrganizationSecurityProfileGroupServiceClient](@ref google::cloud::networksecurity_v1::OrganizationSecurityProfileGroupServiceClient)
43+
- [\c networksecurity_v1::SecurityProfileGroupServiceClient](@ref google::cloud::networksecurity_v1::SecurityProfileGroupServiceClient)
44+
- [\c networksecurity_v1::SSERealmServiceClient](@ref google::cloud::networksecurity_v1::SSERealmServiceClient)
3145
<!-- inject-client-list-end -->
3246

3347
## More Information

‎google/cloud/networksecurity/doc/override-authentication.dox‎

Lines changed: 68 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,20 @@ this default. You can do so by providing the
99
The following example shows how to explicitly load a service account key file:
1010

1111
<!-- inject-service-account-snippet-start -->
12-
@snippet network_security_client_samples.cc with-service-account
12+
@snippet address_group_client_samples.cc with-service-account
13+
14+
Follow these links to find examples for other \c *Client classes:
15+
16+
- [\c networksecurity_v1::AddressGroupServiceClient](@ref networksecurity_v1::AddressGroupServiceClient-service-account-snippet)
17+
- [\c networksecurity_v1::DnsThreatDetectorServiceClient](@ref networksecurity_v1::DnsThreatDetectorServiceClient-service-account-snippet)
18+
- [\c networksecurity_v1::FirewallActivationClient](@ref networksecurity_v1::FirewallActivationClient-service-account-snippet)
19+
- [\c networksecurity_v1::InterceptClient](@ref networksecurity_v1::InterceptClient-service-account-snippet)
20+
- [\c networksecurity_v1::MirroringClient](@ref networksecurity_v1::MirroringClient-service-account-snippet)
21+
- [\c networksecurity_v1::NetworkSecurityClient](@ref networksecurity_v1::NetworkSecurityClient-service-account-snippet)
22+
- [\c networksecurity_v1::OrganizationAddressGroupServiceClient](@ref networksecurity_v1::OrganizationAddressGroupServiceClient-service-account-snippet)
23+
- [\c networksecurity_v1::OrganizationSecurityProfileGroupServiceClient](@ref networksecurity_v1::OrganizationSecurityProfileGroupServiceClient-service-account-snippet)
24+
- [\c networksecurity_v1::SecurityProfileGroupServiceClient](@ref networksecurity_v1::SecurityProfileGroupServiceClient-service-account-snippet)
25+
- [\c networksecurity_v1::SSERealmServiceClient](@ref networksecurity_v1::SSERealmServiceClient-service-account-snippet)
1326

1427
<!-- inject-service-account-snippet-end -->
1528

@@ -27,9 +40,63 @@ guide for more details.
2740

2841
// <!-- inject-authentication-pages-start -->
2942

43+
/*! @page networksecurity_v1::AddressGroupServiceClient-service-account-snippet Override networksecurity_v1::AddressGroupServiceClient Authentication Defaults
44+
45+
@snippet google/cloud/networksecurity/v1/samples/address_group_client_samples.cc with-service-account
46+
47+
*/
48+
49+
/*! @page networksecurity_v1::DnsThreatDetectorServiceClient-service-account-snippet Override networksecurity_v1::DnsThreatDetectorServiceClient Authentication Defaults
50+
51+
@snippet google/cloud/networksecurity/v1/samples/dns_threat_detector_client_samples.cc with-service-account
52+
53+
*/
54+
55+
/*! @page networksecurity_v1::FirewallActivationClient-service-account-snippet Override networksecurity_v1::FirewallActivationClient Authentication Defaults
56+
57+
@snippet google/cloud/networksecurity/v1/samples/firewall_activation_client_samples.cc with-service-account
58+
59+
*/
60+
61+
/*! @page networksecurity_v1::InterceptClient-service-account-snippet Override networksecurity_v1::InterceptClient Authentication Defaults
62+
63+
@snippet google/cloud/networksecurity/v1/samples/intercept_client_samples.cc with-service-account
64+
65+
*/
66+
67+
/*! @page networksecurity_v1::MirroringClient-service-account-snippet Override networksecurity_v1::MirroringClient Authentication Defaults
68+
69+
@snippet google/cloud/networksecurity/v1/samples/mirroring_client_samples.cc with-service-account
70+
71+
*/
72+
3073
/*! @page networksecurity_v1::NetworkSecurityClient-service-account-snippet Override networksecurity_v1::NetworkSecurityClient Authentication Defaults
3174

3275
@snippet google/cloud/networksecurity/v1/samples/network_security_client_samples.cc with-service-account
3376

77+
*/
78+
79+
/*! @page networksecurity_v1::OrganizationAddressGroupServiceClient-service-account-snippet Override networksecurity_v1::OrganizationAddressGroupServiceClient Authentication Defaults
80+
81+
@snippet google/cloud/networksecurity/v1/samples/organization_address_group_client_samples.cc with-service-account
82+
83+
*/
84+
85+
/*! @page networksecurity_v1::OrganizationSecurityProfileGroupServiceClient-service-account-snippet Override networksecurity_v1::OrganizationSecurityProfileGroupServiceClient Authentication Defaults
86+
87+
@snippet google/cloud/networksecurity/v1/samples/organization_security_profile_group_client_samples.cc with-service-account
88+
89+
*/
90+
91+
/*! @page networksecurity_v1::SecurityProfileGroupServiceClient-service-account-snippet Override networksecurity_v1::SecurityProfileGroupServiceClient Authentication Defaults
92+
93+
@snippet google/cloud/networksecurity/v1/samples/security_profile_group_client_samples.cc with-service-account
94+
95+
*/
96+
97+
/*! @page networksecurity_v1::SSERealmServiceClient-service-account-snippet Override networksecurity_v1::SSERealmServiceClient Authentication Defaults
98+
99+
@snippet google/cloud/networksecurity/v1/samples/sse_realm_client_samples.cc with-service-account
100+
34101
*/
35102
// <!-- inject-authentication-pages-end -->

‎google/cloud/networksecurity/doc/override-endpoint.dox‎

Lines changed: 69 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,19 +7,86 @@ library. Use the
77
client library to change this default.
88

99
<!-- inject-endpoint-snippet-start -->
10-
For example, this will override the default endpoint for `networksecurity_v1::NetworkSecurityClient`:
10+
For example, this will override the default endpoint for `networksecurity_v1::AddressGroupServiceClient`:
1111

12-
@snippet network_security_client_samples.cc set-client-endpoint
12+
@snippet address_group_client_samples.cc set-client-endpoint
13+
14+
Follow these links to find examples for other \c *Client classes:
15+
16+
- [\c networksecurity_v1::AddressGroupServiceClient](@ref networksecurity_v1::AddressGroupServiceClient-endpoint-snippet)
17+
- [\c networksecurity_v1::DnsThreatDetectorServiceClient](@ref networksecurity_v1::DnsThreatDetectorServiceClient-endpoint-snippet)
18+
- [\c networksecurity_v1::FirewallActivationClient](@ref networksecurity_v1::FirewallActivationClient-endpoint-snippet)
19+
- [\c networksecurity_v1::InterceptClient](@ref networksecurity_v1::InterceptClient-endpoint-snippet)
20+
- [\c networksecurity_v1::MirroringClient](@ref networksecurity_v1::MirroringClient-endpoint-snippet)
21+
- [\c networksecurity_v1::NetworkSecurityClient](@ref networksecurity_v1::NetworkSecurityClient-endpoint-snippet)
22+
- [\c networksecurity_v1::OrganizationAddressGroupServiceClient](@ref networksecurity_v1::OrganizationAddressGroupServiceClient-endpoint-snippet)
23+
- [\c networksecurity_v1::OrganizationSecurityProfileGroupServiceClient](@ref networksecurity_v1::OrganizationSecurityProfileGroupServiceClient-endpoint-snippet)
24+
- [\c networksecurity_v1::SecurityProfileGroupServiceClient](@ref networksecurity_v1::SecurityProfileGroupServiceClient-endpoint-snippet)
25+
- [\c networksecurity_v1::SSERealmServiceClient](@ref networksecurity_v1::SSERealmServiceClient-endpoint-snippet)
1326

1427
<!-- inject-endpoint-snippet-end -->
1528

1629
*/
1730

1831
// <!-- inject-endpoint-pages-start -->
1932

33+
/*! @page networksecurity_v1::AddressGroupServiceClient-endpoint-snippet Override networksecurity_v1::AddressGroupServiceClient Endpoint Configuration
34+
35+
@snippet google/cloud/networksecurity/v1/samples/address_group_client_samples.cc set-client-endpoint
36+
37+
*/
38+
39+
/*! @page networksecurity_v1::DnsThreatDetectorServiceClient-endpoint-snippet Override networksecurity_v1::DnsThreatDetectorServiceClient Endpoint Configuration
40+
41+
@snippet google/cloud/networksecurity/v1/samples/dns_threat_detector_client_samples.cc set-client-endpoint
42+
43+
*/
44+
45+
/*! @page networksecurity_v1::FirewallActivationClient-endpoint-snippet Override networksecurity_v1::FirewallActivationClient Endpoint Configuration
46+
47+
@snippet google/cloud/networksecurity/v1/samples/firewall_activation_client_samples.cc set-client-endpoint
48+
49+
*/
50+
51+
/*! @page networksecurity_v1::InterceptClient-endpoint-snippet Override networksecurity_v1::InterceptClient Endpoint Configuration
52+
53+
@snippet google/cloud/networksecurity/v1/samples/intercept_client_samples.cc set-client-endpoint
54+
55+
*/
56+
57+
/*! @page networksecurity_v1::MirroringClient-endpoint-snippet Override networksecurity_v1::MirroringClient Endpoint Configuration
58+
59+
@snippet google/cloud/networksecurity/v1/samples/mirroring_client_samples.cc set-client-endpoint
60+
61+
*/
62+
2063
/*! @page networksecurity_v1::NetworkSecurityClient-endpoint-snippet Override networksecurity_v1::NetworkSecurityClient Endpoint Configuration
2164

2265
@snippet google/cloud/networksecurity/v1/samples/network_security_client_samples.cc set-client-endpoint
2366

67+
*/
68+
69+
/*! @page networksecurity_v1::OrganizationAddressGroupServiceClient-endpoint-snippet Override networksecurity_v1::OrganizationAddressGroupServiceClient Endpoint Configuration
70+
71+
@snippet google/cloud/networksecurity/v1/samples/organization_address_group_client_samples.cc set-client-endpoint
72+
73+
*/
74+
75+
/*! @page networksecurity_v1::OrganizationSecurityProfileGroupServiceClient-endpoint-snippet Override networksecurity_v1::OrganizationSecurityProfileGroupServiceClient Endpoint Configuration
76+
77+
@snippet google/cloud/networksecurity/v1/samples/organization_security_profile_group_client_samples.cc set-client-endpoint
78+
79+
*/
80+
81+
/*! @page networksecurity_v1::SecurityProfileGroupServiceClient-endpoint-snippet Override networksecurity_v1::SecurityProfileGroupServiceClient Endpoint Configuration
82+
83+
@snippet google/cloud/networksecurity/v1/samples/security_profile_group_client_samples.cc set-client-endpoint
84+
85+
*/
86+
87+
/*! @page networksecurity_v1::SSERealmServiceClient-endpoint-snippet Override networksecurity_v1::SSERealmServiceClient Endpoint Configuration
88+
89+
@snippet google/cloud/networksecurity/v1/samples/sse_realm_client_samples.cc set-client-endpoint
90+
2491
*/
2592
// <!-- inject-endpoint-pages-end -->

0 commit comments

Comments
 (0)