STUN ileti başlığı
NAT için Oturum Geçiş Yardımcıları (Session Traversal Utilities for NAT - STUN), bir istemcinin NAT arkasından dışarıda hangi IP adresi ve port ile göründüğünü öğrenmesini sağlar. WebRTC ve ICE'in temel yapı taşıdır. Her ileti 20 sekizlilik bir başlıkla başlar, ardından TLV biçiminde öznitelikler gelir.
Biçim kaynağı RFC 8489 §5
Yerleşim
Şemanın tamamı için yatay kaydırın; klavyede sağ ve sol ok tuşlarını kullanabilirsiniz.
Alan genişlikleri RFC 8489 §5 (Format of STUN Message Header) ile derleme sırasında karşılaştırıldı: 2 · 14 · 16 · 32 · 96 bit.
Örnek paket
Bir Binding isteğine sunucunun verdiği başarılı yanıt. Tek özniteliği XOR-MAPPED-ADDRESS'tir (tür 0x0020, 8 sekizli): IPv4 ailesi, X-Port a147 ve X-Address e112a643. Magic Cookie ile XOR'landığında istemcinin dış adresi 192.0.2.1:32853 çıkar.
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 |
|---|---|---|---|---|
| İki sıfır bit0 0 | 0–1 | 2 | 0 | Her STUN iletisinin en anlamlı iki biti 0 olmalıdır. |
| STUN ileti türüSTUN Message Type | 2–15 | 14 | 0x0101 | Yöntem ve sınıf. 0x0001 Binding isteği, 0x0101 Binding başarılı yanıtı, 0x0111 Binding hata yanıtıdır.
|
| İleti uzunluğuMessage Length | 16–31 | 16 | 12 | 20 sekizlilik başlık hariç iletinin uzunluğu. Öznitelikler 4 sekizliye dolgulandığı için son iki biti her zaman 0'dır. |
| Sihirli çerezMagic Cookie | 32–63 | 32 | 0x2112a442 | Sabit 0x2112A442 değeri. Eski RFC 3489 istemcilerinden ayırt etmeye ve XOR-MAPPED-ADDRESS'i kodlamaya yarar. |
| İşlem kimliğiTransaction ID | 64–159 | 96 | b7e7a701bc34d686fa87dfae | İsteği yanıtla eşleştiren, istemcinin rastgele seçtiği 96 bitlik kimlik; yanıt aynı değeri taşır. |
| Öznitelikler | — | değişken | — | Type (16 bit), Length (16 bit) ve değerden oluşan, 4 sekizliye dolgulanmış öznitelikler. |
Notlar
- STUN, UDP ve TCP üzerinde 3478, TLS üzerinde 5349 numaralı portu kullanır (RFC 8489 §18.6).
- İlk iki bitin 0 olması ve sabit Magic Cookie değeri, STUN paketlerinin aynı porttan geçen RTP, RTCP ya da DTLS paketlerinden ayırt edilmesini sağlar.
- Message Type 14 bitinin içinde yöntemi (örneğin Binding) ve sınıfı (istek, gösterge, başarılı yanıt, hata yanıtı) birbirine karışmış olarak taşır; sınıf bitleri C1 ve C0'dır (RFC 8489 Figure 3).
- XOR-MAPPED-ADDRESS, adresi Magic Cookie ile XOR'layarak taşır. Bazı NAT'lar paket içinde kendi dış adreslerini görünce onu yeniden yazar; XOR bunu önler (RFC 8489 §14.2).
- Her öznitelik 4 sekizlilik sınıra dolgulanır; Message Length başlık hariç, dolgu dahil toplam öznitelik uzunluğudur.
Kaynaklar
- [RFC 8489] M. Petit-Huguenin, G. Salgueiro, J. Rosenberg, D. Wing, R. Mahy, P. Matthews, “Session Traversal Utilities for NAT (STUN)”, RFC 8489, February 2020.
- [RFC 5737] J. Arkko, M. Cotton, L. Vegoda, “IPv4 Address Blocks Reserved for Documentation”, RFC 5737, January 2010.