تعذّر إنشاء قناة آمنة SSL/TLS

المشكلة

عند تشغيل نص PowerShell يستخدم Invoke-WebRequest، قد يظهر الخطأ التالي:

Invoke-WebRequest : The request was aborted: Could not create SSL/TLS secure channel.

يحدث هذا لأن النص يحاول الاتصال بخادم باستخدام بروتوكولات آمنة (TLS/SSL)، لكن البروتوكولات المطلوبة (مثل TLS 1.2) غير مفعّلة على النظام.

الحلول

مؤقت
دائم

لإصلاح هذه المشكلة بسرعة في الجلسة الحالية، يمكنك تفعيل البروتوكولات الضرورية بتشغيل الأمر التالي في جلسة PowerShell:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls11 -bor ` [Net.SecurityProtocolType]::Tls12 -bor ` [Net.SecurityProtocolType]::Tls -bor ` [Net.SecurityProtocolType]::Ssl3

ومع ذلك، هذا الإصلاح مؤقت ويحتاج إلى إعادة تطبيقه في كل جلسة PowerShell جديدة.

لحل هذه المشكلة بشكل دائم وضمان استخدام جميع التطبيقات المعتمدة على .NET، بما في ذلك PowerShell، للبروتوكولات الآمنة افتراضيًا، قم بتحديث سجل النظام.

خطوات الإصلاح:

افتح جلسة PowerShell مرتفعة الصلاحيات (Run as Administrator).
شغّل الأوامر التالية لتحديث السجل:

Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\.NETFramework\v4.0.30319" -Name "SchUseStrongCrypto" -Value 1 -Type DWord 
Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\.NETFramework\v4.0.30319" -Name "SystemDefaultTlsVersions" -Value 1 -Type DWord

طبّق التغييرات أيضًا على مفتاح سجل .NET Framework 64 بت:

Set-ItemProperty -Path "HKLM:\SOFTWARE\WOW6432Node\Microsoft\.NETFramework\v4.0.30319" -Name "SchUseStrongCrypto" -Value 1 -Type DWord 
Set-ItemProperty -Path "HKLM:\SOFTWARE\WOW6432Node\Microsoft\.NETFramework\v4.0.30319" -Name "SystemDefaultTlsVersions" -Value 1 -Type DWord

أعد تشغيل النظام لضمان دخول التغييرات حيز التنفيذ.

شرح مفاتيح السجل

إعداد السجل	الوصف
SchUseStrongCrypto	يفرض على .NET Framework استخدام بروتوكولات تشفير قوية (مثل TLS 1.2).
SystemDefaultTlsVersions	يضمن استخدام تطبيقات .NET لإصدار TLS الافتراضي للنظام، مما يسمح لها بالتكيف مع البروتوكولات الأحدث.

إذا استمر الخطأ

إذا استمر الخطأ، فكر في الإجراءات التالية لضمان اتصالات آمنة لجميع تطبيقات .NET دون الحاجة إلى تدخل يدوي في كل جلسة:

تأكد من أن نظامك يدعم TLS 1.2 وأنه مفعّل في نظام التشغيل.
قم بالترقية إلى PowerShell Core أو PowerShell 7، اللذين يستخدمان البروتوكولات الأمنية الحديثة افتراضيًا.

تثبيت أدوات المراقبة

المراقبة

أدلة الكيفية

استكشاف الأخطاء وإصلاحها

تعذّر إنشاء قناة آمنة SSL/TLS

المشكلة

الحلول

خطوات الإصلاح:

شرح مفاتيح السجل

إذا استمر الخطأ

​المشكلة

​الحلول

​خطوات الإصلاح:

​شرح مفاتيح السجل

​إذا استمر الخطأ

المشكلة

الحلول

خطوات الإصلاح:

شرح مفاتيح السجل

إذا استمر الخطأ