An idiomatic C++ client library for theNetwork Security API, a cloud first service that helps you secure egress web traffic (HTTP/S).
While this library isGA, please note that the Google Cloud C++ client libraries donotfollowSemantic Versioning.
Quickstart
The following shows the code that you'll run in thegoogle/cloud/networksecurity/quickstart/directory, which should give you a taste of the Network Security API C++ client library API.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003eThe latest release candidate for the Network Security API C++ Client Library is version 2.37.0-rc, with a list of previous versions ranging from 2.36.0 down to 2.13.0 also available.\u003c/p\u003e\n"],["\u003cp\u003eThis library provides an idiomatic C++ interface for the Network Security API, which focuses on securing egress web traffic, specifically HTTP/S.\u003c/p\u003e\n"],["\u003cp\u003eThe primary class within the library is \u003ccode\u003enetworksecurity_v1::NetworkSecurityClient\u003c/code\u003e, which exposes all Remote Procedure Calls (RPCs) as its member functions, accompanied by helper classes for configuration and testing.\u003c/p\u003e\n"],["\u003cp\u003eThe library does not follow Semantic Versioning, although it is in General Availability (GA) and there is an example of how to use it in the quickstart section of the documentation.\u003c/p\u003e\n"],["\u003cp\u003eSeveral override options are available, including default endpoint, authentication credentials, and retry policies, along with error handling information and how to configure via environment variables.\u003c/p\u003e\n"]]],[],null,["Version 2.13.0keyboard_arrow_down\n\n- [2.42.0-rc (latest)](/cpp/docs/reference/networksecurity/latest)\n- [2.41.0](/cpp/docs/reference/networksecurity/2.41.0)\n- [2.40.0](/cpp/docs/reference/networksecurity/2.40.0)\n- [2.39.0](/cpp/docs/reference/networksecurity/2.39.0)\n- [2.38.0](/cpp/docs/reference/networksecurity/2.38.0)\n- [2.37.0](/cpp/docs/reference/networksecurity/2.37.0)\n- [2.36.0](/cpp/docs/reference/networksecurity/2.36.0)\n- [2.35.0](/cpp/docs/reference/networksecurity/2.35.0)\n- [2.34.0](/cpp/docs/reference/networksecurity/2.34.0)\n- [2.33.0](/cpp/docs/reference/networksecurity/2.33.0)\n- [2.32.0](/cpp/docs/reference/networksecurity/2.32.0)\n- [2.31.0](/cpp/docs/reference/networksecurity/2.31.0)\n- [2.30.0](/cpp/docs/reference/networksecurity/2.30.0)\n- [2.29.0](/cpp/docs/reference/networksecurity/2.29.0)\n- [2.28.0](/cpp/docs/reference/networksecurity/2.28.0)\n- [2.27.0](/cpp/docs/reference/networksecurity/2.27.0)\n- [2.26.0](/cpp/docs/reference/networksecurity/2.26.0)\n- [2.25.1](/cpp/docs/reference/networksecurity/2.25.1)\n- [2.24.0](/cpp/docs/reference/networksecurity/2.24.0)\n- [2.23.0](/cpp/docs/reference/networksecurity/2.23.0)\n- [2.22.1](/cpp/docs/reference/networksecurity/2.22.1)\n- [2.21.0](/cpp/docs/reference/networksecurity/2.21.0)\n- [2.20.0](/cpp/docs/reference/networksecurity/2.20.0)\n- [2.19.0](/cpp/docs/reference/networksecurity/2.19.0)\n- [2.18.0](/cpp/docs/reference/networksecurity/2.18.0)\n- [2.17.0](/cpp/docs/reference/networksecurity/2.17.0)\n- [2.16.0](/cpp/docs/reference/networksecurity/2.16.0)\n- [2.15.1](/cpp/docs/reference/networksecurity/2.15.1)\n- [2.14.0](/cpp/docs/reference/networksecurity/2.14.0)\n- [2.13.0](/cpp/docs/reference/networksecurity/2.13.0) \n\nNetwork Security API C++ Client Library\n=======================================\n\nAn idiomatic C++ client library for the [Network Security API](https://cloud.google.com/secure-web-proxy), a cloud first service that helps you secure egress web traffic (HTTP/S).\n\nWhile this library is **GA** , please note that the Google Cloud C++ client libraries do **not** follow [Semantic Versioning](https://semver.org/).\n\n### Quickstart\n\nThe following shows the code that you'll run in the `google/cloud/networksecurity/quickstart/` directory, which should give you a taste of the Network Security API C++ client library API. \n\n #include \"google/cloud/networksecurity/v1/network_security_client.h\"\n #include \"google/cloud/project.h\"\n #include \u003ciostream\u003e\n\n int main(int argc, char* argv[]) try {\n if (argc != 2) {\n std::cerr \u003c\u003c \"Usage: \" \u003c\u003c argv[0] \u003c\u003c \" project-id\\n\";\n return 1;\n }\n\n namespace networksecurity = ::google::cloud::networksecurity_v1;\n auto client = networksecurity::NetworkSecurityClient(\n networksecurity::MakeNetworkSecurityConnection());\n\n auto const parent = std::string{\"projects/\"} + argv[1] + \"/locations/-\";\n for (auto r : client.ListAuthorizationPolicies(parent)) {\n if (!r) throw std::move(r).status();\n std::cout \u003c\u003c r-\u003eDebugString() \u003c\u003c \"\\n\";\n }\n\n return 0;\n } catch (google::cloud::Status const& status) {\n std::cerr \u003c\u003c \"google::cloud::Status thrown: \" \u003c\u003c status \u003c\u003c \"\\n\";\n return 1;\n }\n\n### Main classes\n\nThe main class in this library is [`networksecurity_v1::NetworkSecurityClient`](/cpp/docs/reference/networksecurity/2.13.0/classgoogle_1_1cloud_1_1networksecurity__v1_1_1NetworkSecurityClient). All RPCs are exposed as member functions of this class. Other classes provide helpers, configuration parameters, and infrastructure to mock [`networksecurity_v1::NetworkSecurityClient`](/cpp/docs/reference/networksecurity/2.13.0/classgoogle_1_1cloud_1_1networksecurity__v1_1_1NetworkSecurityClient) when testing your application.\n\n### More Information\n\n- [Error Handling](https://cloud.google.com/cpp/docs/reference/common/latest/common-error-handling.html) - describes how the library reports errors.\n- [How to Override the Default Endpoint](/cpp/docs/reference/networksecurity/2.13.0/networksecurity-override-endpoint) - describes how to override the default endpoint.\n- [How to Override the Authentication Credentials](/cpp/docs/reference/networksecurity/2.13.0/networksecurity-override-authentication) - describes how to change the authentication credentials used by the library.\n- [Override Retry, Backoff, and Idempotency Policies](/cpp/docs/reference/networksecurity/2.13.0/networksecurity-override-retry) - describes how to change the default retry policies.\n- [Environment Variables](/cpp/docs/reference/networksecurity/2.13.0/networksecurity-env) - describes environment variables that can configure the behavior of the library."]]