Creating a code-signing certificate for the FreeRTOS Windows simulator - FreeRTOS
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Creating a code-signing certificate for the FreeRTOS Windows simulator

The FreeRTOS Windows simulator requires a code-signing certificate with an ECDSA P-256 key and SHA-256 hash to perform OTA updates. If you don't have a code-signing certificate, follow these steps to create one.

Note

To create a code-signing certificate, install OpenSSL on your machine. After you install OpenSSL, make sure that openssl is assigned to the OpenSSL executable in your command prompt or terminal environment.

Use the Amazon Command Line Interface to import your code-signing certificate, private key, and certificate chain into Amazon Certificate Manager. For information about installing the Amazon CLI, see Installing the Amazon CLI.

  1. In your working directory, use the following text to create a file named cert_config.txt. Replace test_signer@amazon.com with your email address:

    [ req ]
prompt             = no
distinguished_name = my_dn
                    
[ my_dn ]
commonName = test_signer@amazon.com
                    
[ my_exts ]
keyUsage         = digitalSignature
extendedKeyUsage = codeSigning

  2. Create an ECDSA code-signing private key:

    openssl genpkey -algorithm EC -pkeyopt ec_paramgen_curve:P-256 -pkeyopt ec_param_enc:named_curve -outform PEM -out ecdsasigner.key

  3. Create an ECDSA code-signing certificate:

    openssl req -new -x509 -config cert_config.txt -extensions my_exts -nodes -days 365 -key ecdsasigner.key -out ecdsasigner.crt

  4. Import the code-signing certificate, private key, and certificate chain into Amazon Certificate Manager:

    aws acm import-certificate --certificate fileb://ecdsasigner.crt --private-key fileb://ecdsasigner.key

    This command displays an ARN for your certificate. You need this ARN when you create an OTA update job.

    Note

    This step is written with the assumption that you are going to use Code Signing for Amazon IoT to sign your firmware images. Although the use of Code Signing for Amazon IoT is recommended, you can sign your firmware images manually.