وبلاگ نت‌آرامآموزش، تجربه و راهکارهای زیرساخت

رفع certificate verify failed در Python requests بدون خاموش کردن امنیت

تشخیص و حل خطای گواهی HTTPS در Python requests با بررسی نام، ساعت، زنجیره و گواهی CA معتبر.

انتشار:
توسط تیم فنی نت‌آرام
۵ دقیقه زمان مطالعه
۰ دیدگاه
محتوای تخصصی، ساده و کاربردی
هماهنگ با هویت حرفه‌ای نت‌آرام
بازگشت به لیست مقالات
تصویر شاخص مقاله رفع certificate verify failed در Python requests بدون خاموش کردن امنیت در وبلاگ نت‌آرام
محتوای آموزشی وبلاگ نت‌آرام
برنامه پایتون می‌خواهد به یک API با HTTPS وصل شود، اما پیام CERTIFICATE_VERIFY_FAILED یا SSLError می‌گیرد. معنی ساده‌اش این است که برنامه نتوانسته هویت مقصد را با گواهی ارائه‌شده تأیید کند. مشکل می‌تواند نام دامنه اشتباه، ساعت نادرست، گواهی منقضی، زنجیره ناقص یا فهرست قدیمی گواهی‌های مورد اعتماد باشد.
خاموش‌کردن بررسی با verify=False اتصال را در برابر جعل مقصد آسیب‌پذیر می‌کند و رفع مشکل نیست. ابتدا خود پیام و محیط اجرا را مشخص می‌کنیم؛ سپس بر اساس علت، گواهی سرور یا فهرست اعتماد کلاینت را درست می‌کنیم.

۱. متن کامل خطا و نشانی را بخوانید

به جزئیات انتهای خطا توجه کنید. certificate has expired معمولاً به تاریخ گواهی یا ساعت نامعتبر اشاره می‌کند؛ hostname mismatch یعنی نام مقصد با نام‌های گواهی نمی‌خواند؛ unable to get local issuer certificate می‌تواند ناشی از زنجیره ناقص یا CA نامعتبر نزد کلاینت باشد. این پیام‌ها سرنخ‌اند و گاهی یک مشکل چند علت دارد.
دامنه‌ای را که برنامه واقعاً درخواست می‌کند با دامنه اعلام‌شده توسط ارائه‌دهنده API مقایسه کنید. استفاده از IP به جای نام دامنه ممکن است بررسی نام گواهی را رد کند. آدرس، توکن، کوکی و خروجی دارای اطلاعات مشتری را در جایی عمومی منتشر نکنید.

۲. مفسر، requests و زمان را در محیط واقعی ببینید

در Terminal یا SSH وارد محیطی شوید که برنامه از آن استفاده می‌کند؛ در هاست پنل Python App ممکن است فرمان فعال‌سازی ویژه داشته باشد:
کد / دستورpython --version python -m pip show requests certifi python -c "import sys, requests; print(sys.executable); print(requests.__version__)" python -c "import certifi; print(certifi.where())" date -u
دستورها نسخه و مسیر مفسر، نسخه بسته‌ها، مسیر فایل گواهی certifi و زمان UTC را نشان می‌دهند. اگر certifi پیدا نشد، متن خطا را نگه دارید؛ نوع نصب یا بسته‌بندی سیستم ممکن است متفاوت باشد. مقایسه کنید که وب‌برنامه یا کار زمان‌بندی‌شده نیز از همین محیط و متغیرها استفاده می‌کند؛ اجرای موفق در ترمینال به‌تنهایی کافی نیست.
اگر ساعت اشتباه است، در سرور مستقل وضعیت همگام‌سازی را با timedatectl status ببینید و طبق راهنمای سیستم‌عامل، سرویس زمان را درست کنید. در هاست اشتراکی تغییر ساعت سیستم معمولاً در اختیار شما نیست؛ اختلاف را به پشتیبانی بگویید.

۳. نام و زنجیره گواهی سرور را جداگانه آزمایش کنید

