use crate::error::{BachsError, BachsResult};
use base64::engine::general_purpose::STANDARD as BASE64;
use base64::Engine;
use hmac::{Hmac, Mac};
use serde::Deserialize;
use sha2::Sha256;
use subtle::ConstantTimeEq;
type HmacSha256 = Hmac<Sha256>;
#[derive(Debug, Clone, Copy)]
pub struct SignatureHeaders<'a> {
pub id: &'a str,
pub timestamp: &'a str,
pub signature: &'a str,
}
#[derive(Debug, Clone, Deserialize)]
pub struct Event {
#[serde(rename = "type")]
pub event_type: String,
#[serde(default)]
pub id: Option<String>,
#[serde(default)]
pub created_at: Option<String>,
pub data: serde_json::Value,
}
pub fn verify_signature(
payload: &[u8],
headers: SignatureHeaders<'_>,
secret: &str,
) -> BachsResult<()> {
let key_b64 = secret.strip_prefix("whsec_").ok_or_else(|| {
BachsError::WebhookSignature(
"secret must start with 'whsec_' — pass the signing secret from your webhook \
endpoint settings, not your API key"
.to_string(),
)
})?;
let key = BASE64
.decode(key_b64)
.map_err(|e| BachsError::WebhookSignature(format!("invalid secret encoding: {e}")))?;
let signed_content = {
let mut buf = Vec::with_capacity(headers.id.len() + headers.timestamp.len() + payload.len() + 2);
buf.extend_from_slice(headers.id.as_bytes());
buf.push(b'.');
buf.extend_from_slice(headers.timestamp.as_bytes());
buf.push(b'.');
buf.extend_from_slice(payload);
buf
};
let mut mac = HmacSha256::new_from_slice(&key)
.map_err(|e| BachsError::WebhookSignature(format!("invalid key length: {e}")))?;
mac.update(&signed_content);
let expected = mac.finalize().into_bytes();
for candidate in headers.signature.split_whitespace() {
let sig_b64 = candidate.split_once(',').map(|(_, s)| s).unwrap_or(candidate);
if let Ok(sig_bytes) = BASE64.decode(sig_b64) {
if sig_bytes.len() == expected.len() && bool::from(sig_bytes.ct_eq(&expected)) {
return Ok(());
}
}
}
Err(BachsError::WebhookSignature(
"no signature in the header matched the expected value".to_string(),
))
}
pub fn construct_event(
payload: &[u8],
headers: SignatureHeaders<'_>,
secret: &str,
) -> BachsResult<Event> {
verify_signature(payload, headers, secret)?;
serde_json::from_slice(payload).map_err(BachsError::from)
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn rejects_a_replay_with_old_timestamp() {
let (secret, key) = {
let key = b"0123456789abcdef0123456789abcdef".to_vec();
let secret = format!("whsec_{}", BASE64.encode(&key));
(secret, key)
};
let payload = br#"{"type":"ping"}"#;
let headers = SignatureHeaders {
id: "msg_1",
timestamp: "1000000",
signature: "",
};
let err = verify_signature(payload, headers, &secret).unwrap_err();
match err {
BachsError::WebhookSignature(_) => {}
other => panic!("expected WebhookSignature, got {other:?}"),
}
}
#[test]
fn rejects_tampered_signature_header() {
let (secret, key) = {
let key = b"0123456789abcdef0123456789abcdef".to_vec();
let secret = format!("whsec_{}", BASE64.encode(&key));
(secret, key)
};
let payload = br#"{"type":"ping"}"#;
let headers = SignatureHeaders {
id: "msg_1",
timestamp: "1750000000",
signature: "v1,notavalidbase64signature!!!",
};
let err = verify_signature(payload, headers, &secret).unwrap_err();
match err {
BachsError::WebhookSignature(_) => {}
other => panic!("expected WebhookSignature, got {other:?}"),
}
}
#[test]
fn event_deserialization() {
let payload = br#"{"type":"collection.succeeded","data":{"charge_id":"chg_1"}}"#;
let (secret, key) = {
let key = b"0123456789abcdef0123456789abcdef".to_vec();
let secret = format!("whsec_{}", BASE64.encode(&key));
(secret, key)
};
let sig = {
let mut mac = HmacSha256::new_from_slice(&key).unwrap();
let mut content = Vec::new();
content.extend_from_slice(b"msg_1");
content.push(b'.');
content.extend_from_slice(b"1750000000");
content.push(b'.');
content.extend_from_slice(payload);
mac.update(&content);
format!("v1,{}", BASE64.encode(mac.finalize().into_bytes()))
};
let headers = SignatureHeaders {
id: "msg_1",
timestamp: "1750000000",
signature: &sig,
};
let event = construct_event(payload, headers, &secret).unwrap();
assert_eq!(event.event_type, "collection.succeeded");
assert_eq!(event.data["charge_id"], "chg_1");
}
}