Crate reqsign

Signing API requests without effort.

Example

use anyhow::Result;
use reqsign::AwsConfigLoader;
use reqsign::AwsV4Signer;
use reqwest::Client;
use reqwest::Request;
use reqwest::Url;

#[tokio::main]
async fn main() -> Result<()> {
    // Signer can load region and credentials from environment by default.
    let signer = AwsV4Signer::builder()
        .config_loader(AwsConfigLoader::with_loaded())
        .service("s3")
        .build()?;
    // Construct request
    let url = Url::parse("https://s3.amazonaws.com/testbucket")?;
    let mut req = reqwest::Request::new(http::Method::GET, url);
    // Signing request with Signer
    signer.sign(&mut req)?;
    // Sending already signed request.
    let resp = Client::new().execute(req).await?;
    println!("resp got status: {}", resp.status());
    Ok(())
}

Available Services

• Aliyun OSS for Aliyun OSS.
• AWS SigV4 for AWS services like S3.
• Azure Storage for Azure Storage services like Azure Blob Service.
• Google for All google cloud services like Google Cloud Storage Service.
• Huawei Cloud OBS for Huawei Cloud Object Storage Service (OBS).

Features

reqsign support http::Request by default. Other request types support are hided under feature gates to reduce dependencies.

• reqwest_request: Enable to support signing reqwest::Request
• reqwest_blocking_request: Enable to support signing reqwest::blocking::Request

Structs

• AliyunConfig
  Config carries all the configuration for Aliyun services.
• AliyunCredential
  Credential that holds the access_key and secret_key.
• AliyunLoader
  Loader will load credential from different methods.
• AliyunOssSigner
  Singer for Aliyun OSS.
• AwsConfig
  Config for aws services.
• AwsCredential
  Credential that holds the access_key and secret_key.
• AwsLoader
  CredentialLoader will load credential from different methods.
• AwsV4Signer
  Singer that implement AWS SigV4.
• AzureStorageConfig
  Config carries all the configuration for Azure Storage services.
• AzureStorageLoader
  Loader will load credential from different methods.
• AzureStorageSigner
  Singer that implement Azure Storage Shared Key Authorization.
• GoogleCredential
  A Google API credential file.
• GoogleCredentialLoader
  CredentialLoader will load credential from different methods.
• GoogleSigner
  Singer that implement Google OAuth2 Authentication.
• GoogleToken
  Token is the authentication methods used by google services.
• GoogleTokenLoader
  TokenLoader will load token from different methods.
• HuaweicloudObsConfig
  Config carries all the configuration for Huawei Cloud OBS services.
• HuaweicloudObsCredential
  Credential for obs.
• HuaweicloudObsCredentialLoader
  CredentialLoader will load credential from different methods.
• HuaweicloudObsSigner
  Singer that implement Huawei Cloud Object Storage Service Authorization.
• TencentCosConfig
  Config carries all the configuration for Tencent COS services.
• TencentCosCredential
  Credential for cos.
• TencentCosCredentialLoader
  CredentialLoader will load credential from different methods.
• TencentCosSigner
  Singer for Tencent COS.

Enums

• AzureStorageCredential
  Credential that holds the access_key and secret_key.

Traits

• AwsCredentialLoad
  Loader trait will try to load credential from different sources.
• GoogleTokenLoad
  Loader trait will try to load credential from different sources.