OLD | NEW |
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef NET_SOCKET_SSL_SERVER_SOCKET_H_ | 5 #ifndef NET_SOCKET_SSL_SERVER_SOCKET_H_ |
6 #define NET_SOCKET_SSL_SERVER_SOCKET_H_ | 6 #define NET_SOCKET_SSL_SERVER_SOCKET_H_ |
7 | 7 |
8 #include "base/memory/scoped_ptr.h" | 8 #include "base/memory/scoped_ptr.h" |
9 #include "net/base/completion_callback.h" | 9 #include "net/base/completion_callback.h" |
10 #include "net/base/net_export.h" | 10 #include "net/base/net_export.h" |
(...skipping 13 matching lines...) Expand all Loading... |
24 public: | 24 public: |
25 ~SSLServerSocket() override {} | 25 ~SSLServerSocket() override {} |
26 | 26 |
27 // Perform the SSL server handshake, and notify the supplied callback | 27 // Perform the SSL server handshake, and notify the supplied callback |
28 // if the process completes asynchronously. If Disconnect is called before | 28 // if the process completes asynchronously. If Disconnect is called before |
29 // completion then the callback will be silently, as for other StreamSocket | 29 // completion then the callback will be silently, as for other StreamSocket |
30 // calls. | 30 // calls. |
31 virtual int Handshake(const CompletionCallback& callback) = 0; | 31 virtual int Handshake(const CompletionCallback& callback) = 0; |
32 }; | 32 }; |
33 | 33 |
| 34 class SSLServerContext { |
| 35 public: |
| 36 virtual ~SSLServerContext(){}; |
| 37 |
| 38 // Creates an SSL server socket over an already-connected transport socket. |
| 39 // The caller must ensure the returned socket does not outlive the server |
| 40 // context. |
| 41 // |
| 42 // The caller starts the SSL server handshake by calling Handshake on the |
| 43 // returned socket. |
| 44 virtual scoped_ptr<SSLServerSocket> CreateSSLServerSocket( |
| 45 scoped_ptr<StreamSocket> socket) = 0; |
| 46 }; |
| 47 |
34 // Configures the underlying SSL library for the use of SSL server sockets. | 48 // Configures the underlying SSL library for the use of SSL server sockets. |
35 // | 49 // |
36 // Due to the requirements of the underlying libraries, this should be called | 50 // Due to the requirements of the underlying libraries, this should be called |
37 // early in process initialization, before any SSL socket, client or server, | 51 // early in process initialization, before any SSL socket, client or server, |
38 // has been used. | 52 // has been used. |
39 // | 53 // |
40 // Note: If a process does not use SSL server sockets, this call may be | 54 // Note: If a process does not use SSL server sockets, this call may be |
41 // omitted. | 55 // omitted. |
42 NET_EXPORT void EnableSSLServerSockets(); | 56 NET_EXPORT void EnableSSLServerSockets(); |
43 | 57 |
44 // Creates an SSL server socket over an already-connected transport socket. | 58 // Creates an SSL server socket context where all sockets spawned using this |
| 59 // context will share the same session cache. |
| 60 // |
45 // The caller must provide the server certificate and private key to use. | 61 // The caller must provide the server certificate and private key to use. |
46 // | |
47 // The returned SSLServerSocket takes ownership of |socket|. Stubbed versions | |
48 // of CreateSSLServerSocket will delete |socket| and return NULL. | |
49 // It takes a reference to |certificate|. | 62 // It takes a reference to |certificate|. |
50 // The |key| and |ssl_config| parameters are copied. | 63 // The |key| and |ssl_config| parameters are copied. |
51 // | 64 // |
52 // The caller starts the SSL server handshake by calling Handshake on the | 65 NET_EXPORT scoped_ptr<SSLServerContext> CreateSSLServerContext( |
53 // returned socket. | |
54 NET_EXPORT scoped_ptr<SSLServerSocket> CreateSSLServerSocket( | |
55 scoped_ptr<StreamSocket> socket, | |
56 X509Certificate* certificate, | 66 X509Certificate* certificate, |
57 const crypto::RSAPrivateKey& key, | 67 const crypto::RSAPrivateKey& key, |
58 const SSLServerConfig& ssl_config); | 68 const SSLServerConfig& ssl_config); |
59 | 69 |
60 } // namespace net | 70 } // namespace net |
61 | 71 |
62 #endif // NET_SOCKET_SSL_SERVER_SOCKET_H_ | 72 #endif // NET_SOCKET_SSL_SERVER_SOCKET_H_ |
OLD | NEW |