Struct reqsign::AwsV4Signer

pub struct AwsV4Signer { /* private fields */ }

Singer that implement AWS SigV4.

• Signature Version 4 signing process

Implementations

impl Signer

pub fn new(service: &str, region: &str) -> Self

Create a builder.

pub fn region(&self) -> &str

Get the region of this signer.

pub fn sign( &self, req: &mut impl SignableRequest, cred: &Credential ) -> Result<()>

Signing request with header.

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 will 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(())
}

pub fn sign_query( &self, req: &mut impl SignableRequest, expire: Duration, cred: &Credential ) -> Result<()>

Signing request with query.

Example

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

#[tokio::main]
async fn main() -> Result<()> {
    // Signer will 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_query(&mut req, Duration::hours(1))?;
    // Sending already signed request.
    let resp = Client::new().execute(req).await?;
    println!("resp got status: {}", resp.status());
    Ok(())
}

Trait Implementations

impl Debug for Signer

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.