openauth-core 0.0.4

Core types and primitives for OpenAuth.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

//! OpenAuth secret-rotation envelope helpers.

const ENVELOPE_PREFIX: &str = "$oa$";

/// Parsed OpenAuth encrypted payload envelope.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct Envelope {
    pub version: u32,
    pub ciphertext: String,
}

/// Parse `$oa$<version>$<ciphertext>` payloads.
pub fn parse_envelope(data: &str) -> Option<Envelope> {
    let rest = data.strip_prefix(ENVELOPE_PREFIX)?;
    let (version, ciphertext) = rest.split_once('$')?;
    if version.starts_with('-') {
        return None;
    }
    let version = version.parse::<u32>().ok()?;

    Some(Envelope {
        version,
        ciphertext: ciphertext.to_owned(),
    })
}

/// Format a ciphertext with OpenAuth's secret-rotation envelope.
pub fn format_envelope(version: u32, ciphertext: &str) -> String {
    format!("{ENVELOPE_PREFIX}{version}${ciphertext}")
}