26.5 ferdig: synops-mail --receive med avsender-verifisering og node-opprettelse

Implementert fullstendig epost-mottak pipeline:
- Parser raw RFC 5322 epost fra stdin via mailparse
- Sjekk 1: Envelope-sender matches auth_identities.email (case-insensitive)
- Sjekk 2: Body starter med konfigurerbar aktiveringsfrase (default: "Kjære vaktmester")
- Begge sjekker må bestå — ellers forkastes eposten stille (exit 0, ingen bounce)
- Ved match: oppretter content-node med visibility=hidden, created_by=bruker
- Metadata lagrer source=email, from, to, subject for sporbarhet
- UTF-8 håndtering: prøver raw bytes som UTF-8 først, faller tilbake til mailparse charset
- Aktiveringsfrase konfigurerbar via --phrase eller SYNOPS_MAIL_PHRASE env
This commit is contained in:
vegard 2026-03-19 01:52:53 +00:00
parent ad8aa2181a
commit 25713c4482
4 changed files with 2507 additions and 40 deletions

View file

@ -349,8 +349,7 @@ sidelinja.org, vegard.info) ruter til samme bruker basert på username.
- [x] 26.2 msmtp oppsett: konfigurer utgående epost via SMTP-relay. Avsender: `vaktmester@synops.no`. Tilgjengelig som `synops-mail --send --to <epost> --subject <emne>` CLI-verktøy. - [x] 26.2 msmtp oppsett: konfigurer utgående epost via SMTP-relay. Avsender: `vaktmester@synops.no`. Tilgjengelig som `synops-mail --send --to <epost> --subject <emne>` CLI-verktøy.
- [x] 26.3 MX-records: sett opp MX for synops.no, sidelinja.org, vegard.info som peker til serveren. - [x] 26.3 MX-records: sett opp MX for synops.no, sidelinja.org, vegard.info som peker til serveren.
- [x] 26.4 Postfix minimal: installer Postfix som lokal MTA kun for mottak. Ingen relay, ingen kø for utgående. Pipe innkommende epost til `synops-mail --receive`. - [x] 26.4 Postfix minimal: installer Postfix som lokal MTA kun for mottak. Ingen relay, ingen kø for utgående. Pipe innkommende epost til `synops-mail --receive`.
- [~] 26.5 `synops-mail --receive`: Rust CLI som leser raw epost fra stdin. Sjekk 1: avsender-epost matcher `auth_identities.email`? Sjekk 2: innhold starter med "Kjære vaktmester" (eller konfigurerbar frase)? Begge må matche. Opprett `content`-node i brukerens innboks med epostinnholdet. Alt annet → /dev/null, ingen bounce. - [x] 26.5 `synops-mail --receive`: Rust CLI som leser raw epost fra stdin. Sjekk 1: avsender-epost matcher `auth_identities.email`? Sjekk 2: innhold starter med "Kjære vaktmester" (eller konfigurerbar frase)? Begge må matche. Opprett `content`-node i brukerens innboks med epostinnholdet. Alt annet → /dev/null, ingen bounce.
> Påbegynt: 2026-03-19T01:47
- [ ] 26.6 Domene-alias: `vegard@synops.no`, `vegard@sidelinja.org`, `vegard@vegard.info` ruter alle til samme bruker via username-oppslag i PG. Domenet er irrelevant. - [ ] 26.6 Domene-alias: `vegard@synops.no`, `vegard@sidelinja.org`, `vegard@vegard.info` ruter alle til samme bruker via username-oppslag i PG. Domenet er irrelevant.
- [ ] 26.7 Utgående varsler: vaktmesteren kan sende epost-varsler til brukere (ny oppgave tildelt, innsendt artikkel godkjent, etc.) via `synops-mail --send`. Konfigurerbart per bruker i metadata.preferences. - [ ] 26.7 Utgående varsler: vaktmesteren kan sende epost-varsler til brukere (ny oppgave tildelt, innsendt artikkel godkjent, etc.) via `synops-mail --send`. Konfigurerbart per bruker i metadata.preferences.

File diff suppressed because it is too large Load diff

View file

