apache/reqsign

apache-Profil

Letzte erfasste Quellaktivität: 5. Oktober 2026 um 04:24

SkillsMP-Katalog aktualisiert: 26. Oktober 2026 um 11:37

gesammelte Skills: 1

GitHub-Stars: 177
GitHub-Forks: 77

README des Repositorys

README-Quelldatei: README.md

README-Quelldatei lesen

Vollständige README anzeigen

# Apache Reqsign [![Build Status]][actions] [![Latest Version]][crates.io] [![Crate Downloads]][crates.io] [Build Status]: https://img.shields.io/github/actions/workflow/status/apache/reqsign/ci.yml?branch=main [actions]: https://github.com/apache/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 ### Option 1: Use Default Signer (Recommended) The simplest way to use `reqsign` is with the default signers provided by each service: ```rust use anyhow::Result; use reqsign::aws; #[tokio::main] async fn main() -> Result<()> { // Create a default signer for S3 in us-east-1 // This will automatically: // - Load credentials from environment variables, config files, or IAM roles // - Set up the default HTTP client and file reader let signer = aws::default_signer("s3", "us-east-1"); // Build your request let mut req = http::Request::builder() .method("GET") .uri("https://s3.amazonaws.com/testbucket") .body(()) .unwrap() .into_parts() .0; // Sign the request signer.sign(&mut req, None).await?; // Send the request with your preferred HTTP client println!("Request has been signed!"); Ok(()) } ``` ### Option 2: Custom Assembly For more control over the components, you can manually assemble the signer: ```rust use anyhow::Result; use reqsign::{Context, Signer}; use reqsign_aws_v4::{DefaultCredentialProvider, RequestSigner}; use reqsign_file_read_tokio::TokioFileRead; use reqsign_http_send_reqwest::ReqwestHttpSend; #[tokio::main] async fn main() -> Result<()> { // Build your own context with specific implementations let ctx = Context::new() .with_file_read(TokioFileRead) .with_http_send(ReqwestHttpSend::default()) .with_env(reqsign::OsEnv); // Configure credential provider let credential_provider = DefaultCredentialProvider::new(); // Configure request signer for S3 let request_signer = RequestSigner::new("s3", "us-east-1"); // Assemble the signer let signer = Signer::new(ctx, credential_provider, request_signer); // Build and sign the request let mut req = http::Request::builder() .method("GET") .uri("https://s3.amazonaws.com/testbucket") .body(()) .unwrap() .into_parts() .0; // Sign the request signer.sign(&mut req, None).await?; println!("Request has been signed!"); Ok(()) } ``` ### Customizing Default Signers You can also customize the default signers using the `with_*` methods: ```rust use reqsign::aws; use reqsign_aws_v4::StaticCredentialProvider; // Start with default signer and customize specific components let signer = aws::default_signer("s3", "us-east-1") .with_credential_provider(StaticCredentialProvider::new( "my-access-key", "my-secret-key", None, // Optional session token )); ``` For server applications that already hold an OIDC assertion, see [Caller-provided subject tokens](docs/caller-provided-subject-tokens.md). ### More Services Examples #### AWS SigV4a ```rust use reqsign::aws::v4a::{SigningRegionSet, default_signer}; let region_set = SigningRegionSet::new("us-east-1,us-west-2")?; let signer = default_signer("s3", region_set); # Ok::<(), reqsign_core::Error>(()) ``` #### Azure Storage ```rust use reqsign::azure; // Default signer for Azure Storage let signer = azure::default_signer(); // With custom credentials use reqsign_azure_storage::StaticCredentialProvider; let signer = azure::default_signer() .with_credential_provider(StaticCredentialProvider::new( "account-name", "account-key", )); ``` #### Google Cloud ```rust use reqsign::google; // Default signer for Google Cloud Storage let signer = google::default_signer("storage.googleapis.com"); ``` #### Aliyun OSS ```rust use reqsign::aliyun; // Default signer for Aliyun OSS let signer = aliyun::default_signer(); ``` ## Features - Pure rust with minimal dependencies. - Test again official SDK and services. - Supported services - Aliyun OSS: `reqsign-aliyun-oss` - AWS shared credentials and canonicalization: `reqsign-aws-core` - AWS services (SigV4): `reqsign-aws-v4` - AWS multi-region services (SigV4a): `reqsign-aws-v4a` - Azure Storage services: `reqsign-azure-storage` - Google services: `reqsign-google` - Huawei Cloud OBS: `reqsign-huaweicloud-obs` - OpenStack Keystone: `reqsign-openstack-keystone` - Oracle Cloud: `reqsign-oracle` - Tencent COS: `reqsign-tencent-cos` ## 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/apache/reqsign/issues/new/choose) for bug report or asking questions in [discussion](https://github.com/apache/reqsign/discussions/new?category=q-a). Join the [development mailing list](mailto:dev@reqsign.apache.org) for project discussions and release votes. [Subscribe](mailto:dev-subscribe@reqsign.apache.org) before posting, or browse the [archives](https://lists.apache.org/list.html?dev@reqsign.apache.org). ## 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](LICENSE).

README des Repositorys wird geladen…

Skills in diesem Repository

Klassifizierung ausstehend

Skill

Beruf

Beschreibung

Aktualisiert

reqsign-release

nicht klassifiziert

Release Apache Reqsign through the Apache RC, vote, dist, tag, crates.io, and announcement flow.

Quellsprache: Englisch

2026-10-05

Es werden 1 von 1 gesammelten Skills angezeigt.

Mit einem KI-Assistenten installieren

Diesen Prompt kopieren und in den verwendeten KI-Assistenten einfügen.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/apache/reqsign.