درحال پیکربندی «امنیت لایه انتقال» نسخه ۱.۳ برای ترافیک بالادستی

این صفحه نحوه پیکربندی TLS 1.3 در «رهیاب‌های Apigee» را برای ترافیک شمال‌گرا (ترافیک بین کارخواه و «رهیاب») توضیح می‌دهد.

برای اطلاعات بیشتر درباره میزبان‌های مجازی، به میزبان‌های مجازی مراجعه کنید.

فعال کردن TLS 1.3 برای همه میزبان‌های مجازی مبتنی بر TLS در «مسیریاب»

از روش زیر برای فعال کردن TLS 1.3 برای همه میزبان‌های مجازی مبتنی بر TLS در یک «رهیاب» استفاده کنید:

  1. در «مسیریاب»، فایل ویژگی‌های زیر را در ویرایشگر باز کنید. 
    /opt/apigee/customer/application/router.properties

    اگر فایل وجود ندارد، آن را ایجاد کنید.

  2. خط زیر را به فایل ویژگی‌ها اضافه کنید: 
    conf_load_balancing_load.balancing.driver.server.ssl.protocols=TLSv1 TLSv1.1 TLSv1.2 TLSv1.3

    همه پروتکل‌های TLS را که می‌خواهید پشتیبانی کنید اضافه کنید. توجه داشته باشید که پروتکل‌ها با فاصله از هم جدا شده‌اند و حروف‌حساس هستند.

  3. فایل را ذخیره کنید.
  4. مطمئن شوید که فایل متعلق به کاربر apigee است: 
    chown apigee:apigee /opt/apigee/customer/application/router.properties
  5. بازراه‌اندازی رهیاب: 
    /opt/apigee/apigee-service/bin/apigee-service edge-router restart
  6. مراحل بالا را برای همه گره‌های «رهیاب» یکی‌یکی تکرار کنید.

فعال کردن TLS 1.3 فقط برای میزبان‌های مجازی خاص

این بخش توضیح می‌دهد که چگونه TLS 1.3 را برای میزبان‌های مجازی خاص فعال کنید. برای فعال کردن TLS 1.3، مراحل زیر را در گره‌های سرور «مدیریت» انجام دهید:

  1. در هر گره سرور Management، فایل /opt/apigee/customer/application/management-server.properties را ویرایش کنید و خط زیر را اضافه کنید. (اگر فایل وجود ندارد، آن را ایجاد کنید.) 
    conf_virtualhost_virtual.host.allowed.protocol.list=TLSv1,TLSv1.1,TLSv1.2,TLSv1.3

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

  2. فایل را ذخیره کنید.
  3. مطمئن شوید که فایل متعلق به کاربر apigee است: 
    chown apigee:apigee /opt/apigee/customer/application/management-server.properties
  4. سرور «مدیریت» را بازراه‌اندازی کنید: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
  5. مراحل بالا را برای همه گره‌های سرور Management یکی‌یکی تکرار کنید.
  6. میزبان مجازی جدیدی با ویژگی زیر ایجاد کنید (یا میزبان مجازی موجود را به‌روز کنید). توجه داشته باشید که پروتکل‌ها با فاصله از هم جدا می‌شوند و حروف‌حساس هستند. 
    "properties": {
    "property": [
      {
        "name": "ssl_protocols",
        "value": "TLSv1 TLSv1.1 TLSv1.2 TLSv1.3"
      }
    ]
}

    نمونه‌ای از vhost با این ویژگی در زیر نشان داده شده است:

    {
  "hostAliases": [
    "api.myCompany,com",
  ],
  "interfaces": [],
  "listenOptions": [],
  "name": "secure",
  "port": "443",
  "retryOptions": [],
  "properties": {
    "property": [
      {
        "name": "ssl_protocols",
        "value": "TLSv1 TLSv1.1 TLSv1.2 TLSv1.3"
      }
    ]
  },
  "sSLInfo": {
    "ciphers": [],
    "clientAuthEnabled": "false",
    "enabled": "true",
    "ignoreValidationErrors": false,
    "keyAlias": "myCompanyKeyAlias",
    "keyStore": "ref://myCompanyKeystoreref",
    "protocols": []
  },
  "useBuiltInFreeTrialCert": false
}

    درحال آزمایش TLS 1.3

    برای آزمایش «امنیت لایه انتقال» نسخه ۱.۳، فرمان زیر را وارد کنید:

    curl -v --tlsv1.3 "https://api.myCompany,com/testproxy"

    توجه داشته باشید که «امنیت لایه انتقال» نسخه ۱.۳ را فقط می‌توان در کارخواه‌هایی آزمایش کرد که از این پروتکل پشتیبانی می‌کنند. اگر TLS 1.3 فعال نباشد، پیام خطایی مانند زیر خواهید دید: 

    sslv3 alert handshake failure