| Gilles Peskine | 2a079ac | 2019-10-15 16:08:13 +0200 | [diff] [blame] | 1 | <h1 id="psa-cryptography-interfaces">PSA cryptography interfaces</h1> |
| 2 | <p>This page contains technical information about the cryptography interfaces in the Arm Platform Security Architecture (PSA) and related documents and software. For more information about the Platform Security Architecture, see <a href="https://developer.arm.com/architectures/security-architectures/platform-security-architecture">the Arm Developer website</a>.</p> |
| 3 | <h2 id="application-programming-interface">Application programming interface</h2> |
| 4 | <p>The PSA Cryptography API is a C programming interface for applications that wish to store cryptographic keys and use them to perform cryptographic operations.</p> |
| 5 | <p><strong>Status: beta</strong> — version 1.0.0 beta 3. Minor changes and clarifications are planned before 1.0. Additional features are planned for 1.x releases.</p> |
| 6 | <p><strong>Reference documentation</strong>: <a href="../html/index.html">HTML</a>, <a href="../PSA_Cryptography_API_Specification.pdf">PDF</a></p> |
| 7 | <p><strong>Reference implementation</strong>: <a href="https://github.com/ARMmbed/mbed-crypto">Mbed Crypto</a></p> |
| 8 | <h2 id="hardware-abstraction-layer">Hardware abstraction layer</h2> |
| 9 | <p>PSA includes functional specifications describing a hardware abstraction layer covering <a href="accel/">cryptographic accelerators</a>, <a href="se/">secure elements</a> and <a href="entropy/">entropy sources</a>.</p> |
| 10 | <h3 id="accelerator-driver-interface">Accelerator driver interface</h3> |
| Gilles Peskine | d1bf57b | 2019-10-15 18:06:25 +0200 | [diff] [blame^] | 11 | <p>The cryptographic accelerator driver interface lets you write drivers for hardware that performs cryptographic operations with keys in clear text. You can plug such drivers into any implementation of the PSA Cryptography API.</p> |
| Gilles Peskine | 2a079ac | 2019-10-15 16:08:13 +0200 | [diff] [blame] | 12 | <p>For more information, see <a href="accel/">PSA cryptography accelerator driver interface</a>.</p> |
| 13 | <h3 id="secure-element-driver-interface">Secure element driver interface</h3> |
| Gilles Peskine | d1bf57b | 2019-10-15 18:06:25 +0200 | [diff] [blame^] | 14 | <p>The secure element driver interface lets you write drivers for external cryptoprocessors such as secure elements (SE), smart cards and hardware security modules (HSM) that perform operations on keys that never leave the external processor and are accessed only through opaque handles. You can plug such drivers into any implementation of the PSA Cryptography API.</p> |
| Gilles Peskine | 2a079ac | 2019-10-15 16:08:13 +0200 | [diff] [blame] | 15 | <p>For more information, see <a href="se/">PSA secure element driver interface</a>.</p> |
| 16 | <h3 id="entropy-source-driver-interface">Entropy source driver interface</h3> |
| Gilles Peskine | d1bf57b | 2019-10-15 18:06:25 +0200 | [diff] [blame^] | 17 | <p>The entropy source driver interface lets you write drivers for Hardware Random Number Generators (HRNG), also known as True Random Number Generators (TRNG). You can plug such drivers into any implementation of the PSA Cryptography API.</p> |
| Gilles Peskine | 2a079ac | 2019-10-15 16:08:13 +0200 | [diff] [blame] | 18 | <p>For more information, see <a href="entropy/">PSA entropy source driver interface</a>.</p> |
| Gilles Peskine | b78b628 | 2019-10-15 16:26:55 +0200 | [diff] [blame] | 19 | <h2 id="feedback">Feedback</h2> |
| Gilles Peskine | d1bf57b | 2019-10-15 18:06:25 +0200 | [diff] [blame^] | 20 | <p>Arm welcomes feedback on the design of the PSA cryptography interfaces. If you think something could be improved, please open an <a href="https://github.com/ARMmbed/mbed-crypto/labels/api-spec">issue on the Mbed Crypto GitHub repository</a>. Alternatively, if you prefer to provide your feedback privately, please email us at <code>mbed-crypto@arm.com</code>. All feedback received by email is treated confidentially.</p> |