ضبط TLS 1.3 للزيارات الشمالية

توضّح هذه الصفحة كيفية ضبط الإصدار 1.3 من بروتوكول أمان طبقة النقل (TLS) في موجّهات Apigee للزيارات الواردة (الزيارات بين العميل والموجّه).

يمكنك الاطّلاع على المضيفين الافتراضيين لمزيد من المعلومات عن المضيفين الافتراضيين.

تفعيل الإصدار 1.3 من بروتوكول أمان طبقة النقل (TLS) لجميع المضيفين الافتراضيين المستندين إلى بروتوكول أمان طبقة النقل (TLS) في جهاز توجيه

اتّبِع الإجراء التالي لتفعيل الإصدار 1.3 من بروتوكول أمان طبقة النقل (TLS) لجميع المضيفين الافتراضيين المستندين إلى بروتوكول أمان طبقة النقل (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. كرِّر الخطوات أعلاه على جميع عُقد "الموجّه" واحدة تلو الأخرى.

تفعيل الإصدار 1.3 من بروتوكول أمان طبقة النقل (TLS) لمضيفين افتراضيين محدّدين فقط

يشرح هذا القسم كيفية تفعيل الإصدار 1.3 من بروتوكول أمان طبقة النقل (TLS) لمضيفين افتراضيين محدّدين. لتفعيل الإصدار 1.3 من بروتوكول أمان طبقة النقل (TLS)، اتّبِع الخطوات التالية على عُقد خادم الإدارة:

  1. في كل عقدة خادم إدارة، عدِّل الملف /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. كرِّر الخطوات أعلاه على جميع عُقد خادم الإدارة واحدة تلو الأخرى.
  6. أنشئ مضيفًا افتراضيًا (أو عدِّل مضيفًا حاليًا) باستخدام السمة التالية. يُرجى العِلم أنّ البروتوكولات مفصولة بمسافات وحسّاسة لحالة الأحرف. 
    "properties": {
    "property": [
      {
        "name": "ssl_protocols",
        "value": "TLSv1 TLSv1.1 TLSv1.2 TLSv1.3"
      }
    ]
}

    في ما يلي نموذج لمضيف افتراضي يتضمّن هذه السمة:

    {
  "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
}

    اختبار الإصدار 1.3 من بروتوكول أمان طبقة النقل (TLS)

    لاختبار الإصدار 1.3 من بروتوكول أمان طبقة النقل (TLS)، أدخِل الأمر التالي:

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

    يُرجى العِلم أنّه لا يمكن اختبار الإصدار 1.3 من بروتوكول أمان طبقة النقل (TLS) إلا على البرامج المتوافقة مع هذا البروتوكول. إذا لم يتم تفعيل الإصدار 1.3 من بروتوكول أمان طبقة النقل (TLS)، ستظهر لك رسالة خطأ مثل الرسالة التالية: 

    sslv3 alert handshake failure