تنظیم پروتکل TLS برای «مسیریاب» و «پردازشگر پیام»

Edge for Private Cloud نسخه ۴.۱۸.۰۵

به‌طور پیش‌فرض، «مسیریاب» و «پردازشگر پیام» از نسخه‌های 1.0، 1.1، و 1.2 «امنیت لایه انتقال» پشتیبانی می‌کنند. بااین‌حال، ممکن است بخواهید پروتکل‌های پشتیبانی‌شده توسط «مسیریاب» و «پردازشگر پیام» را محدود کنید. این سند نحوه تنظیم پروتکل به‌صورت سراسری در «رهیاب» و «پردازشگر پیام» را شرح می‌دهد.

برای «مسیریاب»، می‌توانید پروتکل را برای میزبان‌های مجازی جداگانه نیز تنظیم کنید. برای اطلاعات بیشتر، پیکربندی دسترسی TLS به میانای برنامه‌سازی کاربردی برای Private Cloud را ببینید.

برای «پردازشگر پیام»، می‌توانید پروتکل را برای TargetEndpoint جداگانه تنظیم کنید. برای اطلاعات بیشتر، پیکربندی TLS از Edge به پس‌بک (Cloud و Private Cloud) را ببینید.

تنظیم پروتکل TLS در «رهیاب»

برای تنظیم پروتکل TLS در «رهیاب»، ویژگی‌ها را در فایل router.properties تنظیم کنید:

1. فایل router.properties را در ویرایشگر باز کنید. اگر فایل وجود ندارد، آن را ایجاد کنید:

   vi /opt/apigee/customer/application/router.properties

2. ویژگی‌ها را به‌دلخواه تنظیم کنید:

   # Possible values are space-delimited list of: TLSv1 TLSv1.1 TLSv1.2
   conf_load_balancing_load.balancing.driver.server.ssl.protocols=TLSv1.2

3. تغییراتتان را ذخیره کنید.
4. مطمئن شوید که فایل ویژگی‌ها متعلق به کاربر «apigee» است:

    chown apigee:apigee /opt/apigee/customer/application/router.properties

5. بازراه‌اندازی رهیاب:

   /opt/apigee/apigee-service/bin/apigee-service edge-router restart

6. با بررسی فایل Nginx، تأیید کنید که پروتکل به‌درستی به‌روز شده است /opt/nginx/conf.d/0-default.conf:

   cat /opt/nginx/conf.d/0-default.conf

   مطمئن شوید مقدار ssl_protocols‏ TLSv1.2 باشد.

7. اگر از TLS دوطرفه با میزبان مجازی استفاده می‌کنید، باید پروتکل TLS را نیز در میزبان مجازی تنظیم کنید، همان‌طور که در پیکربندی دسترسی TLS به API برای Private Cloud شرح داده شده است.

تنظیم پروتکل TLS در پردازشگر پیام

برای تنظیم پروتکل TLS در «پردازشگر پیام»، ویژگی‌ها را در فایل message-processor.properties تنظیم کنید:

1. فایل message-processor.properties را در ویرایشگر باز کنید. اگر فایل وجود ندارد، آن را ایجاد کنید:

   vi /opt/apigee/customer/application/message-processor.properties

2. ویژگی‌ها را به‌دلخواه تنظیم کنید:

   # Possible values are a comma-delimited list of TLSv1, TLSv1.1, TLSv1.2
   conf/system.properties+https.protocols=TLSv1.2
   # Possible values are a comma-delimited list of SSLv3, TLSv1, TLSv1.1, TLSv1.2
   # Ensure that you include SSLv3
   conf/jvmsecurity.properties+jdk.tls.disabledAlgorithms=SSLv3, TLSv1, TLSv1.1
   
   # Specify the ciphers that need to be supported by the Message Processor:
   conf_message-processor-communication_local.http.ssl.ciphers=TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDH_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDH_RSA_WITH_AES_256_GCM_SHA384,TLS_DHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384

3. تغییراتتان را ذخیره کنید.
4. مطمئن شوید که فایل ویژگی‌ها متعلق به کاربر «apigee» است:

   chown apigee:apigee /opt/apigee/customer/application/message-processor.properties

5. «پردازشگر پیام» را بازراه‌اندازی کنید:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

6. اگر از «امنیت لایه انتقال» دوطرفه با پس‌بخش استفاده می‌کنید، پروتکل «امنیت لایه انتقال» را در میزبان مجازی همان‌طور که در پیکربندی «امنیت لایه انتقال» از Edge به پس‌بخش (Cloud و Private Cloud) شرح داده شده است تنظیم کنید.