cosmian_kms_cli 5.20.0

Command Line Interface used to manage the KMS server If any assistance is needed, please either visit the Cosmian technical documentation at https://docs.cosmian.com or contact the Cosmian support team on Discord https://discord.com/invite/7kPMNtHpnz
Documentation
use std::fmt::Display;

use clap::{Parser, Subcommand, ValueEnum};
use cosmian_kms_client::{
    KmsClient,
    cosmian_kmip::{kmip_0::kmip_types::HashingAlgorithm, kmip_2_1::kmip_types::UniqueIdentifier},
    kmip_2_1::{
        kmip_operations::{MAC, MACVerify},
        kmip_types::CryptographicParameters,
    },
};

use crate::{actions::kms::console, error::result::KmsCliResult};

#[derive(ValueEnum, Debug, Clone, PartialEq, Eq)]
pub enum CHashingAlgorithm {
    SHA1,
    SHA224,
    SHA256,
    SHA384,
    SHA512,
    SHA3_224,
    SHA3_256,
    SHA3_384,
    SHA3_512,
}

impl Display for CHashingAlgorithm {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            Self::SHA1 => write!(f, "sha1"),
            Self::SHA224 => write!(f, "sha224"),
            Self::SHA256 => write!(f, "sha256"),
            Self::SHA384 => write!(f, "sha384"),
            Self::SHA512 => write!(f, "sha512"),
            Self::SHA3_224 => write!(f, "sha3-224"),
            Self::SHA3_256 => write!(f, "sha3-256"),
            Self::SHA3_384 => write!(f, "sha3-384"),
            Self::SHA3_512 => write!(f, "sha3-512"),
        }
    }
}

impl From<CHashingAlgorithm> for HashingAlgorithm {
    fn from(algo: CHashingAlgorithm) -> Self {
        match algo {
            CHashingAlgorithm::SHA1 => Self::SHA1,
            CHashingAlgorithm::SHA224 => Self::SHA224,
            CHashingAlgorithm::SHA256 => Self::SHA256,
            CHashingAlgorithm::SHA384 => Self::SHA384,
            CHashingAlgorithm::SHA512 => Self::SHA512,
            CHashingAlgorithm::SHA3_224 => Self::SHA3224,
            CHashingAlgorithm::SHA3_256 => Self::SHA3256,
            CHashingAlgorithm::SHA3_384 => Self::SHA3384,
            CHashingAlgorithm::SHA3_512 => Self::SHA3512,
        }
    }
}

/// MAC utilities: compute or verify a MAC value.
#[derive(Parser, Debug)]
#[clap(verbatim_doc_comment)]
pub struct MacCommands {
    #[command(subcommand)]
    pub command: MacSubcommand,
}

#[derive(Subcommand, Debug)]
pub enum MacSubcommand {
    /// Compute a MAC over data with a MAC key.
    Compute(MacAction),
    /// Verify a MAC over data with a MAC key.
    Verify(MacVerifyAction),
}

/// Compute a MAC over data with a MAC key.
#[derive(Parser, Debug)]
#[clap(verbatim_doc_comment)]
pub struct MacAction {
    /// Locate an object which has a link to this MAC key id.
    #[clap(long, short = 'k')]
    pub mac_key_id: String,

    /// Hashing algorithm (case insensitive)
    ///
    /// Running the locate sub-command with a wrong value will list all the possible values.
    /// e.g. `ckms mac --algorithm WRONG`
    #[clap(
        long = "algorithm",
        short = 'a',
        value_name = "ALGORITHM",
        verbatim_doc_comment
    )]
    pub hashing_algorithm: CHashingAlgorithm,

    /// The data to be hashed in hexadecimal format.
    /// The data to be hashed in hexadecimal format.
    #[clap(
        long,
        short = 'd',
        value_parser = |s: &str| hex::decode(s).map(|_| s.to_string()).map_err(|e| format!("Invalid hex format: {}", e))
    )]
    pub data: Option<String>,

    /// Specifies the existing stream or by-parts cryptographic operation (as returned from a previous call to this operation).
    /// The correlation value is represented as a hexadecimal string.
    #[clap(long,
        short = 'c',
        value_parser = |s: &str| hex::decode(s).map(|_| s.to_string()).map_err(|e| format!("Invalid hex format: {}", e))
)]
    pub correlation_value: Option<String>,

    /// Initial operation as Boolean
    #[clap(long, short = 'i')]
    pub init_indicator: bool,

    /// Final operation as Boolean
    #[clap(long, short = 'f')]
    pub final_indicator: bool,
}

