Pion DTLS

DTLS का एक Go कार्यान्वयन

Go प्रोग्रामिंग भाषा में मूल DTLS 1.2 और DTLS 1.3 का कार्यान्वयन।

एक दीर्घकालिक लक्ष्य एक पेशेवर सुरक्षा समीक्षा है, और शायद stdlib में शामिल करना।

RFCs

कार्यान्वित

• RFC 6347: Datagram Transport Layer Security Version 1.2
• RFC 9146: Connection Identifier for DTLS 1.2
• RFC 9147: The Datagram Transport Layer Security (DTLS) Protocol Version 1.3
• RFC 9849: TLS Encrypted Client Hello
• RFC 9853: Return Routability Check for DTLS 1.2 and 1.3
• RFC 5705: Keying Material Exporters for Transport Layer Security (TLS)
• RFC 7627: Transport Layer Security (TLS) - Session Hash and Extended Master Secret Extension
• RFC 7301: Transport Layer Security (TLS) - Application-Layer Protocol Negotiation Extension

विशेषताएँ

Pion DTLS, DTLS 1.2 और DTLS 1.3 का समर्थन करता है। हम योगदान और बग फ़िक्स का स्वागत करते हैं।

वर्तमान विशेषताएँ

• DTLS 1.2 और DTLS 1.3 क्लाइंट/सर्वर
• ECDHE(curve25519, nistp256, nistp384) और PSK के माध्यम से कुंजी विनिमय
• psk_ke और psk_dhe_ke के साथ DTLS 1.3 बाह्य PSK, SHA-256 और SHA-384 का समर्थन करता है
• DTLS 1.3 सर्वर चयन के लिए प्रति हैंडशेक कई PSK पहचान प्रदान करता है
• हैंडशेकिंग के दौरान पैकेट हानि और पुनः क्रमण संभाला जाता है
• कुंजी निर्यात (RFC 5705)
• Resume के साथ DTLS 1.2 और DTLS 1.3 कनेक्शन स्थिति का क्रमांकन और पुनर्स्थापन
• DTLS 1.3 सत्र टिकट पुनःआरंभ और वैकल्पिक 0-RTT अर्ली डेटा
• DTLS 1.3 एन्क्रिप्टेड क्लाइंट हेलो (ECH), WithECH के साथ कॉन्फ़िगर किया गया (RFC 9849)
• विस्तारित मास्टर सीक्रेट एक्सटेंशन (RFC 7627)
• ALPN एक्सटेंशन (RFC 7301)
• DTLS 1.2 और DTLS 1.3 के लिए कनेक्शन ID (CID), जिसमें पीयर पता परिवर्तनों में लिसनर रूटिंग शामिल है
• DTLS 1.3 पोस्ट-हैंडशेक CID अपडेट और पथ माइग्रेशन के लिए स्पेयर CID
• DTLS 1.2 और DTLS 1.3 के लिए रिटर्न रूटेबिलिटी चेक (RRC) (RFC 9853)
• Conn.AddPath, Path.Probe, और Path.Switch के साथ DTLS 1.3 स्थानीय पथ प्रोबिंग और माइग्रेशन
• Conn.UpdateKeys के साथ DTLS 1.3 ट्रैफ़िक-कुंजी अपडेट

समर्थित सिफर

DTLS 1.3: प्रमाणपत्र और PSK

• TLS_AES_128_GCM_SHA256 (RFC 8446)
• TLS_AES_256_GCM_SHA384 (RFC 8446)
• TLS_CHACHA20_POLY1305_SHA256 (RFC 8446)

DTLS 1.2: ECDHE

• TLS_ECDHE_ECDSA_WITH_AES_128_CCM (RFC 6655)
• TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8 (RFC 6655)
• TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 (RFC 5289)
• TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (RFC 5289)
• TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 (RFC 5289)
• TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (RFC 5289)
• TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA (RFC 8422)
• TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA (RFC 8422)
• TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256 (RFC 7905)
• TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256 (RFC 7905)

