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

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

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

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

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

لمزيد من المعلومات، يُرجى الاطّلاع على أوامر واجهة SQL في Cassandra.

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

يمكنك تفعيل مصادقة Cassandra في وقت التثبيت. ومع ذلك، على الرغم من أنّه يمكنك تفعيل المصادقة عند تثبيت Cassandra، يجب دائمًا استخدام اسم المستخدم وكلمة المرور التلقائيين لـ Cassandra (‘cassandra’:’cassandra’) أثناء التثبيت. إذا أردت استخدام بيانات اعتماد Cassandra غير التلقائية، عليك إعادة تفعيل مصادقة Cassandra بعد التثبيت باتّباع الخطوات الواردة هنا.

إذا أردت تفعيل مصادقة Cassandra أثناء تثبيت Cassandra جديد، يمكنك تضمين السمات أدناه في ملف الإعداد لجميع عُقد Cassandra:

CASS_AUTH=y
CASS_USERNAME=cassandra
CASS_PASSWORD=cassandra

بعد ذلك، سيتم إعداد Cassandra مع تفعيل المصادقة واستخدام بيانات اعتماد cassandra:cassandra التلقائية.

بعد اكتمال عملية التثبيت الأولية، يمكنك اتّباع خطوة واحدة أو أكثر من الخطوات التالية:

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

مكوّنات Edge التي تتصل بـ Cassandra

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

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

تثبيت مكوّنات Edge عند تفعيل مصادقة Cassandra

إذا كانت مصادقة Cassandra مفعَّلة عند تثبيت مكوّنات Edge هذه للمرة الأولى، عليك تقديم الإعدادات التالية في ملف الإعداد الصامت:

CASS_AUTH=Y
CASS_USERNAME=<valid username in Cassandra>
CASS_PASSWORD=<password for the above username>

يمكنك تغيير بيانات اعتماد Cassandra بعد تثبيت Cassandra. ومع ذلك، إذا كنت قد ثبّتّ Management Server أو Message Processors أو Routers أو خوادم Qpid أو خوادم Postgres، عليك أيضًا تحديث هذه المكوّنات لاستخدام بيانات الاعتماد الجديدة، كما هو موضّح في القسم التالي.

تعديل مكوّنات Edge التي تتصل بـ Cassandra

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

1. على عقدة خادم الإدارة، نفِّذ الأمر التالي:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server store_cassandra_credentials -u cassandra_username -p cassandra_password

   يمكنك اختياريًا تمرير ملف يحتوي على اسم المستخدم وكلمة المرور الجديدَين إلى الأمر:

   apigee-service edge-management-server store_cassandra_credentials  -f configFile

   حيث يحتوي configFile على ما يلي:

   CASS_USERNAME=cassandra_username # Default is cassandra
   CASS_PASSWORD='cassandra_password' # Default is cassandra; wrap in single quotes if it includes special characters.

   يعيد هذا الأمر تشغيل "خادم الإدارة" تلقائيًا.

