إعادة ضبط كلمات مرور Edge

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

يمكنك إعادة ضبط كلمات مرور OpenLDAP ومشرف نظام Apigee Edge ومستخدم مؤسسة Edge و Cassandra بعد اكتمال عملية التثبيت.

إعادة ضبط كلمة مرور OpenLDAP

استنادًا إلى إعدادات Edge، يمكن تثبيت OpenLDAP على النحو التالي:

  • نسخة واحدة من OpenLDAP مثبّتة على عقدة خادم الإدارة. على سبيل المثال، في إعدادات Edge التي تتضمّن عقدتَين أو 5 عقد أو 9 عقد.
  • تم تثبيت نُسخ متعددة من OpenLDAP على عُقد خادم الإدارة، وتم ضبطها باستخدام النسخ المتماثل لـ OpenLDAP. على سبيل المثال، في إعداد Edge يتألف من 12 عقدة.
  • نُسخ متعددة من OpenLDAP مثبّتة على عُقدها الخاصة، وتم ضبطها باستخدام النسخ المتماثل في OpenLDAP على سبيل المثال، في إعداد Edge يتألف من 13 عقدة.

تعتمد طريقة إعادة ضبط كلمة مرور OpenLDAP على الإعدادات التي تضبطها.

بالنسبة إلى مثيل واحد من OpenLDAP مثبَّت على خادم الإدارة، نفِّذ ما يلي:

  1. في عقدة خادم الإدارة، نفِّذ الأمر التالي لإنشاء كلمة مرور OpenLDAP الجديدة: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-password -o OLD_PASSWORD -n NEW_PASSWORD
  2. شغِّل الأمر التالي لتخزين كلمة المرور الجديدة ليتمكّن خادم الإدارة من الوصول إليها: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server store_ldap_credentials -p NEW_PASSWORD

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

في إعداد النسخ المتماثل لـ OpenLDAP مع تثبيت OpenLDAP على عُقد خادم الإدارة، اتّبِع الخطوات المذكورة أعلاه على عُقد خادم الإدارة لتحديث كلمة المرور.

في إعداد النسخ المتماثل لـ OpenLDAP مع وجود OpenLDAP على عقدة أخرى غير خادم الإدارة، تأكَّد من تغيير كلمة المرور أولاً على عقدتَي OpenLDAP، ثم على عقدتَي خادم الإدارة.

إعادة ضبط كلمة مرور مشرف النظام

تتطلب إعادة ضبط كلمة مرور مشرف النظام إعادة ضبط كلمة المرور في مكانَين:

  • خادم الإدارة
  • واجهة المستخدِم

لإعادة ضبط كلمة مرور مشرف النظام:

  1. في عقدة واجهة المستخدم، أوقِف واجهة مستخدم Edge: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui stop
  2. على خادم الإدارة، شغِّل الأمر التالي لإعادة ضبط كلمة المرور:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server change_sysadmin_password -o currentPW -n newPW
  3. عدِّل ملف الإعداد التلقائي الذي استخدمته لتثبيت واجهة مستخدم Edge لضبط السمات التالية: 
    APIGEE_ADMINPW=NEW_PASSWORD
SMTPHOST=smtp.gmail.com
SMTPPORT=465
SMTPUSER=foo@gmail.com
SMTPPASSWORD=bar
SMTPSSL=y
SMTPMAILFROM="My Company <myco@company.com>"

    يُرجى العِلم أنّه عليك تضمين سمات SMTP عند تمرير كلمة المرور الجديدة لأنّه تتم إعادة ضبط جميع السمات في واجهة المستخدم.

  4. استخدِم الأداة المساعدة apigee-setup لإعادة ضبط كلمة المرور في واجهة مستخدم Edge من ملف الإعداد: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
  5. (فقط في حال تفعيل بروتوكول أمان طبقة النقل (TLS) في واجهة المستخدم) أعِد تفعيل بروتوكول أمان طبقة النقل (TLS) في واجهة مستخدم Edge كما هو موضّح في ضبط بروتوكول أمان طبقة النقل (TLS) لواجهة مستخدم الإدارة.

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

إعادة ضبط كلمة مرور مستخدم المؤسسة

لإعادة ضبط كلمة المرور لمستخدم في المؤسسة، استخدِم الأداة المساعدة apigee-service لاستدعاء apigee-setup:

