diff --git a/libs/bao1x-api/src/pubkeys/bao1.rs b/libs/bao1x-api/src/pubkeys/bao1.rs new file mode 100644 index 000000000..9241f0cc2 --- /dev/null +++ b/libs/bao1x-api/src/pubkeys/bao1.rs @@ -0,0 +1,21 @@ +/// ===== PLACEHOLDER - bao2 signing HSM ceremony pending ====== +use super::*; +use crate::signatures::Pubkey; + +/// Bao1 public key. Will be extracted from signing/bao1_id_ed25519_sk using extract_sk_credential.py +pub const ID_ED25519_SK_PUB: [u8; 32] = [0u8; 32]; + +/// Bao1 public key auth_data +pub const ID_ED25519_SK_AUTH_DATA: [u8; 37] = [0u8; 37]; +/// Bao1 public key "key handle" +pub const ID_ED25519_SK_CRED_ID: [u8; 241] = [0u8; 241]; +/// Bao1 public key "relying party" +pub const ID_ED25519_SK_RP: &'static str = "ssh:"; + +pub const PUBKEY: Pubkey = Pubkey { + pk: ID_ED25519_SK_PUB, + // Placeholder: tag is 0. + tag: [0u8; 4], // *KEYSLOT_INITIAL_TAGS[super::BAO1_KEY_SLOT], + aad_len: ID_ED25519_SK_AUTH_DATA.len() as u8, + aad: pad_array(&ID_ED25519_SK_AUTH_DATA), +}; diff --git a/libs/bao1x-api/src/pubkeys/bao2.rs b/libs/bao1x-api/src/pubkeys/bao2.rs new file mode 100644 index 000000000..9c3c1a0d1 --- /dev/null +++ b/libs/bao1x-api/src/pubkeys/bao2.rs @@ -0,0 +1,21 @@ +/// ===== PLACEHOLDER - bao2 signing HSM ceremony pending ====== +use super::*; +use crate::signatures::Pubkey; + +/// Bao1 public key. Will be extracted from signing/bao1_id_ed25519_sk using extract_sk_credential.py +pub const ID_ED25519_SK_PUB: [u8; 32] = [0u8; 32]; + +/// Bao1 public key auth_data +pub const ID_ED25519_SK_AUTH_DATA: [u8; 37] = [0u8; 37]; +/// Bao1 public key "key handle" +pub const ID_ED25519_SK_CRED_ID: [u8; 241] = [0u8; 241]; +/// Bao1 public key "relying party" +pub const ID_ED25519_SK_RP: &'static str = "ssh:"; + +pub const PUBKEY: Pubkey = Pubkey { + pk: ID_ED25519_SK_PUB, + // Placeholder: tag is 0. + tag: [0u8; 4], // *KEYSLOT_INITIAL_TAGS[super::BAO2_KEY_SLOT], + aad_len: ID_ED25519_SK_AUTH_DATA.len() as u8, + aad: pad_array(&ID_ED25519_SK_AUTH_DATA), +}; diff --git a/libs/bao1x-api/src/pubkeys/beta.rs b/libs/bao1x-api/src/pubkeys/beta.rs new file mode 100644 index 000000000..6e97e0fc9 --- /dev/null +++ b/libs/bao1x-api/src/pubkeys/beta.rs @@ -0,0 +1,45 @@ +use super::*; +use crate::signatures::Pubkey; + +/// Beta public key. Extracted from signing/beta_id_ed25519_sk using extract_sk_credential.py +pub const ID_ED25519_SK_PUB: [u8; 32] = [ + 0x80, 0x97, 0x99, 0x29, 0xed, 0xd0, 0x4e, 0x40, 0x12, 0x4b, 0x52, 0xca, 0xe9, 0xae, 0x54, 0xb2, 0x4b, + 0xdf, 0xf7, 0x2a, 0x7b, 0x8a, 0x00, 0x4c, 0x41, 0x06, 0x5b, 0xd1, 0x40, 0x20, 0x78, 0xa7, +]; +/// Beta public key auth_data - needed to validate an image. Extracted by a trial run of +/// signing/fido_signer with `cargo run -- --credential-file ..\credentials\beta.json --file .\test.bin` +/// inside the fido_signer directory. Needs to have the token & key connected to generate this. +pub const ID_ED25519_SK_AUTH_DATA: [u8; 37] = [ + 0xe3, 0x06, 0x10, 0xe8, 0xa1, 0x62, 0x11, 0x59, 0x60, 0xfe, 0x1e, 0xc2, 0x23, 0xe6, 0x52, 0x9c, 0x9f, + 0x4b, 0x6e, 0x80, 0x20, 0x0d, 0xcb, 0x5e, 0x5c, 0x32, 0x1c, 0x8a, 0xf1, 0xe2, 0xb1, 0xbf, 0x05, 0x00, + 0x00, 0x02, 0x0f, +]; +/// Beta public key "key handle" - used to retrieve the key for signing from the token. +/// Extracted from signing/beta_id_ed25519_sk using extract_sk_credential.py +pub const ID_ED25519_SK_CRED_ID: [u8; 241] = [ + 0x01, 0x06, 0x60, 0x8b, 0xfa, 0x05, 0x28, 0x24, 0x0d, 0x5b, 0x33, 0x92, 0x1b, 0xb1, 0x38, 0x4e, 0xbe, + 0xae, 0xf3, 0xe4, 0x73, 0x7a, 0x5e, 0xb2, 0xd0, 0x7e, 0x77, 0x80, 0x5b, 0x88, 0xcb, 0x1e, 0xd6, 0xea, + 0xfc, 0x75, 0xd4, 0x21, 0xc9, 0x41, 0xfa, 0x8d, 0x09, 0xe2, 0x4b, 0x4a, 0x4c, 0xec, 0x98, 0x85, 0xdd, + 0x76, 0xc0, 0xfd, 0xa1, 0x66, 0x0c, 0x4d, 0x6e, 0x72, 0xe4, 0xf3, 0xba, 0x6b, 0xba, 0xc0, 0x68, 0xc8, + 0x75, 0x32, 0x7b, 0x4f, 0x4d, 0xbd, 0xab, 0x87, 0x36, 0x80, 0xe7, 0x52, 0x58, 0x28, 0x84, 0xf1, 0xb7, + 0x80, 0xd1, 0xfc, 0xb0, 0xde, 0xcd, 0x53, 0x00, 0x7e, 0x7a, 0x6b, 0x5b, 0x8c, 0x61, 0x81, 0xea, 0x74, + 0xf1, 0xb5, 0x73, 0xde, 0x72, 0x99, 0x2d, 0x2c, 0x07, 0x96, 0x5f, 0x5c, 0x81, 0x08, 0x75, 0xed, 0x11, + 0xf3, 0x42, 0x43, 0x66, 0x8b, 0x18, 0xeb, 0x99, 0x42, 0x56, 0x8c, 0x57, 0x8f, 0x7c, 0x03, 0xfa, 0xbf, + 0x6e, 0xbd, 0xc8, 0x19, 0xc9, 0x48, 0xd9, 0xc9, 0x69, 0xef, 0x2b, 0xb1, 0x26, 0x6c, 0xd0, 0xd1, 0xa0, + 0xd5, 0x2e, 0x1c, 0x37, 0xe3, 0x23, 0x6a, 0x07, 0x56, 0xe5, 0x41, 0x0f, 0x31, 0x7e, 0x62, 0x28, 0xb1, + 0x08, 0x85, 0xc8, 0x33, 0xaa, 0xae, 0x94, 0xa8, 0x89, 0x7b, 0xe4, 0x6f, 0xb6, 0x7b, 0xd4, 0xc8, 0xc2, + 0x6b, 0x01, 0x21, 0x16, 0x2c, 0xb0, 0x46, 0x15, 0xae, 0xf8, 0x2c, 0x6a, 0x6e, 0x6f, 0xa7, 0x6b, 0x9c, + 0x5f, 0x03, 0x4a, 0x3d, 0xda, 0x15, 0x04, 0xcd, 0x2e, 0x09, 0x9d, 0xcc, 0x1d, 0x03, 0xff, 0xb8, 0x2b, + 0xe4, 0x97, 0xfe, 0x96, 0x1f, 0x7a, 0x4a, 0xd8, 0x6b, 0x7d, 0x6c, 0xcd, 0x73, 0x3f, 0xaa, 0xfe, 0x94, + 0x4a, 0x85, 0x8b, +]; +/// Beta public key "relying party" +/// Extracted from signing/beta_id_ed25519_sk using extract_sk_credential.py +pub const ID_ED25519_SK_RP: &'static str = "ssh:"; + +pub const PUBKEY: Pubkey = Pubkey { + pk: ID_ED25519_SK_PUB, + tag: *KEYSLOT_INITIAL_TAGS[BETA_KEY_SLOT], + aad_len: ID_ED25519_SK_AUTH_DATA.len() as u8, + aad: pad_array(&ID_ED25519_SK_AUTH_DATA), +}; diff --git a/libs/bao1x-api/src/pubkeys/developer.rs b/libs/bao1x-api/src/pubkeys/developer.rs new file mode 100644 index 000000000..5f2cc4e94 --- /dev/null +++ b/libs/bao1x-api/src/pubkeys/developer.rs @@ -0,0 +1,18 @@ +use super::*; +use crate::signatures::Pubkey; + +/// Developer public key. The private key is the devkey/ directory, included here for your +/// convenience: "MC4CAQAwBQYDK2VwBCIEIKindlyNoteThisIsADevKeyDontUseForProduction" (base64) +pub const PUB: [u8; 32] = [ + 0x1c, 0x9b, 0xea, 0xe3, 0x2a, 0xea, 0xc8, 0x75, 0x07, 0xc1, 0x80, 0x94, 0x38, 0x7e, 0xff, 0x1c, 0x74, + 0x61, 0x42, 0x82, 0xaf, 0xfd, 0x81, 0x52, 0xd8, 0x71, 0x35, 0x2e, 0xdf, 0x3f, 0x58, 0xbb, +]; +/// Developer key has no auth data. It is a classic ed25519ph signature. +pub const AUTH_DATA: [u8; 0] = []; + +pub const PUBKEY: Pubkey = Pubkey { + pk: PUB, + tag: *KEYSLOT_INITIAL_TAGS[DEVELOPER_KEY_SLOT], + aad_len: AUTH_DATA.len() as u8, + aad: pad_array(&AUTH_DATA), +}; diff --git a/libs/bao1x-api/src/pubkeys/mod.rs b/libs/bao1x-api/src/pubkeys/mod.rs new file mode 100644 index 000000000..02c87c43a --- /dev/null +++ b/libs/bao1x-api/src/pubkeys/mod.rs @@ -0,0 +1,38 @@ +use crate::signatures::Pubkey; + +pub mod bao1; +pub mod bao2; +pub mod beta; +pub mod developer; + +pub const BAO1_KEY_SLOT: usize = 0; +pub const BAO2_KEY_SLOT: usize = 1; +pub const BETA_KEY_SLOT: usize = 2; +pub const DEVELOPER_KEY_SLOT: usize = 3; + +/// Nominal purposes of pub key slots: +/// - slot 0 is Baochip secured signing key 1 +/// - slot 1 is Baochip secured signing key 2 +/// - slot 2 is a Beta signing key. It's kept in a secured token but also available in a development +/// environment. +/// - slot 3 is the Developer signing key. It's a well-known key that anyone can use to sign an image. If +/// revoked, it is not a valid signing key. When not revoked, upon being presented with an image signed by +/// this, the bootloader will automatically erase all device-local secrets. +/// +/// The dual signing keys for Baochip allows for a laddered upgrade path in case a signing key +/// needs to be replaced, upgraded, or cycled out for any reason. +pub const KEYSLOT_INITIAL_TAGS: [&'static [u8; 4]; 4] = [b"bao1", b"bao2", b"beta", b"dev "]; + +// helper function to pad arrays out, useful for the auth_data +const fn pad_array(input: &[u8; N]) -> [u8; M] { + let mut result = [0u8; M]; + let mut i = 0; + while i < N && i < M { + result[i] = input[i]; + i += 1; + } + result +} + +/// This is the exported record that should be copied into the header of all boot images +pub const PUBKEY_HEADER: [Pubkey; 4] = [bao1::PUBKEY, bao2::PUBKEY, beta::PUBKEY, developer::PUBKEY];