From ec688b4723a041044226358bcd4dd6e2da39da49 Mon Sep 17 00:00:00 2001 From: Luca Muscariello Date: Thu, 23 Feb 2017 17:01:02 +0100 Subject: Initial commit: cframework. Longbow and Libparc Change-Id: I90378dbd30da6033b20fb1f829b3b822cf366c59 Signed-off-by: Luca Muscariello --- libparc/parc/security/parc_CryptoSuite.h | 58 ++++++++++++++++++++++++++++++++ 1 file changed, 58 insertions(+) create mode 100755 libparc/parc/security/parc_CryptoSuite.h (limited to 'libparc/parc/security/parc_CryptoSuite.h') diff --git a/libparc/parc/security/parc_CryptoSuite.h b/libparc/parc/security/parc_CryptoSuite.h new file mode 100755 index 00000000..b9c138e2 --- /dev/null +++ b/libparc/parc/security/parc_CryptoSuite.h @@ -0,0 +1,58 @@ +/* + * Copyright (c) 2017 Cisco and/or its affiliates. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +/** + * @file parc_CryptoSuite.h + * @ingroup security + * @brief Represent a cryptographic suite, a set of corresponding hash and signing/MAC/CRC algorithms. + * + * A cryptographic suite encapsulates the method by which (public key) digital signatures and + * (private key) MACs. For example, a digital signature suite might combine SHA-256 as the hash + * digest algorithm and RSA as the signature generation/verification algorithm. Such a suite + * would would have the PARCCryptoSuite value PARCCryptoSuite_RSA_SHA256. + * + */ +#ifndef libparc_parc_CryptoSuite_h +#define libparc_parc_CryptoSuite_h + +#include + +typedef enum { + PARCCryptoSuite_RSA_SHA256, + PARCCryptoSuite_DSA_SHA256, + PARCCryptoSuite_RSA_SHA512, + PARCCryptoSuite_HMAC_SHA256, + PARCCryptoSuite_HMAC_SHA512, + PARCCryptoSuite_NULL_CRC32C, + PARCCryptoSuite_EC_SECP_256K1, + PARCCryptoSuite_UNKNOWN +} PARCCryptoSuite; + +/** + * Given a PARCCryptoSuite value, return the corresponding cryptographic hash as a `PARCCryptoHashType`. + * + * @param [in] suite A PARCCryptoSuite value. + * + * @return A PARCCryptoHashType value + * + * Example: + * @code + * { + * PARCryptoHashType hash = parcCryptoSuite_GetCryptoHash(PARCCryptoSuite_RSA_SHA256); + * } + * @endcode + */ +PARCCryptoHashType parcCryptoSuite_GetCryptoHash(PARCCryptoSuite suite); +#endif // libparc_parc_CryptoSuite_h -- cgit 1.2.3-korg