/opt/apigee/apigee-service/bin/apigee-service apigee-setup reset_user_password
  [-h]
  [-u USER_EMAIL]
  [-p USER_PWD]
  [-a ADMIN_EMAIL]
  [-P APIGEE_ADMINPW]
  [-f configFile]

على سبيل المثال:

/opt/apigee/apigee-service/bin/apigee-service apigee-setup reset_user_password -u user@myCo.com -p Foo12345 -a admin@myCo.com -P adminPword

في ما يلي مثال على ملف إعداد يمكنك استخدامه مع الخيار "-f":

USER_NAME= user@myCo.com
USER_PWD="Foo12345"
APIGEE_ADMINPW=ADMIN_PASSWORD

يمكنك أيضًا استخدام واجهة برمجة التطبيقات تعديل مستخدم لتغيير كلمة مرور المستخدم.

قواعد كلمات المرور لمشرف النظام ومستخدمي المؤسسة

استخدِم هذا القسم لفرض مستوى معيّن من طول كلمة المرور وقوتها لمستخدمي إدارة واجهة برمجة التطبيقات. تستخدم الإعدادات سلسلة من التعبيرات العادية التي تم ضبطها مسبقًا (وتم ترقيمها بشكل فريد) للتحقّق من محتوى كلمة المرور (مثل الأحرف الكبيرة والأحرف الصغيرة والأرقام والرموز الخاصة). اكتب هذه الإعدادات في ملف /opt/apigee/customer/application/management-server.properties. إذا لم يكن هذا الملف متوفّرًا، أنشِئه.

بعد تعديل management-server.properties، أعِد تشغيل خادم الإدارة:

/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

يمكنك بعد ذلك ضبط تقييمات مدى قوة كلمة المرور من خلال تجميع مجموعات مختلفة من التعبيرات العادية. على سبيل المثال، يمكنك تحديد أنّ كلمة المرور التي تحتوي على حرف كبير واحد على الأقل وحرف صغير واحد على الأقل تحصل على تقييم قوة "3"، ولكن كلمة المرور التي تحتوي على حرف صغير واحد على الأقل ورقم واحد تحصل على تقييم أقوى "4".

الموقع الوصف 
conf_security_password.validation.minimum.password.length=8
conf_security_password.validation.default.rating=2
conf_security_password.validation.minimum.rating.required=3

استخدِم هذه الخيارات لتحديد الخصائص العامة لكلمات المرور الصالحة. الحد الأدنى التلقائي لتقييم مدى قوة كلمة المرور (الموضَّح لاحقًا في الجدول) هو 3.

يُرجى ملاحظة أنّ password.validation.default.rating=2 أقل من الحد الأدنى للتقييم المطلوب، ما يعني أنّه إذا كانت كلمة المرور التي تم إدخالها لا تتوافق مع القواعد التي تم ضبطها، يتم تقييم كلمة المرور على أنّها 2 وبالتالي تكون غير صالحة (أقل من الحد الأدنى للتقييم الذي يبلغ 3).

في ما يلي التعبيرات العادية التي تحدّد خصائص كلمة المرور. لاحظ أن كل واحد مرقم. على سبيل المثال، password.validation.regex.5=... هو التعبير رقم 5. ستستخدم هذه الأرقام في قسم لاحق من الملف لضبط مجموعات مختلفة تحدّد مدى قوة كلمة المرور بشكل عام.

 
conf_security_password.validation.regex.1=^(.)\\1+$

‫1: تكرار جميع الأحرف

 
conf_security_password.validation.regex.2=^.*[a-z]+.*$

‫2: حرف صغير واحد على الأقل

 
conf_security_password.validation.regex.3=^.*[A-Z]+.*$

‫3: حرف كبير واحد على الأقل

 
conf_security_password.validation.regex.4=^.*[0-9]+.*$

‫4: رقم واحد على الأقل

 
conf_security_password.validation.regex.5=^.*[^a-zA-z0-9]+.*$

‫5: رمز خاص واحد على الأقل (لا يشمل الشرطة السفلية _)

 
conf_security_password.validation.regex.6=^.*[_]+.*$

‫6: شرطة سفلية واحدة على الأقل

 
conf_security_password.validation.regex.7=^.*[a-z]{2,}.*$

