~ubuntu-branches/ubuntu/precise/gnutls28/precise

transport functions with functions that emulate the operation

of @code{recvfrom} and @code{sendto}. In addition

@acronym{DTLS} requires timers during the receive of a handshake

 

@showfuncdesc{gnutls_transport_set_pull_timeout_function}

 

of the peer's identity. When certificates are in use,

this can be done, either after the handshake is complete, or during 

the handshake if @funcref{gnutls_certificate_set_verify_function}

used to verify the peer's certificate (see @ref{Certificate authentication}

for more information).

 

Once the handshake is complete and peer's identity

has been verified data can be exchanged. The available

functions resemble the POSIX @code{recv} and @code{send}

 

@showfuncdesc{gnutls_record_send}

 

@showfuncdesc{gnutls_record_recv}

 

In DTLS it is adviceable to use the extended receive

function shown below, because it allows the extraction

of the sequence number. This is required in DTLS because

session. That way the peer is notified securely about the

intention of termination, which allows distinguishing it

from a malicious connection termination.

 

@showfuncdesc{gnutls_bye}

@showfuncdesc{gnutls_deinit}

 

@subsection Asynchronous operation

to generate a secret key that is used to sign a cookie@footnote{A key of 128 bits or 16 bytes should be sufficient for this purpose.}. 

That cookie is sent to the client using @funcref{gnutls_dtls_cookie_send}, and 

the client must reply using the correct cookie. The server side

 

Note that the above apply to server side only and they are not mandatory to be

used. Not using them, however, allows denial of service attacks.

 

Datagrams are typically restricted by a maximum transfer unit (MTU). For that

both client and server side should set the correct maximum transfer unit for

of DTLS messages and prevent messages from being silently discarded by the

transport layer. The ``correct'' maximum transfer unit can be obtained through

a path MTU discovery mechanism @xcite{RFC4821}.

 

 

@node Priority Strings

@section Priority strings

 

 

@showfuncD{gnutls_priority_set_direct,gnutls_priority_init,gnutls_priority_deinit,gnutls_priority_set}

 

 

Unless the first keyword is "NONE" the defaults (in preference

order) are for TLS protocols TLS 1.2, TLS1.1, TLS1.0, SSL3.0; for

perfect forward secrecy algorithms take precedence of the other

protocols.  In all cases all the supported key exchange algorithms

 are enabled (except for the RSA-EXPORT which is only enabled in

EXPORT level).

and is used to provide the exact list of requested algorithms@footnote{To avoid collisions in order to specify a compression algorithm in

this string you have to prefix it with "COMP-", protocol versions

with "VERS-", signature algorithms with "SIGN-" and certificate types with "CTYPE-". All other

CURVE-SECP224R1, CURVE-SECP256R1, CURVE-SECP384R1, CURVE-SECP521R1. Catch all is CURVE-ALL.

 

@end multitable

@end float

 

 

 

@item %NO_EXTENSIONS @tab

will prevent the sending of any TLS extensions in client side. Note

 

@item %DISABLE_SAFE_RENEGOTIATION @tab

will disable safe renegotiation

 

@node Echo Server with OpenPGP authentication

@subsection Echo server with @acronym{OpenPGP} authentication

 

The following example is an echo server which supports

@acronym{OpenPGP} key authentication. You can easily combine

@cindex random numbers

 

Access to the random number generator is provided using the @funcref{gnutls_rnd}

 

@showfuncdesc{gnutls_rnd}