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

اتصال امن پایتون به PostgreSQL؛ رفع خطای نام گواهی و CA

آموزش تشخیص خطای TLS PostgreSQL در پایتون، بررسی نام میزبان و تنظیم گواهی CA معتبر.

انتشار:
توسط تیم فنی نت‌آرام
۵ دقیقه زمان مطالعه
۰ دیدگاه
محتوای تخصصی، ساده و کاربردی
هماهنگ با هویت حرفه‌ای نت‌آرام
بازگشت به لیست مقالات
تصویر شاخص مقاله اتصال امن پایتون به PostgreSQL؛ رفع خطای نام گواهی و CA در وبلاگ نت‌آرام
محتوای آموزشی وبلاگ نت‌آرام
برنامه پایتون هنگام اتصال به PostgreSQL خطای گواهی می‌دهد، یا اتصال برقرار می‌شود اما نمی‌دانید آیا هویت سرور هم بررسی شده است. رمزگذاری مسیر مهم است، ولی به‌تنهایی کافی نیست: برنامه باید مطمئن شود به همان سرور موردنظر وصل شده، نه به مقصدی که خودش را جای آن معرفی کرده است.
در اتصال مبتنی بر libpq، گزینه sslmode=verify-full علاوه بر بررسی زنجیره گواهی، نام میزبان را نیز با گواهی تطبیق می‌دهد. ابتدا نوع خطا را جدا می‌کنیم و سپس اتصال آزمایشی را با نام و CA معتبر می‌سازیم. این راهنما برای اتصال TCP است؛ رفتار اتصال با Unix socket متفاوت است.

۱. پیام خطا و محل اجرا را پیدا کنید

گزارش برنامه را در زمان اتصال بخوانید. connection timed out معمولاً یعنی ارتباط در زمان مقرر کامل نشده؛ باید نام، پورت، مسیر شبکه و مجوز اتصال بررسی شوند. password authentication failed به احراز هویت مربوط است. خطای certificate verify failed یا نام نامنطبق به مرحله TLS اشاره می‌کند. گاهی چند مشکل هم‌زمان وجود دارد، پس متن کامل و ترتیب خطاها مهم است.
در هاست پایتون، وارد محیطی شوید که برنامه واقعاً از آن استفاده می‌کند:
کد / دستورpython --version python -c "import sys; print(sys.executable)" python -m pip show psycopg psycopg2
بسته نصب‌شده و مفسر را با تنظیم پنل مقایسه کنید. یکی از دو نام بسته ممکن است نصب نباشد و این به‌تنهایی خطا نیست. نام پایگاه داده، نام کاربر و میزبان را از ارائه‌دهنده معتبر بگیرید. رمز و رشته اتصال کامل را در گزارش عمومی یا تیکت بدون پوشاندن اطلاعات محرمانه نفرستید.

۲. نام درست و گواهی مورد اعتماد را انتخاب کنید

در verify-full نامی که در host می‌گذارید باید با نام مجاز گواهی سرور تطبیق داشته باشد. اگر ارائه‌دهنده نامی مثل db.example.com داده است، اتصال با IP یا نام داخلی متفاوت ممکن است این بررسی را رد کند. راه درست، استفاده از نام معتبر یا اصلاح گواهی توسط مدیر سرور است؛ تغییر sslmode به disable برای حذف خطا اتصال را ناامن می‌کند.
فایل CA یا زنجیره مورد نیاز را از مسیر مطمئن ارائه‌دهنده دریافت کنید و در جایی خارج از پوشه عمومی سایت بگذارید. CA عمومی حاوی کلید خصوصی شما نیست؛ اگر ارائه‌دهنده برای احراز هویت مشتری گواهی و کلید خصوصی جداگانه داده، آن کلید را محرمانه و با مجوز محدود نگه دارید. فایل ناشناسی را صرفاً برای رفع خطا به فهرست اعتماد اضافه نکنید.

۳. یک اتصال آزمایشی با psycopg بسازید

نمونه زیر برای psycopg نسخه ۳ است. مقادیر نمونه را با اطلاعات تأییدشده عوض کنید. آن را در ترمینال خصوصی محیط آزمایشی اجرا کنید؛ رمز با ورودی مخفی دریافت می‌شود و در فایل کد نوشته نمی‌شود:
کد / دستورimport getpass import psycopg password = getpass.getpass("Database password: ") with psycopg.connect( host="db.example.com", port=5432, dbname="example_db", user="example_user", password=password, sslmode="verify-full", sslrootcert="/home/example/private/db-ca.pem", connect_timeout=10, ) as conn: with conn.cursor() as cur: cur.execute("SELECT current_database(), current_user") print(cur.fetchone()) cur.execute("SELECT ssl FROM pg_stat_ssl WHERE pid = pg_backend_pid()") print("TLS:", cur.fetchone())
نام دامنه، پایگاه داده، کاربر و مسیر CA نمونه‌اند. خروجی خط اول باید نام پایگاه و کاربر موردنظر را نشان دهد؛ مقدار True در ردیف TLS نشانه رمزگذاری همان اتصال است. بررسی هویت از تنظیم verify-full و موفقیت اتصال با CA درست به دست می‌آید، نه صرفاً از دیدن True. دسترسی به نمای آماری به نسخه و مجوزهای سرویس وابسته است؛ اگر query دوم مجاز نبود، آن را از مدیر پایگاه داده بپرسید.

۴. اگر اتصال هنوز برقرار نشد

اگر خطا می‌گوید فایل CA پیدا نشد، مسیر را از دید کاربر اجرای برنامه بررسی کنید. در ترمینال:
کد / دستورls -l /home/example/private/db-ca.pem
مسیر نمونه را عوض کنید؛ دیدن فایل با کاربر ترمینال لزوماً دسترسی سرویس وب را ثابت نمی‌کند. اگر نام گواهی اشتباه است، نام میزبان تأییدشده را از ارائه‌دهنده بگیرید. اگر زنجیره قابل تأیید نیست، تاریخ سیستم، CA و زنجیره ارائه‌شده توسط سرور را بررسی کنید؛ نسخه جدید CA را فقط از منبع معتبر دریافت کنید.
اگر خطا به جای گواهی، عدم دسترسی شبکه یا پورت است، آیا سرور پایگاه داده اجازه اتصال از هاست برنامه را دارد؟ مدیر پایگاه داده باید محدودیت IP و تنظیمات دسترسی را بررسی کند. بازکردن PostgreSQL برای تمام اینترنت یا غیرفعال‌کردن دیوار آتش راه‌حل امنی نیست. بعضی سرویس‌ها پایگاه داده را فقط داخل شبکه خصوصی ارائه می‌کنند.

۵. تنظیم را به برنامه اصلی ببرید و دوباره آزمایش کنید

در نسخه آزمایشی جنگو یا برنامه خود، همین نام، sslmode و مسیر CA را با قالب تنظیمات همان کتابخانه وارد کنید. رمز را در محل امن پشتیبانی‌شده سرویس نگه دارید، نه در مخزن عمومی. سپس یک خواندن بی‌خطر از پایگاه داده و مسیر واقعی برنامه را امتحان کنید. نسخه و تنظیم قبلی را برای بازگشت نگه دارید.
برای خطای متفاوت گواهی در درخواست HTTP، راهنمای requests و certificate verify failed را بخوانید. اطلاعات هاست پایتون نت‌آرام و تفاوت حالت‌های TLS در مستندات PostgreSQL آمده است.
اشتراک‌گذاری:
لینکدینتلگرامایکس
مقاله قبلی
مقاله قبلی وجود ندارد.

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

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