‫7: أكثر من حرف صغير واحد

 
conf_security_password.validation.regex.8=^.*[A-Z]{2,}.*$

‫8: أكثر من حرف كبير واحد

 
conf_security_password.validation.regex.9=^.*[0-9]{2,}.*$

‫9: أكثر من رقم واحد

 
conf_security_password.validation.regex.10=^.*[^a-zA-z0-9]{2,}.*$

‫10: أكثر من رمز خاص واحد (لا يشمل الشرطة السفلية)

 
conf_security_password.validation.regex.11=^.*[_]{2,}.*$

‫11: أكثر من شرطة سفلية واحدة

تحدّد القواعد التالية مدى قوة كلمة المرور استنادًا إلى محتواها. تتضمّن كل قاعدة تعبيرًا عاديًا واحدًا أو أكثر من القسم السابق وتحدّد قوة رقمية له. تتم مقارنة القوة الرقمية لكلمة المرور بالرقم conf_security_password.validation.minimum.rating.required في أعلى هذا الملف لتحديد ما إذا كانت كلمة المرور صالحة أم لا.

 
conf_security_password.validation.rule.1=1,AND,0
conf_security_password.validation.rule.2=2,3,4,AND,4
conf_security_password.validation.rule.3=2,9,AND,4
conf_security_password.validation.rule.4=3,9,AND,4
conf_security_password.validation.rule.5=5,6,OR,4
conf_security_password.validation.rule.6=3,2,AND,3
conf_security_password.validation.rule.7=2,9,AND,3
conf_security_password.validation.rule.8=3,9,AND,3

يتم ترقيم كل قاعدة. على سبيل المثال، password.validation.rule.3=... هي القاعدة رقم 3.

تستخدم كل قاعدة التنسيق التالي (على يسار علامة يساوي):

regex-index-list,[AND|OR],rating

‫regex-index-list هي قائمة التعبيرات العادية (حسب الرقم من القسم السابق)، بالإضافة إلى عامل التشغيل AND|OR (أي مراعاة كل التعبيرات المدرَجة أو أي منها).

‫rating هو تقييم القوة الرقمي الممنوح لكل قاعدة.

على سبيل المثال، تعني القاعدة 5 أنّ أي كلمة مرور تحتوي على رمز خاص واحد على الأقل أو شرطة سفلية واحدة تحصل على تقييم قوة 4. عند استخدام password.validation.minimum.rating.required=3 في أعلى الملف، تكون كلمة المرور التي حصلت على تقييم 4 صالحة.

 
conf_security_rbac.password.validation.enabled=true

اضبط التحقّق من كلمة مرور التحكّم في الوصول المستند إلى الدور على "خطأ" عند تفعيل الدخول الموحّد (SSO). القيمة التلقائية هي true.

إعادة ضبط كلمة مرور Cassandra

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

للحصول على معلومات حول كيفية تفعيل مصادقة Cassandra، يُرجى الاطّلاع على تفعيل مصادقة Cassandra.

لإعادة ضبط كلمة مرور Cassandra، عليك اتّباع الخطوات التالية:

  • اضبط كلمة المرور على أي عقدة Cassandra وسيتم بثها إلى جميع عقد Cassandra في الحلقة
  • تحديث خادم الإدارة ومعالجات الرسائل وأجهزة التوجيه وخوادم Qpid وخوادم Postgres على كل عقدة باستخدام كلمة المرور الجديدة

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

لإعادة ضبط كلمة مرور Cassandra، اتّبِع الخطوات التالية:

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

    المكان:

    • ‫cassIP هو عنوان IP لعقدة Cassandra.
    • ‫9042 هو منفذ Cassandra.
    • المستخدم التلقائي هو cassandra.
    • كلمة المرور التلقائية هي cassandra. إذا غيّرت كلمة المرور سابقًا، استخدِم كلمة المرور الحالية.
  2. نفِّذ الأمر التالي في طلب cqlsh> لتعديل كلمة المرور: 
    ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';

    إذا كانت كلمة المرور الجديدة تحتوي على علامة اقتباس مفردة، يمكنك تخطيها عن طريق وضع علامة اقتباس مفردة قبلها.

  3. للخروج من أداة "cqlsh": 
    exit
  4. على عقدة خادم الإدارة، نفِّذ الأمر التالي: 
    /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=CASS_USERNAME
