1// Copyright 2013 The Chromium Authors. All rights reserved. 2// Use of this source code is governed by a BSD-style license that can be 3// found in the LICENSE file. 4 5// A set of common constants that are needed for the WebSocket handshake. 6// In general, you should prefer using these constants to literal strings, 7// except in tests. 8// 9// These constants cannot be used in files that are compiled on iOS, because 10// this file is not compiled on iOS. 11 12#ifndef NET_WEBSOCKETS_WEBSOCKET_HANDSHAKE_CONSTANTS_H_ 13#define NET_WEBSOCKETS_WEBSOCKET_HANDSHAKE_CONSTANTS_H_ 14 15#include "base/basictypes.h" 16 17// This file plases constants inside the ::net::websockets namespace to avoid 18// risk of collisions with other symbols in libnet. 19namespace net { 20namespace websockets { 21 22// "HTTP/1.1" 23// RFC6455 only requires HTTP/1.1 "or better" but in practice an HTTP version 24// other than 1.1 should not occur in a WebSocket handshake. 25extern const char* const kHttpProtocolVersion; 26 27// The Sec-WebSockey-Key challenge is 16 random bytes, base64 encoded. 28extern const size_t kRawChallengeLength; 29 30// "Sec-WebSocket-Protocol" 31extern const char* const kSecWebSocketProtocol; 32 33// "Sec-WebSocket-Extensions" 34extern const char* const kSecWebSocketExtensions; 35 36// "Sec-WebSocket-Key" 37extern const char* const kSecWebSocketKey; 38 39// "Sec-WebSocket-Accept" 40extern const char* const kSecWebSocketAccept; 41 42// "Sec-WebSocket-Version" 43extern const char* const kSecWebSocketVersion; 44 45// This implementation only supports one version of the WebSocket protocol, 46// "13", as specified in RFC6455. If support for multiple versions is added in 47// future, it will probably no longer be worth having a constant for this. 48extern const char* const kSupportedVersion; 49 50// "Upgrade" 51extern const char* const kUpgrade; 52 53// "258EAFA5-E914-47DA-95CA-C5AB0DC85B11" as defined in section 4.1 of 54// RFC6455. 55extern const char* const kWebSocketGuid; 56 57// Colon-prefixed lowercase headers for SPDY3. 58 59// ":sec-websocket-protocol" 60extern const char* const kSecWebSocketProtocolSpdy3; 61 62// ":sec-websocket-extensions" 63extern const char* const kSecWebSocketExtensionsSpdy3; 64 65// Some parts of the code require lowercase versions of the header names in 66// order to do case-insensitive comparisons, or because of SPDY. 67// "sec-websocket-protocol" 68extern const char* const kSecWebSocketProtocolLowercase; 69 70// "sec-websocket-extensions" 71extern const char* const kSecWebSocketExtensionsLowercase; 72 73// "sec-webSocket-key" 74extern const char* const kSecWebSocketKeyLowercase; 75 76// "sec-websocket-version" 77extern const char* const kSecWebSocketVersionLowercase; 78 79// "upgrade" 80extern const char* const kUpgradeLowercase; 81 82// "websocket", as used in the "Upgrade:" header. This is always lowercase 83// (except in obsolete versions of the protocol). 84extern const char* const kWebSocketLowercase; 85 86} // namespace websockets 87} // namespace net 88 89#endif // NET_WEBSOCKETS_WEBSOCKET_HANDSHAKE_CONSTANTS_H_ 90