blob: 1bfef4c27914aca5b6597b0db391f6f9fb00773e [file] [log] [blame]
Gilles Peskine39292792022-04-12 18:33:04 +02001
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 &#8212; 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.
77It 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>
136AES 0058<br/>
137Non-confidential<br/>
138Version 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 &copy; 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 &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.8</a>
174
175 </div>
176
177
178
179
180 </body>
181</html>