اگر openssl در دسترس است، دامنه و پورت API خود را به جای نمونه بگذارید:
کد / دستورopenssl s_client -connect api.example.com:443 -servername api.example.com -verify_hostname api.example.com -verify_return_error </dev/null
-servername نام را برای انتخاب گواهی به سرور می‌فرستد و -verify_hostname نام را بررسی می‌کند. نسخه‌های قدیمی OpenSSL ممکن است گزینه‌ها را پشتیبانی نکنند. خروجی، جزئیات ارتباط و نتیجه بررسی را نشان می‌دهد؛ هیچ کلید خصوصی نباید در خروجی عادی لازم باشد. موفقیت این آزمایش تضمین موفقیت requests نیست، چون OpenSSL ترمینال ممکن است از فهرست CA دیگری استفاده کند.
اگر مالک API هستید، در پنل گواهی بررسی کنید گواهیِ نام درست و زنجیره میانی کامل روی سرویس فعال باشد. اصلاح را در همان محل خاتمه TLS انجام دهید؛ گاهی آن محل CDN یا پراکسی است نه برنامه اصلی. پس از تمدید یا اصلاح، دوباره همان نام عمومی را از محیط هاست آزمایش کنید. اگر API متعلق به شرکت دیگری است، زمان و پیام خطا را بدون رمز برای همان ارائه‌دهنده ارسال کنید.

۴. CA معتبر را در سمت برنامه اصلاح کنید

برای یک گواهی عمومی معتبر، به‌روزرسانی کنترل‌شده بسته‌های مورد اعتماد پروژه و فهرست CA ممکن است لازم باشد؛ ابتدا نسخه‌های مجاز را در محیط آزمایشی و با فایل نیازمندی تأییدشده پروژه نصب و آزمون کنید. نصب تصادفی آخرین نسخه همه بسته‌ها می‌تواند برنامه را بشکند.
برای API داخلی که از CA خصوصی سازمان استفاده می‌کند، فایل CA را از مسیر مطمئن و با تأیید مدیر آن سازمان بگیرید. سپس در یک نمونه آزمایشی مسیر فایل مورد اعتماد را مشخص کنید:
کد / دستورimport requests response = requests.get( "https://api.example.com/health", verify="/home/example/private-ca-bundle.pem", timeout=(5, 15), ) response.raise_for_status() print(response.status_code)
آدرس و مسیر، نمونه‌اند. فایل باید حاوی CA مورد اعتماد مناسب باشد، نه کلید خصوصی. با تعیین verify، همان فایل به عنوان فهرست اعتماد این درخواست استفاده می‌شود؛ اگر مقصدهای دیگری هم لازم دارید، بسته CA مناسب آن‌ها را طبق سیاست سازمان تهیه کنید. requests همچنین متغیر REQUESTS_CA_BUNDLE را می‌شناسد، اما تنظیم آن برای کل برنامه بر تمام درخواست‌های مربوط اثر می‌گذارد.
اگر شبکه از پراکسی بازرسی TLS استفاده می‌کند، هویت و CA آن باید با سیاست امنیتی سازمان تأیید شود؛ پذیرش گواهی ناشناس صرفاً برای حذف خطا خطرناک است. در سناریوهای PreparedRequest، تنظیمات محیطی باید طبق راهنمای requests به نشست ادغام شوند؛ فرض نکنید متغیر محیطی همیشه خودکار اعمال شده است.

۵. اتصال واقعی را دوباره امتحان کنید

نمونه بالا را با همان Python و تنظیمات برنامه آزمایشی اجرا کنید. وضعیت 200 یا پاسخ موفق مورد انتظار API، همراه با نبود SSLError نشانه رفع خطای گواهی است؛ سپس مسیر اصلی برنامه را نیز امتحان کنید. اگر خطا تبدیل به timeout یا ۴۰۱ شد، آن‌ها مسئله جداگانه اتصال یا احراز هویت‌اند.
برای تنظیم زمان انتظار، راهنمای connect و read timeout در requests را بخوانید. اطلاعات سرویس در هاست پایتون نت‌آرام و تنظیم verify در مستندات رسمی requests آمده است.
اشتراک‌گذاری:
لینکدینتلگرامایکس

دیدگاه‌ها (۰)

دیدگاه‌های تاییدشده و پاسخ‌های تیم نت‌آرام