SSD Nodes Learn Hosting plans →
راهنماها Matt Connorتوسط Matt Connor · به‌روزرسانی شده 2026-11-15

آموزش افزودن CA اختصاصی به Trust Store در اوبونتو

با کپی کردن گواهی ریشه در مسیر /usr/local/share/ca-certificates و اجرای دستور update-ca-certificates، خطاهای SSL در سرویس‌های داخلی اوبونتو 24.04 را به سادگی برطرف کنید.

Verified Every command ran end-to-end on a fresh Ubuntu 24.04 server, August 15, 2026.

افزودن CA اختصاصی به trust store در اوبونتو

برای افزودن CA اختصاصی خود به trust store در اوبونتو، گواهی ریشه (root certificate) را در /usr/local/share/ca-certificates/ با نامی که به .crt ختم می‌شود کپی کنید و سپس دستور sudo update-ca-certificates را اجرا نمایید. یک CA (مرجع صدور گواهی) یک جفت کلید است که گواهی آن اجازه دارد سایر گواهی‌ها را امضا کند. هنگامی که سیستم به ریشه شما اعتماد کند، تمام گواهی‌هایی که توسط آن ریشه امضا شده‌اند پذیرفته می‌شوند؛ در نتیجه، خطاهای تأیید اعتبار در ارتباطات HTTPS بین سرویس‌های داخلی شما برطرف خواهد شد.

این راهنما کل زنجیره را به‌صورت آفلاین با openssl ایجاد می‌کند. شما یک کلید ریشه و یک گواهی ریشه می‌سازید، یک گواهی leaf برای یک سرور صادر می‌کنید، سپس ریشه را نصب کرده و مشاهده می‌کنید که خروجی دستور تأیید اعتبار تغییر می‌کند. این ترتیب اهمیت دارد: تأیید اعتبار قبل و بعد از نصب، روشی است که متوجه شوید نصب گواهی عامل تغییر نتیجه بوده است.

اوبونتو 24.04 به‌صورت پیش‌فرض با OpenSSL 3 و بسته ca-certificates عرضه می‌شود، بنابراین نیازی به نصب هیچ موردی در ابتدا نیست (بررسی‌شده در اوت 2026).

چه زمانی باید CA اختصاصی خود را راه‌اندازی کنید؟

یک CA عمومی مانند Let's Encrypt به نامی در DNS عمومی و سروری که در دسترس باشد نیاز دارد. نام‌های داخلی واجد شرایط نیستند. یک پایگاه داده در شبکه خصوصی یا پنل مدیریتی که به یک تونل محدود شده است، نمی‌تواند گواهی عمومی دریافت کند و هیچ‌کدام از آن‌ها نباید صرفاً برای دریافت گواهی، در معرض اینترنت قرار بگیرند.

یک گواهی خودامضا در Ubuntu تنها مشکل یک میزبان را حل می‌کند. هر کلاینت باید به آن یک گواهی اعتماد کند و برای میزبان بعدی، همین فرآیند دوباره تکرار می‌شود. یک CA خصوصی، تصمیم‌گیری را یک سطح بالاتر می‌برد. کلاینت‌ها یک‌بار به ریشه (root) اعتماد می‌کنند و پس از آن، هر گواهی که توسط آن ریشه امضا شود مورد اعتماد خواهد بود؛ این شامل گواهی‌های مربوط به میزبان‌هایی که هنوز وجود ندارند نیز می‌شود.

هزینه این کار واقعی است. کلید ریشه می‌تواند هر چیزی را که محدودیت‌ها اجازه می‌دهند امضا کند، بنابراین هر کسی که ca.key را بخواند می‌تواند گواهی‌هایی صادر کند که ماشین‌های شما آن‌ها را می‌پذیرند. از آن همان‌طور محافظت کنید که از یک کلید خصوصی در مدیریت کلیدهای SSH محافظت می‌کنید. اگر سرویسی دارای نام DNS عمومی است، از تمام این مراحل صرف‌نظر کرده و از یک CA عمومی استفاده کنید: Certbot با nginx و Let's Encrypt کار کمتری می‌برد و نیازی به نصب هیچ‌چیزی در سمت کلاینت ندارد.

ایجاد کلید CA و گواهی ریشه

در دایرکتوری کار کنید که فقط کاربر شما امکان دسترسی به آن را دارد. کلید ریشه هرگز نباید از این دایرکتوری خارج شود.

install -d -m 700 ~/ca
cd ~/ca
openssl genrsa -aes256 -out ca.key 4096
chmod 600 ca.key

