درحال تبدیل گواهینامه‌ها به قالب پشتیبانی‌شده

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید. اطلاعات

این سند توضیح می‌دهد که چگونه گواهی TLS و کلید خصوصی مرتبط را به قالب‌های PEM یا PFX (PKCS ‎ #12) تبدیل کنید.

‫Apigee Edge فقط از ذخیره گواهینامه‌های قالب PEM یا PFX در keystore و truststore پشتیبانی می‌کند. مراحل استفاده‌شده برای تبدیل گواهینامه‌ها از هر قالب موجود به قالب‌های PEM یا PFX به مجموعه ابزار OpenSSL متکی است و در هر محیطی که OpenSSL دردسترس باشد قابل‌اجرا است.

قبل‌از شروع

قبل‌از استفاده از مراحل این سند، مطمئن شوید که موضوعات زیر را درک می‌کنید:

  • اگر با قالب PEM یا PFX آشنا نیستید، درباره TLS/SSL را بخوانید.
  • اگر با قالب‌های گواهینامه آشنا نیستید، قالب‌های گواهینامه SSL را بخوانید.
  • اگر با کتابخانه OpenSSL آشنا نیستید، OpenSSL را بخوانید.
  • اگر می‌خواهید از مثال‌های خط فرمان در این راهنما استفاده کنید، جدیدترین نسخه کارخواه OpenSSL را نصب یا به آن به‌روزرسانی کنید.

درحال تبدیل گواهی از قالب DER به قالب PEM

این بخش نحوه تبدیل گواهی و کلید خصوصی مرتبط از قالب DER به قالب PEM را شرح می‌دهد.

  1. فایل حاوی زنجیره گواهی کامل (certificate.der) و کلید خصوصی مرتبط (private_key.der) را که می‌خواهید به قالب PEM تبدیل کنید بااستفاده از scp، sftp، یا هر ابزار دیگری به دستگاهی که OpenSSL در آن نصب شده است منتقل کنید.

    برای مثال، از فرمان scp برای انتقال فایل به دایرکتوری /tmp در سرور حاوی OpenSSL به‌صورت زیر استفاده کنید: 

    scp certificate.der servername:/tmp
scp private_key.der servername:/tmp

    که در آن servername نام سرور حاوی OpenSSL است.

  2. به سیستم ماشینی که OpenSSL در آن نصب شده است وارد شوید.
  3. از فهرست راهنمایی که گواهی‌ها در آن قرار دارند، فرمان زیر را برای تبدیل گواهی و کلید خصوصی مرتبط از قالب DER به قالب PEM اجرا کنید: 
    openssl x509 -inform DER -in certificate.der -outform PEM -out certificate.pem
openssl rsa -inform DER -in private_key.der -outform PEM -out private.key
  4. تأیید کنید که گواهینامه به قالب PEM تبدیل شده است.

درحال تبدیل گواهی از قالب P7B به قالب PEM

این بخش نحوه تبدیل گواهی‌ها از قالب P7B به قالب PEM را توضیح می‌دهد.

  1. فایل حاوی زنجیره گواهی کامل (certificate.p7b) را که می‌خواهید به قالب PEM تبدیل کنید بااستفاده از scp، sftp یا هر ابزار دیگری به دستگاهی که OpenSSL در آن نصب شده است منتقل کنید.

    برای مثال، از فرمان scp برای انتقال فایل به دایرکتوری /tmp در سرور حاوی OpenSSL به‌صورت زیر استفاده کنید: 

    scp certificate.p7b servername:/tmp

    که در آن servername نام سرور حاوی OpenSSL است.

  2. به سیستم ماشینی که OpenSSL در آن نصب شده است وارد شوید.
  3. از فهرست راهنمایی که گواهی‌ها در آن قرار دارد، دستور زیر را برای تبدیل گواهی از قالب P7B به قالب PEM اجرا کنید: 
    openssl pkcs7 -print_certs -in certificate.p7b -out certificate.pem
  4. تأیید کنید که گواهینامه به قالب PEM تبدیل شده است.

درحال تبدیل گواهی از قالب PFX به قالب PEM

این بخش نحوه تبدیل گواهی‌های TLS از قالب PFX به قالب PEM را شرح می‌دهد.

هنگام تبدیل فایل PFX به قالب PEM،‏ OpenSSL همه گواهینامه‌ها و کلید خصوصی را در یک فایل قرار می‌دهد. باید فایل را در ویرایشگر نوشتار باز کنید و هر گواهینامه و کلید خصوصی (شامل عبارت‌های BEGIN/END) را در فایل‌های نوشتاری جداگانه کپی کنید و آن‌ها را به‌ترتیب با نام‌های certificate.pfx، Intermediate.pfx (درصورت وجود)، CACert.pfx، و privateKey.key ذخیره کنید.

‫Apigee از قالب PFX/PKCS ‎ #12 پشتیبانی می‌کند؛ بااین‌حال، قالب PEM به‌دلایل زیادی ازجمله اعتبارسنجی مناسب است.

  1. گواهی‌ها و کلید خصوصی (certificate.pfx، Intermediate.pfx CACert.pfx، privateKey.key) را که می‌خواهید به قالب PEM تبدیل کنید بااستفاده از scp، sftp، یا هر ابزار دیگری به دستگاهی که OpenSSL در آن نصب شده است منتقل کنید.

    برای مثال، از فرمان scp برای انتقال فایل به دایرکتوری /tmp در سرور حاوی OpenSSL به‌صورت زیر استفاده کنید: 

    scp certificate.pfx servername:/tmp

    که در آن servername نام سرور حاوی OpenSSL است.

  2. به سیستم ماشینی که OpenSSL در آن نصب شده است وارد شوید.
  3. از فهرست راهنمایی که گواهی‌ها در آن قرار دارد، دستور زیر را برای تبدیل گواهی از قالب P7B به قالب PEM اجرا کنید: 
    openssl pkcs12 -in certificate.pfx -out certificate.pem -nodes
  4. تأیید کنید که گواهینامه به قالب PEM تبدیل شده است.

درحال تبدیل گواهینامه از قالب P7B به قالب PFX

این بخش نحوه تبدیل گواهینامه‌های TLS از قالب P7B به قالب PFX را شرح می‌دهد.

برای تبدیل به قالب PFX، باید کلید خصوصی را نیز دریافت کنید.

  1. گواهینامه‌ای (certificate.p7b) را که می‌خواهید به PFX تبدیل کنید به ماشینی که OpenSSL در آن نصب شده است بااستفاده از scp،‏ sftp، یا هر ابزار دیگری منتقل کنید.

    برای مثال، از فرمان scp برای انتقال فایل به دایرکتوری /tmp در سرور حاوی OpenSSL به‌صورت زیر استفاده کنید: 

    scp certificate.p7b servername:/tmp
scp private_key.key servername:/tmp

    که در آن servername نام سرور حاوی OpenSSL است.

  2. به سیستم ماشینی که OpenSSL در آن نصب شده است وارد شوید.
  3. از فهرست راهنمایی که گواهی‌ها در آن قرار دارد، دستورات زیر را برای تبدیل گواهی از قالب P7B به قالب PFX و صادر کردن گواهی‌های نهاد و «مرجع صدور گواهی میانجی» در فایل‌های جداگانه اجرا کنید: 
    openssl pkcs7 -print_certs -in certificate.p7b -out certificate.cer

openssl pkcs12 -export -in certificate.cer -inkey private_key.key -out certificate.pfx -certfile CACert.cer

درحال درستی‌سنجی گواهینامه در قالب PEM

این بخش نحوه درستی‌سنجی اینکه گواهی در قالب PEM است را توضیح می‌دهد.

  1. برای مشاهده گواهی در قالب PEM، فرمان زیر را اجرا کنید: 
    openssl x509 -in certificate.pem -text -noout
  2. اگر می‌توانید محتوای گواهینامه را بدون هیچ خطایی در قالب قابل‌خواندن برای انسان مشاهده کنید، می‌توانید تأیید کنید که گواهینامه در قالب PEM است.
  3. اگر گواهینامه در قالب دیگری باشد، خطاهایی مانند موارد زیر را مشاهده خواهید کرد: 
    unable to load certificate
12626:error:0906D06C:PEM routines:PEM_read_bio:no start line:pem_lib.c:647:Expecting: TRUSTED CERTIFICATE View DER encoded Certificate

بسته‌بندی فایل‌های گواهی و کلید PEM در PKCS12/PFX

  1. مطمئن شوید فایل کلید خصوصی در قالب PEM باشد. برای گواهینامه، اگر فایل‌های PEM جداگانه برای زنجیره خود دارید، هر فایل را در یک ویرایشگر متن باز کنید و آن‌ها را به یک فایل واحد پیوند دهید، همان‌طور که در زیر نشان داده شده است: 
    -----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----
  2. فایل‌ها را بااستفاده از scp، sftp، یا هر ابزار دیگری به دستگاهی که OpenSSL در آن نصب شده است منتقل کنید: 
    scp certificate.pem servername:/tmp
scp private.key servername:/tmp
  3. به سیستم ماشینی که OpenSSL در آن نصب شده است وارد شوید.
  4. از فهرست راهنمایی که فایل‌ها در آن قرار دارند، فرمان زیر را اجرا کنید تا فایل‌ها را در فایل PKCS12 با نام مستعار myalias بسته‌بندی کنید. وقتی از شما خواسته شد، گذرواژه مناسبی وارد کنید: 
    openssl pkcs12 -export -in certificate.pem -inkey private.key -out keystore.pfx -name myalias