به‌روزرسانی گواهینامه «امنیت لایه انتقال» برای «ابر خصوصی»

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

روشی که برای مشخص کردن نام انبار کلید و انبار اعتماد در میزبان مجازی یا نقطه پایانی هدف/سرور هدف استفاده می‌کنید تعیین می‌کند که چگونه به‌روزرسانی گواهینامه را انجام دهید. بااستفاده از موارد زیر می‌توانید نام انبار کلید و انبار اعتماد را مشخص کنید:

• مرجع‌ها - ترجیحی
• نام‌های مستقیم
• متغیرهای جریان

هریک از این روش‌ها پیامدهای متفاوتی بر فرایند به‌روزرسانی گواهینامه دارد، همان‌طور که در جدول زیر توضیح داده شده است.

آزمایش گواهینامه قبل و بعداز به‌روزرسانی

برای آزمایش گواهینامه فعلی قبل‌از به‌روزرسانی آن، از فرمان‌های openssl زیر استفاده کنید:

echo | openssl s_client -servername hostAlias -connect hostAlias.apigee.net:443 2>/dev/null | openssl x509 -noout -dates -subject

در اینجا hostAlias نام مستعار میزبان میزبان مجازی یا نشانی IP است. برای مثال:

echo | openssl s_client -servername api.myCompany.com -connect api.myCompany.com:443 2>/dev/null | openssl x509 -noout -dates -subject

باید برونداد را به این شکل ببینید:

notBefore=Dec 30 22:11:38 2015 GMT
notAfter=Dec 30 22:11:38 2016 GMT
subject= /OU=Domain Control Validated/CN=*.apigee.net

پس‌از به‌روز کردن گواهینامه، از همان فرمان برای آزمایش آن استفاده کنید.

به‌روزرسانی گواهینامه «امنیت لایه انتقال» در انبار کلید

برای استقرار محلی Edge:

1. ‫keystore جدیدی ایجاد کنید و گواهینامه و کلید را همان‌طور که در Keystores و Truststores توضیح داده شده است بارگذاری کنید. در انبار کلید جدید، مطمئن شوید که از همان نام برای نام مستعار کلید استفاده می‌کنید که در انبار کلید موجود استفاده شده است.
   
   توجه: می‌توانید انبار کلید فعلی را حذف کنید و انبار کلید جدیدی با همان نام و نام مستعار ایجاد کنید. بازراه‌اندازی «رهیاب» لازم نیست. بااین‌حال، تا زمانی که انبار کلید جدید و نام مستعار تنظیم نشود، درخواست‌های API ناموفق خواهد بود.
2. برای میزبان مجازی که توسط اتصالات ورودی استفاده می‌شود، یعنی درخواست API به Edge:
   1. اگر میزبان مجازی شما از مرجعی برای انبار کلید استفاده می‌کند، مرجع را همان‌طور که در کار با مراجع توضیح داده شده است به‌روز کنید.
   2. اگر میزبان مجازی شما از نام مستقیم انبار کلید استفاده می‌کند:
      1. همه میزبان‌های مجازی را که به انبار کلید قدیمی و نام مستعار کلید ارجاع می‌دادند به‌روز کنید تا به انبار کلید جدید و نام مستعار کلید ارجاع دهند.
      2. «رهیاب‌ها» را یکی‌یکی بازراه‌اندازی کنید. توجه داشته باشید که اگر انبار کلید قدیمی را حذف کرده‌اید و انبار کلید جدیدی با همان نام ایجاد کرده‌اید، نیازی به بازراه‌اندازی «مسیریاب» نیست.
         
         بازاستقرار پراکسی لازم نیست.
3. برای نقطه پایانی هدف/سرور هدف که توسط اتصال‌های خروجی استفاده می‌شود، یعنی از Apigee به سرور پشتیبان:
   1. اگر نقطه پایانی هدف/سرور هدف از مرجع‌های انبار کلید استفاده می‌کند، مرجع را همان‌طور که در کار با مرجع‌ها توضیح داده شده است به‌روز کنید. استقرار مجدد پراکسی لازم نیست.
   2. اگر نقطه پایانی هدف/سرور هدف از متغیر جاری استفاده می‌کند، متغیر جاری را به‌روز کنید. بازاستقرار کارگزار لازم نیست.
   3. اگر نقطه پایانی هدف/سرور هدف از نام مستقیم مخزن کلید استفاده می‌کند:
      1. پیکربندی سرور هدف/نقطه پایانی هدف را برای هریک از پراکسی‌های API که به انبار کلید قدیمی و نام مستعار کلید ارجاع داده‌اند به‌روز کنید تا به انبار کلید جدید و نام مستعار کلید ارجاع دهند.
      2. برای هر پراکسی API که از تعریف TargetEndpoint به انبار کلید ارجاع می‌دهد، باید پراکسی را مجدداً مستقر کنید.
         
         اگر TargetEndpoint به تعریف TargetServer ارجاع دهد، و تعریف TargetServer به keystore ارجاع دهد، دیگر استقرار مجدد پراکسی لازم نیست.
      3. اگر از انبار کلید برای «امنیت لایه انتقال» دوطرفه بین Edge و سرویس زیرینه استفاده می‌شود، و انبار کلید را با همان نام حذف/بازسازی کرده‌اید، باید «پردازشگرهای پیام» Edge را بازراه‌اندازی کنید.
4. پس‌از اینکه مطمئن شدید انبار کلید جدیدتان به‌درستی کار می‌کند، انبار کلید قدیمی را که گواهینامه و کلید منقضی‌شده دارد، همان‌طور که در بالا توضیح داده شد حذف کنید.

به‌روزرسانی گواهینامه «امنیت لایه انتقال» در مخزن اعتماد

اگر از مرجع‌های truststore استفاده می‌کنید، فرایند به‌روزرسانی گواهینامه در truststore همانند keystore است که در بالا نشان داده شده است. تنها تفاوت‌ها عبارت‌اند از:

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

اگر از نام‌های مستقیم keystore و truststore استفاده می‌کنید:

1. گواهینامه جدیدی را در truststore بارگذاری کنید، همان‌طور که در Keystores و Truststores توضیح داده شده است. نیازی به حذف گواهینامه قدیمی نیست.
2. برای میزبان مجازی که توسط اتصالات ورودی استفاده می‌شود، یعنی درخواست API به Edge، «مسیریاب‌ها» را یکی‌یکی بازراه‌اندازی کنید.
3. برای نقطه پایانی مقصد/سرور مقصد که توسط اتصالات خروجی استفاده می‌شود، یعنی از Apigee به سرور زیرینه، «پردازشگرهای پیام Edge» را یک‌به‌یک بازراه‌اندازی کنید.
4. تأیید کنید که مخزن اعتماد جدیدتان به‌درستی کار می‌کند.