Gilles Peskine | 3929279 | 2022-04-12 18:33:04 +0200 | [diff] [blame] | 1 | |
| 2 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" |
| 3 | "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
| 4 | |
| 5 | <html xmlns="http://www.w3.org/1999/xhtml"> |
| 6 | <head> |
| 7 | <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> |
| 8 | <title>PSA Cryptography API 1.1 PAKE Extension — PSA Crypto API PAKE Extension 1.1 PAKE Extension.0-bet.0 documentation</title> |
| 9 | <link rel="stylesheet" href="_static/alabaster.css" type="text/css" /> |
| 10 | <link rel="stylesheet" href="_static/pygments.css" type="text/css" /> |
| 11 | <script type="text/javascript"> |
| 12 | var DOCUMENTATION_OPTIONS = { |
| 13 | URL_ROOT: './', |
| 14 | VERSION: '1.1 PAKE Extension.0-bet.0', |
| 15 | COLLAPSE_INDEX: false, |
| 16 | FILE_SUFFIX: '.html', |
| 17 | HAS_SOURCE: false, |
| 18 | SOURCELINK_SUFFIX: '.txt' |
| 19 | }; |
| 20 | </script> |
| 21 | <script type="text/javascript" src="_static/jquery.js"></script> |
| 22 | <script type="text/javascript" src="_static/underscore.js"></script> |
| 23 | <script type="text/javascript" src="_static/doctools.js"></script> |
| 24 | <link rel="author" title="About these documents" href="about.html" /> |
| 25 | <link rel="index" title="Index" href="genindex.html" /> |
| 26 | <link rel="search" title="Search" href="search.html" /> |
| 27 | <link rel="next" title="About this document" href="about.html" /> |
| 28 | |
| 29 | <link rel="stylesheet" href="_static/custom.css" type="text/css" /> |
| 30 | |
| 31 | <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" /> |
| 32 | |
| 33 | </head> |
| 34 | <body> |
| 35 | |
| 36 | |
| 37 | <div class="document"> |
| 38 | <div class="documentwrapper"> |
| 39 | <div class="bodywrapper"> |
| 40 | <div class="body" role="main"> |
| 41 | |
| 42 | <a class="reference internal image-reference" href="_images/Arm_logo_blue_150LG.png"><img alt="_images/Arm_logo_blue_150LG.png" class="align-right" src="_images/Arm_logo_blue_150LG.png" style="width: 5cm;" /></a> |
| 43 | <div class="section" id="doctitle-docversion"> |
| 44 | <h1>PSA Cryptography API 1.1 PAKE Extension</h1> |
| 45 | <table border="1" class="titletable docutils align-left"> |
| 46 | <colgroup> |
| 47 | <col width="50%" /> |
| 48 | <col width="50%" /> |
| 49 | </colgroup> |
| 50 | <tbody valign="top"> |
| 51 | <tr class="row-odd"><td>Document number:</td> |
| 52 | <td>AES 0058</td> |
| 53 | </tr> |
| 54 | <tr class="row-even"><td>Release Quality:</td> |
| 55 | <td>Beta</td> |
| 56 | </tr> |
| 57 | <tr class="row-odd"><td>Issue Number:</td> |
| 58 | <td>0</td> |
| 59 | </tr> |
| 60 | <tr class="row-even"><td>Confidentiality:</td> |
| 61 | <td>Non-confidential</td> |
| 62 | </tr> |
| 63 | <tr class="row-odd"><td>Date of Issue:</td> |
| 64 | <td>10/02/2022</td> |
| 65 | </tr> |
| 66 | </tbody> |
| 67 | </table> |
| 68 | <p class="titlecopyright">Copyright © 2022, Arm Limited. All rights reserved.</p> |
| 69 | <div class="banner admonition docutils container"> |
| 70 | <p>BETA RELEASE</p> |
| 71 | <p>This is a proposed update to the <em>IHI 0086 PSA Cryptography API 1.1</em> specification.</p> |
| 72 | <p>This is a BETA release in order to enable wider review and feedback on the changes proposed to be included in a future version of the specification.</p> |
| 73 | <p>At this quality level, the proposed changes and interfaces are complete, and suitable for initial product development. However, the specification is still subject to change.</p> |
| 74 | </div> |
| 75 | <p><span class="sectiontitle">Abstract</span></p> |
| 76 | <p>This document is part of the PSA family of specifications. |
| 77 | It defines an extension to the PSA Cryptography API, to introduce support for Password-authenticated key exchange (PAKE) algorithms.</p> |
| 78 | <p><span class="sectiontitle">Contents</span></p> |
| 79 | <div class="toctree-wrapper compound"> |
| 80 | <ul> |
| 81 | <li class="toctree-l1"><a class="reference internal" href="about.html">About this document</a><ul> |
| 82 | <li class="toctree-l2"><a class="reference internal" href="about.html#release-information">Release information</a></li> |
| 83 | <li class="toctree-l2"><a class="reference internal" href="about.html#arm-non-confidential-document-licence-licence">Arm Non-Confidential Document Licence (“Licence”)</a></li> |
| 84 | <li class="toctree-l2"><a class="reference internal" href="about.html#references">References</a></li> |
| 85 | <li class="toctree-l2"><a class="reference internal" href="about.html#terms-and-abbreviations">Terms and abbreviations</a></li> |
| 86 | <li class="toctree-l2"><a class="reference internal" href="about.html#conventions">Conventions</a></li> |
| 87 | <li class="toctree-l2"><a class="reference internal" href="about.html#current-status-and-anticipated-changes">Current status and anticipated changes</a></li> |
| 88 | <li class="toctree-l2"><a class="reference internal" href="about.html#feedback">Feedback</a></li> |
| 89 | </ul> |
| 90 | </li> |
| 91 | </ul> |
| 92 | </div> |
| 93 | <div class="toctree-wrapper compound"> |
| 94 | <ul> |
| 95 | <li class="toctree-l1"><a class="reference internal" href="intro.html">1. Introduction</a><ul> |
| 96 | <li class="toctree-l2"><a class="reference internal" href="intro.html#objectives-for-the-pake-extension">1.1. Objectives for the PAKE Extension</a><ul> |
| 97 | <li class="toctree-l3"><a class="reference internal" href="intro.html#scheme-review">1.1.1. Scheme review</a></li> |
| 98 | <li class="toctree-l3"><a class="reference internal" href="intro.html#scope-of-the-pake-extension">1.1.2. Scope of the PAKE Extension</a></li> |
| 99 | </ul> |
| 100 | </li> |
| 101 | </ul> |
| 102 | </li> |
| 103 | <li class="toctree-l1"><a class="reference internal" href="pake.html">2. Password-authenticated key exchange (PAKE)</a><ul> |
| 104 | <li class="toctree-l2"><a class="reference internal" href="pake.html#algorithm-encoding">2.1. Algorithm encoding</a><ul> |
| 105 | <li class="toctree-l3"><a class="reference internal" href="pake.html#pake-algorithm-encoding">2.1.1. PAKE algorithm encoding</a></li> |
| 106 | </ul> |
| 107 | </li> |
| 108 | <li class="toctree-l2"><a class="reference internal" href="pake.html#changes-and-additions-to-the-programming-api">2.2. Changes and additions to the Programming API</a><ul> |
| 109 | <li class="toctree-l3"><a class="reference internal" href="pake.html#pake-algorithms">2.2.1. PAKE algorithms</a></li> |
| 110 | <li class="toctree-l3"><a class="reference internal" href="pake.html#pake-primitives">2.2.2. PAKE primitives</a></li> |
| 111 | <li class="toctree-l3"><a class="reference internal" href="pake.html#pake-cipher-suites">2.2.3. PAKE cipher suites</a></li> |
| 112 | <li class="toctree-l3"><a class="reference internal" href="pake.html#pake-roles">2.2.4. PAKE roles</a></li> |
| 113 | <li class="toctree-l3"><a class="reference internal" href="pake.html#pake-step-types">2.2.5. PAKE step types</a></li> |
| 114 | <li class="toctree-l3"><a class="reference internal" href="pake.html#multi-part-pake-operations">2.2.6. Multi-part PAKE operations</a></li> |
| 115 | <li class="toctree-l3"><a class="reference internal" href="pake.html#support-macros">2.2.7. Support macros</a></li> |
| 116 | </ul> |
| 117 | </li> |
| 118 | </ul> |
| 119 | </li> |
| 120 | </ul> |
| 121 | </div> |
| 122 | <div class="toctree-wrapper compound"> |
| 123 | <ul> |
| 124 | <li class="toctree-l1"><a class="reference internal" href="example_header.html">Example header file</a></li> |
| 125 | <li class="toctree-l1"><a class="reference internal" href="specdef_values.html">Example macro implementations</a></li> |
| 126 | </ul> |
| 127 | </div> |
| 128 | </div> |
| 129 | |
| 130 | |
| 131 | </div> |
| 132 | </div> |
| 133 | </div> |
| 134 | <div class="sphinxsidebar" role="navigation" aria-label="main navigation"> |
| 135 | <div class="sphinxsidebarwrapper"><h3><a href="#"><b>PSA Crypto API PAKE Extension</b></a></h3> |
| 136 | AES 0058<br/> |
| 137 | Non-confidential<br/> |
| 138 | Version 1.1 PAKE Extension.0-bet.0 |
| 139 | <span style="color: red; font-weight: bold;"></span> |
| 140 | <ul> |
| 141 | <li class="toctree-l1"><a class="reference internal" href="about.html">About this document</a></li> |
| 142 | </ul> |
| 143 | <ul> |
| 144 | <li class="toctree-l1"><a class="reference internal" href="intro.html">1. Introduction</a></li> |
| 145 | <li class="toctree-l1"><a class="reference internal" href="pake.html">2. Password-authenticated key exchange (PAKE)</a></li> |
| 146 | </ul> |
| 147 | <ul> |
| 148 | <li class="toctree-l1"><a class="reference internal" href="example_header.html">Example header file</a></li> |
| 149 | <li class="toctree-l1"><a class="reference internal" href="specdef_values.html">Example macro implementations</a></li> |
| 150 | </ul> |
| 151 | <ul> |
| 152 | <li class="toctree-l1"><a class="reference internal" href="psa_c-identifiers.html">Index of API elements</a></li> |
| 153 | </ul> |
| 154 | <div id="searchbox" style="display: none" role="search"> |
| 155 | <h3>Quick search</h3> |
| 156 | <form class="search" action="search.html" method="get"> |
| 157 | <div><input type="text" name="q" /></div> |
| 158 | <div><input type="submit" value="Go" /></div> |
| 159 | <input type="hidden" name="check_keywords" value="yes" /> |
| 160 | <input type="hidden" name="area" value="default" /> |
| 161 | </form> |
| 162 | </div> |
| 163 | <script type="text/javascript">$('#searchbox').show(0);</script> |
| 164 | </div> |
| 165 | </div> |
| 166 | <div class="clearer"></div> |
| 167 | </div> |
| 168 | <div class="footer"> |
| 169 | © 2022, Arm Limited or its affiliates. All rights reserved. |
| 170 | |
| 171 | | |
| 172 | Powered by <a href="http://sphinx-doc.org/">Sphinx 1.6.7</a> |
| 173 | & <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.8</a> |
| 174 | |
| 175 | </div> |
| 176 | |
| 177 | |
| 178 | |
| 179 | |
| 180 | </body> |
| 181 | </html> |