Skip to content

Commit b6014cc

Browse files
author
Peter Thorson
committed
FAQ & Change log minor update
1 parent d917f09 commit b6014cc

File tree

2 files changed

+14
-1
lines changed

2 files changed

+14
-1
lines changed

changelog.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ HEAD
4949
- Compatibility: Replace deprecated use of auto_ptr on systems where unique_ptr
5050
is available.
5151

52-
0.6.0
52+
0.6.0 - 2015-06-02
5353
- MINOR BREAKING TRANSPORT POLICY CHANGE: Custom transport policies will now be
5454
required to include a new method `void set_uri(uri_ptr u)`. An implementation
5555
is not required. The stub transport policy includes an example stub method

docs/faq.dox

+13
Original file line numberDiff line numberDiff line change
@@ -19,4 +19,17 @@ Whether an Asio endpoint uses TLS or not is determined by its config template pa
1919

2020
The `<websocketpp/config/asio.hpp>` and `<websocketpp/config/asio_client.hpp>` headers will include both the TLS and non-TLS varients of their respective configs and require the presence of OpenSSL. The `<websocketpp/config/asio_no_tls.hpp>` and `<websocketpp/config/asio_no_tls_client.hpp>` headers will include only the non-TLS configs and do not require OpenSSL.
2121

22+
23+
## Security
24+
25+
### Is it possible to terminate a malicious connection quickly, without tying up resources performing clean close steps,
26+
27+
Yes. The library will automatically detect and terminate connections that violate the WebSocket protocol. In cases where the library believes the remote endpoint to be malicious or sufficiently broken to be unlikely to understand or process the closing handshake, it will be omited.
28+
29+
If your application detects conditions above the protocol level that you believe to be malicious, for example, if you recognize an IP from a known denial of service attack, you can close the connection with two different levels of urgency. Use the standard `websocketpp::endpoint::close` or `websocketpp::connection::close` methods with one of the following special close codes:
30+
- `websocketpp::close::status::omit_handshake`: Omits the closing handshake, but cleanly closes the TCP connection.
31+
- `websocketpp::close::status::force_tcp_drop`: Forcibly drop the TCP connection.
32+
33+
Please note that usage of these disconnect methods results in a violation of the WebSocket protocol and may have negative reprocusions for the remote endpoint with respect to network timeouts. Please use caution when using them.
34+
2235
*/

0 commit comments

Comments
 (0)