2. كرِّر الخطوة 1 لكل من الخدمات التالية:
   • جميع معالِجات الرسائل
   • جميع أجهزة التوجيه
   • جميع خوادم Qpid ‏ (edge-qpid-server)
   • خوادم Postgres ‏ (edge-postgres-server)

   عند تكرار الخطوة 1 لكل خدمة، استبدِل edge-management-server في الأمر أعلاه باسم الخدمة المناسب. على سبيل المثال، عند تنفيذ الخطوة لخدمة "الموجّه"، استخدِم الأمر التالي:

   /opt/apigee/apigee-service/bin/apigee-service edge-router store_cassandra_credentials -u cassandra -p cassandra

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

   توضّح الأقسام التالية كيفية تفعيل مصادقة Cassandra بعد التثبيت.

   تفعيل مصادقة Cassandra في إعداد مركز بيانات واحد

   بالنسبة إلى إعداد Apigee المستند إلى مركز بيانات واحد والذي تم تثبيت Cassandra فيه، يمكنك إجراء ما يلي:

   • فعِّل مصادقة Cassandra للمرة الأولى، إما باستخدام مستخدم Cassandra التلقائي (cassandra:cassandra) أو من خلال إنشاء مستخدم متميّز جديد تمامًا. لإجراء ذلك، اتّبِع الخطوات التالية:
     1. اتّبِع الخطوات الواردة في مقالة تفعيل مصادقة Cassandra للمرة الأولى.
     2. عدِّل مكوّنات Edge التي تتصل بـ Cassandra باستخدام اسم المستخدم وكلمة المرور في Cassandra.
   • تغيير كلمة مرور مستخدم Cassandra حالي إذا فعّلت مصادقة Cassandra باستخدام بيانات اعتماد Cassandra التلقائية (cassandra:cassandra)، يمكنك تغيير كلمة المرور باتّباع الخطوات التالية:
     1. تغيير كلمة المرور لمستخدم Cassandra
     2. عدِّل مكوّنات Edge التي تتصل بـ Cassandra باستخدام اسم المستخدم وكلمة المرور في Cassandra.

   ملاحظة: مستخدم Cassandra هو مستخدم خاص في Cassandra. تتطلّب المصادقة باستخدام هذا المستخدم اتساق QUORUM. يُرجى الاطّلاع على لمحة عن مستويات اتساق Cassandra.

   تفعيل مصادقة Cassandra في حال توفّر مراكز بيانات متعدّدة

   عند توسيع مراكز البيانات، اتّبِع الخطوات الواردة في أحد السيناريوهات التالية، حسب ما يتوافق مع الإعدادات.

   السيناريو 1: تفعيل مصادقة Cassandra في مركز البيانات الحالي

   إذا كانت مصادقة Cassandra مفعَّلة في مركز بيانات حالي باستخدام بيانات اعتماد cassandra:cassandra التلقائية، اتّبِع الخطوات التالية:

   1. إعداد مركز بيانات جديد باستخدام بيانات اعتماد Cassandra:Cassandra التلقائية وCASS_AUTH=y يُرجى الاطّلاع على تفعيل مصادقة Cassandra للمرة الأولى.
   2. ثبِّت مكوّنات Edge في مركز البيانات الجديد باستخدام بيانات اعتماد Cassandra التلقائية.

   إذا كانت مصادقة Cassandra مفعَّلة في مركز البيانات الحالي باستخدام بيانات اعتماد غير تلقائية، اتّبِع الخطوات التالية:

   1. إعداد مركز بيانات جديد باستخدام بيانات اعتماد Cassandra:Cassandra التلقائية وCASS_AUTH=y يُرجى الاطّلاع على تفعيل مصادقة Cassandra للمرة الأولى.
   2. اتّبِع الخطوات الواردة في قسم تفعيل مصادقة Cassandra للمرة الأولى لإعادة استخدام بيانات الاعتماد من مركز بيانات حالي (إذا كان المركز الحالي يستخدم بيانات اعتماد غير تلقائية).
   3. تثبيت مكوّنات Edge في مركز البيانات الجديد باستخدام بيانات اعتماد Cassandra غير التلقائية.

   السيناريو 2: لم يتم تفعيل مصادقة Cassandra في مركز البيانات الحالي

   إذا لم تكن مصادقة Cassandra مفعَّلة، اتّبِع الخطوات التالية:

   1. إعداد مركز بيانات جديد بدون مصادقة Cassandra
   2. اتّبِع الخطوات الواردة في مقالة تفعيل مصادقة Cassandra للمرة الأولى لتفعيل مصادقة Cassandra في المجموعة (بعد التوسيع).
   3. حدِّث مكوّنات Edge التي تتصل بـ Cassandra باتّباع الخطوات هنا.

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

   اتّبِع الإجراء التالي لتفعيل مصادقة Cassandra لأول مرة، أو لإنشاء اسم مستخدم وكلمة مرور جديدَين في Cassandra:

   1. أنشئ ملف إعداد صامتًا بالمحتوى الموضّح أدناه:

      # Specify IP address or DNS name of cassandra node
      IP1=192.168.1.1
      IP2=192.168.1.2
      IP3=192.168.1.3
      
      # Must resolve to IP address or DNS name of host
      HOSTIP=$(hostname -i)
      
      # Set to ‘y’ to enable Cassandra authentication.
      CASS_AUTH=y # Possible values are ‘y/n’
      
      # Cassandra username. If it does not exist, this user would be created as a SUPERUSER
      CASS_USERNAME=cassandra # Default value is cassandra
      # Cassandra Password. If CASS_USERNAME does not exist, create SUPERUSER with this as password
      CASS_PASSWORD=cassandra # Default value is cassandra
      
      # Space-separated IP/DNS names of the Cassandra hosts
      CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1"
      
      # Username of an existing C* user. Only needed if you have disabled or change details of the default cassandra user(‘cassandra’)
      CASS_EXISTING_USERNAME=cassandra  # The default username is cassandra
      # Password of an existing C* user. Only needed if you have disabled or change password of the default cassandra user(‘cassandra’)
      CASS_EXISTING_PASSWORD=cassandra  # The default password is cassandra
      
      # Cassandra port
      CASS_PORT=9042 # The default port is 9042.

   2. سجِّل الدخول إلى عقدة Cassandra الأولى ونفِّذ الأمر التالي:

      apigee-service apigee-cassandra enable_cassandra_authentication -f CONFIG

      يمكنك اختياريًا تمرير السمات كوسيطات أوامر إلى النص البرمجي، كما هو موضّح في المثال التالي:

      CASS_AUTH=y HOSTIP=$(hostname -i) CASS_PORT=9042 CASS_EXISTING_USERNAME=cassandra CASS_EXISTING_PASSWORD=cassandra CASS_USERNAME=cassandra CASS_PASSWORD=cassandra  CASS_HOSTS="192.168.1.1:1,1 192.168.1.2:1,1 192.168.1.3:1,1" apigee-service apigee-cassandra enable_cassandra_authentication

      ملاحظات:

      • بالنسبة إلى بيانات اعتماد Cassandra التلقائية، يفعّل الأمر أعلاه مصادقة Cassandra ويعيد تشغيل Cassandra.
      • بالنسبة إلى بيانات الاعتماد غير التلقائية، يغيّر الأمر أيضًا عامل النسخ المتماثل، وينشئ مستخدمًا مميزًا، ويُجري إصلاحًا على مساحة مفاتيح system_auth.
   3. كرِّر الخطوتين 1 و2 على جميع عُقد Cassandra واحدة تلو الأخرى.

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

   لتغيير بيانات اعتماد 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> لتعديل كلمة المرور:

      ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';

   3. اخرج من أداة cqlsh، كما هو موضّح في المثال التالي:

      exit

   4. إذا لم يسبق لك تثبيت خادم الإدارة أو معالجات الرسائل أو أجهزة التوجيه أو خوادم Qpid أو خوادم Postgres، اضبط السمات التالية في ملف الإعداد ثم ثبِّت هذه المكوّنات:

      CASS_USERNAME=cassandra
      CASS_PASSWORD=NEW_PASSWORD

   5. إذا سبق لك تثبيت خادم الإدارة أو معالجات الرسائل أو أجهزة التوجيه أو خوادم Qpid أو خوادم Postgres، يُرجى الاطّلاع على إعادة ضبط كلمات مرور Edge لمعرفة الإجراءات اللازمة لتعديل هذه المكوّنات لاستخدام كلمة المرور الجديدة.