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

الإصدار 4.17.01 من 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 oldPword -n newPword
  2. شغِّل الأمر التالي لتخزين كلمة المرور الجديدة من أجل وصول خادم الإدارة إليها:
    > /opt/apigee/apigee-service/bin/apigee-service edge-management-server store_ldap_credentials -p newPword

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

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

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

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

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

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

تحذير: يجب إيقاف واجهة مستخدم Edge قبل إعادة ضبط كلمة مرور مشرف النظام. بما أنّك أعدت ضبط كلمة المرور أولاً على خادم الإدارة، قد تكون هناك فترة زمنية قصيرة تستمر فيها واجهة المستخدم في استخدام كلمة المرور القديمة. إذا أجرى واجهة المستخدم أكثر من ثلاث مكالمات باستخدام كلمة المرور القديمة، سيقفل خادم 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=newPW
    SMTPHOST=smtp.gmail.com
    SMTPPORT=465
    SMTPUSER=foo@gmail.com
    SMTPPASSWORD=bar
    SMTPSSL=y

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

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

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

لإعادة ضبط كلمة المرور لمستخدم في المؤسسة، استخدِم الأداة المساعدة apigee-servce لاستدعاء 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= adminPword

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

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

استخدِم هذا القسم لفرض مستوى معيّن من طول كلمة المرور وقوتها لمستخدمي إدارة واجهة برمجة التطبيقات. تستخدم الإعدادات سلسلة من التعبيرات العادية التي تم ضبطها مسبقًا (وتم ترقيمها بشكل فريد) للتحقّق من محتوى كلمة المرور (مثل الأحرف الكبيرة والأحرف الصغيرة والأرقام والرموز الخاصة). اكتب هذه الإعدادات في ملف /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 جديد. يمكنك إضافة المستخدمين وإزالتهم وتعديلهم باستخدام عبارات Cassandra CREATE/ALTER/DROP USER.

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

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

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

لمزيد من المعلومات، يُرجى الاطّلاع على 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> لتعديل كلمة المرور:
    cqlsh> ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';

    إذا كانت كلمة المرور الجديدة تحتوي على علامة اقتباس مفردة، يمكنك تجاوزها من خلال وضع علامة اقتباس مفردة قبلها.
  3. اخرج من أداة cqlsh:
    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)
  6. في عقدة 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:
      > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid configure
    5. أعِد تشغيل حزمة BaaS:
      > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid restart
    6. كرِّر هذه الخطوات لجميع عُقد حزمة BaaS.

تم الآن تغيير كلمة مرور 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، أدخِل الأمر التالي لتغيير كلمة المرور التلقائية:
      apigee=> ALTER USER postgres WITH PASSWORD 'apigee1234';
    4. اخرج من قاعدة بيانات PostgreSQL باستخدام الأمر:
      apigee=> \q
  3. اضبط كلمة مرور مستخدم PostgreSQL "apigee":
    1. سجِّل الدخول إلى قاعدة بيانات PostgreSQL باستخدام الأمر:
      > psql -h localhost -d apigee -U apigee
    2. عندما يُطلب منك ذلك، أدخِل كلمة مرور المستخدم "apigee" على أنّها "postgres".
    3. في موجّه أوامر PostgreSQL، أدخِل الأمر التالي لتغيير كلمة المرور التلقائية:
      apigee=> ALTER USER apigee WITH PASSWORD 'apigee1234';
    4. اخرج من قاعدة بيانات PostgreSQL باستخدام الأمر:
      apigee=> \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

    يعرض هذا الأمر كلمة المرور المشفّرة كما هو موضّح أدناه. تبدأ كلمة المرور المشفّرة بعد الرمز ":" ولا تتضمّن الرمز ":".
    سلسلة مشفّرة :WheaR8U4OeMEM11erxA3Cw==
  6. عدِّل عقدة خادم الإدارة باستخدام كلمات المرور الجديدة المشفّرة للمستخدمَين postgres وapigee.
    1. على خادم الإدارة، غيِّر الدليل إلى /opt/apigee/customer/application.
    2. عدِّل الملف management-server.properties لضبط السمات التالية. إذا لم يكن هذا الملف متوفّرًا، أنشئه:
      ملاحظة: تستخدم بعض السمات كلمة مرور مستخدم postgres المشفّرة، بينما تستخدم سمات أخرى كلمة مرور مستخدم apigee المشفّرة.
      • conf_pg-agent_password=newEncryptedPasswordForPostgresUser
      • conf_pg-ingest_password=newEncryptedPasswordForPostgresUser
      • conf_query-service_pgDefaultPwd=newEncryptedPasswordForApigeeUser
      • conf_query-service_dwDefaultPwd=newEncryptedPasswordForApigeeUser
      • conf_analytics_aries.pg.password=newEncryptedPasswordForPostgresUser
    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. أضِف السمات التالية إلى الملفات:
      ملاحظة: تستخدم كل هذه السمات كلمة مرور مستخدم postgres المشفّرة.
      • conf_pg-agent_password=newEncryptedPasswordForPostgresUser
      • conf_pg-ingest_password=newEncryptedPasswordForPostgresUser
      • conf_query-service_pgDefaultPwd=newEncryptedPasswordForPostgresUser
      • conf_query-service_dwDefaultPwd=newEncryptedPasswordForPostgresUser
      • conf_analytics_aries.pg.password=newEncryptedPasswordForPostgresUser
    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. Management Server:
      > /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart