صيانة Apigee mTLS

توضّح هذه الصفحة مهام صيانة mTLS في Apigee التي يجب تنفيذها بانتظام.

تدوير الشهادات المُخزَّنة على الجهاز

يجب استبدال الشهادات المحلية المثبّتة على كل مضيف Apigee بشهادات جديدة سنويًا. ويُعرف ذلك باسم تدوير الشهادات. هناك طريقتان لتبديل الشهادات، حسب ما إذا كنت تستخدم مرجع تصديق مخصّص أو شهادة مثبّتة من خلال Consul.

تبديل الشهادات المحلية بدون هيئة إصدار شهادات (CA) مخصّصة

أبسط طريقة لعرض الشهادات بالتبادل بدون مرجع تصديق مخصّص هي إلغاء تثبيت apigee-mtls وإعادة تثبيته. يؤدي هذا الإجراء إلى إزالة جميع الشهادات القديمة وإنشاء شهادات جديدة على الجهاز. يمكنك إجراء ذلك بأقل وقت توقّف عن العمل من خلال تنفيذ الأوامر التالية على كل مضيف، واحدًا تلو الآخر:

ملاحظة: يفترض هذا الإجراء أنّ ملف silent.conf نفسه الذي تم استخدامه في عملية التثبيت الأولية متوفّر.

  1. أوقِف جميع مكوّنات Apigee الأساسية: 
    /opt/apigee/apigee-service/bin/apigee-all stop
     يُرجى الاطّلاع على بدء/إيقاف/التحقّق من جميع المكوّنات.
  2. إيقاف "apigee-mtls": 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls stop
  3. إلغاء تثبيت "apigee-mtls": 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls uninstall
  4. إعادة تثبيت "apigee-mtls": 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls install
  5. نفِّذ الأمر apigee-mtls setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls setup -f /opt/silent.conf
  6. إعادة تشغيل "apigee-mtls": 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls start
  7. أعِد تشغيل جميع مكوّنات Apigee الأساسية: 
    /opt/apigee/apigee-service/bin/apigee-all start
     يُرجى الاطّلاع على بدء/إيقاف/التحقّق من جميع المكوّنات.

تبديل الشهادات المحلية باستخدام هيئة إصدار شهادات (CA) مخصّصة

لتدوير الشهادات المحلية باستخدام مرجع تصديق مخصّص، اتّبِع الخطوات التالية:

  1. اتّبِع الخطوات الواردة في مقالة استخدام شهادة مخصّصة لإنشاء الشهادات الجديدة التي ستستخدمها.
  2. أوقِف جميع مكوّنات Apigee الأساسية: 
    /opt/apigee/apigee-service/bin/apigee-all stop
     يُرجى الاطّلاع على بدء/إيقاف/التحقّق من جميع المكوّنات.
  3. إيقاف "apigee-mtls": 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls stop
  4. أزِل ملفات الشهادات المحلية القديمة: 
    rm -f /opt/apigee/apigee-mtls/certs/local_cert.pem
rm -f /opt/apigee/apigee-mtls/certs/local_key.pem
rm -f /opt/apigee/apigee-mtls/source/certs/local_cert.pem
rm -f /opt/apigee/apigee-mtls/source/certs/local_key.pem
rm -rf /opt/apigee/data/apigee-mtls
  5. انسخ الشهادة الجديدة/مفتاحَي التشفير اللذين تم إنشاؤهما في الخطوة الأولى إلى المواقع التالية، وعدِّل الأذونات: 
    cp ${new_cert} /opt/apigee/apigee-mtls/certs/local_cert.pem

chmod \
  --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
  /opt/apigee/apigee-mtls/certs/local_cert.pem

chown \
  --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
  /opt/apigee/apigee-mtls/certs/local_cert.pem

cp ${new_cert} /opt/apigee/apigee-mtls/source/certs/local_cert.pem

chmod \
  --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
  /opt/apigee/apigee-mtls/source/certs/local_cert.pem

chown \
  --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
  /opt/apigee/apigee-mtls/source/certs/local_cert.pem

cp ${new_key} /opt/apigee/apigee-mtls/certs/local_key.pem

chmod \
  --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
  /opt/apigee/apigee-mtls/source/certs/local_cert.pem

chown \
  --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
  /opt/apigee/apigee-mtls/source/certs/local_cert.pem

cp ${new_key} /opt/apigee/apigee-mtls/source/certs/local_key.pem

chmod \
  --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
  /opt/apigee/apigee-mtls/source/certs/local_cert.pem

chown \
  --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
  /opt/apigee/apigee-mtls/source/certs/local_cert.pem
  6. إعادة تشغيل "apigee-mtls": 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls start
  7. أعِد تشغيل جميع مكوّنات Apigee الأساسية: 
    /opt/apigee/apigee-service/bin/apigee-all start
     يُرجى الاطّلاع على بدء/إيقاف/التحقّق من جميع المكوّنات.