切换默认加密提供程序

本文档介绍了如何在 Rust 中切换默认 rustls 加密提供程序。如果您的应用有默认提供程序无法满足的特定要求,您可能需要切换默认加密提供程序。

Rust 客户端库使用 Rustls 来保护应用与 Google Cloud之间的通信。Rustls 可以使用不同的提供程序来实现加密功能。默认情况下,客户端库会启用 aws-lc-rs 提供程序。客户端库默认使用此提供程序,因为它基于 Google 的 BoringSSL 加密库。它也是唯一获得 FIPS 认证的 Rust 加密提供程序。

不过,某些应用可能需要使用其他提供程序。本文档介绍了如何停用默认提供方并配置您自己的提供方。这些示例使用 google-cloud-storage 和 ring 作为替代加密提供程序。您可以针对其他客户端库自定义此流程。如需了解其他提供程序,请参阅 rustls 文档。

将客户端库与默认加密提供程序搭配使用

如需使用默认加密提供程序,请将客户端库作为依赖项添加到 Cargo.toml 文件中:

[dependencies]
google-cloud-storage = { version = "1" }

使用默认加密提供程序,并停用其他默认功能

某些应用倾向于停用其依赖项中的所有默认功能,然后仅启用它们要使用的功能。例如,您的 Cargo.toml 可能如下所示:

[dependencies]
google-cloud-storage = { version = "1", default-features = false }

如需仅启用默认提供程序功能,请使用:

[dependencies]
google-cloud-storage = { version = "1", default-features = false, features = ["default-rustls-provider"] }

使用您自己的加密提供程序

如需选择自己的提供商,请执行以下操作:

  1. 添加 Rust(停用默认功能),并添加提供程序所需的任何依赖项。以下示例使用 ring:

    您必须使用与 `google-cloud-storage` 相同的 `rustls` 版本。
    [dependencies]
    google-cloud-storage = { version = "1", default-features = false }
    rustls               = { version = "0.23", features = ["ring"] }
    
  2. 更改 main() 函数以安装此提供程序:

    use rustls::crypto::{CryptoProvider, ring::default_provider};
    
    #[tokio::main]
    async fn main() -> anyhow::Result<()> {
        // Install a default crypto provider.
        CryptoProvider::install_default(default_provider())
            .map_err(|_| anyhow::anyhow!("default crypto provider already installed"))?;
        // ... ... ...
        Ok(())
    }