-aes256 کلید را با یک عبارت عبور (passphrase) که انتخاب می‌کنید رمزنگاری می‌کند و هر دستور بعدی که با این کلید امضا انجام می‌دهد، به آن نیاز خواهد داشت. OpenSSL در ترمینال از شما درخواست این عبارت را می‌کند، مگر اینکه آن را از طریق -passin تأمین کنید که یک فایل یا متغیر محیطی را می‌پذیرد؛ بنابراین هر جایی که آن را برای اتوماسیون قرار می‌دهید، اکنون از کلید نیز محافظت می‌کند. اگر -aes256 را حذف کنید، کلید به صورت متن ساده (clear) روی دیسک ذخیره می‌شود، بنابراین یک نسخه پشتیبان یا یک حساب کاربری مدیریتی دوم کافی است تا امکان صدور گواهی‌هایی که ماشین‌های شما به آن اعتماد دارند، در اختیار دیگران قرار گیرد.

اکنون گواهی ریشه را ایجاد کنید که کلید CA آن را برای خودش امضا می‌کند.

openssl req -x509 -new -key ca.key -sha256 -days 3650 \
  -subj "/O=Example Internal/CN=Example Internal Root CA" \
  -addext "basicConstraints=critical,CA:TRUE,pathlen:0" \
  -addext "keyUsage=critical,keyCertSign,cRLSign" \
  -addext "subjectKeyIdentifier=hash" \
  -addext "nameConstraints=critical,permitted;DNS:internal.example" \
  -out ca.crt

عبارت internal.example را با پسوند نامی که واقعاً استفاده می‌کنید جایگزین کنید و پیش از نگه داشتن آن پسوند نهایی، بخش بعدی را مطالعه کنید.

هر extension یک وظیفه مشخص دارد.

  • basicConstraints به همراه CA:TRUE همان چیزی است که این گواهی را به یک گواهی CA تبدیل می‌کند. بدون آن، کلاینت هر گواهی‌ای که این کلید امضا کرده باشد را رد می‌کند، حتی اگر خود امضا معتبر باشد.
  • pathlen:0 بیان می‌کند که CA می‌تواند گواهی‌های نهایی (leaf certificates) را امضا کند و هیچ CA دیگری نباید زیرمجموعه آن باشد.
  • keyUsage کلید را محدود به امضای گواهی‌ها و لیست‌های ابطال (revocation lists) می‌کند تا از استفاده اشتباه آن به عنوان کلید سرور TLS جلوگیری شود.
  • subjectKeyIdentifier به ریشه یک شناسه می‌دهد که گواهی‌های نهایی به آن ارجاع می‌دهند؛ این همان روشی است که کلاینت از طریق آن، صادرکننده صحیح را در میان صدها گواهی موجود در یک store پیدا می‌کند.
  • nameConstraints نام‌هایی که این CA اجازه دارد برای آن‌ها ضمانت کند را محدود می‌سازد.

به جای فرض کردن اینکه دستور دقیقاً همان کاری را انجام داده که مد نظر شما بوده، خروجی را بازبینی کنید.

openssl x509 -noout -subject -issuer -serial -dates -in ca.crt
openssl x509 -noout -text -in ca.crt

Subject و issuer یک رشته یکسان را چاپ می‌کنند، زیرا یک گواهی ریشه خودش را امضا می‌کند. شماره سریال و دو تاریخ از فایلی که همین الان ایجاد کردید می‌آیند، بنابراین آن‌ها را از همان خروجی بردارید و نه از راهنمای هیچ‌کس دیگری.

محدود کردن دامنه‌های مجاز برای امضای CA

یک ریشه (root) در مخزن سیستم، برای تمام نام‌های موجود در اینترنت قابل اعتماد است، مگر آنکه خلاف آن را تعیین کنید. این حجم عظیمی از اختیارات است که در یک فایل روی یک سرور نگهداری می‌شود. nameConstraints این اختیارات را کاهش می‌دهد. با وجود permitted;DNS:internal.example در ریشه، زنجیره‌ای از این CA برای نامی خارج از internal.example رد می‌شود، حتی اگر امضا معتبر باشد.

به جای اعتماد کردن، آن را تست کنید.

openssl req -new -newkey rsa:2048 -nodes -keyout /tmp/outside.key -out /tmp/outside.csr \
  -subj "/CN=www.example.com"
openssl x509 -req -in /tmp/outside.csr -CA ca.crt -CAkey ca.key -CAcreateserial \
  -days 30 -sha256 \
  -extfile <(printf 'subjectAltName=DNS:www.example.com\n') -out /tmp/outside.crt
openssl verify -CAfile ca.crt /tmp/outside.crt
echo $?

