
rustls v/0.23.44
مكتبة TLS آمنة للذاكرة مكتوبة بلغة Rust، تنفّذ بروتوكولَي TLS 1.2 و TLS 1.3 مع مزوّدي تشفير قابلين للتبديل، وأوضاع العميل/الخادم، ومصادقة قائمة على الشهادات.
Rustls هي مكتبة TLS حديثة مكتوبة بلغة Rust.
الحالة
تُستخدم Rustls في بيئات الإنتاج لدى العديد من المؤسسات والمشاريع. نهدف إلى الحفاظ على استقرار معقول لواجهة برمجة التطبيقات (API)، لكن قد تتطور الواجهة مع إجرائنا تغييرات لاستيعاب ميزات جديدة أو تحسينات في الأداء.
لدينا خارطة طريق لخططنا المستقبلية. ولدينا أيضًا اختبارات أداء (benchmarks) لمنع تراجع الأداء ولتمكينك من تقييم 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.
راجع توثيق crypto::CryptoProvider للحصول على تفاصيل حول كيفية اختيار المزوّدين.
(بالنسبة لإصدارات rustls السابقة لـ 0.24، كان كلا هذين المزوّدين يُشحَنان كجزء من حزمة rustls، وكانت ميزات Cargo تُستخدم لاختيار المزوّد المفضّل. كانت ميزة aws-lc-rs مُفعّلة افتراضيًا.)
مزوّدون من طرف ثالث
طوّرت المجتمعات أيضًا العديد من المزوّدين من طرف ثالث لـ Rustls. ومن الجدير بالذكر بشكل خاص:
rustls-graviola- مزوّد يستخدمgraviolaللتشفير.rustls-symcrypt- مزوّد يستخدم مكتبة SymCrypt من Microsoft.
لمزيد من المزوّدين من طرف ثالث، راجع PROVIDERS.md.
راجع قسم Making a custom CryptoProvider من التوثيق للحصول على مزيد من المعلومات حول هذا الموضوع.
مثال على الكود
يحتوي دليل examples الخاص بنا على عروض توضيحية تُظهر كيفية التعامل مع الإدخال/الإخراج باستخدام مساعد stream::Stream، بالإضافة إلى إدخال/إخراج غير متزامن أكثر تعقيدًا باستخدام mio.
إذا كنت تستخدم Tokio بالفعل كبيئة تشغيل غير متزامنة، فقد تفضّل استخدام tokio-rustls بدلاً من التعامل مع rustls مباشرةً.
تُعد الأمثلة القائمة على mio الأكثر اكتمالاً، وهي مُناقشة أدناه. قد يفضّل المستخدمون الجدد على Rustls إلقاء نظرة على أمثلة العميل/الخادم البسيطة قبل الخوض في أمثلة MIO الأكثر تعقيدًا.
برنامج مثال العميل
يُسمّى برنامج مثال عميل 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، ثم نتصل به باستخدام
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 الإصدار 2.0.
- ترخيص MIT.
- ترخيص ISC.
وهي مُضمَّنة باسم LICENSE-APACHE وLICENSE-MIT وLICENSE-ISC على الترتيب. يجوز لك استخدام هذا البرنامج بموجب شروط أيٍّ من هذه التراخيص، حسب اختيارك.
عضوية المشروع
- Joe Birr-Pixton (@ctz، مؤسس المشروع - متفرغ بتمويل من Prossimo)
- Dirkjan Ochtman (@djc، مشرف مشارك)
- Daniel McCarney (@cpu، مشرف مشارك)
- Josh Aas (@bdaehlie، إدارة المشروع)
مدونة قواعد السلوك
يعتمد هذا المشروع مدونة قواعد سلوك Rust. يُرجى مراسلة [email protected] للإبلاغ عن أي حالة سوء سلوك، أو إذا كانت لديك أي تعليقات أو أسئلة حول مدونة قواعد السلوك.