تفعيل مصادقة Cassandra

الإصدار 4.16.09 من Edge for Private Cloud

يتم تثبيت Cassandra تلقائيًا بدون تفعيل المصادقة. هذا يعني أنه يمكن لأي شخص الوصول إلى Cassandra. يمكنك تفعيل المصادقة بعد تثبيت Edge أو كجزء من عملية التثبيت.

إذا قررت تفعيل المصادقة على Cassandra، ستستخدم بيانات الاعتماد التلقائية التالية:

  • username = 'cassandra'
  • password = 'cassandra'

يمكنك استخدام هذا الحساب أو ضبط كلمة مرور مختلفة له أو إنشاء مستخدم Cassandra جديد. إضافة مستخدمين وإزالتهم وتعديلهم باستخدام عبارات Cassandra CREATE/ALTER/DROP USER

لمزيد من المعلومات، يُرجى الاطّلاع على http://www.datastax.com/documentation/cql/3.0/cql/cql_reference/cqlCommandsTOC.html.

تفعيل مصادقة Cassandra أثناء التثبيت

يمكنك تفعيل مصادقة Cassandra في وقت التثبيت. ومع ذلك، على الرغم من إمكانية تفعيل المصادقة عند تثبيت Cassandra، لا يمكنك تغيير اسم المستخدم وكلمة المرور التلقائيين. عليك تنفيذ هذه الخطوة يدويًا بعد اكتمال تثبيت Cassandra.

ملاحظة: استخدِم هذا الإجراء عند تثبيت Cassandra باستخدام الخيارات "‎-p c" و"‎-p ds" و"‎-p sa" و"‎-p aio" و"‎-p asa" و "‎-p ebp".

لتفعيل مصادقة Cassandra في وقت التثبيت، يجب تضمين السمة CASS_AUTH في ملف الإعداد لجميع عُقد Cassandra:

CASS_AUTH=y # The default value is n.

تصل مكوّنات Edge التالية إلى Cassandra:

  • خادم الإدارة
  • معالِجات الرسائل
  • أجهزة توجيه
  • خوادم Qpid
  • خوادم Postgres
  • BaaS Stack

لذلك، عند تثبيت هذه المكوّنات، يجب ضبط السمات التالية في ملف الإعداد لتحديد بيانات اعتماد Cassandra:

CASS_USERNAME=cassandra 
CASS_PASSWORD=cassandra

يمكنك تغيير بيانات اعتماد Cassandra بعد تثبيت Cassandra. ومع ذلك، إذا كنت قد ثبّتّ خادم الإدارة أو معالجات الرسائل أو أجهزة التوجيه أو خوادم Qpid أو خوادم Postgres أو حزمة BaaS، يجب أيضًا تحديث هذه المكوّنات لاستخدام بيانات الاعتماد الجديدة.

لتغيير بيانات اعتماد Cassandra بعد تثبيت Cassandra:

  1. سجِّل الدخول إلى أي عقدة Cassandra باستخدام أداة cqlsh وبيانات الاعتماد التلقائية. عليك تغيير كلمة المرور على عقدة واحدة فقط وسيتم بثها إلى جميع عُقد Cassandra في الحلقة:
    > /opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p cassandra
    حيث:
    1. cassIP هو عنوان IP لعقدة Cassandra.
    2. 9042 هو منفذ Cassandra التلقائي.
    3. المستخدم التلقائي هو cassandra.
    4. كلمة المرور التلقائية هي cassandra. إذا غيّرت كلمة المرور سابقًا، استخدِم كلمة المرور الحالية.
  2. شغِّل الأمر التالي في الطلب cqlsh> لتعديل كلمة المرور:
    cqlsh> ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';
  3. اخرج من أداة cqlsh:
    cqlsh> exit
  4. إذا لم تكن قد ثبّت خادم الإدارة أو معالجات الرسائل أو أجهزة التوجيه أو خوادم Qpid أو خوادم Postgres أو حزمة BaaS، اضبط السمات التالية في ملف الإعداد ثم ثبِّت هذه المكوّنات:
    CASS_USERNAME=cassandra
    CASS_PASSWORD=NEW_PASSWORD
  5. إذا سبق لك تثبيت خادم الإدارة أو معالجات الرسائل أو أجهزة التوجيه أو خوادم Qpid أو خوادم Postgres أو BaaS Stack، يمكنك الاطّلاع على إعادة ضبط كلمات مرور Edge لمعرفة الإجراءات اللازمة لتعديل هذه المكوّنات لاستخدام كلمة المرور الجديدة.

تفعيل مصادقة Cassandra بعد التثبيت

لتفعيل المصادقة:

  • حدِّث جميع مكوّنات Edge التي تتصل بـ Cassandra باستخدام اسم المستخدم وكلمة المرور في Cassandra.
  • فعِّل المصادقة على جميع عُقد Cassandra.
  • اضبط اسم مستخدم Cassandra وكلمة المرور على أي عُقدة واحدة. ما عليك سوى تغيير بيانات الاعتماد على عقدة Cassandra واحدة وسيتم بثها إلى جميع عقد Cassandra في الحلقة.