گواهی صادر می‌شود، زیرا CA شما هر چه از آن بخواهید را امضا می‌کند. مرحله تایید (Verification) جایی است که فرآیند متوقف می‌شود: وضعیت خروجی غیر صفر است و OpenSSL محدودیتی که با آن برخورد کرده را نام می‌برد. این ارزش این افزونه (extension) است. یک کلید CA سرقت‌شده همچنان نمی‌تواند یک گواهی معتبر برای نامی خارج از زیردرخت (subtree) تولید کند. پس از اتمام کار، فایل‌های باقی‌مانده را با rm /tmp/outside.* حذف کنید.

چهار نکته که باید پیش از اعمال محدودیت بدانید. این مورد با critical علامت‌گذاری شده است، بنابراین کلاینتی که این افزونه را درک نمی‌کند باید زنجیره را رد کند و نه اینکه آن را نادیده بگیرد؛ این رویکرد امن است اما ممکن است کتابخانه‌های قدیمی TLS را غافلگیر کند. یک زیردرخت مجاز برای نام‌های DNS، محدودیت‌های SAN برای آدرس‌های IP را اعمال نمی‌کند، زیرا نوع نامی که زیردرخت برای آن لیست نشده باشد بدون محدودیت باقی می‌ماند؛ بنابراین اگر گواهی‌های شما شامل آدرس‌های IP هستند، permitted;IP:10.0.0.0/255.255.0.0 را نیز در همان افزونه اضافه کنید. زیردرخت باید تمام نام‌هایی که در آینده صادر خواهید کرد را پوشش دهد، از جمله نام‌های میزبان کوتاه؛ بنابراین گواهی برای نام ساده app در برابر مثال بالا با شکست مواجه می‌شود. همچنین این محدودیت در ریشه نهادینه شده است، بنابراین تغییر نظر شما به معنای نیاز به یک گواهی ریشه جدید و نصب مجدد روی تمام کلاینت‌ها خواهد بود.

صدور گواهی leaf امضا شده توسط CA شما

گواهی leaf همان گواهی است که سرور به کلاینت‌ها ارائه می‌دهد. کار را با کلید اختصاصی آن و یک CSR (درخواست امضای گواهی) شروع کنید؛ این درخواست شامل کلید عمومی و نام درخواستی است و توسط کلید leaf امضا می‌شود تا ثابت کند درخواست‌کننده، نیمهٔ خصوصی کلید را در اختیار دارد.

openssl req -new -newkey rsa:2048 -nodes \
  -keyout app.key -out app.csr \
  -subj "/CN=app.internal.example"
chmod 600 app.key

نام‌هایی که اهمیت دارند باید در یک فایل extension قرار بگیرند، نه در CSR. کلاینت‌ها نام میزبان را با subjectAltName (SAN) تطبیق می‌دهند. مرورگرها و Go به‌طور کامل از Common Name صرف‌نظر می‌کنند و کلاینت‌هایی که هنوز به آن متکی هستند (مانند curl)، تنها زمانی این کار را انجام می‌دهند که گواهی فاقد هرگونه DNS یا IP SAN باشد. بنابراین، گواهی دارای CN و بدون SAN در برخی ابزارها کار می‌کند و در برخی دیگر با شکست مواجه می‌شود؛ پس تمام نام‌ها را در SAN لیست کنید و CN را صرفاً به عنوان یک برچسب در نظر بگیرید.

basicConstraints = CA:FALSE
keyUsage = critical, digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = DNS:app.internal.example, DNS:api.internal.example
subjectKeyIdentifier = hash
authorityKeyIdentifier = keyid:always

آن را با نام app.ext ذخیره کنید و سپس درخواست را با CA امضا کنید.

openssl x509 -req -in app.csr -CA ca.crt -CAkey ca.key -CAcreateserial \
  -days 397 -sha256 -extfile app.ext -out app.crt

-CAcreateserial فایل ca.srl را در کنار CA می‌نویسد که حاوی شماره سریال بعدی است تا هیچ دو گواهی از این CA شماره یکسانی نداشته باشند. این فایل را در دایرکتوری CA نگه دارید. -days 397 یک انتخاب است، نه محدودیت ابزار. طول عمر کوتاه در اینجا اهمیت بیشتری نسبت به یک CA عمومی دارد، زیرا یک CA خصوصی زیرساخت ابطال (revocation) ندارد: هیچ CRL و پاسخ‌دهنده OCSP وجود ندارد مگر اینکه خودتان یکی بسازید؛ بنابراین اگر کلید leaf لو برود، تا زمان انقضای گواهی قابل استفاده باقی می‌ماند.

