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

به‌طور پیش‌فرض، «مسیریاب» و «پردازشگر پیام» از نسخه‌های 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, and TLSv1.2
   conf/system.properties+https.protocols=[TLSv1][,TLSv1.1][,TLSv1.2]
   # Possible values are a comma-delimited list of SSLv3, TLSv1, TLSv1.1, TLSv1.2
   # SSLv3 is required
   conf/jvmsecurity.properties+jdk.tls.disabledAlgorithms=SSLv3[,TLSv1][,TLSv1.1][,TLSv1.2]
   
   # Specify the ciphers that the Message Processor supports. (You must separate ciphers with a comma.):
   conf_message-processor-communication_local.http.ssl.ciphers=cipher[,...]

   مقادیر ممکن برای conf_message-processor-communication_local.http.ssl.ciphers عبارتند از:

   • 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

   برای مثال:

   conf/system.properties+https.protocols=TLSv1.2
   conf/jvmsecurity.properties+jdk.tls.disabledAlgorithms=SSLv3, TLSv1, TLSv1.1
   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

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

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) شرح داده شده است تنظیم کنید.