372 lines
65 KiB
HTML
372 lines
65 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
|
|
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
|
|
<meta name="generator" content="Doxygen 1.8.17"/>
|
|
<meta name="viewport" content="width=device-width, initial-scale=1"/>
|
|
<title>GRPC C++: include/grpcpp/security/tls_certificate_verifier.h Source File</title>
|
|
<link href="tabs.css" rel="stylesheet" type="text/css"/>
|
|
<script type="text/javascript" src="jquery.js"></script>
|
|
<script type="text/javascript" src="dynsections.js"></script>
|
|
<link href="search/search.css" rel="stylesheet" type="text/css"/>
|
|
<script type="text/javascript" src="search/searchdata.js"></script>
|
|
<script type="text/javascript" src="search/search.js"></script>
|
|
<link href="doxygen.css" rel="stylesheet" type="text/css" />
|
|
</head>
|
|
<body>
|
|
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
|
|
<div id="titlearea">
|
|
<table cellspacing="0" cellpadding="0">
|
|
<tbody>
|
|
<tr style="height: 56px;">
|
|
<td id="projectalign" style="padding-left: 0.5em;">
|
|
<div id="projectname">GRPC C++
|
|
 <span id="projectnumber">1.58.0</span>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<!-- end header part -->
|
|
<!-- Generated by Doxygen 1.8.17 -->
|
|
<script type="text/javascript">
|
|
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
|
|
var searchBox = new SearchBox("searchBox", "search",false,'Search');
|
|
/* @license-end */
|
|
</script>
|
|
<script type="text/javascript" src="menudata.js"></script>
|
|
<script type="text/javascript" src="menu.js"></script>
|
|
<script type="text/javascript">
|
|
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
|
|
$(function() {
|
|
initMenu('',true,false,'search.php','Search');
|
|
$(document).ready(function() { init_search(); });
|
|
});
|
|
/* @license-end */</script>
|
|
<div id="main-nav"></div>
|
|
<!-- window showing the filter options -->
|
|
<div id="MSearchSelectWindow"
|
|
onmouseover="return searchBox.OnSearchSelectShow()"
|
|
onmouseout="return searchBox.OnSearchSelectHide()"
|
|
onkeydown="return searchBox.OnSearchSelectKey(event)">
|
|
</div>
|
|
|
|
<!-- iframe showing the search results (closed by default) -->
|
|
<div id="MSearchResultsWindow">
|
|
<iframe src="javascript:void(0)" frameborder="0"
|
|
name="MSearchResults" id="MSearchResults">
|
|
</iframe>
|
|
</div>
|
|
|
|
<div id="nav-path" class="navpath">
|
|
<ul>
|
|
<li class="navelem"><a class="el" href="dir_d44c64559bbebec7f509842c48db8b23.html">include</a></li><li class="navelem"><a class="el" href="dir_412f9a3d5dfcba8716486cd870ef4586.html">grpcpp</a></li><li class="navelem"><a class="el" href="dir_121096a639b520446ccef04f840b5644.html">security</a></li> </ul>
|
|
</div>
|
|
</div><!-- top -->
|
|
<div class="header">
|
|
<div class="headertitle">
|
|
<div class="title">tls_certificate_verifier.h</div> </div>
|
|
</div><!--header-->
|
|
<div class="contents">
|
|
<a href="tls__certificate__verifier_8h.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00002"></a><span class="lineno"> 2</span> <span class="comment">// Copyright 2021 gRPC authors.</span></div>
|
|
<div class="line"><a name="l00003"></a><span class="lineno"> 3</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00004"></a><span class="lineno"> 4</span> <span class="comment">// Licensed under the Apache License, Version 2.0 (the "License");</span></div>
|
|
<div class="line"><a name="l00005"></a><span class="lineno"> 5</span> <span class="comment">// you may not use this file except in compliance with the License.</span></div>
|
|
<div class="line"><a name="l00006"></a><span class="lineno"> 6</span> <span class="comment">// You may obtain a copy of the License at</span></div>
|
|
<div class="line"><a name="l00007"></a><span class="lineno"> 7</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00008"></a><span class="lineno"> 8</span> <span class="comment">// http://www.apache.org/licenses/LICENSE-2.0</span></div>
|
|
<div class="line"><a name="l00009"></a><span class="lineno"> 9</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span class="comment">// Unless required by applicable law or agreed to in writing, software</span></div>
|
|
<div class="line"><a name="l00011"></a><span class="lineno"> 11</span> <span class="comment">// distributed under the License is distributed on an "AS IS" BASIS,</span></div>
|
|
<div class="line"><a name="l00012"></a><span class="lineno"> 12</span> <span class="comment">// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span></div>
|
|
<div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="comment">// See the License for the specific language governing permissions and</span></div>
|
|
<div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="comment">// limitations under the License.</span></div>
|
|
<div class="line"><a name="l00015"></a><span class="lineno"> 15</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00016"></a><span class="lineno"> 16</span>  </div>
|
|
<div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="preprocessor">#ifndef GRPCPP_SECURITY_TLS_CERTIFICATE_VERIFIER_H</span></div>
|
|
<div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="preprocessor">#define GRPCPP_SECURITY_TLS_CERTIFICATE_VERIFIER_H</span></div>
|
|
<div class="line"><a name="l00019"></a><span class="lineno"> 19</span>  </div>
|
|
<div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="preprocessor">#include <functional></span></div>
|
|
<div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="preprocessor">#include <map></span></div>
|
|
<div class="line"><a name="l00022"></a><span class="lineno"> 22</span> <span class="preprocessor">#include <memory></span></div>
|
|
<div class="line"><a name="l00023"></a><span class="lineno"> 23</span> <span class="preprocessor">#include <utility></span></div>
|
|
<div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="preprocessor">#include <vector></span></div>
|
|
<div class="line"><a name="l00025"></a><span class="lineno"> 25</span>  </div>
|
|
<div class="line"><a name="l00026"></a><span class="lineno"> 26</span> <span class="preprocessor">#include <<a class="code" href="grpc__security__constants_8h.html">grpc/grpc_security_constants.h</a>></span></div>
|
|
<div class="line"><a name="l00027"></a><span class="lineno"> 27</span> <span class="preprocessor">#include <<a class="code" href="grpc_2status_8h.html">grpc/status.h</a>></span></div>
|
|
<div class="line"><a name="l00028"></a><span class="lineno"> 28</span> <span class="preprocessor">#include <<a class="code" href="support_2log_8h.html">grpc/support/log.h</a>></span></div>
|
|
<div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="preprocessor">#include <<a class="code" href="grpcpp_2impl_2grpc__library_8h.html">grpcpp/impl/grpc_library.h</a>></span></div>
|
|
<div class="line"><a name="l00030"></a><span class="lineno"> 30</span> <span class="preprocessor">#include <<a class="code" href="p_2impl_2sync_8h.html">grpcpp/impl/sync.h</a>></span></div>
|
|
<div class="line"><a name="l00031"></a><span class="lineno"> 31</span> <span class="preprocessor">#include <<a class="code" href="grpcpp_2support_2config_8h.html">grpcpp/support/config.h</a>></span></div>
|
|
<div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="preprocessor">#include <<a class="code" href="grpcpp_2support_2status_8h.html">grpcpp/support/status.h</a>></span></div>
|
|
<div class="line"><a name="l00033"></a><span class="lineno"> 33</span> <span class="preprocessor">#include <<a class="code" href="grpcpp_2support_2string__ref_8h.html">grpcpp/support/string_ref.h</a>></span></div>
|
|
<div class="line"><a name="l00034"></a><span class="lineno"> 34</span>  </div>
|
|
<div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="comment">// TODO(yihuazhang): remove the forward declaration here and include</span></div>
|
|
<div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="comment">// <grpc/grpc_security.h> directly once the insecure builds are cleaned up.</span></div>
|
|
<div class="line"><a name="l00037"></a><span class="lineno"><a class="line" href="tls__certificate__verifier_8h.html#aaac530cd68851c41b8817ec9749f5df1"> 37</a></span> <span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="structgrpc__tls__custom__verification__check__request.html">grpc_tls_custom_verification_check_request</a></div>
|
|
<div class="line"><a name="l00038"></a><span class="lineno"> 38</span>  <a class="code" href="structgrpc__tls__custom__verification__check__request.html">grpc_tls_custom_verification_check_request</a>;</div>
|
|
<div class="line"><a name="l00039"></a><span class="lineno"><a class="line" href="tls__certificate__verifier_8h.html#afc10060e41d23b0e31f5c5a312d49138"> 39</a></span> <span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="grpc__security_8h.html#afc10060e41d23b0e31f5c5a312d49138">grpc_tls_certificate_verifier</a> <a class="code" href="grpc__security_8h.html#afc10060e41d23b0e31f5c5a312d49138">grpc_tls_certificate_verifier</a>;</div>
|
|
<div class="line"><a name="l00040"></a><span class="lineno"><a class="line" href="tls__certificate__verifier_8h.html#a02ce84a849538d46352f38553d1df8f1"> 40</a></span> <span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="structgrpc__tls__certificate__verifier__external.html">grpc_tls_certificate_verifier_external</a></div>
|
|
<div class="line"><a name="l00041"></a><span class="lineno"> 41</span>  <a class="code" href="structgrpc__tls__certificate__verifier__external.html">grpc_tls_certificate_verifier_external</a>;</div>
|
|
<div class="line"><a name="l00042"></a><span class="lineno"><a class="line" href="tls__certificate__verifier_8h.html#acb2cccf44dad8776d1a0abbd36781ee7"> 42</a></span> <span class="keyword">typedef</span> void (*<a class="code" href="tls__certificate__verifier_8h.html#acb2cccf44dad8776d1a0abbd36781ee7">grpc_tls_on_custom_verification_check_done_cb</a>)(</div>
|
|
<div class="line"><a name="l00043"></a><span class="lineno"> 43</span>  <a class="code" href="structgrpc__tls__custom__verification__check__request.html">grpc_tls_custom_verification_check_request</a>* request, <span class="keywordtype">void</span>* callback_arg,</div>
|
|
<div class="line"><a name="l00044"></a><span class="lineno"> 44</span>  <a class="code" href="grpc_2status_8h.html#a35ab2a68917eb836de84cb23253108eb">grpc_status_code</a> status, <span class="keyword">const</span> <span class="keywordtype">char</span>* error_details);</div>
|
|
<div class="line"><a name="l00045"></a><span class="lineno"> 45</span> <span class="keyword">extern</span> <span class="stringliteral">"C"</span> <a class="code" href="grpc__security_8h.html#afc10060e41d23b0e31f5c5a312d49138">grpc_tls_certificate_verifier</a>*</div>
|
|
<div class="line"><a name="l00046"></a><span class="lineno"> 46</span> <a class="code" href="tls__certificate__verifier_8h.html#a129d8fd8e77cde679368f6ae03f990d4">grpc_tls_certificate_verifier_external_create</a>(</div>
|
|
<div class="line"><a name="l00047"></a><span class="lineno"> 47</span>  <a class="code" href="structgrpc__tls__certificate__verifier__external.html">grpc_tls_certificate_verifier_external</a>* external_verifier);</div>
|
|
<div class="line"><a name="l00048"></a><span class="lineno"> 48</span>  </div>
|
|
<div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="keyword">namespace </span><a class="code" href="namespacegrpc.html">grpc</a> {</div>
|
|
<div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="keyword">namespace </span>experimental {</div>
|
|
<div class="line"><a name="l00051"></a><span class="lineno"> 51</span>  </div>
|
|
<div class="line"><a name="l00052"></a><span class="lineno"> 52</span> <span class="comment">// Contains the verification-related information associated with a connection</span></div>
|
|
<div class="line"><a name="l00053"></a><span class="lineno"> 53</span> <span class="comment">// request. Users should not directly create or destroy this request object, but</span></div>
|
|
<div class="line"><a name="l00054"></a><span class="lineno"> 54</span> <span class="comment">// shall interact with it through CertificateVerifier's Verify() and Cancel().</span></div>
|
|
<div class="line"><a name="l00055"></a><span class="lineno"><a class="line" href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html"> 55</a></span> <span class="keyword">class </span><a class="code" href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html">TlsCustomVerificationCheckRequest</a> {</div>
|
|
<div class="line"><a name="l00056"></a><span class="lineno"> 56</span>  <span class="keyword">public</span>:</div>
|
|
<div class="line"><a name="l00057"></a><span class="lineno"> 57</span>  <span class="keyword">explicit</span> <a class="code" href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#accc7f76347376f5ab78eb3558c38427e">TlsCustomVerificationCheckRequest</a>(</div>
|
|
<div class="line"><a name="l00058"></a><span class="lineno"> 58</span>  <a class="code" href="structgrpc__tls__custom__verification__check__request.html">grpc_tls_custom_verification_check_request</a>* request);</div>
|
|
<div class="line"><a name="l00059"></a><span class="lineno"><a class="line" href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#a4477738251ddc09e23b152431a25bfff"> 59</a></span>  <a class="code" href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#a4477738251ddc09e23b152431a25bfff">~TlsCustomVerificationCheckRequest</a>() {}</div>
|
|
<div class="line"><a name="l00060"></a><span class="lineno"> 60</span>  </div>
|
|
<div class="line"><a name="l00061"></a><span class="lineno"> 61</span>  <a class="code" href="classgrpc_1_1string__ref.html">grpc::string_ref</a> <a class="code" href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#a12209dde5499614655bf317402e5d564">target_name</a>() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00062"></a><span class="lineno"> 62</span>  <a class="code" href="classgrpc_1_1string__ref.html">grpc::string_ref</a> <a class="code" href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#ab7e55b53c51a3ac3f2a63ac20599a519">peer_cert</a>() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00063"></a><span class="lineno"> 63</span>  <a class="code" href="classgrpc_1_1string__ref.html">grpc::string_ref</a> <a class="code" href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#a546d5daf4deb0b2b0465de56edd43be0">peer_cert_full_chain</a>() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00064"></a><span class="lineno"> 64</span>  <a class="code" href="classgrpc_1_1string__ref.html">grpc::string_ref</a> <a class="code" href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#a13a8356b3151deff241ef4f23798a783">common_name</a>() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00065"></a><span class="lineno"> 65</span>  <span class="comment">// The subject name of the root certificate used to verify the peer chain</span></div>
|
|
<div class="line"><a name="l00066"></a><span class="lineno"> 66</span>  <span class="comment">// If verification fails or the peer cert is self-signed, this will be an</span></div>
|
|
<div class="line"><a name="l00067"></a><span class="lineno"> 67</span>  <span class="comment">// empty string. If verification is successful, it is a comma-separated list,</span></div>
|
|
<div class="line"><a name="l00068"></a><span class="lineno"> 68</span>  <span class="comment">// where the entries are of the form "FIELD_ABBREVIATION=string"</span></div>
|
|
<div class="line"><a name="l00069"></a><span class="lineno"> 69</span>  <span class="comment">// ex: "CN=testca,O=Internet Widgits Pty Ltd,ST=Some-State,C=AU"</span></div>
|
|
<div class="line"><a name="l00070"></a><span class="lineno"> 70</span>  <span class="comment">// ex: "CN=GTS Root R1,O=Google Trust Services LLC,C=US"</span></div>
|
|
<div class="line"><a name="l00071"></a><span class="lineno"> 71</span>  <a class="code" href="classgrpc_1_1string__ref.html">grpc::string_ref</a> <a class="code" href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#a57dc59b09c8986c5800e2ebfaf161350">verified_root_cert_subject</a>() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00072"></a><span class="lineno"> 72</span>  std::vector<grpc::string_ref> <a class="code" href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#a229d24a192c9e23ce2bef7f8f1c4f0fa">uri_names</a>() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00073"></a><span class="lineno"> 73</span>  std::vector<grpc::string_ref> <a class="code" href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#a4205407782152afdaefdd23febfc9969">dns_names</a>() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00074"></a><span class="lineno"> 74</span>  std::vector<grpc::string_ref> <a class="code" href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#a6b2fa23b836091ce72d6f3474ff79a78">email_names</a>() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00075"></a><span class="lineno"> 75</span>  std::vector<grpc::string_ref> <a class="code" href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#affa1020d4e6a6dc7edd2c6a154ae3547">ip_names</a>() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00076"></a><span class="lineno"> 76</span>  </div>
|
|
<div class="line"><a name="l00077"></a><span class="lineno"><a class="line" href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#af14256f7b3532106f3b523209af0168c"> 77</a></span>  <a class="code" href="structgrpc__tls__custom__verification__check__request.html">grpc_tls_custom_verification_check_request</a>* <a class="code" href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#af14256f7b3532106f3b523209af0168c">c_request</a>() { <span class="keywordflow">return</span> c_request_; }</div>
|
|
<div class="line"><a name="l00078"></a><span class="lineno"> 78</span>  </div>
|
|
<div class="line"><a name="l00079"></a><span class="lineno"> 79</span>  <span class="keyword">private</span>:</div>
|
|
<div class="line"><a name="l00080"></a><span class="lineno"> 80</span>  <a class="code" href="structgrpc__tls__custom__verification__check__request.html">grpc_tls_custom_verification_check_request</a>* c_request_ = <span class="keyword">nullptr</span>;</div>
|
|
<div class="line"><a name="l00081"></a><span class="lineno"> 81</span> };</div>
|
|
<div class="line"><a name="l00082"></a><span class="lineno"> 82</span>  </div>
|
|
<div class="line"><a name="l00083"></a><span class="lineno"> 83</span> <span class="comment">// The base class of all internal verifier implementations, and the ultimate</span></div>
|
|
<div class="line"><a name="l00084"></a><span class="lineno"> 84</span> <span class="comment">// class that all external verifiers will eventually be transformed into.</span></div>
|
|
<div class="line"><a name="l00085"></a><span class="lineno"> 85</span> <span class="comment">// To implement a custom verifier, do not extend this class; instead,</span></div>
|
|
<div class="line"><a name="l00086"></a><span class="lineno"> 86</span> <span class="comment">// implement a subclass of ExternalCertificateVerifier. Note that custom</span></div>
|
|
<div class="line"><a name="l00087"></a><span class="lineno"> 87</span> <span class="comment">// verifier implementations can compose their functionality with existing</span></div>
|
|
<div class="line"><a name="l00088"></a><span class="lineno"> 88</span> <span class="comment">// implementations of this interface, such as HostnameVerifier, by delegating</span></div>
|
|
<div class="line"><a name="l00089"></a><span class="lineno"> 89</span> <span class="comment">// to an instance of that class.</span></div>
|
|
<div class="line"><a name="l00090"></a><span class="lineno"><a class="line" href="classgrpc_1_1experimental_1_1_certificate_verifier.html"> 90</a></span> <span class="keyword">class </span><a class="code" href="classgrpc_1_1experimental_1_1_certificate_verifier.html">CertificateVerifier</a> {</div>
|
|
<div class="line"><a name="l00091"></a><span class="lineno"> 91</span>  <span class="keyword">public</span>:</div>
|
|
<div class="line"><a name="l00092"></a><span class="lineno"> 92</span>  <span class="keyword">explicit</span> <a class="code" href="classgrpc_1_1experimental_1_1_certificate_verifier.html#a9631cd85f3d9663562ab619414da6218">CertificateVerifier</a>(<a class="code" href="grpc__security_8h.html#afc10060e41d23b0e31f5c5a312d49138">grpc_tls_certificate_verifier</a>* v);</div>
|
|
<div class="line"><a name="l00093"></a><span class="lineno"> 93</span>  </div>
|
|
<div class="line"><a name="l00094"></a><span class="lineno"> 94</span>  <a class="code" href="classgrpc_1_1experimental_1_1_certificate_verifier.html#a2f6fb970944ebc4f4c8fba3c833982ec">~CertificateVerifier</a>();</div>
|
|
<div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  </div>
|
|
<div class="line"><a name="l00096"></a><span class="lineno"> 96</span>  <span class="comment">// Verifies a connection request, based on the logic specified in an internal</span></div>
|
|
<div class="line"><a name="l00097"></a><span class="lineno"> 97</span>  <span class="comment">// verifier. The check on each internal verifier could be either synchronous</span></div>
|
|
<div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  <span class="comment">// or asynchronous, and we will need to use return value to know.</span></div>
|
|
<div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00100"></a><span class="lineno"> 100</span>  <span class="comment">// request: the verification information associated with this request</span></div>
|
|
<div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  <span class="comment">// callback: This will only take effect if the verifier is asynchronous.</span></div>
|
|
<div class="line"><a name="l00102"></a><span class="lineno"> 102</span>  <span class="comment">// The function that gRPC will invoke when the verifier has already</span></div>
|
|
<div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  <span class="comment">// completed its asynchronous check. Callers can use this function</span></div>
|
|
<div class="line"><a name="l00104"></a><span class="lineno"> 104</span>  <span class="comment">// to perform any additional checks. The input parameter of the</span></div>
|
|
<div class="line"><a name="l00105"></a><span class="lineno"> 105</span>  <span class="comment">// std::function indicates the status of the verifier check.</span></div>
|
|
<div class="line"><a name="l00106"></a><span class="lineno"> 106</span>  <span class="comment">// sync_status: This will only be useful if the verifier is synchronous.</span></div>
|
|
<div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  <span class="comment">// The status of the verifier as it has already done it's</span></div>
|
|
<div class="line"><a name="l00108"></a><span class="lineno"> 108</span>  <span class="comment">// synchronous check.</span></div>
|
|
<div class="line"><a name="l00109"></a><span class="lineno"> 109</span>  <span class="comment">// return: return true if executed synchronously, otherwise return false</span></div>
|
|
<div class="line"><a name="l00110"></a><span class="lineno"> 110</span>  <span class="keywordtype">bool</span> <a class="code" href="classgrpc_1_1experimental_1_1_certificate_verifier.html#a0e585b2306ce405823a234e33d543a9f">Verify</a>(<a class="code" href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html">TlsCustomVerificationCheckRequest</a>* request,</div>
|
|
<div class="line"><a name="l00111"></a><span class="lineno"> 111</span>  std::function<<span class="keywordtype">void</span>(<a class="code" href="classgrpc_1_1_status.html">grpc::Status</a>)> callback,</div>
|
|
<div class="line"><a name="l00112"></a><span class="lineno"> 112</span>  <a class="code" href="classgrpc_1_1_status.html">grpc::Status</a>* sync_status);</div>
|
|
<div class="line"><a name="l00113"></a><span class="lineno"> 113</span>  </div>
|
|
<div class="line"><a name="l00114"></a><span class="lineno"> 114</span>  <span class="comment">// Cancels a verification request previously started via Verify().</span></div>
|
|
<div class="line"><a name="l00115"></a><span class="lineno"> 115</span>  <span class="comment">// Used when the connection attempt times out or is cancelled while an async</span></div>
|
|
<div class="line"><a name="l00116"></a><span class="lineno"> 116</span>  <span class="comment">// verification request is pending.</span></div>
|
|
<div class="line"><a name="l00117"></a><span class="lineno"> 117</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00118"></a><span class="lineno"> 118</span>  <span class="comment">// request: the verification information associated with this request</span></div>
|
|
<div class="line"><a name="l00119"></a><span class="lineno"> 119</span>  <span class="keywordtype">void</span> <a class="code" href="classgrpc_1_1experimental_1_1_certificate_verifier.html#a7312acadecd716e3a0c7c4bbcb3e84d1">Cancel</a>(<a class="code" href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html">TlsCustomVerificationCheckRequest</a>* request);</div>
|
|
<div class="line"><a name="l00120"></a><span class="lineno"> 120</span>  </div>
|
|
<div class="line"><a name="l00121"></a><span class="lineno"> 121</span>  <span class="comment">// Gets the core verifier used internally.</span></div>
|
|
<div class="line"><a name="l00122"></a><span class="lineno"><a class="line" href="classgrpc_1_1experimental_1_1_certificate_verifier.html#a6781b51585677cd1267173eba8348b22"> 122</a></span>  <a class="code" href="grpc__security_8h.html#afc10060e41d23b0e31f5c5a312d49138">grpc_tls_certificate_verifier</a>* <a class="code" href="classgrpc_1_1experimental_1_1_certificate_verifier.html#a6781b51585677cd1267173eba8348b22">c_verifier</a>() { <span class="keywordflow">return</span> verifier_; }</div>
|
|
<div class="line"><a name="l00123"></a><span class="lineno"> 123</span>  </div>
|
|
<div class="line"><a name="l00124"></a><span class="lineno"> 124</span>  <span class="keyword">private</span>:</div>
|
|
<div class="line"><a name="l00125"></a><span class="lineno"> 125</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> AsyncCheckDone(</div>
|
|
<div class="line"><a name="l00126"></a><span class="lineno"> 126</span>  <a class="code" href="structgrpc__tls__custom__verification__check__request.html">grpc_tls_custom_verification_check_request</a>* request, <span class="keywordtype">void</span>* callback_arg,</div>
|
|
<div class="line"><a name="l00127"></a><span class="lineno"> 127</span>  <a class="code" href="grpc_2status_8h.html#a35ab2a68917eb836de84cb23253108eb">grpc_status_code</a> status, <span class="keyword">const</span> <span class="keywordtype">char</span>* error_details);</div>
|
|
<div class="line"><a name="l00128"></a><span class="lineno"> 128</span>  </div>
|
|
<div class="line"><a name="l00129"></a><span class="lineno"> 129</span>  <a class="code" href="grpc__security_8h.html#afc10060e41d23b0e31f5c5a312d49138">grpc_tls_certificate_verifier</a>* verifier_ = <span class="keyword">nullptr</span>;</div>
|
|
<div class="line"><a name="l00130"></a><span class="lineno"> 130</span>  <a class="code" href="classgrpc_1_1internal_1_1_mutex.html">grpc::internal::Mutex</a> mu_;</div>
|
|
<div class="line"><a name="l00131"></a><span class="lineno"> 131</span>  std::map<<a class="code" href="structgrpc__tls__custom__verification__check__request.html">grpc_tls_custom_verification_check_request</a>*,</div>
|
|
<div class="line"><a name="l00132"></a><span class="lineno"> 132</span>  std::function<void(<a class="code" href="classgrpc_1_1_status.html">grpc::Status</a>)>></div>
|
|
<div class="line"><a name="l00133"></a><span class="lineno"> 133</span>  request_map_ ABSL_GUARDED_BY(mu_);</div>
|
|
<div class="line"><a name="l00134"></a><span class="lineno"> 134</span> };</div>
|
|
<div class="line"><a name="l00135"></a><span class="lineno"> 135</span>  </div>
|
|
<div class="line"><a name="l00136"></a><span class="lineno"> 136</span> <span class="comment">// The base class of all external, user-specified verifiers. Users should</span></div>
|
|
<div class="line"><a name="l00137"></a><span class="lineno"> 137</span> <span class="comment">// inherit this class to implement a custom verifier.</span></div>
|
|
<div class="line"><a name="l00138"></a><span class="lineno"> 138</span> <span class="comment">// Note that while implementing the custom verifier that extends this class, it</span></div>
|
|
<div class="line"><a name="l00139"></a><span class="lineno"> 139</span> <span class="comment">// is possible to compose an existing ExternalCertificateVerifier or</span></div>
|
|
<div class="line"><a name="l00140"></a><span class="lineno"> 140</span> <span class="comment">// CertificateVerifier, inside the Verify() and Cancel() function of the new</span></div>
|
|
<div class="line"><a name="l00141"></a><span class="lineno"> 141</span> <span class="comment">// custom verifier.</span></div>
|
|
<div class="line"><a name="l00142"></a><span class="lineno"><a class="line" href="classgrpc_1_1experimental_1_1_external_certificate_verifier.html"> 142</a></span> <span class="keyword">class </span><a class="code" href="classgrpc_1_1experimental_1_1_external_certificate_verifier.html">ExternalCertificateVerifier</a> {</div>
|
|
<div class="line"><a name="l00143"></a><span class="lineno"> 143</span>  <span class="keyword">public</span>:</div>
|
|
<div class="line"><a name="l00144"></a><span class="lineno"> 144</span>  <span class="comment">// A factory method for creating a |CertificateVerifier| from this class. All</span></div>
|
|
<div class="line"><a name="l00145"></a><span class="lineno"> 145</span>  <span class="comment">// the user-implemented verifiers should use this function to be converted to</span></div>
|
|
<div class="line"><a name="l00146"></a><span class="lineno"> 146</span>  <span class="comment">// verifiers compatible with |TlsCredentialsOptions|.</span></div>
|
|
<div class="line"><a name="l00147"></a><span class="lineno"> 147</span>  <span class="comment">// The resulting CertificateVerifier takes ownership of the newly instantiated</span></div>
|
|
<div class="line"><a name="l00148"></a><span class="lineno"> 148</span>  <span class="comment">// Subclass.</span></div>
|
|
<div class="line"><a name="l00149"></a><span class="lineno"> 149</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> Subclass, <span class="keyword">typename</span>... Args></div>
|
|
<div class="line"><a name="l00150"></a><span class="lineno"><a class="line" href="classgrpc_1_1experimental_1_1_external_certificate_verifier.html#a9585983d0bd04c7a0a126b5b1cc15359"> 150</a></span>  <span class="keyword">static</span> std::shared_ptr<CertificateVerifier> <a class="code" href="classgrpc_1_1experimental_1_1_external_certificate_verifier.html#a9585983d0bd04c7a0a126b5b1cc15359">Create</a>(Args&&... args) {</div>
|
|
<div class="line"><a name="l00151"></a><span class="lineno"> 151</span>  <span class="keyword">auto</span>* external_verifier = <span class="keyword">new</span> Subclass(std::forward<Args>(args)...);</div>
|
|
<div class="line"><a name="l00152"></a><span class="lineno"> 152</span>  <span class="keywordflow">return</span> std::make_shared<CertificateVerifier>(</div>
|
|
<div class="line"><a name="l00153"></a><span class="lineno"> 153</span>  <a class="code" href="tls__certificate__verifier_8h.html#a129d8fd8e77cde679368f6ae03f990d4">grpc_tls_certificate_verifier_external_create</a>(</div>
|
|
<div class="line"><a name="l00154"></a><span class="lineno"> 154</span>  external_verifier->base_));</div>
|
|
<div class="line"><a name="l00155"></a><span class="lineno"> 155</span>  }</div>
|
|
<div class="line"><a name="l00156"></a><span class="lineno"> 156</span>  </div>
|
|
<div class="line"><a name="l00157"></a><span class="lineno"> 157</span>  <span class="comment">// The verification logic that will be performed after the TLS handshake</span></div>
|
|
<div class="line"><a name="l00158"></a><span class="lineno"> 158</span>  <span class="comment">// completes. Implementers can choose to do their checks synchronously or</span></div>
|
|
<div class="line"><a name="l00159"></a><span class="lineno"> 159</span>  <span class="comment">// asynchronously.</span></div>
|
|
<div class="line"><a name="l00160"></a><span class="lineno"> 160</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00161"></a><span class="lineno"> 161</span>  <span class="comment">// request: the verification information associated with this request</span></div>
|
|
<div class="line"><a name="l00162"></a><span class="lineno"> 162</span>  <span class="comment">// callback: This should only be used if your check is done asynchronously.</span></div>
|
|
<div class="line"><a name="l00163"></a><span class="lineno"> 163</span>  <span class="comment">// When the asynchronous work is done, invoke this callback function</span></div>
|
|
<div class="line"><a name="l00164"></a><span class="lineno"> 164</span>  <span class="comment">// with the proper status, indicating the success or the failure of</span></div>
|
|
<div class="line"><a name="l00165"></a><span class="lineno"> 165</span>  <span class="comment">// the check. The implementer MUST NOT invoke this |callback| in the</span></div>
|
|
<div class="line"><a name="l00166"></a><span class="lineno"> 166</span>  <span class="comment">// same thread before Verify() returns, otherwise it can lead to</span></div>
|
|
<div class="line"><a name="l00167"></a><span class="lineno"> 167</span>  <span class="comment">// deadlocks.</span></div>
|
|
<div class="line"><a name="l00168"></a><span class="lineno"> 168</span>  <span class="comment">// sync_status: This should only be used if your check is done synchronously.</span></div>
|
|
<div class="line"><a name="l00169"></a><span class="lineno"> 169</span>  <span class="comment">// Modifies this value to indicate the success or the failure of</span></div>
|
|
<div class="line"><a name="l00170"></a><span class="lineno"> 170</span>  <span class="comment">// the check.</span></div>
|
|
<div class="line"><a name="l00171"></a><span class="lineno"> 171</span>  <span class="comment">// return: return true if your check is done synchronously, otherwise return</span></div>
|
|
<div class="line"><a name="l00172"></a><span class="lineno"> 172</span>  <span class="comment">// false</span></div>
|
|
<div class="line"><a name="l00173"></a><span class="lineno"> 173</span>  <span class="keyword">virtual</span> <span class="keywordtype">bool</span> <a class="code" href="classgrpc_1_1experimental_1_1_external_certificate_verifier.html#aa8776fc87f8fbe4bee331e520ba04620">Verify</a>(<a class="code" href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html">TlsCustomVerificationCheckRequest</a>* request,</div>
|
|
<div class="line"><a name="l00174"></a><span class="lineno"> 174</span>  std::function<<span class="keywordtype">void</span>(<a class="code" href="classgrpc_1_1_status.html">grpc::Status</a>)> callback,</div>
|
|
<div class="line"><a name="l00175"></a><span class="lineno"> 175</span>  <a class="code" href="classgrpc_1_1_status.html">grpc::Status</a>* sync_status) = 0;</div>
|
|
<div class="line"><a name="l00176"></a><span class="lineno"> 176</span>  </div>
|
|
<div class="line"><a name="l00177"></a><span class="lineno"> 177</span>  <span class="comment">// Cancels a verification request previously started via Verify().</span></div>
|
|
<div class="line"><a name="l00178"></a><span class="lineno"> 178</span>  <span class="comment">// Used when the connection attempt times out or is cancelled while an async</span></div>
|
|
<div class="line"><a name="l00179"></a><span class="lineno"> 179</span>  <span class="comment">// verification request is pending. The implementation should abort whatever</span></div>
|
|
<div class="line"><a name="l00180"></a><span class="lineno"> 180</span>  <span class="comment">// async operation it is waiting for and quickly invoke the callback that was</span></div>
|
|
<div class="line"><a name="l00181"></a><span class="lineno"> 181</span>  <span class="comment">// passed to Verify() with a status indicating the cancellation.</span></div>
|
|
<div class="line"><a name="l00182"></a><span class="lineno"> 182</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00183"></a><span class="lineno"> 183</span>  <span class="comment">// request: the verification information associated with this request</span></div>
|
|
<div class="line"><a name="l00184"></a><span class="lineno"> 184</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classgrpc_1_1experimental_1_1_external_certificate_verifier.html#a3c6341b38f918b9a99d033287527fe51">Cancel</a>(<a class="code" href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html">TlsCustomVerificationCheckRequest</a>* request) = 0;</div>
|
|
<div class="line"><a name="l00185"></a><span class="lineno"> 185</span>  </div>
|
|
<div class="line"><a name="l00186"></a><span class="lineno"> 186</span>  <span class="keyword">protected</span>:</div>
|
|
<div class="line"><a name="l00187"></a><span class="lineno"> 187</span>  <a class="code" href="classgrpc_1_1experimental_1_1_external_certificate_verifier.html#a3742120a627609e1a300e13bcb4e5d3a">ExternalCertificateVerifier</a>();</div>
|
|
<div class="line"><a name="l00188"></a><span class="lineno"> 188</span>  </div>
|
|
<div class="line"><a name="l00189"></a><span class="lineno"> 189</span>  <span class="keyword">virtual</span> <a class="code" href="classgrpc_1_1experimental_1_1_external_certificate_verifier.html#a15aceea4e2ba7944e502cfc3d0d51618">~ExternalCertificateVerifier</a>();</div>
|
|
<div class="line"><a name="l00190"></a><span class="lineno"> 190</span>  </div>
|
|
<div class="line"><a name="l00191"></a><span class="lineno"> 191</span>  <span class="keyword">private</span>:</div>
|
|
<div class="line"><a name="l00192"></a><span class="lineno"> 192</span>  <span class="keyword">struct </span>AsyncRequestState {</div>
|
|
<div class="line"><a name="l00193"></a><span class="lineno"> 193</span>  AsyncRequestState(<a class="code" href="tls__certificate__verifier_8h.html#acb2cccf44dad8776d1a0abbd36781ee7">grpc_tls_on_custom_verification_check_done_cb</a> cb,</div>
|
|
<div class="line"><a name="l00194"></a><span class="lineno"> 194</span>  <span class="keywordtype">void</span>* arg,</div>
|
|
<div class="line"><a name="l00195"></a><span class="lineno"> 195</span>  <a class="code" href="structgrpc__tls__custom__verification__check__request.html">grpc_tls_custom_verification_check_request</a>* request)</div>
|
|
<div class="line"><a name="l00196"></a><span class="lineno"> 196</span>  : callback(cb), callback_arg(arg), cpp_request(request) {}</div>
|
|
<div class="line"><a name="l00197"></a><span class="lineno"> 197</span>  </div>
|
|
<div class="line"><a name="l00198"></a><span class="lineno"> 198</span>  <a class="code" href="tls__certificate__verifier_8h.html#acb2cccf44dad8776d1a0abbd36781ee7">grpc_tls_on_custom_verification_check_done_cb</a> callback;</div>
|
|
<div class="line"><a name="l00199"></a><span class="lineno"> 199</span>  <span class="keywordtype">void</span>* callback_arg;</div>
|
|
<div class="line"><a name="l00200"></a><span class="lineno"> 200</span>  TlsCustomVerificationCheckRequest cpp_request;</div>
|
|
<div class="line"><a name="l00201"></a><span class="lineno"> 201</span>  };</div>
|
|
<div class="line"><a name="l00202"></a><span class="lineno"> 202</span>  </div>
|
|
<div class="line"><a name="l00203"></a><span class="lineno"> 203</span>  <span class="keyword">static</span> <span class="keywordtype">int</span> VerifyInCoreExternalVerifier(</div>
|
|
<div class="line"><a name="l00204"></a><span class="lineno"> 204</span>  <span class="keywordtype">void</span>* user_data, <a class="code" href="structgrpc__tls__custom__verification__check__request.html">grpc_tls_custom_verification_check_request</a>* request,</div>
|
|
<div class="line"><a name="l00205"></a><span class="lineno"> 205</span>  <a class="code" href="tls__certificate__verifier_8h.html#acb2cccf44dad8776d1a0abbd36781ee7">grpc_tls_on_custom_verification_check_done_cb</a> callback,</div>
|
|
<div class="line"><a name="l00206"></a><span class="lineno"> 206</span>  <span class="keywordtype">void</span>* callback_arg, <a class="code" href="grpc_2status_8h.html#a35ab2a68917eb836de84cb23253108eb">grpc_status_code</a>* sync_status,</div>
|
|
<div class="line"><a name="l00207"></a><span class="lineno"> 207</span>  <span class="keywordtype">char</span>** sync_error_details);</div>
|
|
<div class="line"><a name="l00208"></a><span class="lineno"> 208</span>  </div>
|
|
<div class="line"><a name="l00209"></a><span class="lineno"> 209</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> CancelInCoreExternalVerifier(</div>
|
|
<div class="line"><a name="l00210"></a><span class="lineno"> 210</span>  <span class="keywordtype">void</span>* user_data, <a class="code" href="structgrpc__tls__custom__verification__check__request.html">grpc_tls_custom_verification_check_request</a>* request);</div>
|
|
<div class="line"><a name="l00211"></a><span class="lineno"> 211</span>  </div>
|
|
<div class="line"><a name="l00212"></a><span class="lineno"> 212</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> DestructInCoreExternalVerifier(<span class="keywordtype">void</span>* user_data);</div>
|
|
<div class="line"><a name="l00213"></a><span class="lineno"> 213</span>  </div>
|
|
<div class="line"><a name="l00214"></a><span class="lineno"> 214</span>  <span class="comment">// TODO(yihuazhang): after the insecure build is removed, make this an object</span></div>
|
|
<div class="line"><a name="l00215"></a><span class="lineno"> 215</span>  <span class="comment">// member instead of a pointer.</span></div>
|
|
<div class="line"><a name="l00216"></a><span class="lineno"> 216</span>  <a class="code" href="structgrpc__tls__certificate__verifier__external.html">grpc_tls_certificate_verifier_external</a>* base_ = <span class="keyword">nullptr</span>;</div>
|
|
<div class="line"><a name="l00217"></a><span class="lineno"> 217</span>  <a class="code" href="classgrpc_1_1internal_1_1_mutex.html">grpc::internal::Mutex</a> mu_;</div>
|
|
<div class="line"><a name="l00218"></a><span class="lineno"> 218</span>  std::map<grpc_tls_custom_verification_check_request*, AsyncRequestState></div>
|
|
<div class="line"><a name="l00219"></a><span class="lineno"> 219</span>  request_map_ ABSL_GUARDED_BY(mu_);</div>
|
|
<div class="line"><a name="l00220"></a><span class="lineno"> 220</span> };</div>
|
|
<div class="line"><a name="l00221"></a><span class="lineno"> 221</span>  </div>
|
|
<div class="line"><a name="l00222"></a><span class="lineno"> 222</span> <span class="comment">// A CertificateVerifier that doesn't perform any additional checks other than</span></div>
|
|
<div class="line"><a name="l00223"></a><span class="lineno"> 223</span> <span class="comment">// certificate verification, if specified.</span></div>
|
|
<div class="line"><a name="l00224"></a><span class="lineno"> 224</span> <span class="comment">// Note: using this solely without any other authentication mechanisms on the</span></div>
|
|
<div class="line"><a name="l00225"></a><span class="lineno"> 225</span> <span class="comment">// peer identity will leave your applications to the MITM(Man-In-The-Middle)</span></div>
|
|
<div class="line"><a name="l00226"></a><span class="lineno"> 226</span> <span class="comment">// attacks. Users should avoid doing so in production environments.</span></div>
|
|
<div class="line"><a name="l00227"></a><span class="lineno"><a class="line" href="classgrpc_1_1experimental_1_1_no_op_certificate_verifier.html"> 227</a></span> <span class="keyword">class </span><a class="code" href="classgrpc_1_1experimental_1_1_no_op_certificate_verifier.html">NoOpCertificateVerifier</a> : <span class="keyword">public</span> <a class="code" href="classgrpc_1_1experimental_1_1_certificate_verifier.html">CertificateVerifier</a> {</div>
|
|
<div class="line"><a name="l00228"></a><span class="lineno"> 228</span>  <span class="keyword">public</span>:</div>
|
|
<div class="line"><a name="l00229"></a><span class="lineno"> 229</span>  <a class="code" href="classgrpc_1_1experimental_1_1_no_op_certificate_verifier.html#a98498f87d3c6f9a29942fcb2a9e9c870">NoOpCertificateVerifier</a>();</div>
|
|
<div class="line"><a name="l00230"></a><span class="lineno"> 230</span> };</div>
|
|
<div class="line"><a name="l00231"></a><span class="lineno"> 231</span>  </div>
|
|
<div class="line"><a name="l00232"></a><span class="lineno"> 232</span> <span class="comment">// A CertificateVerifier that will perform hostname verification, to see if the</span></div>
|
|
<div class="line"><a name="l00233"></a><span class="lineno"> 233</span> <span class="comment">// target name set from the client side matches the identity information</span></div>
|
|
<div class="line"><a name="l00234"></a><span class="lineno"> 234</span> <span class="comment">// specified on the server's certificate.</span></div>
|
|
<div class="line"><a name="l00235"></a><span class="lineno"><a class="line" href="classgrpc_1_1experimental_1_1_host_name_certificate_verifier.html"> 235</a></span> <span class="keyword">class </span><a class="code" href="classgrpc_1_1experimental_1_1_host_name_certificate_verifier.html">HostNameCertificateVerifier</a> : <span class="keyword">public</span> <a class="code" href="classgrpc_1_1experimental_1_1_certificate_verifier.html">CertificateVerifier</a> {</div>
|
|
<div class="line"><a name="l00236"></a><span class="lineno"> 236</span>  <span class="keyword">public</span>:</div>
|
|
<div class="line"><a name="l00237"></a><span class="lineno"> 237</span>  <a class="code" href="classgrpc_1_1experimental_1_1_host_name_certificate_verifier.html#ade3b26ed39412e2e0bc4d241b52bd3bf">HostNameCertificateVerifier</a>();</div>
|
|
<div class="line"><a name="l00238"></a><span class="lineno"> 238</span> };</div>
|
|
<div class="line"><a name="l00239"></a><span class="lineno"> 239</span>  </div>
|
|
<div class="line"><a name="l00240"></a><span class="lineno"> 240</span> } <span class="comment">// namespace experimental</span></div>
|
|
<div class="line"><a name="l00241"></a><span class="lineno"> 241</span> } <span class="comment">// namespace grpc</span></div>
|
|
<div class="line"><a name="l00242"></a><span class="lineno"> 242</span>  </div>
|
|
<div class="line"><a name="l00243"></a><span class="lineno"> 243</span> <span class="preprocessor">#endif // GRPCPP_SECURITY_TLS_CERTIFICATE_VERIFIER_H</span></div>
|
|
</div><!-- fragment --></div><!-- contents -->
|
|
<div class="ttc" id="aclassgrpc_1_1string__ref_html"><div class="ttname"><a href="classgrpc_1_1string__ref.html">grpc::string_ref</a></div><div class="ttdoc">This class is a non owning reference to a string.</div><div class="ttdef"><b>Definition:</b> string_ref.h:41</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_host_name_certificate_verifier_html_ade3b26ed39412e2e0bc4d241b52bd3bf"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_host_name_certificate_verifier.html#ade3b26ed39412e2e0bc4d241b52bd3bf">grpc::experimental::HostNameCertificateVerifier::HostNameCertificateVerifier</a></div><div class="ttdeci">HostNameCertificateVerifier()</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_tls_custom_verification_check_request_html_a4205407782152afdaefdd23febfc9969"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#a4205407782152afdaefdd23febfc9969">grpc::experimental::TlsCustomVerificationCheckRequest::dns_names</a></div><div class="ttdeci">std::vector< grpc::string_ref > dns_names() const</div></div>
|
|
<div class="ttc" id="anamespacegrpc_html"><div class="ttname"><a href="namespacegrpc.html">grpc</a></div><div class="ttdoc">An Alarm posts the user-provided tag to its associated completion queue or invokes the user-provided ...</div><div class="ttdef"><b>Definition:</b> alarm.h:33</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_certificate_verifier_html_a6781b51585677cd1267173eba8348b22"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_certificate_verifier.html#a6781b51585677cd1267173eba8348b22">grpc::experimental::CertificateVerifier::c_verifier</a></div><div class="ttdeci">grpc_tls_certificate_verifier * c_verifier()</div><div class="ttdef"><b>Definition:</b> tls_certificate_verifier.h:122</div></div>
|
|
<div class="ttc" id="agrpc_2status_8h_html_a35ab2a68917eb836de84cb23253108eb"><div class="ttname"><a href="grpc_2status_8h.html#a35ab2a68917eb836de84cb23253108eb">grpc_status_code</a></div><div class="ttdeci">grpc_status_code</div><div class="ttdef"><b>Definition:</b> status.h:28</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_external_certificate_verifier_html_a3c6341b38f918b9a99d033287527fe51"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_external_certificate_verifier.html#a3c6341b38f918b9a99d033287527fe51">grpc::experimental::ExternalCertificateVerifier::Cancel</a></div><div class="ttdeci">virtual void Cancel(TlsCustomVerificationCheckRequest *request)=0</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_certificate_verifier_html_a2f6fb970944ebc4f4c8fba3c833982ec"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_certificate_verifier.html#a2f6fb970944ebc4f4c8fba3c833982ec">grpc::experimental::CertificateVerifier::~CertificateVerifier</a></div><div class="ttdeci">~CertificateVerifier()</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_tls_custom_verification_check_request_html_a57dc59b09c8986c5800e2ebfaf161350"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#a57dc59b09c8986c5800e2ebfaf161350">grpc::experimental::TlsCustomVerificationCheckRequest::verified_root_cert_subject</a></div><div class="ttdeci">grpc::string_ref verified_root_cert_subject() const</div></div>
|
|
<div class="ttc" id="agrpcpp_2support_2status_8h_html"><div class="ttname"><a href="grpcpp_2support_2status_8h.html">status.h</a></div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_tls_custom_verification_check_request_html_a4477738251ddc09e23b152431a25bfff"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#a4477738251ddc09e23b152431a25bfff">grpc::experimental::TlsCustomVerificationCheckRequest::~TlsCustomVerificationCheckRequest</a></div><div class="ttdeci">~TlsCustomVerificationCheckRequest()</div><div class="ttdef"><b>Definition:</b> tls_certificate_verifier.h:59</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_external_certificate_verifier_html_a9585983d0bd04c7a0a126b5b1cc15359"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_external_certificate_verifier.html#a9585983d0bd04c7a0a126b5b1cc15359">grpc::experimental::ExternalCertificateVerifier::Create</a></div><div class="ttdeci">static std::shared_ptr< CertificateVerifier > Create(Args &&... args)</div><div class="ttdef"><b>Definition:</b> tls_certificate_verifier.h:150</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_external_certificate_verifier_html_a3742120a627609e1a300e13bcb4e5d3a"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_external_certificate_verifier.html#a3742120a627609e1a300e13bcb4e5d3a">grpc::experimental::ExternalCertificateVerifier::ExternalCertificateVerifier</a></div><div class="ttdeci">ExternalCertificateVerifier()</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_certificate_verifier_html_a7312acadecd716e3a0c7c4bbcb3e84d1"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_certificate_verifier.html#a7312acadecd716e3a0c7c4bbcb3e84d1">grpc::experimental::CertificateVerifier::Cancel</a></div><div class="ttdeci">void Cancel(TlsCustomVerificationCheckRequest *request)</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_tls_custom_verification_check_request_html"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html">grpc::experimental::TlsCustomVerificationCheckRequest</a></div><div class="ttdef"><b>Definition:</b> tls_certificate_verifier.h:55</div></div>
|
|
<div class="ttc" id="agrpc_2status_8h_html"><div class="ttname"><a href="grpc_2status_8h.html">status.h</a></div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1_status_html"><div class="ttname"><a href="classgrpc_1_1_status.html">grpc::Status</a></div><div class="ttdoc">Did it work? If it didn't, why?</div><div class="ttdef"><b>Definition:</b> status.h:35</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_no_op_certificate_verifier_html"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_no_op_certificate_verifier.html">grpc::experimental::NoOpCertificateVerifier</a></div><div class="ttdef"><b>Definition:</b> tls_certificate_verifier.h:227</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_external_certificate_verifier_html"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_external_certificate_verifier.html">grpc::experimental::ExternalCertificateVerifier</a></div><div class="ttdef"><b>Definition:</b> tls_certificate_verifier.h:142</div></div>
|
|
<div class="ttc" id="astructgrpc__tls__certificate__verifier__external_html"><div class="ttname"><a href="structgrpc__tls__certificate__verifier__external.html">grpc_tls_certificate_verifier_external</a></div><div class="ttdoc">EXPERIMENTAL API - Subject to change.</div><div class="ttdef"><b>Definition:</b> grpc_security.h:986</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_tls_custom_verification_check_request_html_a6b2fa23b836091ce72d6f3474ff79a78"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#a6b2fa23b836091ce72d6f3474ff79a78">grpc::experimental::TlsCustomVerificationCheckRequest::email_names</a></div><div class="ttdeci">std::vector< grpc::string_ref > email_names() const</div></div>
|
|
<div class="ttc" id="asupport_2log_8h_html"><div class="ttname"><a href="support_2log_8h.html">log.h</a></div></div>
|
|
<div class="ttc" id="atls__certificate__verifier_8h_html_acb2cccf44dad8776d1a0abbd36781ee7"><div class="ttname"><a href="tls__certificate__verifier_8h.html#acb2cccf44dad8776d1a0abbd36781ee7">grpc_tls_on_custom_verification_check_done_cb</a></div><div class="ttdeci">void(* grpc_tls_on_custom_verification_check_done_cb)(grpc_tls_custom_verification_check_request *request, void *callback_arg, grpc_status_code status, const char *error_details)</div><div class="ttdef"><b>Definition:</b> tls_certificate_verifier.h:42</div></div>
|
|
<div class="ttc" id="agrpc__security_8h_html_afc10060e41d23b0e31f5c5a312d49138"><div class="ttname"><a href="grpc__security_8h.html#afc10060e41d23b0e31f5c5a312d49138">grpc_tls_certificate_verifier</a></div><div class="ttdeci">struct grpc_tls_certificate_verifier grpc_tls_certificate_verifier</div><div class="ttdoc">EXPERIMENTAL API - Subject to change.</div><div class="ttdef"><b>Definition:</b> grpc_security.h:978</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_certificate_verifier_html_a0e585b2306ce405823a234e33d543a9f"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_certificate_verifier.html#a0e585b2306ce405823a234e33d543a9f">grpc::experimental::CertificateVerifier::Verify</a></div><div class="ttdeci">bool Verify(TlsCustomVerificationCheckRequest *request, std::function< void(grpc::Status)> callback, grpc::Status *sync_status)</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_tls_custom_verification_check_request_html_accc7f76347376f5ab78eb3558c38427e"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#accc7f76347376f5ab78eb3558c38427e">grpc::experimental::TlsCustomVerificationCheckRequest::TlsCustomVerificationCheckRequest</a></div><div class="ttdeci">TlsCustomVerificationCheckRequest(grpc_tls_custom_verification_check_request *request)</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_tls_custom_verification_check_request_html_a546d5daf4deb0b2b0465de56edd43be0"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#a546d5daf4deb0b2b0465de56edd43be0">grpc::experimental::TlsCustomVerificationCheckRequest::peer_cert_full_chain</a></div><div class="ttdeci">grpc::string_ref peer_cert_full_chain() const</div></div>
|
|
<div class="ttc" id="atls__certificate__verifier_8h_html_a129d8fd8e77cde679368f6ae03f990d4"><div class="ttname"><a href="tls__certificate__verifier_8h.html#a129d8fd8e77cde679368f6ae03f990d4">grpc_tls_certificate_verifier_external_create</a></div><div class="ttdeci">grpc_tls_certificate_verifier * grpc_tls_certificate_verifier_external_create(grpc_tls_certificate_verifier_external *external_verifier)</div></div>
|
|
<div class="ttc" id="agrpcpp_2impl_2grpc__library_8h_html"><div class="ttname"><a href="grpcpp_2impl_2grpc__library_8h.html">grpc_library.h</a></div></div>
|
|
<div class="ttc" id="agrpcpp_2support_2config_8h_html"><div class="ttname"><a href="grpcpp_2support_2config_8h.html">config.h</a></div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_tls_custom_verification_check_request_html_a13a8356b3151deff241ef4f23798a783"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#a13a8356b3151deff241ef4f23798a783">grpc::experimental::TlsCustomVerificationCheckRequest::common_name</a></div><div class="ttdeci">grpc::string_ref common_name() const</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_certificate_verifier_html"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_certificate_verifier.html">grpc::experimental::CertificateVerifier</a></div><div class="ttdef"><b>Definition:</b> tls_certificate_verifier.h:90</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_tls_custom_verification_check_request_html_affa1020d4e6a6dc7edd2c6a154ae3547"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#affa1020d4e6a6dc7edd2c6a154ae3547">grpc::experimental::TlsCustomVerificationCheckRequest::ip_names</a></div><div class="ttdeci">std::vector< grpc::string_ref > ip_names() const</div></div>
|
|
<div class="ttc" id="agrpc__security__constants_8h_html"><div class="ttname"><a href="grpc__security__constants_8h.html">grpc_security_constants.h</a></div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_tls_custom_verification_check_request_html_ab7e55b53c51a3ac3f2a63ac20599a519"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#ab7e55b53c51a3ac3f2a63ac20599a519">grpc::experimental::TlsCustomVerificationCheckRequest::peer_cert</a></div><div class="ttdeci">grpc::string_ref peer_cert() const</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_tls_custom_verification_check_request_html_a12209dde5499614655bf317402e5d564"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#a12209dde5499614655bf317402e5d564">grpc::experimental::TlsCustomVerificationCheckRequest::target_name</a></div><div class="ttdeci">grpc::string_ref target_name() const</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_certificate_verifier_html_a9631cd85f3d9663562ab619414da6218"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_certificate_verifier.html#a9631cd85f3d9663562ab619414da6218">grpc::experimental::CertificateVerifier::CertificateVerifier</a></div><div class="ttdeci">CertificateVerifier(grpc_tls_certificate_verifier *v)</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_no_op_certificate_verifier_html_a98498f87d3c6f9a29942fcb2a9e9c870"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_no_op_certificate_verifier.html#a98498f87d3c6f9a29942fcb2a9e9c870">grpc::experimental::NoOpCertificateVerifier::NoOpCertificateVerifier</a></div><div class="ttdeci">NoOpCertificateVerifier()</div></div>
|
|
<div class="ttc" id="astructgrpc__tls__custom__verification__check__request_html"><div class="ttname"><a href="structgrpc__tls__custom__verification__check__request.html">grpc_tls_custom_verification_check_request</a></div><div class="ttdoc">EXPERIMENTAL API - Subject to change.</div><div class="ttdef"><b>Definition:</b> grpc_security.h:926</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1internal_1_1_mutex_html"><div class="ttname"><a href="classgrpc_1_1internal_1_1_mutex.html">grpc::internal::Mutex</a></div><div class="ttdef"><b>Definition:</b> sync.h:57</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_host_name_certificate_verifier_html"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_host_name_certificate_verifier.html">grpc::experimental::HostNameCertificateVerifier</a></div><div class="ttdef"><b>Definition:</b> tls_certificate_verifier.h:235</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_tls_custom_verification_check_request_html_a229d24a192c9e23ce2bef7f8f1c4f0fa"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#a229d24a192c9e23ce2bef7f8f1c4f0fa">grpc::experimental::TlsCustomVerificationCheckRequest::uri_names</a></div><div class="ttdeci">std::vector< grpc::string_ref > uri_names() const</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_external_certificate_verifier_html_aa8776fc87f8fbe4bee331e520ba04620"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_external_certificate_verifier.html#aa8776fc87f8fbe4bee331e520ba04620">grpc::experimental::ExternalCertificateVerifier::Verify</a></div><div class="ttdeci">virtual bool Verify(TlsCustomVerificationCheckRequest *request, std::function< void(grpc::Status)> callback, grpc::Status *sync_status)=0</div></div>
|
|
<div class="ttc" id="ap_2impl_2sync_8h_html"><div class="ttname"><a href="p_2impl_2sync_8h.html">sync.h</a></div></div>
|
|
<div class="ttc" id="agrpcpp_2support_2string__ref_8h_html"><div class="ttname"><a href="grpcpp_2support_2string__ref_8h.html">string_ref.h</a></div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_tls_custom_verification_check_request_html_af14256f7b3532106f3b523209af0168c"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_tls_custom_verification_check_request.html#af14256f7b3532106f3b523209af0168c">grpc::experimental::TlsCustomVerificationCheckRequest::c_request</a></div><div class="ttdeci">grpc_tls_custom_verification_check_request * c_request()</div><div class="ttdef"><b>Definition:</b> tls_certificate_verifier.h:77</div></div>
|
|
<div class="ttc" id="aclassgrpc_1_1experimental_1_1_external_certificate_verifier_html_a15aceea4e2ba7944e502cfc3d0d51618"><div class="ttname"><a href="classgrpc_1_1experimental_1_1_external_certificate_verifier.html#a15aceea4e2ba7944e502cfc3d0d51618">grpc::experimental::ExternalCertificateVerifier::~ExternalCertificateVerifier</a></div><div class="ttdeci">virtual ~ExternalCertificateVerifier()</div></div>
|
|
<!-- start footer part -->
|
|
<hr class="footer"/><address class="footer"><small>
|
|
Generated on Wed Sep 6 2023 16:09:16 for GRPC C++ by  <a href="http://www.doxygen.org/index.html">
|
|
<img class="footer" src="doxygen.png" alt="doxygen"/>
|
|
</a> 1.8.17
|
|
</small></address>
|
|
</body>
|
|
</html>
|