پیش از نزدیک شدن به trust store، نتیجه را بررسی کنید.

openssl x509 -noout -subject -issuer -serial -dates -in app.crt
openssl x509 -noout -ext subjectAltName -in app.crt

خط issuer اکنون نام CA را نشان می‌دهد، نه خودِ leaf. خط SAN نام‌هایی را لیست می‌کند که گواهی برای آن‌ها معتبر است و کلاینت فقط با آن لیست تطبیق انجام می‌دهد و نه هیچ چیز دیگر.

تأیید با استفاده از -CAfile صریح، پیش از نصب هر چیزی

openssl verify -CAfile ca.crt app.crt
echo $?

این دستور یک پرسش محدود را مطرح می‌کند: آیا app.crt به گواهی موجود در ca.crt زنجیره می‌شود؟ این دستور هیچ چیزی درباره آنچه این ماشین به آن اعتماد دارد نمی‌گوید، زیرا شما root را در خط فرمان به OpenSSL داده‌اید. شکست در اینجا به معنای وجود مشکل در خود گواهی‌ها است، بنابراین پیش از ادامه، آن را رفع کنید.

اکنون از ماشین پرسش کنید.

openssl verify app.crt
echo $?

بدون -CAfile، ابزار OpenSSL به دایرکتوری گواهی پیش‌فرض خود بازمی‌گردد. openssl version -d دایرکتوری پایه مورد استفاده در build شما را چاپ می‌کند و در Ubuntu، دایرکتوری certs در زیر آن به /etc/ssl/certs ارجاع می‌دهد. root شما هنوز در آنجا نیست، بنابراین تأیید شکست می‌خورد: زنجیره به صادرکننده‌ای می‌رسد که در store موجود نیست و جای دیگری برای جستجو باقی نمانده است. به وضعیت خروج (exit status) توجه کنید. این همان چیزی است که دو مرحله بعد تغییر خواهد کرد.

یک کلاینت واقعی تست بهتری نسبت به openssl verify ارائه می‌دهد، زیرا علاوه بر زنجیره، نام میزبان (hostname) را نیز بررسی می‌کند. گواهی را سرو کنید و آن را دریافت کنید.

openssl s_server -accept 8443 -cert app.crt -key app.key -www &
curl --resolve app.internal.example:8443:127.0.0.1 https://app.internal.example:8443/

--resolve اتصال را به 127.0.0.1 می‌فرستد در حالی که همچنان درخواست app.internal.example را دارد، بنابراین SAN مطابقت دارد و تنها پرسش باقی‌مانده، اعتماد است. curl شکست می‌خورد و دلیلی که نتوانسته زنجیره را تأیید کند چاپ می‌کند. برای جزئیات بیشتر -v را اضافه کنید. سرور تست را در حال اجرا باقی بگذارید.

نصب ریشه (root) در مسیر /usr/local/share/ca-certificates

sudo cp ca.crt /usr/local/share/ca-certificates/example-internal-root.crt
sudo chmod 644 /usr/local/share/ca-certificates/example-internal-root.crt
sudo update-ca-certificates

جزئیاتی که تعیین می‌کنند آیا این کار به درستی انجام می‌شود یا خیر:

  • نام فایل حتماً باید به .crt ختم شود. صفحه راهنمای update-ca-certificates بیان می‌کند که گواهی‌هایی با پسوند .crt که در زیرشاخه /usr/local/share/ca-certificates یافت شوند، گنجانده شده و به‌طور ضمنی مورد اعتماد قرار می‌گیرند. فایلی با نام root.pem یا root.cer بدون هیچ هشداری نادیده گرفته می‌شود.
  • محتوا باید با فرمت PEM باشد، یعنی بلوک base64 که بین خطوط BEGIN CERTIFICATE و END CERTIFICATE قرار گرفته است. update-ca-certificates هرگز محتوای فایل را بررسی نمی‌کند، بنابراین یک فایل DER که به .crt تغییر نام یافته، نادیده گرفته نمی‌شود: این فایل به /etc/ssl/certs لینک می‌شود، بایت‌های خام آن به دسته‌ای (bundle) اضافه می‌شوند که کلاینت‌ها انتظار دارند متن PEM باشد، و به عنوان یک فایل اضافه شده شمارش می‌شود. پیش از کپی کردن فایل، آن را با openssl x509 -noout -subject -in ca.crt بررسی کنید؛ این دستور در صورت مواجهه با ورودی DER خطا می‌دهد. برای تبدیل فایل DER از openssl x509 -inform DER -in ca.der -out ca.crt استفاده کنید.
  • فقط گواهی ریشه (root) باید در اینجا قرار گیرد. کلید خصوصی CA و گواهی leaf هیچ جایگاهی در trust store ندارند.

