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 çerçeve bayrağıFIN | 0 | 1 bit | 1 | 1 ise bu çerçevenin iletinin son parçası olduğunu gösterir; parçalanmamış iletilerde 1'dir. |
| Ayrılmış bit 1RSV1 | 1 | 1 bit | 0 | Uzantılar için ayrılmış bit; uzantı uzlaşılmadıkça 0 olmalıdır. |
| Ayrılmış bit 2RSV2 | 2 | 1 bit | 0 | Uzantılar için ayrılmış bit; uzantı uzlaşılmadıkça 0 olmalıdır. |
| Ayrılmış bit 3RSV3 | 3 | 1 bit | 0 | Uzantılar için ayrılmış bit; uzantı uzlaşılmadıkça 0 olmalıdır. |
| İşlem koduOpcode | 4–7 | 4 bit | 1 | Çerçevenin işlevini tanımlayan 4 bitlik kod.
|
| Maskeleme bayrağıMASK | 8 | 1 bit | 1 | 1 ise yükün 4 baytlık Maskeleme Anahtarı ile maskelendiğini belirtir; istemciden sunucuya giden çerçevelerde zorunludur. |
| Yük uzunluğu göstergesiPayload length | 9–15 | 7 bit | 5 | 0–125 ise doğrudan yükün bayt cinsinden uzunluğudur; 126 ise sonraki 2 sekizli, 127 ise sonraki 8 sekizli uzunluğu verir. |
| Genişletilmiş yük uzunluğuExtended payload length | — | değişken | — | Yük uzunluğu 126 veya 127 olduğunda eklenen 16 bitlik veya 64 bitlik genişletilmiş uzunluk alanı. |
| Maskeleme anahtarıMasking-key | 16–47 | 32 bit | 0x37fa213d | Mask biti 1 olduğunda bulunan 4 sekizlilik rastgele anahtar; yük verisi bu anahtarla XOR'lanarak maskelenir. |
| Yük verisiPayload Data | — | değişken | — | Taşınan uygulama verisi; istemciden giden iletilerde Maskeleme Anahtarı ile maskelenmiştir. |
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.