kaniop_radius/reconcile/
image.rs1use thiserror::Error;
9
10pub const RADIUS_UID: i64 = 497;
13pub const RADIUS_GID: i64 = 496;
16
17const VERIFIED_RADIUS_RELEASE: &str = "1.12.1";
22
23#[derive(Debug, Error, PartialEq, Eq)]
24pub enum RadiusImageError {
25 #[error("RADIUS image must not be empty")]
26 EmptyImage,
27 #[error("explicit RADIUS image is required for an unrecognized or unpinned Kanidm image")]
28 ExplicitImageRequired,
29}
30
31pub fn resolve_radius_image(
37 kanidm_image: &str,
38 override_image: Option<&str>,
39) -> Result<String, RadiusImageError> {
40 if let Some(image) = override_image {
41 if image.trim().is_empty() {
42 return Err(RadiusImageError::EmptyImage);
43 }
44 return Ok(image.to_string());
45 }
46
47 let mut parts = kanidm_image.rsplitn(2, ':');
50 let tag = parts
51 .next()
52 .ok_or(RadiusImageError::ExplicitImageRequired)?;
53 let name = parts
54 .next()
55 .ok_or(RadiusImageError::ExplicitImageRequired)?;
56 if !matches!(
57 name,
58 "kanidm/server" | "docker.io/kanidm/server" | "index.docker.io/kanidm/server"
59 ) || tag != VERIFIED_RADIUS_RELEASE
60 {
61 return Err(RadiusImageError::ExplicitImageRequired);
62 }
63
64 Ok(format!("kanidm/radius:{tag}"))
65}
66
67#[cfg(test)]
68mod tests {
69 use super::*;
70
71 #[test]
72 fn maps_official_dockerhub_release_tag_only() {
73 for image in [
74 "kanidm/server:1.12.1",
75 "docker.io/kanidm/server:1.12.1",
76 "index.docker.io/kanidm/server:1.12.1",
77 ] {
78 assert_eq!(
79 resolve_radius_image(image, None),
80 Ok("kanidm/radius:1.12.1".into())
81 );
82 }
83 }
84
85 #[test]
86 fn does_not_copy_digest_or_guess_nonofficial_registry() {
87 for image in [
88 "kanidm/server@sha256:deadbeef",
89 "docker.io/kanidm/server:latest",
90 "ghcr.io/kanidm/server:1.12.1",
91 "example.com/my/server:1.12.1",
92 "kanidm/server:devel",
93 "kanidm/server:1.12.2",
94 "kanidm/server:1.12",
95 "kanidm/server",
96 ] {
97 assert_eq!(
98 resolve_radius_image(image, None),
99 Err(RadiusImageError::ExplicitImageRequired)
100 );
101 }
102 }
103
104 #[test]
105 fn overrides_are_passed_through_unmodified() {
106 assert_eq!(
107 resolve_radius_image(
108 "kanidm/server@sha256:deadbeef",
109 Some("mirror.example/radius@sha256:abcdef")
110 ),
111 Ok("mirror.example/radius@sha256:abcdef".into())
112 );
113 }
114
115 #[test]
116 fn explicitly_blank_override_fails_closed() {
117 assert_eq!(
118 resolve_radius_image("kanidm/server:1.12.1", Some(" ")),
119 Err(RadiusImageError::EmptyImage)
120 );
121 }
122}