update-ca-certificates تعداد گواهی‌های اضافه و حذف شده را چاپ می‌کند. اگر هیچ گواهی اضافه نشد، دلیل آن پسوند نام فایل است. عدد یک فقط به این معنی است که یک فایل با پسوند .crt پیدا شده است، نه اینکه فایل لزوماً حاوی یک گواهی معتبر باشد؛ بنابراین تغییرات را از سمت سیستم تأیید کنید، نه صرفاً با تکیه بر آن پیام.

ls -l /etc/ssl/certs/$(openssl x509 -noout -subject_hash -in /usr/local/share/ca-certificates/example-internal-root.crt).0
grep -c 'BEGIN CERTIFICATE' /etc/ssl/certs/ca-certificates.crt

دستور اول، نام فایلی را بر اساس hash موضوع (subject hash) گواهی شما می‌سازد و آن را لیست می‌کند. update-ca-certificates این symlink را با اجرای openssl rehash ایجاد کرده است و به فایلی که نصب کرده‌اید اشاره می‌کند. یک فایل DER در این بررسی شکست می‌خورد، زیرا openssl rehash برای فایلی که نتواند به عنوان PEM بخواند، hash link نمی‌سازد. دستور دوم، گواهی‌های موجود در bundle تک‌فایلی را می‌شمارد. این دستور را پیش از نصب نیز اجرا کنید تا بتوانید افزایش تعداد گواهی‌ها را مشاهده کنید.

هنگام کپی‌کردن این root به ماشین‌های دیگر، پیش از نصب بررسی کنید که کپی بدون تغییر و کامل منتقل شده باشد. اشتباه‌بودن یک root certificate در سیستم می‌تواند بیشترین آسیب را ایجاد کند؛ بنابراین مانند هر فایل دانلودشدهٔ دیگری، پیش از استفاده آن را با checksum بررسی کنید. ماشین‌های Rocky Linux و AlmaLinux این root را از مسیر متفاوتی دریافت می‌کنند و به‌جای update-ca-certificates از update-ca-trust استفاده می‌کنند؛ بنابراین در این سیستم‌ها، به افزودن CA در Rocky Linux و AlmaLinux مراجعه کنید. روی ویندوز هم وضع مشابه است: اگر کلاینت v2rayN به سروری وصل می‌شود که گواهی‌اش را این CA امضا کرده، نصب root روی سرور اوبونتو کمکی به آن کلاینت نمی‌کند و روشن کردن allowInsecure هم به‌جای اعتماد به root شما، بررسی گواهی را به‌کلی کنار می‌گذارد؛ راهنمای دانلود v2rayN و وارد کردن کانفیگ در ویندوز توضیح می‌دهد خطای allowInsecure چطور رفع می‌شود.

تأیید مجدد در برابر استور سیستم

openssl verify app.crt
echo $?
curl --resolve app.internal.example:8443:127.0.0.1 https://app.internal.example:8443/

همان دستورات، همان فایل‌های گواهی، اما پاسخ متفاوت است. هیچ تغییری در app.crt ایجاد نشده و سرور همان سروری است که قبلاً راه‌اندازی کردید. تنها تفاوت این است که اکنون root در استوری قرار دارد که کلاینت‌ها آن را می‌خوانند، بنابراین زنجیره کامل می‌شود. این مکانیزمی است که ارزش به خاطر سپردن دارد: تأیید اعتبار، جستجو برای صادرکننده‌ای است که کلاینت از قبل به آن اعتماد دارد و نصب یک CA روشی است که صادرکننده به محلی که کلاینت در آن جستجو می‌کند، وارد می‌شود.

سرور تست را با kill %1 متوقف کنید.

چرا نباید فایل‌های خود را در /etc/ssl/certs قرار دهید

/etc/ssl/certs یک خروجی تولیدشده است. update-ca-certificates آن را با لینک‌های نمادین (symlinks) به فایل‌های گواهی اصلی پر می‌کند و باندل الحاقی /etc/ssl/certs/ca-certificates.crt را در کنار آن‌ها می‌نویسد.

گواهی‌ای که به‌صورت دستی در این دایرکتوری کپی می‌کنید، توسط هیچ برنامه‌ای شناسایی نمی‌شود. جستجوی دایرکتوری در OpenSSL فقط فایل‌هایی را باز می‌کند که نام آن‌ها بر اساس هش موضوع (subject hash) گواهی باشد؛ بنابراین فایلی با نام myca.crt برای آن نامرئی است. ابزار curl در Ubuntu فایل باندل را می‌خواند و این باندل از منابع ثبت‌شده بازسازی می‌شود، پس کپی شما در آن مسیر نیز وجود نخواهد داشت. update-ca-certificates --fresh لینک‌هایی را که به دو دایرکتوری منبع اشاره می‌کنند، به همراه هر لینک معلقی حذف کرده و فقط محتویات آن منابع را بازسازی می‌کند.

