1.. zephyr:code-sample:: psa_its
2   :name: PSA Internal Trusted Storage API
3   :relevant-api: psa_secure_storage
4
5   Use the PSA ITS API.
6
7Overview
8********
9
10This sample demonstrates usage of the
11`PSA Internal Trusted Storage (ITS) API <https://arm-software.github.io/psa-api/storage/1.0/overview/architecture.html#the-internal-trusted-storage-api>`_,
12which is part of the `PSA Secure Storage API <https://arm-software.github.io/psa-api/storage/>`_,
13for storing and retrieving persistent data.
14
15Requirements
16************
17
18An implementation of the PSA ITS API must be present for this sample to build.
19It can be provided by:
20
21* :ref:`tfm`, for ``*/ns`` :term:`board targets<board target>`.
22* The :ref:`secure storage subsystem <secure_storage>`, for the other board targets.
23
24Building
25********
26
27This sample is located in :zephyr_file:`samples/psa/its`.
28
29Different configurations are defined in the :file:`sample.yaml` file.
30You can use them to build the sample, depending on the PSA ITS provider, as follows:
31
32.. tabs::
33
34   .. tab:: TF-M
35
36     For board targets with TF-M:
37
38      .. zephyr-app-commands::
39         :zephyr-app: samples/psa/its
40         :tool: west
41         :goals: build
42         :board: <ns_board_target>
43         :west-args: -T sample.psa.its.tfm
44
45   .. tab:: secure storage subsystem
46
47      For board targets without TF-M.
48
49      If the board target to compile for has an entropy driver (preferable):
50
51      .. zephyr-app-commands::
52         :zephyr-app: samples/psa/its
53         :tool: west
54         :goals: build
55         :board: <board_target>
56         :west-args: -T sample.psa.its.secure_storage.entropy_driver
57
58      Or, to use an insecure entropy source (only for testing):
59
60      .. zephyr-app-commands::
61         :zephyr-app: samples/psa/its
62         :tool: west
63         :goals: build
64         :board: <board_target>
65         :west-args: -T sample.psa.its.secure_storage.entropy_not_secure
66
67To flash it, see :ref:`west-flashing`.
68