impl MacAction {
    /// Processes the access action.
    ///
    /// # Errors
    ///
    /// Returns an error if there was a problem running the action.
    pub async fn run(&self, kms_rest_client: KmsClient) -> KmsCliResult<()> {
        let unique_identifier = Some(UniqueIdentifier::TextString(self.mac_key_id.clone()));

        let cryptographic_parameters = CryptographicParameters {
            hashing_algorithm: Some(self.hashing_algorithm.clone().into()),
            ..Default::default()
        };

        let data = match self.data.clone() {
            Some(data) => Some(hex::decode(data)?),
            None => None,
        };

        let correlation_value = match self.correlation_value.clone() {
            Some(correlation_value) => Some(hex::decode(correlation_value)?),
            None => None,
        };

        let init_indicator = Some(self.init_indicator);
        let final_indicator = Some(self.final_indicator);

        let response = kms_rest_client
            .mac(MAC {
                unique_identifier: unique_identifier.clone(),
                cryptographic_parameters: Some(cryptographic_parameters),
                data,
                correlation_value,
                init_indicator,
                final_indicator,
            })
            .await?;

        let hex_output = response.mac_data.map_or_else(String::new, hex::encode);

        console::Stdout::new(&format!("Mac output: {hex_output}")).write()?;
        Ok(())
    }
}

/// Verify a MAC over provided data with a MAC key.
#[derive(Parser, Debug)]
#[clap(verbatim_doc_comment)]
pub struct MacVerifyAction {
    /// Locate an object which has a link to this MAC key id.
    #[clap(long, short = 'k')]
    pub mac_key_id: String,

    /// Hashing algorithm (case insensitive)
    #[clap(
        long = "algorithm",
        short = 'a',
        value_name = "ALGORITHM",
        verbatim_doc_comment
    )]
    pub hashing_algorithm: CHashingAlgorithm,

    /// The data to verify in hexadecimal format.
    #[clap(
        long,
        short = 'd',
        value_parser = |s: &str| hex::decode(s).map(|_| s.to_string()).map_err(|e| format!("Invalid hex format: {}", e))
    )]
    pub data: String,

    /// The MAC to verify in hexadecimal format.
    #[clap(
        long = "mac",
        short = 'm',
        value_parser = |s: &str| hex::decode(s).map(|_| s.to_string()).map_err(|e| format!("Invalid hex format: {}", e))
    )]
    pub mac_hex: String,
}

impl MacVerifyAction {
    pub async fn run(&self, kms_rest_client: KmsClient) -> KmsCliResult<()> {
        let unique_identifier = UniqueIdentifier::TextString(self.mac_key_id.clone());

        let cryptographic_parameters = CryptographicParameters {
            hashing_algorithm: Some(self.hashing_algorithm.clone().into()),
            ..Default::default()
        };

        let data = hex::decode(&self.data)?;
        let mac_data = hex::decode(&self.mac_hex)?;

        let resp = kms_rest_client
            .mac_verify(MACVerify {
                unique_identifier,
                cryptographic_parameters: Some(cryptographic_parameters),
                data,
                mac_data,
            })
            .await?;

        console::Stdout::new(&format!("MAC validity: {}", resp.validity_indicator)).write()?;
        Ok(())
    }
}

impl MacCommands {
    pub async fn process(&self, kms_rest_client: KmsClient) -> KmsCliResult<()> {
        match &self.command {
            MacSubcommand::Compute(action) => action.run(kms_rest_client).await?,
            MacSubcommand::Verify(action) => action.run(kms_rest_client).await?,
        }
        Ok(())
    }
}