نیمه دیگر این تقسیم‌بندی، /usr/share/ca-certificates است که متعلق به بسته ca-certificates بوده و در /etc/ca-certificates.conf فهرست شده است. به‌روزرسانی‌های بسته، این فایل را بازنویسی می‌کنند. /usr/local/share/ca-certificates دایرکتوری رزرو شده برای مدیر سیستم (local administrator) است؛ بنابراین گواهی CA شما از هرگونه ارتقای بسته‌ای که مدیریت سایر بخش‌ها را بر عهده دارد، جان سالم به در می‌برد.

کدام برنامه‌ها از مخزن اعتماد سیستم صرف‌نظر می‌کنند

نصب ریشه (root) تمام برنامه‌هایی را که از OpenSSL استفاده می‌کنند یا /etc/ssl/certs را می‌خوانند، اصلاح می‌کند. این شامل curl، wget، git، ماژول استاندارد ssl در پایتون و برنامه‌های Go می‌شود که فایل‌های سیستم را در لینوکس می‌خوانند. محیط‌های اجرایی (runtimes) که لیست گواهی‌های اختصاصی خود را به همراه دارند، تحت تأثیر قرار نمی‌گیرند و بیشتر سردرگمی‌ها پس از نصب موفقیت‌آمیز، ناشی از همین موضوع است.

  • Node.js از لیستی استفاده می‌کند که در زمان کامپایل در آن گنجانده شده است. آن را با استفاده از NODE_EXTRA_CA_CERTS=/usr/local/share/ca-certificates/example-internal-root.crt به ریشه خود ارجاع دهید؛ این متغیر را پیش از شروع پردازش در محیط تنظیم کنید، زیرا Node این متغیر را فقط یک‌بار در زمان راه‌اندازی می‌خواند. نسخه‌های فعلی Node گزینه‌ای برای خواندن مخزن سیستم نیز دارند؛ node --help | grep -i system-ca را اجرا کنید تا ببینید آیا نسخه شما از آن پشتیبانی می‌کند یا خیر.
  • کتابخانه requests در پایتون از باندل certifi استفاده می‌کند. برای آن پردازش، REQUESTS_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt را تنظیم کنید یا verify="/etc/ssl/certs/ca-certificates.crt" را به فراخوانی ارسال نمایید. pip نیز به همین دلیل از --cert استفاده می‌کند.
  • Java یک keystore را می‌خواند. در اوبونتو، بسته ca-certificates-java یک هوک در مسیر /etc/ca-certificates/update.d/ نصب می‌کند، بنابراین وقتی این بسته موجود باشد، update-ca-certificates مخزن کلید Java را نیز به‌روزرسانی می‌کند. بدون آن، ریشه را با keytool -importcert وارد (import) کنید.
  • Firefox مخزن اختصاصی خود را دارد و هرگز به /etc/ssl/certs نگاه نمی‌کند. گواهی را از طریق تنظیمات گواهی آن وارد کنید. Chromium در لینوکس یک دیتابیس NSS برای هر کاربر می‌خواند که می‌توانید آن را با certutil از بسته libnss3-tools ویرایش کنید.
  • کانتینرها فایل‌سیستم مخصوص خود را دارند، بنابراین مخزن میزبان در داخل آن‌ها بی‌معنی است. ریشه را در ایمیج کپی کنید و در طول فرآیند build، دستور update-ca-certificates را اجرا کنید. اگر سرویس‌های شما تحت Docker Compose on a VPS اجرا می‌شوند، برای این مورد برنامه‌ریزی کنید.

هنگامی که برنامه‌ای پس از نصب تمیز همچنان گواهی را نمی‌پذیرد، پیش از هر تغییری بررسی کنید که چه فایل‌هایی را باز می‌کند. strace -f -e trace=openat <command> 2>&1 | grep -i cert ابزاری صریح است و در بیشتر اجراها پاسخ این سؤال را می‌دهد. این ابزار فقط فراخوانی‌های openat را ردیابی می‌کند و فیلتر آن هر باندلی را که در مسیرش کلمه cert نباشد مخفی می‌کند؛ بنابراین اگر چیزی چاپ نکرد، پیش از نتیجه‌گیری مبنی بر اینکه برنامه هیچ فایلی را نمی‌خواند (که نشانه وجود لیست داخلی/کامپایل‌شده است)، آن را بدون grep دوباره اجرا کنید.

