Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Xuanwo/reqsign
Signing HTTP requests without heavy SDKs.
https://github.com/Xuanwo/reqsign
Last synced: 3 months ago
JSON representation
Signing HTTP requests without heavy SDKs.
- Host: GitHub
- URL: https://github.com/Xuanwo/reqsign
- Owner: Xuanwo
- License: apache-2.0
- Created: 2022-03-12T11:58:40.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-07-09T13:58:12.000Z (4 months ago)
- Last Synced: 2024-07-28T17:42:21.800Z (3 months ago)
- Language: Rust
- Homepage: https://docs.rs/reqsign/
- Size: 720 KB
- Stars: 89
- Watchers: 3
- Forks: 33
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# reqsign [![Build Status]][actions] [![Latest Version]][crates.io] [![Crate Downloads]][crates.io]
[Build Status]: https://img.shields.io/github/actions/workflow/status/Xuanwo/reqsign/ci.yml?branch=main
[actions]: https://github.com/Xuanwo/reqsign/actions?query=branch%3Amain
[Latest Version]: https://img.shields.io/crates/v/reqsign.svg
[crates.io]: https://crates.io/crates/reqsign
[Crate Downloads]: https://img.shields.io/crates/d/reqsign.svg
Signing API requests without effort.
---
Most API is simple. But they could be complicated when they are hidden from complex abstraction. `reqsign` bring the simple API back: build, sign, send.
## Quick Start
```rust
use anyhow::Result;
use reqsign::AwsConfig;
use reqsign::AwsLoader;
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 client = Client::new();
let config = AwsConfig::default().from_profile().from_env();
let loader = AwsLoader::new(client.clone(), config);
let signer = AwsV4Signer::new("s3", "us-east-1");
// 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
let credential = loader.load().await?.unwrap();
signer.sign(&mut req, &credential)?;
// Sending already signed request.
let resp = client.execute(req).await?;
println!("resp got status: {}", resp.status());
Ok(())
}
```
## Features
- Pure rust with minimal dependencies.
- Test again official SDK and services.
- Supported services
- Aliyun OSS: `reqsign::AliyunOssSigner`
- AWS services (SigV4): `reqsign::AwsV4Signer`
- Azure Storage services: `reqsign::AzureStorageSigner`
- Google services: `reqsign::GoogleSigner`
- Huawei Cloud OBS: `reqsign::HuaweicloudObsSigner`
## Contributing
Check out the [CONTRIBUTING.md](./CONTRIBUTING.md) guide for more details on getting started with contributing to this project.
## Getting help
Submit [issues](https://github.com/Xuanwo/reqsign/issues/new/choose) for bug report or asking questions in [discussion](https://github.com/Xuanwo/reqsign/discussions/new?category=q-a).
## Acknowledge
Inspired a lot from:
- [aws-sigv4](https://crates.io/crates/aws-sigv4) for AWS SigV4 support.
- [azure_storage_blobs](https://crates.io/crates/azure_storage_blobs) for Azure Storage support.
#### License
Licensed under Apache License, Version 2.0.