1use clap::{Args, Subcommand};
2use std::os::fd::RawFd;
3use std::path::PathBuf;
4
5#[cfg(test)]
6mod tests {
7 use super::TrustCommand;
8 use clap::Subcommand as _;
9
10 #[test]
13 fn trust_argument_relationships_resolve() {
14 TrustCommand::augment_subcommands(clap::Command::new("hyprstream")).debug_assert();
15 }
16}
17
18#[derive(Debug, Subcommand)]
19pub enum TrustCommand {
20 HashMacBootPolicy(HashMacBootPolicyArgs),
22 SignMacBootPolicy(SignMacBootPolicyArgs),
24 ReconcileMacBootEnrollment(ReconcileMacBootEnrollmentArgs),
27 MintDeploymentCa(MintDeploymentCaArgs),
29 DelegateRegistrySigner(DelegateRegistrySignerArgs),
31 MintRegistryJwt(MintRegistryJwtArgs),
33 EnrollServiceKey(EnrollServiceKeyArgs),
36 VerifyDeployment(VerifyDeploymentArgs),
38 RotateAuthority(RotateAuthorityArgs),
40 Install(InstallDeploymentTrustArgs),
43
44 MintAnchorCapsule(MintAnchorCapsuleArgs),
46}
47
48#[derive(Debug, Args)]
49pub struct HashMacBootPolicyArgs {
50 #[arg(long)]
52 pub policy_input: PathBuf,
53 #[arg(long)]
55 pub reviewed_ucan: PathBuf,
56}
57
58#[derive(Debug, Args)]
59pub struct ReconcileMacBootEnrollmentArgs {
60 #[arg(long)]
62 pub journal_dir: PathBuf,
63 #[arg(long)]
65 pub current_policy: PathBuf,
66 #[arg(long)]
68 pub expected_generation: u64,
69 #[arg(long)]
71 pub expected_hash: String,
72 #[arg(long)]
74 pub output_dir: PathBuf,
75}
76
77#[derive(Debug, Args)]
78pub struct SignMacBootPolicyArgs {
79 #[arg(long)]
81 pub policy_input: PathBuf,
82 #[arg(long)]
84 pub reviewed_ucan: PathBuf,
85 #[arg(long)]
87 pub expected_generation: u64,
88 #[arg(long)]
90 pub expected_hash: String,
91 #[arg(long)]
93 pub secrets_dir: PathBuf,
94 #[arg(long)]
96 pub output_dir: PathBuf,
97}
98
99#[derive(Debug, Args)]
100pub struct MintAnchorCapsuleArgs {
101 #[arg(long, default_value = "deployment-ca.hybrid")]
103 pub public_ca: PathBuf,
104
105 #[arg(long, default_value = "deployment-ca.age")]
107 pub authority_key: PathBuf,
108
109 #[arg(long, default_value = "deployment-authority.log.json")]
111 pub authority_log: PathBuf,
112
113 #[arg(long, default_value = "deployment-authority.head.json")]
115 pub authority_checkpoint: PathBuf,
116
117 #[arg(long = "identity", value_name = "AGE_IDENTITY_FILE")]
119 pub identities: Vec<PathBuf>,
120
121 #[arg(long = "yubikey-identity", value_name = "AGE_YUBIKEY_IDENTITY_FILE")]
123 pub yubikey_identities: Vec<PathBuf>,
124
125 #[arg(long)]
127 pub software_recovery: bool,
128
129 #[arg(long, value_name = "DID_WEB")]
131 pub did_web: String,
132
133 #[arg(long, value_name = "MULTIKEY", conflicts_with = "quic_endpoint")]
135 pub iroh_node_id: Option<String>,
136
137 #[arg(long, value_name = "URL", requires = "iroh_node_id")]
139 pub iroh_relay: Option<String>,
140
141 #[arg(long, value_name = "ADDR")]
143 pub quic_endpoint: Option<std::net::SocketAddr>,
144
145 #[arg(long, value_name = "HOST", requires = "quic_endpoint")]
147 pub quic_sni: Option<String>,
148
149 #[arg(
151 long = "quic-cert-sha256",
152 value_name = "HEX",
153 requires = "quic_endpoint"
154 )]
155 pub quic_cert_sha256: Vec<String>,
156
157 #[arg(long, requires = "quic_endpoint")]
159 pub quic_web_pki: bool,
160
161 #[arg(long, value_name = "MULTIBASE", requires_all = ["mesh_kem_mlkem768", "mesh_pq"])]
163 pub mesh_kem_x25519: Option<String>,
164
165 #[arg(long, value_name = "MULTIBASE", requires_all = ["mesh_kem_x25519", "mesh_pq"])]
167 pub mesh_kem_mlkem768: Option<String>,
168
169 #[arg(long, value_name = "MULTIBASE", requires_all = ["mesh_kem_x25519", "mesh_kem_mlkem768"])]
171 pub mesh_pq: Option<String>,
172
173 #[arg(long, default_value = "anchor-capsule.cbor")]
175 pub capsule_out: PathBuf,
176
177 #[arg(long, default_value = "did.json")]
179 pub did_json_out: PathBuf,
180
181 #[arg(long)]
183 pub force: bool,
184}
185
186#[derive(Debug, Args)]
187pub struct MintDeploymentCaArgs {
188 #[arg(long, default_value = "deployment-ca.hybrid")]
190 pub public_ca: PathBuf,
191
192 #[arg(long, default_value = "deployment-ca.age")]
194 pub authority_key: PathBuf,
195
196 #[arg(long, default_value = "deployment-authority.log.json")]
198 pub authority_log: PathBuf,
199
200 #[arg(long, default_value = "deployment-authority.head.json")]
202 pub authority_checkpoint: PathBuf,
203
204 #[arg(long = "recipient", value_name = "AGE_RECIPIENT")]
206 pub recipients: Vec<String>,
207
208 #[arg(long = "yubikey", value_name = "AGE_YUBIKEY_RECIPIENT")]
210 pub yubikey_recipients: Vec<String>,
211
212 #[arg(long = "kms-plugin", value_name = "AGE_PLUGIN_RECIPIENT")]
214 pub kms_plugin_recipients: Vec<String>,
215
216 #[arg(long, value_name = "SLOT")]
218 pub piv_slot: Option<String>,
219
220 #[arg(long)]
222 pub force: bool,
223}
224
225#[derive(Debug, Args)]
226pub struct DelegateRegistrySignerArgs {
227 #[arg(long, default_value = "deployment-ca.hybrid")]
229 pub public_ca: PathBuf,
230
231 #[arg(long, default_value = "deployment-authority.log.json")]
233 pub authority_log: PathBuf,
234
235 #[arg(long, default_value = "deployment-authority.head.json")]
237 pub authority_checkpoint: PathBuf,
238
239 #[arg(long, default_value = "deployment-ca.age")]
241 pub authority_key: PathBuf,
242
243 #[arg(long = "identity", value_name = "AGE_IDENTITY_FILE")]
245 pub identities: Vec<PathBuf>,
246
247 #[arg(long = "yubikey-identity", value_name = "AGE_YUBIKEY_IDENTITY_FILE")]
249 pub yubikey_identities: Vec<PathBuf>,
250
251 #[arg(long)]
253 pub software_recovery: bool,
254
255 #[arg(long = "signer-recipient", value_name = "AGE_RECIPIENT")]
257 pub signer_recipients: Vec<String>,
258
259 #[arg(long, default_value = "registry-delegated-signer.age")]
261 pub delegated_key: PathBuf,
262
263 #[arg(long, default_value = "registry-signer.delegation.json")]
265 pub delegation: PathBuf,
266
267 #[arg(
269 long,
270 default_value_t = 2_592_000,
271 value_parser = clap::value_parser!(u64).range(3600..=31_536_000)
272 )]
273 pub delegation_ttl_seconds: u64,
274
275 #[arg(long)]
277 pub force: bool,
278}
279
280#[derive(Debug, Args)]
281#[command(group = clap::ArgGroup::new("delegated_signer")
282 .args(["via_delegated_signer", "via_delegated_signer_fd"])
283 .multiple(false)
284 .conflicts_with("root"))]
285pub struct MintRegistryJwtArgs {
286 #[arg(long, default_value = "deployment-ca.hybrid")]
288 pub public_ca: PathBuf,
289
290 #[arg(long, default_value = "deployment-ca.age")]
292 pub authority_key: PathBuf,
293
294 #[arg(
296 long = "identity",
297 value_name = "AGE_IDENTITY_FILE",
298 conflicts_with = "identity_fds"
299 )]
300 pub identities: Vec<PathBuf>,
301
302 #[arg(long = "identity-fd", value_name = "FD", value_parser = clap::value_parser!(RawFd).range(0..))]
306 pub identity_fds: Vec<RawFd>,
307
308 #[arg(long = "yubikey-identity", value_name = "AGE_YUBIKEY_IDENTITY_FILE")]
310 pub yubikey_identities: Vec<PathBuf>,
311
312 #[arg(long)]
314 pub software_recovery: bool,
315
316 #[arg(long, value_name = "DELEGATED_KEY.age")]
318 pub via_delegated_signer: Option<PathBuf>,
319
320 #[arg(long, value_name = "FD", value_parser = clap::value_parser!(RawFd).range(0..))]
324 pub via_delegated_signer_fd: Option<RawFd>,
325
326 #[arg(long, value_name = "DELEGATION.json", requires = "delegated_signer")]
328 pub delegation: Option<PathBuf>,
329
330 #[arg(long, default_value = "deployment-authority.log.json")]
332 pub authority_log: PathBuf,
333
334 #[arg(long, default_value = "deployment-authority.head.json")]
336 pub authority_checkpoint: PathBuf,
337
338 #[arg(long, required_unless_present = "delegated_signer")]
342 pub root: bool,
343
344 #[arg(long, value_name = "PATH")]
346 pub registry_public_key: PathBuf,
347
348 #[arg(long, default_value_t = 3600, value_parser = clap::value_parser!(u32).range(1..=3600))]
350 pub ttl_seconds: u32,
351
352 #[arg(long, default_value = "registry-service.jwt")]
354 pub jwt: PathBuf,
355
356 #[arg(long, default_value = "deployment-trust.contract.json")]
358 pub contract: PathBuf,
359
360 #[arg(long)]
362 pub force: bool,
363}
364
365#[derive(Debug, Args)]
366#[command(group = clap::ArgGroup::new("delegated_signer")
367 .args(["via_delegated_signer", "via_delegated_signer_fd"])
368 .required(true)
369 .multiple(false))]
370pub struct EnrollServiceKeyArgs {
371 #[arg(long, default_value = "deployment-ca.hybrid")]
373 pub public_ca: PathBuf,
374
375 #[arg(long, default_value = "deployment-authority.log.json")]
377 pub authority_log: PathBuf,
378
379 #[arg(long, default_value = "deployment-authority.head.json")]
381 pub authority_checkpoint: PathBuf,
382
383 #[arg(
385 long = "identity",
386 value_name = "AGE_IDENTITY_FILE",
387 conflicts_with = "identity_fds"
388 )]
389 pub identities: Vec<PathBuf>,
390
391 #[arg(long = "identity-fd", value_name = "FD", value_parser = clap::value_parser!(RawFd).range(0..))]
395 pub identity_fds: Vec<RawFd>,
396
397 #[arg(long = "yubikey-identity", value_name = "AGE_YUBIKEY_IDENTITY_FILE")]
399 pub yubikey_identities: Vec<PathBuf>,
400
401 #[arg(long)]
403 pub software_recovery: bool,
404
405 #[arg(long, value_name = "DELEGATED_KEY.age")]
407 pub via_delegated_signer: Option<PathBuf>,
408
409 #[arg(long, value_name = "FD", value_parser = clap::value_parser!(RawFd).range(0..))]
413 pub via_delegated_signer_fd: Option<RawFd>,
414
415 #[arg(long, value_name = "DELEGATION.json")]
417 pub delegation: PathBuf,
418
419 #[arg(long, value_parser = ["discovery", "policy"])]
421 pub service: String,
422
423 #[arg(long, value_name = "PATH")]
426 pub service_public_key: PathBuf,
427
428 #[arg(long, default_value_t = 3600, value_parser = clap::value_parser!(u32).range(1..=3600))]
430 pub ttl_seconds: u32,
431
432 #[arg(long, default_value = "service-key-enrollment.json")]
434 pub attestation: PathBuf,
435
436 #[arg(long)]
438 pub force: bool,
439}
440
441#[derive(Debug, Args)]
442pub struct RotateAuthorityArgs {
443 #[arg(long, default_value = "deployment-ca.hybrid")]
445 pub public_ca: PathBuf,
446
447 #[arg(long, default_value = "deployment-authority.log.json")]
449 pub authority_log: PathBuf,
450
451 #[arg(long, default_value = "deployment-authority.head.json")]
453 pub authority_checkpoint: PathBuf,
454
455 #[arg(long, default_value = "deployment-ca.age")]
457 pub authority_key: PathBuf,
458
459 #[arg(long = "identity", value_name = "AGE_IDENTITY_FILE")]
461 pub identities: Vec<PathBuf>,
462
463 #[arg(long = "yubikey-identity", value_name = "AGE_YUBIKEY_IDENTITY_FILE")]
465 pub yubikey_identities: Vec<PathBuf>,
466
467 #[arg(long)]
469 pub software_recovery: bool,
470
471 #[arg(long = "recipient", value_name = "AGE_RECIPIENT")]
473 pub recipients: Vec<String>,
474
475 #[arg(long, conflicts_with = "replace")]
477 pub add: bool,
478
479 #[arg(long, conflicts_with = "add")]
481 pub replace: bool,
482
483 #[arg(long, default_value = "deployment-authority-next.age")]
485 pub new_authority_key: PathBuf,
486
487 #[arg(long, default_value = "deployment-authority-next.hybrid")]
489 pub new_public_key: PathBuf,
490
491 #[arg(long, default_value = "deployment-authority.log.next.json")]
493 pub authority_log_out: PathBuf,
494
495 #[arg(long, default_value = "deployment-authority.head.next.json")]
497 pub authority_checkpoint_out: PathBuf,
498
499 #[arg(long)]
501 pub force: bool,
502}
503
504#[derive(Debug, Args)]
505pub struct InstallDeploymentTrustArgs {
506 #[arg(long, default_value = "deployment-ca.hybrid")]
508 pub public_ca: PathBuf,
509
510 #[arg(long, default_value = "deployment-authority.log.json")]
512 pub authority_log: PathBuf,
513
514 #[arg(long, default_value = "deployment-authority.head.json")]
516 pub authority_checkpoint: PathBuf,
517
518 #[arg(long, requires = "delegation")]
522 pub delegated_key: Option<PathBuf>,
523
524 #[arg(long, requires = "delegated_key")]
526 pub delegation: Option<PathBuf>,
527
528 #[arg(long, requires = "delegated_key")]
531 pub registry_public_key: Option<PathBuf>,
532
533 #[arg(long, requires = "delegated_key", value_name = "AGE_IDENTITY_FILE")]
538 pub refresh_identity: Option<PathBuf>,
539
540 #[arg(
543 long,
544 default_value = "30min",
545 requires = "delegated_key",
546 value_name = "SYSTEMD_TIME_SPAN"
547 )]
548 pub refresh_interval: String,
549
550 #[arg(long)]
553 pub force: bool,
554
555 #[arg(long)]
558 pub no_enable: bool,
559}
560
561#[derive(Debug, Args)]
562pub struct VerifyDeploymentArgs {
563 #[arg(long, default_value = "deployment-ca.hybrid")]
565 pub public_ca: PathBuf,
566
567 #[arg(long, default_value = "registry-service.jwt")]
569 pub jwt: PathBuf,
570
571 #[arg(long, default_value = "deployment-authority.log.json")]
573 pub authority_log: PathBuf,
574
575 #[arg(long, default_value = "deployment-authority.head.json")]
577 pub authority_checkpoint: PathBuf,
578
579 #[arg(long)]
581 pub contract: Option<PathBuf>,
582
583 #[arg(long = "service-key-attestation", value_name = "ATTESTATION_FILE")]
589 pub service_key_attestations: Vec<PathBuf>,
590}