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

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

يمكنك إضافة الأدوار وإزالتها وتعديلها باستخدام عبارات "كاساندرا" CREATE/ALTER/DROP ROLES. لمزيد من المعلومات، يُرجى الاطّلاع على ما يلي:

بعض الاعتبارات العامة

  • في اللحظة التي تفعّل فيها مصادقة Cassandra، يتم إنشاء المستخدم المتميز التلقائي cassandra (بكلمة المرور cassandra) بواسطة "كاساندرا" تلقائيًا. هذا مستخدم متميّز معروف على نطاق واسع، ويجب عدم استخدام هذا المستخدم لتلبية احتياجاتك المتعلقة بالإصدار العلني. بالإضافة إلى ذلك، تتطلّب المصادقة من خلال هذا المستخدم المتميّز اتّساق النصاب القانوني. ولذلك، تتطلب جميع عمليات الربط بمصادقة "كاساندرا" عبر هذا المستخدم اتساقًا أكثر صرامة، ما يؤدي إلى أداء أبطأ وأقل تساهلًا مع الأخطاء.
  • ويشمل سير العمل النموذجي تفعيل المصادقة في Cassandra مع تمرير اسم مستخدم وكلمة مرور مخصّصَين عبر ملف الإعداد. سيؤدي ذلك إلى إنشاء المستخدم وكلمة المرور المخصصين اللذين يمكنك استخدامهما بأمان لتلبية احتياجاتك، ولا تفرض المصادقة عبر هؤلاء المستخدمين قيود على اتساق النصاب.
  • يُرجى تذكُّر أنّه على الرغم من أنّه قد يكون قد تم إنشاء مستخدم مخصَّص، لا تزال "كاساندرا" تنشئ المستخدِم المميّز التلقائي cassandra، ويمكن للمستخدم المميّز الوصول إلى مجموعة Cassandra. عليك عادةً استخدام الأمر الدور البديل لتغيير كلمة مرور مستخدم كاساندرا إلى كلمة مرور أخرى غير كلمة كاساندرا التلقائية بعد تفعيل مصادقة "كاساندرا" بنجاح على جميع الأجهزة في Apigee. يُرجى الاحتفاظ بسجلّ لكلمة المرور هذه للرجوع إليها في المستقبل.
  • يجب عدم تغيير كلمة مرور الدور الذي تستخدمه مكونات edge-* للمصادقة، لأنّ ذلك سيؤدي إلى انقطاع الخدمة على الفور. بدلاً من ذلك، عليك إنشاء مستخدم جديد تمامًا وتعديل مكوّنات edge-* لاستخدام المستخدم الجديد، وبعد الانتهاء، عليك إسقاط المستخدم القديم باستخدام الأمر DROP ROLE.
  • لتغيير الدور الذي تستخدمه مكوِّنات edge-* لمصادقة Cassandra، اتّبِع الخطوات التالية:
    1. اتبع الخطوات الواردة في القسم الذي يحمل عنوان تفعيل المصادقة لإنشاء مستخدم جديد. يُرجى ملاحظة أنّه في حال تفعيل المصادقة في المجموعة وتغيير كلمة مرور مستخدم cassandra، عليك تمرير تركيبة اسم المستخدم/كلمة المرور لمستخدم حالي عبر CASS_EXISTING_USERNAME وCASS_EXISTING_PASSWORD.
    2. بعد اكتمال العملية، تحقَّق عبر cqlsh من قدرتك على الاتصال بـ "كاساندرا" من خلال كل من المستخدم القديم والجديد.
    3. وجِّه جميع مكونات edge-* لاستخدام المستخدم الذي تم إنشاؤه حديثًا للاتصال بـ "كاساندرا" من خلال اتّباع التعليمات الواردة في مكوِّنات Update Edge التي تتصل بـ Cassandra.
    4. وأخيرًا، عندما تستخدم جميع المكوّنات المستخدم الجديد للتواصل مع "كاساندرا"، يمكنك حذف المستخدم القديم باستخدام الأمر DROP ROLE. تجدر الإشارة إلى أنّه يجب عدم إغفال دور cassandra التلقائي. يمكنك حذف أي أدوار مخصّصة تم إنشاؤها ولا تستخدمها المكوّنات edge-* للتواصل مع "كاساندرا".
  • تذكر تحديث اسم المستخدم وكلمة المرور اللذين يعملان في Cassandra في ملف الإعداد الذي تستخدمه لتثبيت مكونات Edge أو ترقيتها. سيؤدي ذلك إلى إزالة أو تقليل أي انقطاع أثناء العمليات الهامشية.

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

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

