feat: update server to Smol Mail protocol 1.1

This commit is contained in:
randogoth 2026-09-27 09:39:01 +03:00
parent 71ad7e04c0
commit 24fe701ca2
8 changed files with 311 additions and 52 deletions

View file

@ -1,21 +1,26 @@
//! Per-connection dispatch and the six wire operations.
use crate::crypto::{message_id, verify};
use crate::crypto::{b32, ct_eq, hmac_sha256, message_id, verify};
use crate::proto::{
valid_username, ProtocolError, Reader, AUTH_FAILED, AUTH_REQUIRED, BAD_VERSION, CERT_LEN,
ENVELOPE_MAGIC, ENVELOPE_MIN, ENVELOPE_VERSION, FETCH_BUDGET, ID_LEN, KEY_LEN, LABEL_AUTH,
LABEL_ROTATE, MALFORMED, MAX_CHAIN, NOT_PERMITTED, OK, OP_AUTH, OP_DELETE, OP_FETCH,
OP_REGISTER, OP_RESOLVE, OP_SEND, QUOTA_EXCEEDED, RATE_LIMITED, TOO_LARGE, UNKNOWN_USER,
LABEL_MAC, LABEL_REGISTER, LABEL_ROTATE, MAC_LEN, MALFORMED, MAX_CHAIN, NOT_PERMITTED, OK,
OP_AUTH, OP_DELETE, OP_FETCH, OP_REGISTER, OP_RESOLVE, OP_SEND, QUOTA_EXCEEDED, RATE_LIMITED,
TOKEN_LEN, TOO_LARGE, UNKNOWN_USER,
};
use crate::ratelimit::RateLimiter;
use crate::store::Store;
pub struct ServerConfig {
pub max_envelope: usize,
pub quota: i64,
pub main_quota: i64,
pub requests_quota: i64,
pub max_tokens: u16,
pub invite_token: Option<Vec<u8>>,
pub server_static: [u8; KEY_LEN],
pub conn_limiter: RateLimiter,
pub send_limiter: RateLimiter,
pub token_limiter: RateLimiter,
}
/// A parse failure (-> MALFORMED) or a storage failure (-> INTERNAL_ERROR).
@ -100,8 +105,19 @@ impl<'a> Session<'a> {
let username = Self::read_str(r)?;
let identity = r.take(KEY_LEN)?.to_vec();
let signature = r.take(64)?.to_vec();
let sync = r.u8()?;
let count = r.u16()? as usize;
let mut tokens = Vec::with_capacity(count);
for _ in 0..count {
tokens.push(r.take(TOKEN_LEN)?.to_vec());
}
r.done()?;
// sync = 0 leaves the stored set untouched, so it carries no tokens.
if sync > 1 || (sync == 0 && count != 0) {
return Ok((MALFORMED, Vec::new()));
}
let bound = self.store.identity_of(&username)?;
// A wrong username and a wrong signature are both AUTH_FAILED: telling
// them apart would turn this into an account-existence oracle.
@ -113,8 +129,18 @@ impl<'a> Session<'a> {
if !verify(&identity, &signature, &msg) {
return Ok((AUTH_FAILED, Vec::new()));
}
if sync == 1 {
if count > self.config.max_tokens as usize {
// Leaves the session unauthenticated, per SPEC.md sec 4.
return Ok((TOO_LARGE, Vec::new()));
}
self.store.set_tokens(&username, &tokens)?;
}
let accepted = self.store.token_count(&username)?;
self.username = Some(username);
Ok((OK, Vec::new()))
Ok((OK, accepted.to_be_bytes().to_vec()))
}
fn op_resolve(&mut self, r: &mut Reader) -> OpResult {
@ -134,7 +160,13 @@ impl<'a> Session<'a> {
}
fn op_send(&mut self, r: &mut Reader) -> OpResult {
let mac_len = r.u8()? as usize;
if mac_len != 0 && mac_len != MAC_LEN {
return Ok((MALFORMED, Vec::new()));
}
let mac = r.take(mac_len)?.to_vec();
let envelope = r.rest().to_vec();
if !self.config.send_limiter.allow(&self.peer_ip) {
return Ok((RATE_LIMITED, Vec::new()));
}
@ -152,28 +184,63 @@ impl<'a> Session<'a> {
Some(u) => u,
None => return Ok((UNKNOWN_USER, Vec::new())),
};
let keys = self.store.keys_of(&username)?;
let used = self.store.mailbox_bytes(&keys)?;
if used + envelope.len() as i64 > self.config.quota {
return Ok((QUOTA_EXCEEDED, Vec::new()));
}
// The ciphertext is never inspected; the server cannot read it.
let mid = message_id(&envelope);
self.store.store_message(&mid, recipient, &envelope)?;
// A matching accept token (SPEC.md sec 5.8) puts the envelope in the
// mailbox's main tier; anything else lands in the smaller, short-lived
// requests tier. A failed match is never reported to the sender.
let matched_token = if mac.len() == MAC_LEN {
let mut msg = LABEL_MAC.to_vec();
msg.extend_from_slice(&mid);
self.store
.tokens_of(&username)?
.into_iter()
.find(|t| ct_eq(&hmac_sha256(t, &msg), &mac))
} else {
None
};
if let Some(token) = &matched_token {
if !self.config.token_limiter.allow(&b32(token)) {
return Ok((RATE_LIMITED, Vec::new()));
}
}
let unsolicited = matched_token.is_none();
let tier_quota = if unsolicited {
self.config.requests_quota
} else {
self.config.main_quota
};
let keys = self.store.keys_of(&username)?;
let used = self.store.mailbox_bytes(&keys, unsolicited)?;
if used + envelope.len() as i64 > tier_quota {
return Ok((QUOTA_EXCEEDED, Vec::new()));
}
self.store
.store_message(&mid, recipient, &envelope, unsolicited)?;
Ok((OK, mid.to_vec()))
}
fn op_fetch(&mut self, r: &mut Reader) -> OpResult {
let after_received_at = r.i64()?;
let after_id = r.take(ID_LEN)?.to_vec();
r.done()?;
let username = self.username.as_ref().expect("AUTH_REQUIRED gate above");
let keys = self.store.keys_of(username)?;
let records = self.store.pending(&keys, FETCH_BUDGET)?;
let records = self
.store
.pending(&keys, after_received_at, &after_id, FETCH_BUDGET)?;
let mut out = Vec::new();
out.extend_from_slice(&(records.len() as u16).to_be_bytes());
for (mid, received_at, envelope) in records {
for (mid, received_at, unsolicited, envelope) in records {
out.extend_from_slice(&mid);
out.extend_from_slice(&received_at.to_be_bytes());
out.push(if unsolicited { 1 } else { 0 });
out.extend_from_slice(&(envelope.len() as u32).to_be_bytes());
out.extend_from_slice(&envelope);
}
@ -202,6 +269,7 @@ impl<'a> Session<'a> {
fn op_register(&mut self, r: &mut Reader) -> OpResult {
let username = Self::read_str(r)?;
let identity = r.take(KEY_LEN)?.to_vec();
let signature = r.take(64)?.to_vec();
let token_len = r.u8()? as usize;
let token = r.take(token_len)?.to_vec();
let cert_len = r.u8()? as usize;
@ -214,6 +282,17 @@ impl<'a> Session<'a> {
// identity is exactly KEY_LEN bytes by construction (Reader::take
// enforces it); no separate curve-point validity check is needed.
// Proof of possession, required on every registration and rotation
// (SPEC.md sec 6.1). Binding server_static stops the attestation from
// being replayed against another server.
let mut pop_msg = LABEL_REGISTER.to_vec();
pop_msg.extend_from_slice(&self.config.server_static);
pop_msg.extend_from_slice(username.as_bytes());
pop_msg.extend_from_slice(&identity);
if !verify(&identity, &signature, &pop_msg) {
return Ok((AUTH_FAILED, Vec::new()));
}
if let Some(expected) = &self.config.invite_token {
if &token != expected {
return Ok((NOT_PERMITTED, Vec::new()));
@ -233,7 +312,8 @@ impl<'a> Session<'a> {
let old_pub = &cert[..32];
let new_pub = &cert[32..64];
let when = &cert[64..72];
let signature = &cert[72..];
let sig_old = &cert[72..136];
let sig_new = &cert[136..200];
if new_pub != identity.as_slice() {
return Ok((MALFORMED, Vec::new()));
}
@ -246,10 +326,11 @@ impl<'a> Session<'a> {
return Ok((NOT_PERMITTED, Vec::new()));
}
let mut msg = LABEL_ROTATE.to_vec();
msg.extend_from_slice(username.as_bytes());
msg.extend_from_slice(old_pub);
msg.extend_from_slice(new_pub);
msg.extend_from_slice(when);
if !verify(old_pub, signature, &msg) {
if !verify(old_pub, sig_old, &msg) || !verify(new_pub, sig_new, &msg) {
return Ok((AUTH_FAILED, Vec::new()));
}
let chain = self.store.chain(&username)?;