kdbx-rs 0.5.2

Keepass 2 (KDBX) password database parsing and creation
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
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

use base64::prelude::{Engine, BASE64_STANDARD};
use chrono::{DateTime, Duration, NaiveDate, NaiveDateTime};
use uuid::Uuid;

pub fn keepass_epoch() -> NaiveDateTime {
    NaiveDate::from_ymd_opt(1, 1, 1)
        .unwrap()
        .and_hms_opt(0, 0, 0)
        .unwrap()
}

/// Decode a UUID from a Keepass XML file
///
/// The UUID in Keepass XML files is stored base 64 encoded
pub fn decode_uuid(b64uuid: &str) -> Option<Uuid> {
    let decoded = BASE64_STANDARD.decode(b64uuid).ok()?;
    Uuid::from_slice(&decoded).ok()
}

pub(crate) fn decode_datetime_b64(b64date: &str) -> Option<NaiveDateTime> {
    let decoded = BASE64_STANDARD.decode(b64date).ok()?;
    let mut bytes = [0u8; 8];
    let copy_size = usize::min(bytes.len(), decoded.len());
    bytes[..copy_size].copy_from_slice(&decoded[..copy_size]);
    let timestamp = Duration::seconds(i64::from_le_bytes(bytes));

    keepass_epoch().checked_add_signed(timestamp)
}

/// Decode a Datetime from a Keepass XML file
///
/// This handles either ISO8601 date strings (as used in KDBX3)
/// or base64 encoded seconds since 1/1/1 00:00:00 as used in KDBX 4
pub fn decode_datetime(strdate: &str) -> Option<NaiveDateTime> {
    if strdate.contains('-') {
        let dt = DateTime::parse_from_rfc3339(strdate).ok()?;
        Some(dt.naive_utc())
    } else {
        decode_datetime_b64(strdate)
    }
}

/// Encode a UUID for a Keepass XML file for kdbx4
pub fn encode_uuid(uuid: Uuid) -> String {
    BASE64_STANDARD.encode(uuid.as_bytes())
}

/// Encode a datetime for a Keepass XML file for kdbx4
pub fn encode_datetime(date: NaiveDateTime) -> String {
    let epoch_seconds = date.signed_duration_since(keepass_epoch()).num_seconds();
    BASE64_STANDARD.encode(epoch_seconds.to_le_bytes())
}