samples: psa: persistent_key: add the persistent_key sample

# SPDX-License-Identifier: Apache-2.0

cmake_minimum_required(VERSION 3.20.0)

find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})

project(persistent_key)

target_sources(app PRIVATE src/main.c)

.. zephyr:code-sample:: persistent_key

   :name: PSA Crypto persistent key

   Manage and use persistent keys via the PSA Crypto API.

Overview

********

This sample demonstrates usage of persistent keys in the :ref:`PSA Crypto API <psa_crypto>`.

Requirements

************

In addition to the PSA Crypto API, an implementation of the

`PSA Internal Trusted Storage (ITS) API <https://arm-software.github.io/psa-api/storage/1.0/overview/architecture.html#the-internal-trusted-storage-api>`_

(for storage of the persistent keys) must be present for this sample to work.

It can be provided by:

* :ref:`tfm`, for ``*/ns`` :term:`board targets<board target>`.

* The :ref:`secure storage subsystem <secure_storage>`, for the other board targets.

Building

********

This sample is located in :zephyr_file:`samples/psa/persistent_key`.

Different configurations are defined in the :file:`sample.yaml` file.

You can use them to build the sample, depending on the PSA ITS provider, as follows:

.. tabs::

   .. tab:: TF-M

     For board targets with TF-M:

      .. zephyr-app-commands::

         :zephyr-app: samples/psa/persistent_key

         :tool: west

         :goals: build

         :board: <ns_board_target>

         :west-args: -T sample.psa.persistent_key.tfm

   .. tab:: secure storage subsystem

      For board targets without TF-M.

      If the board target to compile for has an entropy driver (preferable):

      .. zephyr-app-commands::

         :zephyr-app: samples/psa/persistent_key

         :tool: west

         :goals: build

         :board: <board_target>

         :west-args: -T sample.psa.persistent_key.secure_storage.entropy_driver

      Or, to use an insecure entropy source (only for testing):

      .. zephyr-app-commands::

         :zephyr-app: samples/psa/persistent_key

         :tool: west

         :goals: build

         :board: <board_target>

         :west-args: -T sample.psa.persistent_key.secure_storage.entropy_not_secure

To flash it, see :ref:`west-flashing`.

API reference

*************

`PSA Crypto key management API reference <https://arm-software.github.io/psa-api/crypto/1.2/api/keys/index.html>`_

# SPDX-License-Identifier: Apache-2.0

CONFIG_ENTROPY_GENERATOR=y

CONFIG_MBEDTLS_PSA_CRYPTO_EXTERNAL_RNG=y

# SPDX-License-Identifier: Apache-2.0

CONFIG_TEST_RANDOM_GENERATOR=y

CONFIG_TIMER_RANDOM_GENERATOR=y

CONFIG_MBEDTLS_ENTROPY_POLL_ZEPHYR=y

# SPDX-License-Identifier: Apache-2.0

CONFIG_MBEDTLS=y

CONFIG_MBEDTLS_PSA_CRYPTO_C=y

# The default stack size (1024) is not enough for the PSA Crypto core.

# On top of that, the ITS implementation uses the stack for buffers.

CONFIG_MAIN_STACK_SIZE=3072

CONFIG_SECURE_STORAGE=y