
rustls v/0.23.44
Rust में मेमोरी-सुरक्षित TLS लाइब्रेरी जो TLS 1.2 और 1.3 को लागू करती है, जिसमें प्लग करने योग्य क्रिप्टो प्रदाता, क्लाइंट/सर्वर मोड और प्रमाणपत्र-आधारित प्रमाणीकरण शामिल हैं।
Rustls, Rust में लिखी गई एक आधुनिक TLS लाइब्रेरी है।
स्थिति
Rustls का उपयोग कई संगठनों और परियोजनाओं में उत्पादन में किया जाता है। हम उचित API सतह स्थिरता बनाए रखने का लक्ष्य रखते हैं, लेकिन नई सुविधाओं या प्रदर्शन सुधारों को समायोजित करने के लिए बदलाव करते समय API विकसित हो सकता है।
हमारी भविष्य की योजनाओं के लिए हमारे पास एक रोडमैप है। प्रदर्शन में गिरावट को रोकने और आपको अपने लक्षित हार्डवेयर पर rustls का मूल्यांकन करने देने के लिए हमारे पास बेंचमार्क भी हैं।
यदि आप मदद करना चाहते हैं, तो कृपया CONTRIBUTING.md देखें।
अनुरक्षक "rustls" का उच्चारण rustles (rust-TLS के बजाय) करते हैं, लेकिन हम इसके बारे में दृढ़ता से नहीं सोचते।
चेंजलॉग
प्रत्येक रिलीज़ में परिवर्तनों की विस्तृत सूची यहाँ पाई जा सकती है: https://github.com/rustls/rustls/releases.
दस्तावेज़ीकरण
दृष्टिकोण
Rustls एक TLS लाइब्रेरी है जिसका लक्ष्य क्रिप्टोग्राफिक सुरक्षा का एक अच्छा स्तर प्रदान करना है, उस सुरक्षा को प्राप्त करने के लिए किसी कॉन्फ़िगरेशन की आवश्यकता नहीं है, और डिफ़ॉल्ट रूप से कोई असुरक्षित सुविधाएँ या अप्रचलित क्रिप्टोग्राफी प्रदान नहीं करती है।
Rustls क्लाइंट और सर्वर दोनों के लिए TLS1.2 और TLS1.3 को लागू करता है। प्रोटोकॉल सुविधाओं की पूरी सूची देखें।
प्लेटफ़ॉर्म समर्थन
जबकि Rustls स्वयं प्लेटफ़ॉर्म-स्वतंत्र है, इसे TLS में उपयोग किए जाने वाले क्रिप्टोग्राफी एल्गोरिदम को लागू करने के लिए क्रिप्टोग्राफी प्रिमिटिव के उपयोग की आवश्यकता होती है। Rustls में, एक crypto::CryptoProvider क्रिप्टो प्रिमिटिव कार्यान्वयनों के संग्रह को दर्शाता है।
crypto::CryptoProvider स्ट्रक्ट का एक कस्टम इंस्टेंस प्रदान करके, आप rustls की सभी क्रिप्टोग्राफी निर्भरताओं को बदल सकते हैं। यह व्यापक आर्किटेक्चर और वातावरण, या अनुपालन आवश्यकताओं के लिए पोर्टेबल होने का एक मार्ग है। अधिक जानकारी के लिए crypto::CryptoProvider दस्तावेज़ीकरण देखें।
क्रिप्टोग्राफी प्रदाता
Rustls 0.22 से, Rustls द्वारा उपयोग किए जाने वाले क्रिप्टोग्राफिक प्रिमिटिव के प्रदाता को चुनना संभव हो गया है। यह आकर्षक हो सकता है यदि आपके पास विशिष्ट प्लेटफ़ॉर्म, अनुपालन या सुविधा आवश्यकताएँ हैं।
0.24 से, उपयोगकर्ताओं को ClientConfig या ServerConfig इंस्टेंस का निर्माण करते समय स्पष्ट रूप से एक क्रिप्टो प्रदाता प्रदान करना होगा। अधिक जानकारी के लिए crypto::CryptoProvider दस्तावेज़ीकरण देखें।
प्रथम-पक्ष प्रदाता
Rustls परियोजना वर्तमान में दो क्रिप्टोग्राफी प्रदाताओं को बनाए रखती है:
rustls-aws-lc-rs- एक प्रदाता जो क्रिप्टोग्राफी के लिएaws-lc-rsक्रेट का उपयोग करता है। जबकि यह प्रदाता कुछ प्लेटफ़ॉर्मों पर बनाना कठिन हो सकता है, यह उत्कृष्ट प्रदर्शन और एक पूर्ण सुविधा सेट (पोस्ट-क्वांटम एल्गोरिदम सहित) प्रदान करता है।rustls-ring- एक प्रदाता जो क्रिप्टोग्राफी के लिएringक्रेट का उपयोग करता है। यह प्रदाता विभिन्न प्लेटफ़ॉर्मों पर बनाना आसान है, लेकिन इसका सुविधा सेट अधिक सीमित है (उदाहरण के लिए, यह पोस्ट-क्वांटम एल्गोरिदम का समर्थन नहीं करता है)।
Rustls टीम अपने पूर्ण सुविधा सेट और प्रदर्शन के लिए rustls-aws-lc-rs क्रेट का उपयोग करने की सिफारिश करती है। aws-lc-rs में प्लेटफ़ॉर्म/आर्किटेक्चर समर्थन बाधाओं के अधिक विवरण के लिए aws-lc-rs FAQ देखें।
प्रदाताओं के चयन के तरीके के बारे में विवरण के लिए crypto::CryptoProvider का दस्तावेज़ देखें।
(rustls के 0.24 से पहले के संस्करणों में, ये दोनों प्रदाता rustls crate के भाग के रूप में शिप किए गए थे, और पसंदीदा प्रदाता का चयन करने के लिए Cargo features का उपयोग किया जाता था। aws-lc-rs feature डिफ़ॉल्ट रूप से सक्षम था।)
तृतीय-पक्ष प्रदाता
समुदाय ने Rustls के लिए कई तृतीय-पक्ष प्रदाता भी विकसित किए हैं। विशेष रूप से उल्लेखनीय कुछ में शामिल हैं:
rustls-graviola- एक प्रदाता जो क्रिप्टोग्राफी के लिएgraviolaका उपयोग करता है।rustls-symcrypt- एक प्रदाता जो Microsoft की SymCrypt लाइब्रेरी का उपयोग करता है।
अधिक तृतीय-पक्ष प्रदाताओं के लिए, PROVIDERS.md देखें।
इस विषय पर अधिक जानकारी के लिए दस्तावेज़ का Making a custom CryptoProvider अनुभाग देखें।
उदाहरण कोड
हमारी examples निर्देशिका में ऐसे डेमो हैं जो दिखाते हैं कि stream::Stream हेल्पर का उपयोग करके I/O को कैसे संभालना है, साथ ही mio का उपयोग करके अधिक जटिल असिंक्रोनस I/O को कैसे संभालना है।
यदि आप पहले से ही async runtime के लिए Tokio का उपयोग कर रहे हैं, तो आप rustls के साथ सीधे इंटरैक्ट करने के बजाय tokio-rustls का उपयोग करना पसंद कर सकते हैं।
mio आधारित उदाहरण सबसे पूर्ण हैं, और नीचे उन पर चर्चा की गई है। Rustls में नए उपयोगकर्ता अधिक जटिल MIO उदाहरणों में उतरने से पहले सरल client/server उदाहरणों को देखना पसंद कर सकते हैं।
क्लाइंट उदाहरण प्रोग्राम
MIO क्लाइंट उदाहरण प्रोग्राम का नाम tls-client-mio है।
कुछ नमूना रन:
$ cargo run --bin tls-client-mio -- --http jbp.io
HTTP/1.1 200 OK
Date: Tue, 23 Jun 2026 16:13:40 GMT
Content-Type: text/html; charset=utf-8
Connection: close
(...)
अधिक विकल्पों के लिए cargo run --bin tls-client-mio -- --help चलाएँ।
सर्वर उदाहरण प्रोग्राम
MIO सर्वर उदाहरण प्रोग्राम का नाम tls-server-mio है।
यहाँ एक नमूना रन दिया गया है; हम एक TLS echo सर्वर शुरू करते हैं, फिर
openssl और tls-client-mio के साथ उससे कनेक्ट करते हैं:
$ cargo run --bin tls-server-mio -- --certs test-ca/rsa-2048/end.fullchain --key test-ca/rsa-2048/end.key -p 8443 echo &
$ echo hello world | openssl s_client -ign_eof -quiet -connect localhost:8443
depth=2 CN = ponytown RSA CA
verify error:num=19:self signed certificate in certificate chain
hello world
^C
$ echo hello world | cargo run --bin tls-client-mio -- --cafile test-ca/rsa-2048/ca.cert --port 8443 localhost
hello world
^C
अधिक विकल्पों के लिए cargo run --bin tls-server-mio -- --help चलाएँ।
लाइसेंस
Rustls निम्नलिखित तीन लाइसेंसों के अंतर्गत वितरित किया जाता है:
- Apache License संस्करण 2.0।
- MIT लाइसेंस।
- ISC लाइसेंस।