/* * corePKCS11 v3.5.0 * Copyright (C) 2020 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * SPDX-License-Identifier: MIT * * Permission is hereby granted, free of charge, to any person obtaining a copy of * this software and associated documentation files (the "Software"), to deal in * the Software without restriction, including without limitation the rights to * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of * the Software, and to permit persons to whom the Software is furnished to do so, * subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all * copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ /** * @file aws_pkcs11_config.h * @brief PCKS#11 config options. */ #ifndef _AWS_PKCS11_CONFIG_H_ #define _AWS_PKCS11_CONFIG_H_ /* * @brief define away log macros. */ #ifndef LogError #define LogError( message ) #endif #ifndef LogWarn #define LogWarn( message ) #endif #ifndef LogInfo #define LogInfo( message ) #endif #ifndef LogDebug #define LogDebug( message ) #endif /** * @brief Malloc API used by core_pkcs11.h */ #define pkcs11configPKCS11_MALLOC malloc /** * @brief Free API used by core_pkcs11.h */ #define pkcs11configPKCS11_FREE free /** * @brief PKCS #11 default user PIN. * * The PKCS #11 standard specifies the presence of a user PIN. That feature is * sensible for applications that have an interactive user interface and memory * protections. However, since typical microcontroller applications lack one or * both of those, the user PIN is assumed to be used herein for interoperability * purposes only, and not as a security feature. */ #define pkcs11configPKCS11_DEFAULT_USER_PIN "0000" /** * @brief Maximum length (in characters) for a PKCS #11 CKA_LABEL * attribute. */ #define pkcs11configMAX_LABEL_LENGTH 32 /** * @brief Maximum number of token objects that can be stored * by the PKCS #11 module. */ #define pkcs11configMAX_NUM_OBJECTS 1 /** * @brief Maximum number of sessions that can be stored * by the PKCS #11 module. */ #define pkcs11configMAX_SESSIONS 2 /** * @brief Set to 1 if OTA image verification via PKCS #11 module is supported. * * If set to 0, OTA code signing certificate is built in via * aws_ota_codesigner_certificate.h. */ #define pkcs11configOTA_SUPPORTED 0 /** * @brief Set to 1 if PAL supports storage for JITP certificate, * code verify certificate, and trusted server root certificate. * * If set to 0, PAL does not support storage mechanism for these, and * they are accessed via headers compiled into the code. */ #define pkcs11configJITP_CODEVERIFY_ROOT_CERT_SUPPORTED 0 /** * @brief The PKCS #11 label for device private key. * * Private key for connection to AWS IoT endpoint. The corresponding * public key should be registered with the AWS IoT endpoint. */ #define pkcs11configLABEL_DEVICE_PRIVATE_KEY_FOR_TLS "Device Priv TLS Key" /** * @brief The PKCS #11 label for device public key. * * The public key corresponding to pkcs11configLABEL_DEVICE_PRIVATE_KEY_FOR_TLS. */ #define pkcs11configLABEL_DEVICE_PUBLIC_KEY_FOR_TLS "Device Pub TLS Key" /** * @brief The PKCS #11 label for the device certificate. * * Device certificate corresponding to pkcs11configLABEL_DEVICE_PRIVATE_KEY_FOR_TLS. */ #define pkcs11configLABEL_DEVICE_CERTIFICATE_FOR_TLS "Device Cert" /** * @brief The PKCS #11 label for the object to be used for code verification. * * Used by over-the-air update code to verify an incoming signed image. */ #define pkcs11configLABEL_CODE_VERIFICATION_KEY "Code Verify Key" /** * @brief The PKCS #11 label for a claim certificate useful for provisioning with * Fleet Provisioning feature of AWS IoT Core through the "Provisioning by Claim" workflow. * * For more information on Fleet Provisioning, refer to this * [AWS document](https://docs.aws.amazon.com/iot/latest/developerguide/provision-wo-cert.html) */ #define pkcs11configLABEL_CLAIM_CERTIFICATE "Claim Cert" /** * @brief The PKCS #11 label for a claim private key useful for provisioning with * Fleet Provisioning feature of AWS IoT Core through the "Provisioning by Claim" workflow. * * For more information on Fleet Provisioning, refer to this * [AWS document](https://docs.aws.amazon.com/iot/latest/developerguide/provision-wo-cert.html) */ #define pkcs11configLABEL_CLAIM_PRIVATE_KEY "Claim Key" /** * @brief The PKCS #11 label for Just-In-Time-Provisioning. * * The certificate corresponding to the issuer of the device certificate * (pkcs11configLABEL_DEVICE_CERTIFICATE_FOR_TLS) when using the JITR or * JITP flow. */ #define pkcs11configLABEL_JITP_CERTIFICATE "JITP Cert" /** * @brief The PKCS #11 label for the AWS Trusted Root Certificate. * * @see aws_default_root_certificates.h */ #define pkcs11configLABEL_ROOT_CERTIFICATE "Root Cert" #endif /* _AWS_PKCS11_CONFIG_H_ include guard. */