| 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> |
| 11 | <p>The accelerator interface lets you drivers for cryptographic accelerators into an implementation of the PSA Cryptography API. Cryptographic accelerators perform cryptographic operations with keys in clear text.</p> |
| 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> |
| 14 | <p>The accelerator interface lets you drivers for external cryptoprocessors into an implementation of the PSA Cryptography API. External cryptoprocessors such as secure elements and smart cards perform cryptographic operations with keys accessed via opaque handles.</p> |
| 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> |
| 17 | <p>The accelerator interface lets you drivers for entropy sources such as Hardware Random Number Generators (HRNG), also known as True Random Number Generators (TRNG), into an implementation of the PSA Cryptography API.</p> |
| 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> |
| 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> |