حفظ قابلیت استفاده از CA در طول زمان

صدور مجدد یک گواهی leaf شامل تکرار مراحل CSR و امضا با استفاده از همان فایل app.ext است. کلاینت‌ها نیازی به انجام هیچ اقدامی ندارند، زیرا ریشه‌ای که به آن اعتماد دارند تغییر نکرده است. فایل ca.srl و تمامی فایل‌های .ext را در دایرکتوری CA نگه دارید تا صدور بعدی، تکرار دستوری باشد که قبلاً کار کرده است، نه بازسازی آن از روی حافظه.

از ca.key و ca.crt در جایی خارج از دستگاه نسخه پشتیبان تهیه کنید و همچنان آن‌ها را رمزنگاری‌شده نگه دارید. اگر کلید را گم کنید، دیگر قادر به صدور هیچ گواهی جدیدی نخواهید بود: در آن صورت مجبور می‌شوید یک CA دوم بسازید و ریشه آن را در تمام نقاطی که ریشه اول نصب شده بود، جایگزین کنید. فهرستی مکتوب از تمام ماشین‌ها و مخازن گواهی برنامه‌هایی که ریشه را دریافت کرده‌اند نگه دارید، زیرا همین فهرست است که چرخش (rotation) و حذف گواهی‌ها را ممکن می‌سازد.

هنگامی که تاریخ انقضای خودِ ریشه نزدیک می‌شود، جایگزین آن را زودتر تولید کرده و هر دو ریشه را در کنار هم نصب کنید. وجود دو ریشه در مخزن گواهی‌ها مشکلی ایجاد نمی‌کند و کلاینت هر کدام را بپذیرد، معتبر است. گواهی‌های leaf را با ریشه جدید مجدداً صادر کنید و سپس پس از آنکه دیگر هیچ سرویسی به ریشه قدیمی وابسته نبود، آن را حذف کنید.

حذف یک CA از trust store

sudo rm /usr/local/share/ca-certificates/example-internal-root.crt
sudo update-ca-certificates --fresh

دستور --fresh پیوندهای نمادین (symlinks) موجود در /etc/ssl/certs را که به دایرکتوری‌های منبع اشاره دارند حذف می‌کند. این عملیات شامل پیوندی که پس از حذف فایل شما بلااستفاده مانده نیز می‌شود و سپس پیوندها را بر اساس منابع باقی‌مانده بازسازی می‌کند؛ بنابراین با حذف root، دایرکتوری و bundle به‌طور هماهنگ به‌روزرسانی می‌شوند. حذف را به همان روشی که نصب را تأیید کردید، اثبات کنید.

openssl verify app.crt
echo $?
grep -c 'BEGIN CERTIFICATE' /etc/ssl/certs/ca-certificates.crt
ls -l /etc/ssl/certs/$(openssl x509 -noout -subject_hash -in ~/ca/ca.crt).0

تأیید اعتبار دوباره با شکست مواجه می‌شود، تعداد گواهی‌ها به مقدار اولیه بازمی‌گردد و پیوند نمادین hash از بین می‌رود.

آن دستور فقط store سیستم را تغییر می‌دهد و به جای دیگری دسترسی ندارد. نصب را در هر یک از مکان‌های دیگر به‌صورت دستی لغو کنید: NODE_EXTRA_CA_CERTS را پاک‌سازی کنید، alias را از هر Java keystore حذف نمایید، root را از پروفایل هر مرورگر بردارید و هر image کانتینری که آن را در خود جای داده است، بازسازی کنید. حذف root همچنین گواهی‌هایی را که امضا کرده است، باطل نمی‌کند. آن‌ها روی هر ماشینی که هنوز به آن اعتماد دارد معتبر باقی می‌مانند؛ این دلیل عملی است که یک CA خصوصی به لیستی مکتوب از مکان‌هایی که root در آن‌ها قرار گرفته نیاز دارد. CAای که نتوانید آن را به‌طور کامل حذف کنید، یک حفرهٔ دائمی است؛ بنابراین حذف را در همان روزی که آن را راه‌اندازی می‌کنید، روی یک ماشین تست کنید، تا زمانی که لیست هنوز کوتاه است.

FAQ

گواهی CA را در اوبونتو کجا قرار دهم؟

