<p>This class stores values which allow <aclass="el"href="class_s_s_l_client.html"title="The main SSLClient class. Check out README.md for more info.">SSLClient</a> to save and resume SSL sessions.
<trclass="memdesc:a0c8e01b0944c1f4b0ec6d4c423c95b74"><tdclass="mdescLeft"> </td><tdclass="mdescRight"><aclass="el"href="class_s_s_l_session.html"title="This class stores values which allow SSLClient to save and resume SSL sessions.">SSLSession</a> constructor. <ahref="class_s_s_l_session.html#a0c8e01b0944c1f4b0ec6d4c423c95b74">More...</a><br/></td></tr>
<trclass="memdesc:a825373c5ba1aa6c45e74dc8a72b21820"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Get the hostname string associated with this session. <ahref="class_s_s_l_session.html#a825373c5ba1aa6c45e74dc8a72b21820">More...</a><br/></td></tr>
<trclass="memdesc:acbe6549b55d50541d09a16f770e65afc"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Returns a pointer to the ::br_ssl_session_parameters component of this class. <ahref="class_s_s_l_session.html#acbe6549b55d50541d09a16f770e65afc">More...</a><br/></td></tr>
<divclass="textblock"><p>This class stores values which allow <aclass="el"href="class_s_s_l_client.html"title="The main SSLClient class. Check out README.md for more info.">SSLClient</a> to save and resume SSL sessions. </p>
<p>This file contains a simple utility class to store parameters about an SSL Session for reuse later.</p>
<p>This class was created to extend the values stored in br_ssl_session_parameters, which allow BearSSL to resume an SSL session. When testing BearSSL's session resumption feature, it was observed that BearSSL can only resume a session that was was started with the same server. This becomes an issue when using repeated requests to a domain name which can resolve to multiple IP addresses ("api.github.com"), as the device will switch between two or three servers. Since BearSSL only stores one session at a time, this results in session resumption being few and far between.</p>
<p>To remedy this problem, an <aclass="el"href="class_s_s_l_session.html"title="This class stores values which allow SSLClient to save and resume SSL sessions.">SSLSession</a> stores the IPAddress and hostname, along with the parameters in br_ssl_session_parameters struct. Using this data, <aclass="el"href="class_s_s_l_client.html"title="The main SSLClient class. Check out README.md for more info.">SSLClient</a> is able to remember which IPAddress is associated with which session, allowing it to reconnect to the last IPAddress, as opposed to any associated with the domain. </p>
<p><aclass="el"href="class_s_s_l_session.html"title="This class stores values which allow SSLClient to save and resume SSL sessions.">SSLSession</a> constructor. </p>
<p>Get the hostname string associated with this session. </p>
<dlclass="section return"><dt>Returns</dt><dd>A String object or "" if there is no hostname </dd></dl>
<dlclass="section pre"><dt>Precondition</dt><dd>must check isValidSession before getting this value, as if this session in invalid this value is not guarenteed to be reset to "". </dd></dl>
<liclass="footer">Generated by <ahref="https://www.doxygen.org/index.html"><imgclass="footer"src="doxygen.svg"width="104"height="31"alt="doxygen"/></a> 1.9.1 </li>
