aboutsummaryrefslogtreecommitdiffstats
path: root/src/tls/tls_client.h
blob: 95b5c8f61c362468b87e94f4d83a04248b7dc00e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
/*
* TLS Client
* (C) 2004-2011 Jack Lloyd
*
* Released under the terms of the Botan license
*/

#ifndef BOTAN_TLS_CLIENT_H__
#define BOTAN_TLS_CLIENT_H__

#include <botan/tls_channel.h>
#include <botan/tls_session_manager.h>
#include <botan/credentials_manager.h>
#include <vector>

namespace Botan {

/**
* SSL/TLS Client
*/
class BOTAN_DLL TLS_Client : public TLS_Channel
   {
   public:
      /**
      * Set up a new TLS client session
      * @param socket_output_fn is called with data for the outbound socket
      * @param proc_fn is called when new data (application or alerts) is received
      * @param handshake_complete is called when a handshake is completed
      * @param session_manager manages session state
      * @param creds manages application/user credentials
      * @param policy specifies other connection policy information
      * @param rng a random number generator
      * @param servername the server's DNS name, if known
      * @param next_protocol allows the client to specify what the next
      *        protocol will be. For more information read
      *        http://technotes.googlecode.com/git/nextprotoneg.html.
      *
      *        If the function is not empty, NPN will be negotiated
      *        and if the server supports NPN the function will be
      *        called with the list of protocols the server advertised;
      *        the client should return the protocol it would like to use.
      */
      TLS_Client(std::tr1::function<void (const byte[], size_t)> socket_output_fn,
                 std::tr1::function<void (const byte[], size_t, u16bit)> proc_fn,
                 std::tr1::function<bool (const TLS_Session&)> handshake_complete,
                 TLS_Session_Manager& session_manager,
                 Credentials_Manager& creds,
                 const TLS_Policy& policy,
                 RandomNumberGenerator& rng,
                 const std::string& servername = "",
                 std::tr1::function<std::string (std::vector<std::string>)> next_protocol =
                    std::tr1::function<std::string (std::vector<std::string>)>());

      void renegotiate();
   private:
      void process_handshake_msg(Handshake_Type type,
                                 const MemoryRegion<byte>& contents);

      void alert_notify(bool is_fatal, Alert_Type type);

      const TLS_Policy& policy;
      RandomNumberGenerator& rng;
      TLS_Session_Manager& session_manager;
      Credentials_Manager& creds;
   };

}

#endif