WebSocket çerçevesi
WebSocket, açılış el sıkışmasından sonra iki yönlü iletileri çerçeveler halinde taşır. Çerçevenin ilk 2 baytı türü, bayrakları, maske bitini ve kısa uzunluğu taşır. İstemciden sunucuya giden her çerçeve 4 baytlık bir anahtarla maskelenir.
Biçim kaynağı RFC 6455 §5.2
Yerleşim
Şemanın tamamı için yatay kaydırın; klavyede sağ ve sol ok tuşlarını kullanabilirsiniz.
Alan genişlikleri RFC 6455 §5.2 ile derleme sırasında karşılaştırıldı: 1 · 1 · 1 · 1 · 4 · 1 · 7 · 32 bit. Masking-key RFC şemasında iki satıra bölünerek çizildiği için genişliği aynı bölümdeki ABNF tanımından okunur.
Örnek paket
RFC 6455 §5.7'deki örnek: istemcinin gönderdiği, maskelenmiş tek çerçevelik "Hello" metin iletisi. 0x81 FIN biti 1 ve opcode 1 (metin), 0x85 MASK biti 1 ve 5 sekizli yüktür. Ardından 37 fa 21 3d anahtarı ve maskelenmiş yük gelir: 7f ^ 37 = 48 ("H"), 9f ^ fa = 65 ("e") vb.
Bu paket gerçek bir yakalama değildir: aşağıdaki tablodaki örnek değerlerden derleme sırasında üretilir, sağlama toplamları RFC 1071’deki yöntemle hesaplanır. Bir alanın üzerine gelin ya da alana tıklayın; karşılık gelen sekizliler vurgulanır. Soluk sekizliler başlıktan sonraki yüktür.
Alanlar
| Alan | Bit | Genişlik | Örnek | Açıklama ve kaynak |
|---|---|---|---|---|
| Son parçaFIN | 0 | 1 | 1 | İletinin son parçasıysa 1. Tek parçalık iletilerde ilk çerçeve aynı zamanda sondur. |
| Ayrılmış bit 1RSV1 | 1 | 1 | 0 | Bir uzantı anlam tanımlamadıkça 0; anlamı bilinmeyen 1 değeri bağlantıyı başarısız kılar. permessage-deflate uzantısı bu biti sıkıştırma için kullanır. |
| Ayrılmış bit 2RSV2 | 2 | 1 | 0 | RSV1 ile aynı kurallar; uzantılar için ayrılmıştır. |
| Ayrılmış bit 3RSV3 | 3 | 1 | 0 | RSV1 ile aynı kurallar; uzantılar için ayrılmıştır. |
| İşlem koduOpcode | 4–7 | 4 | 1 | Yükün nasıl yorumlanacağı. 0x0–0x7 veri, 0x8–0xF denetim çerçeveleridir.
|
| Maske bayrağıMASK | 8 | 1 | 1 | Yük maskelenmişse 1 ve Masking-key alanı vardır. İstemciden gelen çerçevelerde her zaman 1'dir. |
| Yük uzunluğuPayload len | 9–15 | 7 | 5 | Yük uzunluğu. 0–125 doğrudan uzunluktur; 126 ve 127 genişletilmiş uzunluk alanının izlediğini gösterir. |
| Genişletilmiş yük uzunluğuExtended payload length | — | değişken | — | Payload len 126 ise 16 bitlik, 127 ise 64 bitlik (en anlamlı biti 0) gerçek yük uzunluğu. Bu örnekte bulunmaz. |
| Maskeleme anahtarıMasking-key | 16–47 | 32 | 0x37fa213d | MASK 1 ise bulunan 4 sekizlilik anahtar. Yükün i'nci sekizlisi, anahtarın (i mod 4)'üncü sekizlisiyle XOR'lanır. |
| Yük verisiPayload Data | — | değişken | — | Uzantı verisi ve uygulama verisi; MASK 1 ise maskelenmiş olarak. |
Notlar
- Bağlantı, Upgrade: websocket başlıklı bir HTTP/1.1 isteğiyle açılır; sunucu 101 Switching Protocols ile yanıt verdikten sonra bağlantı yalnızca çerçeve taşır (RFC 6455 §4).
- İstemci her çerçeveyi maskelemek zorundadır, sunucu hiçbirini maskelemez. Maske, aradaki önbellek ve vekil sunucuların çerçeve içeriğini HTTP isteği sanmasını önler (RFC 6455 §5.3, §10.3).
- Yük uzunluğu 125 sekizliye kadar 7 bitlik alana sığar; 126 ardından 16 bitlik, 127 ardından 64 bitlik genişletilmiş uzunluk geldiğini gösterir.
- Denetim çerçeveleri (Close, Ping, Pong) en çok 125 sekizli yük taşır ve parçalanamaz; bir iletinin parçaları arasına girebilirler (RFC 6455 §5.5).
Kaynaklar
- [RFC 6455] I. Fette, A. Melnikov, “The WebSocket Protocol”, RFC 6455, December 2011.