DTLS 1.2: PSK

• TLS_PSK_WITH_AES_128_CCM (RFC 6655)
• TLS_PSK_WITH_AES_128_CCM_8 (RFC 6655)
• TLS_PSK_WITH_AES_256_CCM_8 (RFC 6655)
• TLS_PSK_WITH_AES_128_GCM_SHA256 (RFC 5487)
• TLS_PSK_WITH_AES_128_CBC_SHA256 (RFC 5487)
• TLS_PSK_WITH_CHACHA20_POLY1305_SHA256 (RFC 7905)

DTLS 1.2: ECDHE और PSK

• TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256 (RFC 5489)
• TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256 (RFC 7905)

बहिष्कृत सुविधाएँ

• DTLS 1.0
• पुनर्वार्ता (Renegotiation)
• संपीड़न (Compression)

Pion DTLS

लाइब्रेरी डिफ़ॉल्ट रूप से DTLS 1.2 और DTLS 1.3 सक्षम करती है, DTLS 1.3 को प्राथमिकता देती है। किसी कनेक्शन को DTLS 1.2 तक सीमित करने के लिए WithMaxVersion(protocol.Version1_2) का उपयोग करें, या DTLS 1.3 आवश्यक करने के लिए WithMinVersion(protocol.Version1_3) का उपयोग करें।

127.0.0.1:4444 पर सुनने वाले DTLS सर्वर के लिए

go run examples/listen/selfsign/main.go

DTLS क्लाइंट के लिए जो 127.0.0.1:4444 से कनेक्ट होता है

go run examples/dial/selfsign/main.go

OpenSSL

Pion DTLS स्वयं से और OpenSSL से कनेक्ट हो सकता है।

  // Generate a certificate
  openssl ecparam -out key.pem -name prime256v1 -genkey
  openssl req -new -sha256 -key key.pem -out server.csr
  openssl x509 -req -sha256 -days 365 -in server.csr -signkey key.pem -out cert.pem

  // Use with examples/dial/selfsign/main.go
  openssl s_server -dtls1_2 -cert cert.pem -key key.pem -accept 4444

  // Use with examples/listen/selfsign/main.go
  openssl s_client -dtls1_2 -connect 127.0.0.1:4444 -debug -cert cert.pem -key key.pem

DTLS 1.3 पुनःआरंभ और अर्ली डेटा

DTLS 1.3 वैकल्पिक 0-RTT अर्ली डेटा के साथ सत्र टिकट पुनःआरंभ का समर्थन करता है। पुनःआरंभ केवल psk_dhe_ke (अस्थायी ECDHE के साथ PSK) की अनुमति देता है।

पुनःआरंभ उदाहरण एक प्रमाणपत्र-प्रमाणित पहले कनेक्शन, एन्क्रिप्टेड सत्र संग्रहण, और पुनःआरंभ तथा वैकल्पिक अर्ली डेटा के साथ बाद के कनेक्शनों को प्रदर्शित करता है। चलाने के निर्देशों और 0-RTT के लिए सत्र स्टोर की एकल-उपयोग Claim आवश्यकता के लिए इसका README देखें।

State/Resume API नए हैंडशेक के बिना स्थापित DTLS 1.3 कनेक्शनों को पुनर्स्थापित करने का भी समर्थन करता है। देखें Resume।

PSK के साथ उपयोग करना

DTLS 1.3 SHA-256 या SHA-384 का उपयोग करते हुए psk_ke (केवल-PSK) और psk_dhe_ke (अस्थायी ECDHE के साथ PSK) के साथ बाहरी PSK का समर्थन करता है। क्लाइंट सर्वर द्वारा चयन के लिए प्रति हैंडशेक कई PSK पहचान प्रस्तुत कर सकते हैं।

PSK उदाहरण डिफ़ॉल्ट रूप से DTLS 1.3 का उपयोग करते हैं, TLS_AES_128_GCM_SHA256 के साथ।

Pion DTLS

go run examples/listen/psk/main.go