diff options
| author | tv <tv@krebsco.de> | 2026-11-15 16:43:53 +0000 |
|---|---|---|
| committer | tv <tv@krebsco.de> | 2026-11-15 16:43:53 +0000 |
| commit | af120b87c42ca56f69bbe6f8d27c023919742430 (patch) | |
| tree | 60b493edf48aad388ddc9682498f1ad8c5527b53 /src/access/policy.rs | |
| parent | 2d1c64a6e7134f4d6942d4539b27d45f14e7538c (diff) | |
swarm: a new swarm's policy recorded in its genesis change
A swarm strict from its start had its policy written by its first user
in a later change. A change is judged by the policy at its history, so
any member could always add a change whose history is from before the
policy: judged by none, needing no signature, taken whenever it comes.
Since signed values are read by `seq`, an envelope planted there with
the highest `seq` there is can never be followed: a ban, a user, a
declaration, for good.
`--bootstrap-policy JSON`, with `--genesis`, records the policy in the
genesis change, with the first users: then no change of the swarm is
from before it. It must be a policy this node knows, and a strict one
needs `--bootstrap-keys`, or nobody could sign what decides who may do
what.
Diffstat (limited to 'src/access/policy.rs')
| -rw-r--r-- | src/access/policy.rs | 48 |
1 files changed, 48 insertions, 0 deletions
diff --git a/src/access/policy.rs b/src/access/policy.rs index 85b562a..9f18eb5 100644 --- a/src/access/policy.rs +++ b/src/access/policy.rs @@ -56,6 +56,36 @@ impl Policy { } } +/// The policy a new swarm records in its first change (`--bootstrap-policy`, its JSON), +/// checked: one this node knows; strict, only with its first users' keys +/// (`--bootstrap-keys`), or nobody could sign what decides who may do what. None +/// given: none. +pub(crate) fn first( + given: Option<&str>, + bootstrap_keys: &[String], +) -> Result<Option<JsonValue>, String> { + let Some(given) = given else { + return Ok(None); + }; + let value: JsonValue = serde_json::from_str(given) + .map_err(|error| format!("bootstrap-policy isn't JSON: {error}"))?; + let mut doc = crate::document::Document::new(); + let mut write = doc.transaction(); + store::write_path(&mut write, &path(), &value) + .map_err(|error| format!("bootstrap-policy: {error}"))?; + let policy = of(&write); + write.rollback(); + match policy { + Policy::Unknown(why) => Err(format!("bootstrap-policy: one this node doesn't know: {why}")), + Policy::Open => Err("bootstrap-policy: no policy".to_owned()), + policy if policy.strict() && bootstrap_keys.is_empty() => Err( + "bootstrap-policy: strict, but no bootstrap-keys: nobody could sign what decides who may do what" + .to_owned(), + ), + _ => Ok(Some(value)), + } +} + /// The policy `doc` holds. pub(crate) fn of(doc: &impl ReadDoc) -> Policy { let value = match store::read_plain(doc, &path()) { @@ -145,4 +175,22 @@ mod tests { )); assert!(matches!(with(json!("on")), Policy::Unknown(_))); } + + /// A new swarm's policy: one this node knows; strict, only with keys to sign. + #[test] + fn the_first_policy() { + let keys = ["alice=ssh-ed25519 AAAA".to_owned()]; + assert_eq!(first(None, &[]), Ok(None)); + assert_eq!( + first(Some(r#"{"version": 1}"#), &[]), + Ok(Some(json!({"version": 1}))) + ); + assert_eq!( + first(Some(r#"{"version": 1, "values": "signed"}"#), &keys), + Ok(Some(json!({"version": 1, "values": "signed"}))) + ); + assert!(first(Some(r#"{"version": 1, "values": "signed"}"#), &[]).is_err()); + assert!(first(Some(r#"{"version": 2}"#), &keys).is_err()); + assert!(first(Some("not json"), &keys).is_err()); + } } |
