[go: up one dir, main page]

base64ct 1.3.3

Pure Rust implementation of Base64 (RFC 4648) which avoids any usages of data-dependent branches/LUTs and thereby provides portable "best effort" constant-time operation and embedded-friendly no_std support
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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128

//! URL-safe Base64 tests

#[macro_use]
mod common;

/// URL-safe Base64 with `=` padding
mod padded {
    use crate::common::*;
    use base64ct::Base64Url;

    const TEST_VECTORS: &[TestVector] = &[
        TestVector { raw: b"", b64: "" },
        TestVector {
            raw: b"\0",
            b64: "AA==",
        },
        TestVector {
            raw: b"***",
            b64: "Kioq",
        },
        TestVector {
            raw: b"\x01\x02\x03\x04",
            b64: "AQIDBA==",
        },
        TestVector {
            raw: b"\xAD\xAD\xAD\xAD\xAD",
            b64: "ra2tra0=",
        },
        TestVector {
            raw: b"\xFF\xEF\xFE\xFF\xEF\xFE",
            b64: "_-_-_-_-",
        },
        TestVector {
            raw: b"\xFF\xFF\xFF\xFF\xFF",
            b64: "______8=",
        },
        TestVector {
            raw: b"\x40\xC1\x3F\xBD\x05\x4C\x72\x2A\xA3\xC2\xF2\x11\x73\xC0\x69\xEA\
                   \x49\x7D\x35\x29\x6B\xCC\x24\x65\xF6\xF9\xD0\x41\x08\x7B\xD7\xA9",
            b64: "QME_vQVMciqjwvIRc8Bp6kl9NSlrzCRl9vnQQQh716k=",
        },
        TestVector {
            raw: b"\x00\x10\x83\x10Q\x87 \x92\x8B0\xD3\x8FA\x14\x93QU\x97a\x96\x9Bq\
                   \xD7\x9F\x82\x18\xA3\x92Y\xA7\xA2\x9A\xAB\xB2\xDB\xAF\xC3\x1C\xB3\
                   \xFB\xF0\x00",
            b64: "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz-_AA",
        },
    ];

    impl_tests!(Base64Url);

    #[test]
    fn reject_trailing_whitespace() {
        let input = "QME/vQVMciqjwvIRc8Bp6kl9NSlrzCRl9vnQQQh716k\n";
        let mut buf = [0u8; 1024];
        assert_eq!(
            Base64Url::decode(input, &mut buf),
            Err(Error::InvalidEncoding)
        );
    }
}

/// URL-safe Base64 *without* padding
mod unpadded {
    use crate::common::*;
    use base64ct::Base64UrlUnpadded;

    const TEST_VECTORS: &[TestVector] = &[
        TestVector { raw: b"", b64: "" },
        TestVector {
            raw: b"\0",
            b64: "AA",
        },
        TestVector {
            raw: b"***",
            b64: "Kioq",
        },
        TestVector {
            raw: b"\x01\x02\x03\x04",
            b64: "AQIDBA",
        },
        TestVector {
            raw: b"\xAD\xAD\xAD\xAD\xAD",
            b64: "ra2tra0",
        },
        TestVector {
            raw: b"\xFF\xEF\xFE\xFF\xEF\xFE",
            b64: "_-_-_-_-",
        },
        TestVector {
            raw: b"\xFF\xFF\xFF\xFF\xFF",
            b64: "______8",
        },
        TestVector {
            raw: b"\x40\xC1\x3F\xBD\x05\x4C\x72\x2A\xA3\xC2\xF2\x11\x73\xC0\x69\xEA\
                   \x49\x7D\x35\x29\x6B\xCC\x24\x65\xF6\xF9\xD0\x41\x08\x7B\xD7\xA9",
            b64: "QME_vQVMciqjwvIRc8Bp6kl9NSlrzCRl9vnQQQh716k",
        },
        TestVector {
            raw: b"\x00\x10\x83\x10Q\x87 \x92\x8B0\xD3\x8FA\x14\x93QU\x97a\x96\x9Bq\
                   \xD7\x9F\x82\x18\xA3\x92Y\xA7\xA2\x9A\xAB\xB2\xDB\xAF\xC3\x1C\xB3\
                   \xFB\xF0\x00",
            b64: "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz-_AA",
        },
    ];

    impl_tests!(Base64UrlUnpadded);

    #[test]
    fn reject_trailing_whitespace() {
        let input = "QME/vQVMciqjwvIRc8Bp6kl9NSlrzCRl9vnQQQh716k\n";
        let mut buf = [0u8; 1024];
        assert_eq!(
            Base64UrlUnpadded::decode(input, &mut buf),
            Err(Error::InvalidEncoding)
        );
    }

    #[test]
    fn unpadded_reject_trailing_equals() {
        let input = "QME_vQVMciqjwvIRc8Bp6kl9NSlrzCRl9vnQQQh716k=";
        let mut buf = [0u8; 1024];
        assert_eq!(
            Base64UrlUnpadded::decode(input, &mut buf),
            Err(Error::InvalidEncoding)
        );
    }
}