استخدِم الإجراء التالي لتعديل جميع مكوّنات Edge التي تتواصل مع Cassandra باستخدام بيانات الاعتماد الجديدة. يُرجى العِلم أنّه عليك تنفيذ هذه الخطوة قبل تعديل بيانات اعتماد Cassandra:

  1. في عقدة خادم الإدارة، شغِّل الأمر التالي:
    > /opt/apigee/apigee-service/bin/apigee-service edge-management-server store_cassandra_credentials -u CASS_USERNAME -p CASS_PASSWORD

    يمكنك اختياريًا تمرير ملف إلى الأمر الذي يحتوي على اسم المستخدم وكلمة المرور الجديدَين:
    > apigee-service edge-management-server store_cassandra_credentials -f configFile

    حيث يحتوي configFile على ما يلي:
    CASS_USERNAME=cassandra
    CASS_PASSWORD=CASS_PASSWROD

    يعيد هذا الأمر تشغيل خادم الإدارة تلقائيًا.
  2. كرِّر الخطوة 1 على:
    • جميع معالِجات الرسائل
    • جميع أجهزة التوجيه
    • جميع خوادم Qpid ‏ (edge-qpid-server)
    • خوادم Postgres ‏ (edge-postgres-server)
  3. في عقدة BaaS Stack للإصدار 4.16.05.04 والإصدارات الأحدث:
    1. شغِّل الأمر التالي لإنشاء كلمة مرور مشفّرة:
      > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid secure_password

      يطلب منك هذا الأمر إدخال كلمة المرور النصية العادية ويعرض كلمة المرور المشفّرة بالشكل التالي:
      SECURE:ae1b6dedbf6b26aaab8bee815a910737c1c15b55f3505c239e43bc09f8050
    2. اضبط الرموز المميّزة التالية في /opt/apigee/customer/application/usergrid.properties. إذا لم يكن هذا الملف متوفّرًا، أنشئه:
      usergrid-deployment_cassandra.username=cassandra
      usergrid-deployment_cassandra.password=SECURE:ae1b6dedbf6b26aaab8bee815a910737c1c15b55f3505c239e43bc09f8050

      يستخدم هذا المثال اسم المستخدم التلقائي لـ Cassandra. إذا غيّرت اسم المستخدم، اضبط قيمة usergrid-deployment_cassandra.username وفقًا لذلك.

      تأكَّد من تضمين البادئة "SECURE:" في كلمة المرور. وإلا، ستفسّر حزمة BaaS القيمة على أنّها غير مشفّرة.

      ملاحظة: لكل عقدة في BaaS Stack مفتاح فريد يُستخدَم لتشفير كلمة المرور. لذلك، يجب إنشاء القيمة المشفّرة على كل عقدة في حزمة BaaS بشكل منفصل.
    3. غيِّر ملكية ملف usergrid.properties إلى المستخدم "apigee":
      > chown apigee:apigee /opt/apigee/customer/application/usergrid.properties
    4. اضبط عقدة Stack:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid configure
    5. أعِد تشغيل حزمة BaaS:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid restart
    6. كرِّر هذه الخطوات لجميع عُقد حزمة BaaS.

اتّبِع الإجراء التالي لتفعيل مصادقة Cassandra وضبط اسم المستخدم وكلمة المرور:

  1. سجِّل الدخول إلى عقدة Cassandra الأولى.
  2. نفِّذ الأمر التالي: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra
  enable_cassandra_authentication -e y

    يؤدي هذا الأمر إلى تفعيل المصادقة وإعادة تشغيل Cassandra.

  3. كرِّر الخطوتَين 1 و2 على جميع عُقد Cassandra.
  4. سجِّل الدخول إلى أي عقدة Cassandra باستخدام أداة cqlsh وبيانات الاعتماد التلقائية. ما عليك سوى تغيير كلمة المرور على عقدة Cassandra واحدة وسيتم بثها إلى جميع عقد Cassandra في الحلقة: 
    /opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p cassandra

    المكان

    • ‫cassIP هو عنوان IP لعقدة Cassandra.
    • ‫9042 هو منفذ Cassandra.
    • المستخدم التلقائي هو cassandra.
    • كلمة المرور التلقائية هي cassandra. إذا غيّرت كلمة المرور سابقًا، استخدِم كلمة المرور الحالية.
  5. نفِّذ الأمر التالي في طلب cqlsh> لتعديل كلمة المرور: 
    ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';
  6. نفِّذ الأمر التالي في موجّه الأوامر cqlsh> للتأكّد من أنّ مساحة المفاتيح متاحة دائمًا. بالنسبة إلى مركز بيانات واحد: 
    ALTER KEYSPACE system_auth WITH replication = {'class': 'NetworkTopologyStrategy', 'dc-1': '3'};
     في حال استخدام مركزَي بيانات: 
    ALTER KEYSPACE system_auth WITH replication = {'class': 'NetworkTopologyStrategy', 'dc-1': '3', 'dc-2': '3'};
  7. للخروج من أداة "cqlsh": 
    exit
  8. شغِّل nodetool repair للتأكّد من نشر التغيير على جميع عُقد Cassandra: 
    /opt/apigee/apigee-cassandra/bin/nodetool repair system_auth