در /usr/local/share/ca-certificates/، با نام فایلی که به .crt ختم شود و محتوای PEM داشته باشد، سپس دستور sudo update-ca-certificates را اجرا کنید. آن دایرکتوری برای مدیر سیستم محلی رزرو شده است، بنابراین ارتقای بسته‌ها تغییری در آن ایجاد نمی‌کند. /usr/share/ca-certificates متعلق به بسته ca-certificates است و /etc/ssl/certs از هر دو تولید می‌شود، بنابراین فایلی که در هر یک از آن‌ها قرار گیرد، بازنویسی یا نادیده گرفته می‌شود.

چرا curl پس از اجرای update-ca-certificates همچنان گواهی را رد می‌کند؟

علت‌ها را به ترتیب بررسی کنید. ممکن است فایل به .crt ختم نشود، که در این صورت update-ca-certificates آن را نادیده گرفته و چیزی اضافه نکرده است. ممکن است فرمت آن به جای PEM، از نوع DER باشد که ابزار آن را تشخیص نمی‌دهد: ابزار فایل را لینک کرده و به باندل اضافه می‌کند و آن را به عنوان افزوده شده می‌شمارد، اما لینک هش ایجاد نمی‌شود؛ بنابراین آن را به PEM تبدیل کنید، فایل را جایگزین کرده و دستور را دوباره اجرا کنید. ممکن است subjectAltName گواهی، نام میزبانی که به آن متصل می‌شوید را لیست نکرده باشد، که این یک خطای نام میزبان است نه خطای اعتماد؛ curl تنها زمانی به common name بازمی‌گردد که گواهی هیچ DNS یا IP SAN نداشته باشد، پس با openssl x509 -noout -ext subjectAltName -in app.crt بررسی کنید. ممکن است سرور فقط گواهی leaf را ارسال کند در حالی که به یک intermediate نیز نیاز است. ممکن است curl توسط CURL_CA_BUNDLE یا --cacert به باندل دیگری اشاره کند. همچنین یک سرویس که مدت زیادی در حال اجراست نیاز به راه‌اندازی مجدد دارد، زیرا اکثر برنامه‌ها هنگام شروع، trust store را یک بار می‌خوانند.

آیا trust store سیستم، فایرفاکس، کروم، Node و جاوا را پوشش می‌دهد؟

خیر. curl، wget، git، ماژول استاندارد ssl در پایتون و برنامه‌های Go فایل‌های سیستم را می‌خوانند، بنابراین به محض اجرای update-ca-certificates کار می‌کنند. فایرفاکس store مخصوص خود را دارد. کرومیوم در لینوکس از یک دیتابیس NSS برای هر کاربر استفاده می‌کند که با certutil از بسته libnss3-tools ویرایش می‌شود. Node.js نیاز دارد که NODE_EXTRA_CA_CERTS به فایل ریشه شما اشاره کند. جاوا یک keystore می‌خواند که update-ca-certificates تنها زمانی آن را به‌روز می‌کند که بسته ca-certificates-java نصب شده باشد. کتابخانه requests در پایتون از certifi استفاده می‌کند و به REQUESTS_CA_BUNDLE نیاز دارد.

چگونه یک CA را از trust store اوبونتو حذف کنم؟

فایل را از /usr/local/share/ca-certificates/ حذف کرده و sudo update-ca-certificates --fresh را اجرا کنید. گزینه --fresh، لینک‌های نمادین در /etc/ssl/certs که به دایرکتوری‌های منبع اشاره می‌کنند را پاک کرده و آن‌ها را بازسازی می‌کند، بنابراین گواهی همزمان از لینک‌های هش و باندل ca-certificates.crt خارج می‌شود. با اجرای openssl verify روی گواهی که توسط آن CA امضا شده و خواندن وضعیت خروج، حذف را تأیید کنید. سپس حذف را در هر store دیگری که آن را اضافه کرده بودید تکرار کنید، زیرا آن دستور به هیچ‌کدام از آن‌ها دسترسی ندارد.

آیا می‌توانم برای یک سایت عمومی به جای Let's Encrypt از یک CA خصوصی استفاده کنم؟

خیر. مرورگر بازدیدکننده هرگز ریشه شما را ندیده است، بنابراین یک هشدار تمام‌صفحه نمایش می‌دهد و شما نمی‌توانید ریشه خود را روی ماشین‌هایی که کنترل نمی‌کنید نصب کنید. یک CA خصوصی برای نام‌هایی است که فقط ماشین‌های خودتان آن‌ها را resolve می‌کنند و برای کلاینت‌هایی است که مدیریت می‌کنید. برای هر چیزی که یک غریبه بازدید می‌کند، گواهی را از یک CA عمومی دریافت کنید.

آیا این مقاله مفید بود؟

#tls#certificates#openssl#ubuntu#security#pki