Configures a custom CA (Certificates Authority) certificates file.
Most applications should use the system's root certificates and should avoid setting this option unnecessarily. A common exception to this recommendation are containerized applications. These often deploy without system's root certificates and need to explicitly configure a root of trust.
The value of this option should be the name of a file in PEM format. Consult your security team and/or system administrator for the contents of this file. Be aware of the security implications of adding new CA certificates to this file. Only use trustworthy sources for the CA certificates.
For REST-based libraries this configures the CAINFO option in libcurl. These are used for all credentials that require authentication, including the default credentials.
[[["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-03-05 UTC."],[[["The latest version available is 2.37.0-rc, with numerous older versions available dating back to 2.10.1."],["`CARootsFilePathOption` allows for configuring a custom CA certificates file, which is typically unnecessary except in cases like containerized applications without system root certificates."],["The configured CA certificates file should be in PEM format, sourced from trustworthy entities, and users should be mindful of the security implications when adding certificates."],["For REST-based libraries, this option sets the `CAINFO` in libcurl for all credentials requiring authentication, and for gRPC, it sets the `pem_roots_cert` parameter in `grpc::SslCredentialsOptions`."],["For gRPC with default credentials, the `CARootsFilePathOption` does not apply, and the `GRPC_DEFAULT_SSL_ROOTS_FILE_PATH` environment variable is needed to set CA certificates."]]],[]]
