1    <refentry id="refsslca">
2
3      <refmeta>
4	<refentrytitle>ne_ssl_trust_cert</refentrytitle>
5	<manvolnum>3</manvolnum>
6      </refmeta>
7
8      <refnamediv>
9	<refname id="ne_ssl_trust_cert">ne_ssl_trust_cert</refname>
10	<refname id="ne_ssl_trust_default_ca">ne_ssl_trust_default_ca</refname>
11	<refpurpose>functions to indicate that certificates are trusted</refpurpose>
12      </refnamediv>
13      
14      <refsynopsisdiv>
15	
16	<funcsynopsis>
17
18	  <funcsynopsisinfo>#include &lt;ne_session.h&gt;</funcsynopsisinfo>
19
20	  <funcprototype>
21	    <funcdef>void <function>ne_ssl_trust_cert</function></funcdef>
22	    <paramdef>ne_session *<parameter>session</parameter></paramdef>
23	    <paramdef>const ne_ssl_certificate *<parameter>cert</parameter></paramdef>
24	  </funcprototype>
25
26	  <funcprototype>
27	    <funcdef>void <function>ne_ssl_trust_default_ca</function></funcdef>
28	    <paramdef>ne_session *<parameter>session</parameter></paramdef>
29	  </funcprototype>
30
31	</funcsynopsis>
32	
33      </refsynopsisdiv>
34
35      <refsect1>
36	<title>Description</title>
37
38	<para>To indicate that a given certificate is trusted by the
39user, the certificate object can be passed to
40<function>ne_ssl_trust_cert</function>.  The certificate object is
41duplicated internally and can subsequently be destroyed.</para>
42
43	<para>The SSL library in use by &neon; may include a default
44set of CA certificates; calling the
45<function>ne_ssl_trust_default_ca</function> function will indicate
46that these CAs are trusted by the user.</para>
47
48      </refsect1>
49
50      <refsect1>
51	<title>Examples</title>
52
53	<para>Load the CA certificate stored in <filename>/path/to/cacert.pem</filename>:</para>
54	<programlisting>&egsess;
55ne_ssl_certificate *cert = ne_ssl_cert_read("/path/to/cacert.pem");
56
57if (cert) {
58   ne_ssl_trust_cert(sess, cert);
59   ne_ssl_cert_free(cert);
60} else {
61   printf("Could not load CA cert: %s\n", ne_get_error(sess));
62}</programlisting>
63      </refsect1>
64
65      <refsect1>
66	<title>See also</title>
67
68	<para><xref linkend="ne_ssl_cert_read"/>, <xref
69	linkend="ne_ssl_cert_import"/>, <xref
70	linkend="ne_ssl_cert_free"/></para> </refsect1>
71
72    </refentry>
73