CASS_PASSWORD=CASS_PASSWROD

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

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

تم الآن تغيير كلمة مرور Cassandra.

إعادة ضبط كلمة مرور PostgreSQL

بشكل تلقائي، تحتوي قاعدة بيانات PostgreSQL على مستخدمَين محدَّدَين: "postgres" و "apigee". يستخدم كلا المستخدمَين كلمة المرور التلقائية "postgres". اتّبِع الإجراء التالي لتغيير كلمة المرور التلقائية.

غيِّر كلمة المرور على جميع عُقد Postgres الرئيسية. إذا كان لديك خادما Postgres تم ضبطهما في وضع رئيسي/وضع الاستعداد، فعليك تغيير كلمة المرور على العقدة الرئيسية فقط. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد النسخ المتماثل الرئيسي/الاحتياطي في Postgres.

  1. في عقدة Postgres الرئيسية، غيِّر الأدلة إلى /opt/apigee/apigee-postgresql/pgsql/bin.
  2. اضبط كلمة مرور مستخدم PostgreSQL "postgres":
    1. سجِّل الدخول إلى قاعدة بيانات PostgreSQL باستخدام الأمر: 
      psql -h localhost -d apigee -U postgres
    2. عندما يُطلب منك ذلك، أدخِل كلمة مرور المستخدم "postgres" على أنّها "postgres".
    3. في موجّه أوامر PostgreSQL، أدخِل الأمر التالي لتغيير كلمة المرور التلقائية: 
      ALTER USER postgres WITH PASSWORD 'apigee1234';
    4. اخرج من قاعدة بيانات PostgreSQL باستخدام الأمر: 
      \q
  3. اضبط كلمة مرور مستخدم PostgreSQL "apigee":
    1. سجِّل الدخول إلى قاعدة بيانات PostgreSQL باستخدام الأمر: 
      psql -h localhost -d apigee -U apigee
    2. عندما يُطلب منك ذلك، أدخِل كلمة مرور المستخدم "apigee" على أنّها "postgres".
    3. في موجّه أوامر PostgreSQL، أدخِل الأمر التالي لتغيير كلمة المرور التلقائية: 
      ALTER USER apigee WITH PASSWORD 'NEW_PASSWORD';
    4. اخرج من قاعدة بيانات PostgreSQL باستخدام الأمر: 
      \q
  4. ضبط APIGEE_HOME: 
    export APIGEE_HOME=/opt/apigee/edge-postgres-server
  5. تشفير كلمة المرور الجديدة: 
    sh /opt/apigee/edge-postgres-server/utils/scripts/utilities/passwordgen.sh apigee1234

    يعرض هذا الأمر كلمة المرور المشفّرة كما هو موضّح أدناه. تبدأ كلمة المرور المشفّرة بعد الرمز ":" ولا تتضمّن الرمز ":". 

    Encrypted string:WheaR8U4OeMEM11erxA3Cw==
  6. عدِّل عقدة خادم الإدارة باستخدام كلمات المرور الجديدة المشفّرة للمستخدمَين "postgres" و "apigee".
    1. على خادم الإدارة، غيِّر الدليل إلى /opt/apigee/customer/application.
    2. عدِّل ملف management-server.properties لضبط السمات التالية. إذا لم يكن هذا الملف متوفّرًا، أنشئه.
    3. تأكَّد من أنّ الملف يملكه مستخدم "apigee": 
      chown apigee:apigee management-server.properties
  7. عدِّل جميع عُقد خادم Postgres وخادم Qpid باستخدام كلمة المرور المشفّرة الجديدة.
    1. على عقدة خادم Postgres أو خادم Qpid، غيِّر الدليل إلى /opt/apigee/customer/application.
    2. عدِّل الملفات التالية. إذا لم تكن هذه الملفات متوفّرة، أنشئها:
      • postgres-server.properties
      • qpid-server.properties
    3. أضِف السمات التالية إلى الملفات:
    4. تأكَّد من أنّ الملفات مملوكة للمستخدم "apigee": 
      chown apigee:apigee postgres-server.properties
chown apigee:apigee qpid-server.properties
  8. أعِد تشغيل المكوّنات التالية بهذا الترتيب:
    1. قاعدة بيانات PostgreSQL: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
    2. خادم Qpid: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
    3. خادم Postgres: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
    4. خادم الإدارة: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart