plane 0.5.5

Session backend orchestrator for ambitious browser-based apps.
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

use plane_common::types::ClusterName;
use std::str::FromStr;

/// Maps a requested domain name to a cluster name.
///
/// This can be configured to operate in two ways.
///
/// If the `cname_zone` is `None`, the server assumes that it is the authoritative
/// DNS server for the cluster. It expects requests of the form
/// _acme-challenge.<cluster name>, and will strip the _acme-challenge prefix.
///
/// If the `cname_zone` is `Some(_)`, the server will expect requests of the form
/// <cluster name>.<cname_zone>, and will strip the <cname_zone> suffix.
///
/// Note that the _acme-challenge. prefix is not expected in the case where
/// `cname_zone` is `Some(_)`. The _acme-challenge record should be pointed
/// directly to the <cluster name>.<cname_zone> record via a CNAME record.
///
/// In production, the `cname_zone` should always be set (and the CLI enforces
/// this), but for testing it is useful to be able to run without a `cnbame_zone`
pub struct NameToCluster {
    cname_zone: Option<String>,
}

impl NameToCluster {
    pub fn new(cname_zone: Option<String>) -> Self {
        Self { cname_zone }
    }

    pub fn cluster_name(&self, name: &str) -> Option<ClusterName> {
        let name = name.strip_suffix('.').unwrap_or(name);

        match &self.cname_zone {
            Some(cname_zone) => {
                let name = name.strip_suffix(cname_zone)?;
                let name = name.strip_suffix('.').unwrap_or(name);
                ClusterName::from_str(name).ok()
            }
            None => {
                let name = name.strip_prefix("_acme-challenge.")?;
                ClusterName::from_str(name).ok()
            }
        }
    }
}

#[cfg(test)]
mod test {
    use plane_common::types::ClusterName;
    use std::str::FromStr;

    #[test]
    fn test_no_cname_zone() {
        let name_to_cluster = super::NameToCluster::new(None);

        assert_eq!(
            name_to_cluster.cluster_name("foo.bar.baz"),
            None,
            "No cluster name should be returned for a domain without a _acme-challenge prefix."
        );

        assert_eq!(
            name_to_cluster.cluster_name("_acme-challenge.foo.bar.baz"),
            Some(ClusterName::from_str("foo.bar.baz").unwrap())
        );

        assert_eq!(
            name_to_cluster.cluster_name("_acme-challenge.foo.bar.baz."),
            Some(ClusterName::from_str("foo.bar.baz").unwrap())
        );
    }

    #[test]
    fn test_cname_zone() {
        let name_to_cluster = super::NameToCluster::new(Some("example.com".to_string()));

        assert_eq!(
            name_to_cluster.cluster_name("foo.bar.baz"),
            None,
            "No match for a domain that lacks the cname zone."
        );

        assert_eq!(
            name_to_cluster.cluster_name("foo.bar.baz.example.com"),
            Some(ClusterName::from_str("foo.bar.baz").unwrap())
        );

        assert_eq!(
            name_to_cluster.cluster_name("foo.bar.baz.example.com."),
            Some(ClusterName::from_str("foo.bar.baz").unwrap())
        );
    }
}