mirror of
https://github.com/XRPLF/rippled.git
synced 2025-12-06 17:27:55 +00:00
ac0eaa912b
This changes the behavior and configuration specification of the listening ports that rippled uses to accept incoming connections for the supported protocols: peer (Peer Protocol), http (JSON-RPC over HTTP), https (JSON-RPC) over HTTPS, ws (Websockets Clients), and wss (Secure Websockets Clients). Each listening port is now capable of handshaking in multiple protocols specified in the configuration file (subject to some restrictions). Each port can be configured to provide its own SSL certificate, or to use a self-signed certificate. Ports can be configured to share settings, this allows multiple ports to use the same certificate or values. The list of ports is dynamic, administrators can open as few or as many ports as they like. Authentication settings such as user/password or admin user/admin password (for administrative commands on RPC or Websockets interfaces) can also be specified per-port. As the configuration file has changed significantly, administrators will need to update their ripple.cfg files and carefully review the documentation and new settings. Changes: * rippled-example.cfg updated with documentation and new example settings: All obsolete websocket, rpc, and peer configuration sections have been removed, the documentation updated, and a new documented set of example settings added. * HTTP::Writer abstraction for sending HTTP server requests and responses * HTTP::Handler handler improvements to support Universal Port * HTTP::Handler handler supports legacy Peer protocol handshakes * HTTP::Port uses shared_ptr<boost::asio::ssl::context> * HTTP::PeerImp and Overlay use ssl_bundle to support Universal Port * New JsonWriter to stream message and body through HTTP server * ServerHandler refactored to support Universal Port and legacy peers * ServerHandler Setup struct updated for Universal Port * Refactor some PeerFinder members * WSDoor and Websocket code stores and uses the HTTP::Port configuration * Websocket autotls class receives the current secure/plain SSL setting * Remove PeerDoor and obsolete Overlay peer accept code * Remove obsolete RPCDoor and synchronous RPC handling code * Remove other obsolete classes, types, and files * Command line tool uses ServerHandler Setup for port and authorization info * Fix handling of admin_user, admin_password in administrative commands * Fix adminRole to check credentials for Universal Port * Updated Overlay README.md * Overlay sends IP:port redirects on HTTP Upgrade peer connection requests: Incoming peers who handshake using the HTTP Upgrade mechanism don't get a slot, and always get HTTP Status 503 redirect containing a JSON content-body with a set of alternate IP and port addresses to try, learned from PeerFinder. A future commit related to the Hub and Spoke feature will change the response to grant the peer a slot when there are peer slots available. * HTTP responses to outgoing Peer connect requests parse redirect IP:ports: When the [overlay] configuration section (which is experimental) has http_handshake = 1, HTTP redirect responses will have the JSON content-body parsed to obtain the redirect IP:port addresses. * Use a single io_service for HTTP::Server and Overlay: This is necessary to allow HTTP::Server to pass sockets to and from Overlay and eventually Websockets. Unfortunately Websockets is not so easily changed to use an externally provided io_service. This will be addressed in a future commit, and is one step necessary ease the restriction on ports configured to offer Websocket protocols in the .cfg file.
79 lines
3.7 KiB
C++
79 lines
3.7 KiB
C++
//------------------------------------------------------------------------------
|
|
/*
|
|
This file is part of rippled: https://github.com/ripple/rippled
|
|
Copyright (c) 2012, 2013 Ripple Labs Inc.
|
|
|
|
Permission to use, copy, modify, and/or distribute this software for any
|
|
purpose with or without fee is hereby granted, provided that the above
|
|
copyright notice and this permission notice appear in all copies.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
ANY SPECIAL , DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
|
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
*/
|
|
//==============================================================================
|
|
|
|
#ifndef RIPPLE_CONFIGSECTIONS_H_INCLUDED
|
|
#define RIPPLE_CONFIGSECTIONS_H_INCLUDED
|
|
|
|
namespace ripple {
|
|
|
|
// VFALCO DEPRECATED in favor of the BasicConfig interface
|
|
struct ConfigSection
|
|
{
|
|
static std::string nodeDatabase () { return "node_db"; }
|
|
static std::string tempNodeDatabase () { return "temp_db"; }
|
|
static std::string importNodeDatabase () { return "import_db"; }
|
|
};
|
|
|
|
// VFALCO TODO Rename and replace these macros with variables.
|
|
#define SECTION_ACCOUNT_PROBE_MAX "account_probe_max"
|
|
#define SECTION_CLUSTER_NODES "cluster_nodes"
|
|
#define SECTION_DATABASE_PATH "database_path"
|
|
#define SECTION_DEBUG_LOGFILE "debug_logfile"
|
|
#define SECTION_ELB_SUPPORT "elb_support"
|
|
#define SECTION_FEE_DEFAULT "fee_default"
|
|
#define SECTION_FEE_OFFER "fee_offer"
|
|
#define SECTION_FEE_OPERATION "fee_operation"
|
|
#define SECTION_FEE_ACCOUNT_RESERVE "fee_account_reserve"
|
|
#define SECTION_FEE_OWNER_RESERVE "fee_owner_reserve"
|
|
#define SECTION_FETCH_DEPTH "fetch_depth"
|
|
#define SECTION_LEDGER_HISTORY "ledger_history"
|
|
#define SECTION_INSIGHT "insight"
|
|
#define SECTION_IPS "ips"
|
|
#define SECTION_IPS_FIXED "ips_fixed"
|
|
#define SECTION_NETWORK_QUORUM "network_quorum"
|
|
#define SECTION_NODE_SEED "node_seed"
|
|
#define SECTION_NODE_SIZE "node_size"
|
|
#define SECTION_PATH_SEARCH_OLD "path_search_old"
|
|
#define SECTION_PATH_SEARCH "path_search"
|
|
#define SECTION_PATH_SEARCH_FAST "path_search_fast"
|
|
#define SECTION_PATH_SEARCH_MAX "path_search_max"
|
|
#define SECTION_PEER_PRIVATE "peer_private"
|
|
#define SECTION_PEERS_MAX "peers_max"
|
|
#define SECTION_RPC_ADMIN_ALLOW "rpc_admin_allow"
|
|
#define SECTION_RPC_STARTUP "rpc_startup"
|
|
#define SECTION_SMS_FROM "sms_from"
|
|
#define SECTION_SMS_KEY "sms_key"
|
|
#define SECTION_SMS_SECRET "sms_secret"
|
|
#define SECTION_SMS_TO "sms_to"
|
|
#define SECTION_SMS_URL "sms_url"
|
|
#define SECTION_SNTP "sntp_servers"
|
|
#define SECTION_SSL_VERIFY "ssl_verify"
|
|
#define SECTION_SSL_VERIFY_FILE "ssl_verify_file"
|
|
#define SECTION_SSL_VERIFY_DIR "ssl_verify_dir"
|
|
#define SECTION_VALIDATORS_FILE "validators_file"
|
|
#define SECTION_VALIDATION_QUORUM "validation_quorum"
|
|
#define SECTION_VALIDATION_SEED "validation_seed"
|
|
#define SECTION_WEBSOCKET_PING_FREQ "websocket_ping_frequency"
|
|
#define SECTION_VALIDATORS "validators"
|
|
#define SECTION_VALIDATORS_SITE "validators_site"
|
|
|
|
} // ripple
|
|
|
|
#endif
|