blob: 52d53cb19a2600b32f6d48b91575822284ccb92d [file] [log] [blame]
// Copyright (c) 2012 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#include "base/basictypes.h"
#include "net/base/completion_callback.h"
#include "net/base/net_export.h"
#include "net/socket/ssl_socket.h"
#include "net/socket/stream_socket.h"
namespace crypto {
class RSAPrivateKey;
} // namespace crypto
namespace net {
struct SSLConfig;
class X509Certificate;
class SSLServerSocket : public SSLSocket {
virtual ~SSLServerSocket() {}
// Perform the SSL server handshake, and notify the supplied callback
// if the process completes asynchronously. If Disconnect is called before
// completion then the callback will be silently, as for other StreamSocket
// calls.
virtual int Handshake(const CompletionCallback& callback) = 0;
// Configures the underlying SSL library for the use of SSL server sockets.
// Due to the requirements of the underlying libraries, this should be called
// early in process initialization, before any SSL socket, client or server,
// has been used.
// Note: If a process does not use SSL server sockets, this call may be
// omitted.
NET_EXPORT void EnableSSLServerSockets();
// Creates an SSL server socket over an already-connected transport socket.
// The caller must provide the server certificate and private key to use.
// The returned SSLServerSocket takes ownership of |socket|. Stubbed versions
// of CreateSSLServerSocket will delete |socket| and return NULL.
// It takes a reference to |certificate|.
// The |key| and |ssl_config| parameters are copied. |key| cannot be const
// because the methods used to copy its contents are non-const.
// The caller starts the SSL server handshake by calling Handshake on the
// returned socket.
NET_EXPORT SSLServerSocket* CreateSSLServerSocket(
StreamSocket* socket,
X509Certificate* certificate,
crypto::RSAPrivateKey* key,
const SSLConfig& ssl_config);
} // namespace net