diff options
author | Nikos Mavrogiannopoulos <nmav@gnutls.org> | 2012-05-26 22:47:24 +0200 |
---|---|---|
committer | Nikos Mavrogiannopoulos <nmav@gnutls.org> | 2012-05-26 22:47:24 +0200 |
commit | 1f7dd895ed3949f0f3998e021cea9ba6f28281aa (patch) | |
tree | 13c5eb9ce691084e15a34be1bfd60c8a5f0ea2af /doc/cha-gtls-examples.texi | |
parent | bd0c48a106d54f3a7929edef6eefbf0eadd68c21 (diff) | |
download | gnutls-1f7dd895ed3949f0f3998e021cea9ba6f28281aa.tar.gz |
updated documentation
Diffstat (limited to 'doc/cha-gtls-examples.texi')
-rw-r--r-- | doc/cha-gtls-examples.texi | 32 |
1 files changed, 17 insertions, 15 deletions
diff --git a/doc/cha-gtls-examples.texi b/doc/cha-gtls-examples.texi index 637653c46a..d88e9bc05e 100644 --- a/doc/cha-gtls-examples.texi +++ b/doc/cha-gtls-examples.texi @@ -23,9 +23,9 @@ clients, using @acronym{GnuTLS}. Note that some of the examples require function implemented by another example. @menu -* Simple client example with anonymous authentication:: * Simple client example with X.509 certificate support:: * Simple client example with SSH-style certificate verification:: +* Simple client example with anonymous authentication:: * Simple Datagram TLS client example:: * Obtaining session information:: * Using a callback to select the certificate to use:: @@ -38,20 +38,6 @@ implemented by another example. * Helper functions for UDP connections:: @end menu -@node Simple client example with anonymous authentication -@subsection Simple client example with anonymous authentication - -The simplest client using TLS is the one that doesn't do any -authentication. This means no external certificates or passwords are -needed to set up the connection. As could be expected, the connection -is vulnerable to man-in-the-middle (active or redirection) attacks. -However, the data are integrity protected and encrypted from -passive eavesdroppers. - -Note that the server must support anonymous authentication as well. - -@verbatiminclude examples/ex-client-anon.c - @node Simple client example with X.509 certificate support @subsection Simple client example with @acronym{X.509} certificate support @anchor{ex:verify} @@ -76,6 +62,22 @@ trusted. @verbatiminclude examples/ex-verify-ssh.c +@node Simple client example with anonymous authentication +@subsection Simple client example with anonymous authentication + +The simplest client using TLS is the one that doesn't do any +authentication. This means no external certificates or passwords are +needed to set up the connection. As could be expected, the connection +is vulnerable to man-in-the-middle (active or redirection) attacks. +However, the data are integrity protected and encrypted from +passive eavesdroppers. + +Note that due to the vulnerable nature of this method very few public +servers support it. + +@verbatiminclude examples/ex-client-anon.c + + @node Simple Datagram TLS client example @subsection Simple datagram @acronym{TLS} client example |