@ -9,3 +9,10 @@ path = "src/main.rs"
[dependencies] [dependencies]
clap = { version = "4", features = ["derive", "env"] } clap = { version = "4", features = ["derive", "env"] }
synops-common = { path = "../synops-common" }
sqlx = { version = "0.8", features = ["runtime-tokio", "tls-rustls", "postgres", "uuid", "chrono", "json"] }
uuid = { version = "1", features = ["v7", "serde"] }
serde_json = "1"
tokio = { version = "1", features = ["full"] }
tracing = "0.1"
mailparse = "0.15"

View file

@ -2,6 +2,10 @@
// //
// Send-modus: sender epost via msmtp (Brevo SMTP-relay). // Send-modus: sender epost via msmtp (Brevo SMTP-relay).
// Motta-modus: tar imot epost fra Postfix via pipe transport. // Motta-modus: tar imot epost fra Postfix via pipe transport.
// - Sjekker at avsender-epost finnes i auth_identities
// - Sjekker at innholdet starter med en konfigurerbar frase (default: "Kjære vaktmester")
// - Oppretter content-node i brukerens innboks ved match
// - Alt annet → /dev/null, ingen bounce
// //
// Bruk: // Bruk:
// synops-mail --send --to bruker@eksempel.no --subject "Emne" // synops-mail --send --to bruker@eksempel.no --subject "Emne"
@ -15,31 +19,28 @@
// Konfigurering: // Konfigurering:
// msmtp-konfig: /srv/synops/config/msmtp/msmtprc // msmtp-konfig: /srv/synops/config/msmtp/msmtprc
// Miljøvariabel MSMTP_CONFIG kan overstyre config-sti. // Miljøvariabel MSMTP_CONFIG kan overstyre config-sti.
// Miljøvariabel SYNOPS_MAIL_PHRASE kan overstyre aktiveringsfrase (default: "Kjære vaktmester").
// //
// Ref: docs/retninger/unix_filosofi.md // Ref: docs/retninger/unix_filosofi.md
use clap::{Parser, Subcommand}; use clap::Parser;
use std::io::{self, Read}; use std::io::{self, Read};
use std::process::{Command, Stdio}; use std::process::{Command, Stdio};
const DEFAULT_FROM: &str = "vaktmester@synops.no"; const DEFAULT_FROM: &str = "vaktmester@synops.no";
const DEFAULT_FROM_NAME: &str = "Synops Vaktmester"; const DEFAULT_FROM_NAME: &str = "Synops Vaktmester";
const DEFAULT_CONFIG: &str = "/srv/synops/config/msmtp/msmtprc"; const DEFAULT_CONFIG: &str = "/srv/synops/config/msmtp/msmtprc";
const DEFAULT_PHRASE: &str = "Kjære vaktmester";
/// Synops epost-verktøy: send og motta epost. /// Synops epost-verktøy: send og motta epost.
#[derive(Parser)] #[derive(Parser)]
#[command(name = "synops-mail", about = "Send og motta epost for Synops")] #[command(name = "synops-mail", about = "Send og motta epost for Synops")]
struct Cli { struct Cli {
#[command(subcommand)] /// Send-modus
command: Option<Commands>,
// --- Legacy flag-basert API (bakoverkompatibel) ---
/// Send-modus (legacy: bruk `send` subcommand i stedet)
#[arg(long)] #[arg(long)]
send: bool, send: bool,
/// Motta-modus (legacy: bruk `receive` subcommand i stedet) /// Motta-modus (fra Postfix pipe transport)
#[arg(long)] #[arg(long)]
receive: bool, receive: bool,
@ -70,18 +71,22 @@ struct Cli {
/// Envelope-avsender fra Postfix (--receive) /// Envelope-avsender fra Postfix (--receive)
#[arg(long)] #[arg(long)]
sender: Option<String>, sender: Option<String>,
}
#[derive(Subcommand)] /// Aktiveringsfrase som epost-body må starte med (default: "Kjære vaktmester")
enum Commands { #[arg(long, env = "SYNOPS_MAIL_PHRASE", default_value = DEFAULT_PHRASE)]
// Subcommands kan legges til senere phrase: String,
} }
fn main() { fn main() {
let cli = Cli::parse(); let cli = Cli::parse();
if cli.receive { if cli.receive {
run_receive(&cli); // Motta-modus trenger async for database
let rt = tokio::runtime::Runtime::new().unwrap_or_else(|e| {
eprintln!("synops-mail: kunne ikke starte tokio runtime: {e}");
std::process::exit(0);
});
rt.block_on(run_receive(&cli));
return; return;
} }
@ -90,6 +95,10 @@ fn main() {
std::process::exit(1); std::process::exit(1);
} }
run_send(&cli);
}
fn run_send(cli: &Cli) {
let to = cli.to.as_deref().unwrap_or_else(|| { let to = cli.to.as_deref().unwrap_or_else(|| {
eprintln!("Feil: --to er påkrevd for --send"); eprintln!("Feil: --to er påkrevd for --send");
std::process::exit(1); std::process::exit(1);
@ -100,8 +109,8 @@ fn main() {
}); });
// Les body fra --body eller stdin // Les body fra --body eller stdin
let body = match cli.body { let body = match &cli.body {
Some(b) => b, Some(b) => b.clone(),
None => { None => {
let mut buf = String::new(); let mut buf = String::new();
io::stdin().read_to_string(&mut buf).unwrap_or_else(|e| { io::stdin().read_to_string(&mut buf).unwrap_or_else(|e| {
@ -116,7 +125,7 @@ fn main() {
} }
}; };
let config_path = cli.config.unwrap_or_else(|| DEFAULT_CONFIG.to_string()); let config_path = cli.config.as_deref().unwrap_or(DEFAULT_CONFIG);
// Bygg RFC 5322-melding // Bygg RFC 5322-melding
let message = format!( let message = format!(
@ -130,14 +139,11 @@ fn main() {
{body}", {body}",
from_name = DEFAULT_FROM_NAME, from_name = DEFAULT_FROM_NAME,
from = cli.from, from = cli.from,
to = to,
subject = subject,
body = body,
); );
// Send via msmtp // Send via msmtp
let mut child = Command::new("msmtp") let mut child = Command::new("msmtp")
.args(["--file", &config_path, "--from", &cli.from, to]) .args(["--file", config_path, "--from", &cli.from, to])
.stdin(Stdio::piped()) .stdin(Stdio::piped())
.stdout(Stdio::piped()) .stdout(Stdio::piped())
.stderr(Stdio::piped()) .stderr(Stdio::piped())
@ -147,7 +153,6 @@ fn main() {
std::process::exit(1); std::process::exit(1);
}); });
// Skriv melding til msmtp stdin
if let Some(mut stdin) = child.stdin.take() { if let Some(mut stdin) = child.stdin.take() {
use std::io::Write; use std::io::Write;
stdin.write_all(message.as_bytes()).unwrap_or_else(|e| { stdin.write_all(message.as_bytes()).unwrap_or_else(|e| {
@ -172,27 +177,179 @@ fn main() {
/// Motta epost fra Postfix pipe transport. /// Motta epost fra Postfix pipe transport.
/// ///
/// Leser rå RFC 5322-epost fra stdin og logger mottaket. /// 1. Leser rå RFC 5322-epost fra stdin
/// Faktisk prosessering (brukeroppslag, node-opprettelse) implementeres i oppgave 26.5. /// 2. Parser eposten for å ekstrahere body og subject
fn run_receive(cli: &Cli) { /// 3. Sjekker at envelope-sender finnes i auth_identities.email
/// 4. Sjekker at body starter med aktiveringsfrasen
/// 5. Oppretter content-node med epostinnholdet
///
/// Exit 0 alltid — Postfix skal aldri prøve på nytt (ingen bounce).
async fn run_receive(cli: &Cli) {
synops_common::logging::init("synops_mail");
let recipient = cli.recipient.as_deref().unwrap_or("(ukjent)"); let recipient = cli.recipient.as_deref().unwrap_or("(ukjent)");
let sender = cli.sender.as_deref().unwrap_or("(ukjent)"); let sender = cli.sender.as_deref().unwrap_or("(ukjent)");
// Les rå epost fra stdin // Les rå epost fra stdin
let mut raw_email = String::new(); let mut raw_email = Vec::new();
if let Err(e) = io::stdin().read_to_string(&mut raw_email) { if let Err(e) = io::stdin().read_to_end(&mut raw_email) {
eprintln!("synops-mail receive: feil ved lesing fra stdin: {e}"); tracing::error!("feil ved lesing fra stdin: {e}");
// Exit 0 slik at Postfix ikke prøver på nytt return; // exit 0
std::process::exit(0);
} }
let size = raw_email.len(); tracing::info!(
from = sender,
// Logg mottaket (syslog via stderr som Postfix fanger) to = recipient,
eprintln!( size = raw_email.len(),
"synops-mail receive: mottatt epost fra={sender} til={recipient} størrelse={size} bytes" "epost mottatt"
); );
// Stub: aksepter og logg. Oppgave 26.5 implementerer brukeroppslag og node-opprettelse. // Parse eposten
// Exit 0 = levert OK (Postfix sletter fra kø) let parsed = match mailparse::parse_mail(&raw_email) {
Ok(p) => p,
Err(e) => {
tracing::warn!("kunne ikke parse epost: {e}");
return;
}
};
// Ekstraher subject fra headers
let subject = parsed
.headers
.iter()
.find(|h| h.get_key().eq_ignore_ascii_case("subject"))
.map(|h| h.get_value())
.unwrap_or_default();
// Ekstraher body (plain text)
let body = extract_plain_text(&parsed);
tracing::info!(subject = %subject, body_len = body.len(), "epost parset");
// Sjekk 1: Avsender-epost matcher auth_identities.email?
let db = match synops_common::db::connect().await {
Ok(pool) => pool,
Err(e) => {
tracing::error!("database-tilkobling feilet: {e}");
return;
}
};
let sender_email = sender.trim().to_lowercase();
let user_node_id: Option<uuid::Uuid> = match sqlx::query_scalar(
"SELECT node_id FROM auth_identities WHERE LOWER(email) = $1",
)
.bind(&sender_email)
.fetch_optional(&db)
.await
{
Ok(id) => id,
Err(e) => {
tracing::error!("database-spørring feilet: {e}");
return;
}
};
let user_node_id = match user_node_id {
Some(id) => {
tracing::info!(user_node_id = %id, "avsender verifisert");
id
}
None => {
tracing::info!(
sender = sender_email,
"avsender ikke funnet i auth_identities — forkaster"
);
return;
}
};
// Sjekk 2: Body starter med aktiveringsfrasen?
let body_trimmed = body.trim();
if !body_trimmed.starts_with(&cli.phrase) {
tracing::info!(
phrase = %cli.phrase,
body_start = &body_trimmed[..body_trimmed.len().min(50)],
"epost mangler aktiveringsfrase — forkaster"
);
return;
}
// Begge sjekker bestått — opprett content-node
let node_id = uuid::Uuid::now_v7();
let title = if subject.is_empty() {
format!("Epost fra {}", sender_email)
} else {
subject.clone()
};
let metadata = serde_json::json!({
"source": "email",
"from": sender_email,
"to": recipient,
"subject": subject,
});
match sqlx::query(
"INSERT INTO nodes (id, node_kind, title, content, visibility, metadata, created_by)
VALUES ($1, 'content', $2, $3, 'hidden', $4, $5)",
)
.bind(node_id)
.bind(&title)
.bind(body_trimmed)
.bind(&metadata)
.bind(user_node_id)
.execute(&db)
.await
{
Ok(_) => {
tracing::info!(
node_id = %node_id,
user = %user_node_id,
title = %title,
"content-node opprettet fra epost"
);
}
Err(e) => {
tracing::error!("kunne ikke opprette node: {e}");
}
}
}
/// Ekstraher plain text-body fra en parset epost.
/// Håndterer enkel body og multipart (tar første text/plain-del).
/// Prøver raw UTF-8 først for å unngå mailparse sin latin-1-fallback.
fn extract_plain_text(mail: &mailparse::ParsedMail) -> String {
if mail.subparts.is_empty() {
// Enkel (ikke-multipart) epost — prøv raw UTF-8 først
return get_body_utf8(mail);
}
// Multipart — finn første text/plain
for part in &mail.subparts {
let ctype = part.ctype.mimetype.to_lowercase();
if ctype == "text/plain" {
return get_body_utf8(part);
}
}
// Fallback: prøv første del
mail.subparts
.first()
.map(|p| get_body_utf8(p))
.unwrap_or_default()
}
/// Hent body fra en mail-del. Prøver raw bytes som UTF-8 først,
/// faller tilbake til mailparse sin charset-konvertering.
fn get_body_utf8(part: &mailparse::ParsedMail) -> String {
// Hvis raw body-bytes er gyldig UTF-8, bruk det direkte
if let Ok(raw) = part.get_body_raw() {
if let Ok(s) = String::from_utf8(raw) {
return s;
}
}
// Ellers la mailparse håndtere charset-konvertering
part.get_body().unwrap_or_default()
} }