<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:11.0pt;
font-family:"Calibri","sans-serif";}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:#0563C1;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:#954F72;
text-decoration:underline;}
span.EmailStyle17
{mso-style-type:personal-compose;
font-family:"Calibri","sans-serif";
color:windowtext;}
.MsoChpDefault
{mso-style-type:export-only;
font-family:"Calibri","sans-serif";}
@page WordSection1
{size:8.5in 11.0in;
margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang="EN-US" link="#0563C1" vlink="#954F72">
<div class="WordSection1">
<p class="MsoNormal">Pardon me for posting long email…<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">The servers that we deploy in-house use the TLS_ECDHE_RSA_WITH_?_? cipher suites. I’m adding these news cipher suites to the iPXE. This email post is to describe the approach I am taking to implement the new cipher suites in iPXE and
solicit comments from the experts in this mailing group on the approach I’m taking.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">These e are the main RFCs referenced – rfc5246, rfc4492, rfc5288, rfc5289<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">In the src/include/ipxe/tls.h header file, the new ECDHE_RSA cipher suites are defined.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">diff --git a/src/include/ipxe/tls.h b/src/include/ipxe/tls.h<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">index b1e702e..ab1226a 100644<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">--- a/src/include/ipxe/tls.h<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">+++ b/src/include/ipxe/tls.h<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">@@ -83,6 +83,13 @@ struct tls_header {<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#define TLS_RSA_WITH_AES_128_CBC_SHA256 0x003c<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#define TLS_RSA_WITH_AES_256_CBC_SHA256 0x003d<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">+#define TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA 0xc013<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">+#define TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA 0xc014<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">+#define TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 0xc027<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">+#define TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 0xc028<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">+#define TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 0xc02f<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">+#define TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 0xc030<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">+<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">/* TLS hash algorithm identifiers */<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#define TLS_MD5_ALGORITHM 1<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#define TLS_SHA1_ALGORITHM 2</span><o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">These .c files are added to define new ECDHE_RSA cipher suites and they are located in the src/crypto/mishmash directory.
<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">src/crypto/mishmash/ecdhe_rsa_aes_cbc_sha1.c<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">src/crypto/mishmash/ecdhe_rsa_aes_cbc_sha256.c<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">src/crypto/mishmash/ecdhe_rsa_aes_cbc_sha384.c<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">src/crypto/mishmash/ecdhe_rsa_aes_gcm_sha256.c<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">src/crypto/mishmash/ecdhe_rsa_aes_gcm_sha384.c</span><o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">I look at the <span style="font-family:"Courier New"">src/crypto/mishmash/rsa_aes_cbc_sha256.c</span> file and mirror the ecdhe_rsa*.c files accordingly to build up the ECDHE_RSA cipher suites. The tls_cipher_suite is instantiated for
each ECHED_RSA cipher suite with their member fields populated with the correct functions. If this approach sound reasonable to you, I will post the high level implementation details for the rest of the code here.
<o:p></o:p></p>
<p class="MsoNormal">
<o:p></o:p></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">$ cat src/crypto/mishmash/ecdhe_rsa_aes_cbc_sha1.c<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">. . .<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <byteswap.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/ecc.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/rsa.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/aes.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/sha1.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/tls.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">/** TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA cipher suite */<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">struct tls_cipher_suite tls_ecdhe_rsa_with_aes_128_cbc_sha __tls_cipher_suite(05) = {<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .code = htons ( TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA ),<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .key_len = ( 128 / 8 ),<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .pubkey = &ecdhe_rsa_algorithm,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .cipher = &aes_cbc_algorithm,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .digest = &sha1_algorithm,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">};<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">/** TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA cipher suite */<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">struct tls_cipher_suite tls_ecdhe_rsa_with_aes_256_cbc_sha __tls_cipher_suite(06) = {<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .code = htons ( TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA ),<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .key_len = ( 256 / 8 ),<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .pubkey = &ecdhe_rsa_algorithm,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .cipher = &aes_cbc_algorithm,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .digest = &sha1_algorithm,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">};</span><o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">$ cat src/crypto/mishmash/ecdhe_rsa_aes_cbc_sha256.c<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">. . .<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <byteswap.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/ecc.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/rsa.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/aes.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/sha256.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/tls.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">/** TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 cipher suite */<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">struct tls_cipher_suite tls_ecdhe_rsa_with_aes_128_cbc_sha256 __tls_cipher_suite(07) = {<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .code = htons ( TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 ),<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .key_len = ( 128 / 8 ),<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .pubkey = &ecdhe_rsa_algorithm,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .cipher = &aes_cbc_algorithm,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .digest = &sha256_algorithm,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">};<o:p></o:p></span></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">$ cat src/crypto/mishmash/ecdhe_rsa_aes_cbc_sha384.c<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">. . .<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <byteswap.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/ecc.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/rsa.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/aes.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/sha384.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/tls.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">/** TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 cipher suite */<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">struct tls_cipher_suite tls_ecdhe_rsa_with_aes_256_cbc_sha384 __tls_cipher_suite(08) = {<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .code = htons ( TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 ),<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .key_len = ( 256 / 8 ),<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .pubkey = &ecdhe_rsa_algorithm,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .cipher = &aes_cbc_algorithm,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .digest = &sha384_algorithm,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">};<o:p></o:p></span></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">$ cat src/crypto/mishmash/ecdhe_rsa_aes_gcm_sha256.c<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">. . .<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <byteswap.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/ecc.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/rsa.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/aes.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/gcm.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/sha256.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/tls.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">/** TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 cipher suite */<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">struct tls_cipher_suite tls_ecdhe_rsa_with_aes_128_gcm_sha256 __tls_cipher_suite(09) = {<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .code = htons ( TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 ),<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .key_len = ( 128 / 8 ),<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .pubkey = &ecdhe_rsa_algorithm,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .cipher = &aes_gcm_algorithm,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .digest = &sha256_algorithm,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">};</span><o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">$ cat src/crypto/mishmash/ecdhe_rsa_aes_gcm_sha384.c<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">. . .<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <byteswap.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/ecc.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/rsa.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/aes.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/gcm.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/sha384.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">#include <ipxe/tls.h><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">/** TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 cipher suite */<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">struct tls_cipher_suite tls_ecdhe_rsa_with_aes_256_gcm_sha384 __tls_cipher_suite(10) = {<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .code = htons ( TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 ),<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .key_len = ( 256 / 8 ),<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .pubkey = &ecdhe_rsa_algorithm,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .cipher = &aes_gcm_algorithm,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New""> .digest = &sha384_algorithm,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Courier New"">};</span><o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">The new tests are added in the src/tests directory.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Thanks,<o:p></o:p></p>
<p class="MsoNormal">Al Lau<o:p></o:p></p>
</div>
</body>
</html>