لتفعيل مصادقة Cassandra في وقت التثبيت، أدرِج السمة CASS_AUTH في ملف الإعدادات لجميع عقد Cassandra:

CASS_AUTH=y # The default value is n.

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

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

عند تثبيت هذه المكونات، يجب تعيين اسم مستخدم وكلمة مرور في ملف الإعداد:

CASS_USERNAME=cassandra_username
CASS_PASSWORD=cassandra_password

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

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

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

    المكان:

    1. cassIP هو عنوان IP الخاص بعقدة Cassandra.
    2. 9042 هو منفذ "كاساندرا" التلقائي.
  2. نفِّذ الأمر التالي في موجه cqlsh> من أجل تعديل كلمة المرور: 
    ALTER ROLE <username> WITH PASSWORD='';
  3. اخرج من أداة cqlsh، كما يبيِّن المثال التالي: 
    exit
  4. إذا لم تكن قد ثبّتّ بعد خادم الإدارة أو معالِجات الرسائل أجهزة التوجيه أو خوادم Qpid أو خوادم Postgres، عيِّن الخصائص التالية في config، ثم تثبيت هذه المكونات: 
    CASS_USERNAME=cassandra_username
CASS_PASSWORD=new_cassandra_password
  5. إذا سبق لك تثبيت خادم الإدارة، انقر على معالِجات البيانات أو أجهزة التوجيه أو خوادم Qpid أو خوادم Postgres، يُرجى الاطّلاع على مقالة إعادة ضبط كلمات مرور Edge لمعرفة الخطوات اللازمة لتحديثها والمكونات لاستخدام كلمة المرور الجديدة.

تفعيل مشاركة مصادقة "كاساندرا" التثبيت

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

تحديث مكونات Edge التي تتصل بـ Cassandra

استخدم الإجراء التالي لتحديث جميع مكونات Edge التي تتصل بكاساندرا ببيانات الاعتماد الجديدة. لاحظ أنك تقوم بهذه الخطوة قبل تحديث 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 chars

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

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

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

    /opt/apigee/apigee-service/bin/apigee-service edge-router
  store_cassandra_credentials -u cassandra -p 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_username # Default value is cassandra - don't use for production
# Cassandra Password. If CASS_USERNAME does not exist, create SUPERUSER with this as password
CASS_PASSWORD=cassandra_password # Default value is cassandra - don't use for production
# 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 changed details of the default cassandra user(‘cassandra’)
CASS_EXISTING_USERNAME=existing_cassandra_username
# Password of an existing C* user. Only needed if you have disabled or change password of the default cassandra user(‘cassandra’)
CASS_EXISTING_PASSWORD=existing_cassandra_password
# 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=existing_cassandra_username CASS_EXISTING_PASSWORD=existing_cassandra_password CASS_USERNAME=cassandra_username CASS_PASSWORD=cassandra_password  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 وتتم إعادة التشغيل "كاساندرا".
    • بالنسبة لبيانات الاعتماد غير الافتراضية، يقوم الأمر أيضًا بتغيير عامل النسخ، وينشئ للمستخدم المتميز، وإجراء عملية إصلاح في system_auth keyspace.
  3. كرر الخطوتين 1 و2 على جميع عُقد Cassandra.