تنظیم پروتکل 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. ویژگی‌ها را به‌دلخواه تنظیم کنید:
    # مقادیر ممکن عبارتند از فهرست جداشده با فاصله از: 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. ویژگی‌ها را به‌دلخواه تنظیم کنید:
    # مقادیر ممکن عبارتند از فهرست جداشده با ویرگول از TLSv1،‏ TLSv1.1،‏ TLSv1.2
    conf/system.properties+https.protocols=TLSv1.2
    # مقادیر ممکن عبارتند از فهرست جداشده با ویرگول از SSLv3،‏ TLSv1،‏ TLSv1.1،‏ TLSv1.2
    # مطمئن شوید که SSLv3 را اضافه کرده‌اید.
    conf/jvmsecurity.properties+jdk.tls.disabledAlgorithms=SSLv3, TLSv1, TLSv1.1

    #Configure the ciphers that need to be supported by the 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) شرح داده شده است تنظیم کنید.