use thiserror::Error;
pub const RADIUS_UID: i64 = 497;
pub const RADIUS_GID: i64 = 496;
const VERIFIED_RADIUS_RELEASE: &str = "1.12.1";
#[derive(Debug, Error, PartialEq, Eq)]
pub enum RadiusImageError {
#[error("RADIUS image must not be empty")]
EmptyImage,
#[error("explicit RADIUS image is required for an unrecognized or unpinned Kanidm image")]
ExplicitImageRequired,
}
pub fn resolve_radius_image(
kanidm_image: &str,
override_image: Option<&str>,
) -> Result<String, RadiusImageError> {
if let Some(image) = override_image {
if image.trim().is_empty() {
return Err(RadiusImageError::EmptyImage);
}
return Ok(image.to_string());
}
let mut parts = kanidm_image.rsplitn(2, ':');
let tag = parts
.next()
.ok_or(RadiusImageError::ExplicitImageRequired)?;
let name = parts
.next()
.ok_or(RadiusImageError::ExplicitImageRequired)?;
if !matches!(
name,
"kanidm/server" | "docker.io/kanidm/server" | "index.docker.io/kanidm/server"
) || tag != VERIFIED_RADIUS_RELEASE
{
return Err(RadiusImageError::ExplicitImageRequired);
}
Ok(format!("kanidm/radius:{tag}"))
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn maps_official_dockerhub_release_tag_only() {
for image in [
"kanidm/server:1.12.1",
"docker.io/kanidm/server:1.12.1",
"index.docker.io/kanidm/server:1.12.1",
] {
assert_eq!(
resolve_radius_image(image, None),
Ok("kanidm/radius:1.12.1".into())
);
}
}
#[test]
fn does_not_copy_digest_or_guess_nonofficial_registry() {
for image in [
"kanidm/server@sha256:deadbeef",
"docker.io/kanidm/server:latest",
"ghcr.io/kanidm/server:1.12.1",
"example.com/my/server:1.12.1",
"kanidm/server:devel",
"kanidm/server:1.12.2",
"kanidm/server:1.12",
"kanidm/server",
] {
assert_eq!(
resolve_radius_image(image, None),
Err(RadiusImageError::ExplicitImageRequired)
);
}
}
#[test]
fn overrides_are_passed_through_unmodified() {
assert_eq!(
resolve_radius_image(
"kanidm/server@sha256:deadbeef",
Some("mirror.example/radius@sha256:abcdef")
),
Ok("mirror.example/radius@sha256:abcdef".into())
);
}
#[test]
fn explicitly_blank_override_fails_closed() {
assert_eq!(
resolve_radius_image("kanidm/server:1.12.1", Some(" ")),
Err(RadiusImageError::EmptyImage)
);
}
}