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

بعد إكمال عملية التثبيت، يمكنك إعادة ضبط كلمات المرور التالية:

• SymasLDAP
• مشرف نظام Apigee Edge
• مستخدم مؤسسة Edge
• Cassandra

تتضمّن الأقسام التالية تعليمات حول إعادة ضبط كل كلمة من كلمات المرور هذه.

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

تعتمد طريقة إعادة ضبط كلمة مرور SymasLDAP على الإعدادات التي تضبطها. استنادًا إلى إعدادات Edge، يمكن تثبيت SymasLDAP على النحو التالي:

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

بالنسبة إلى نسخة واحدة من SymasLDAP مثبّتة على خادم الإدارة، اتّبِع الخطوات التالية:

1. في عقدة Management Server، نفِّذ الأمر التالي لإنشاء كلمة مرور SymasLDAP جديدة:

   /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

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

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

في إعداد النسخ المتماثل من SymasLDAP مع تثبيت SymasLDAP على عقدة غير "خادم الإدارة"، احرص على تغيير كلمة المرور أولاً على كلتا عقدتَي SymasLDAP، ثم على كلتا عقدتَي "خادم الإدارة".

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

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

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

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

1. عدِّل ملف الإعداد التلقائي الذي استخدمته لتثبيت واجهة مستخدم 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 عند إدخال كلمة المرور الجديدة لأنّه تتم إعادة ضبط جميع السمات في واجهة مستخدم Edge الجديدة.

2. في عقدة واجهة مستخدم Edge الجديدة، أوقِف واجهة مستخدم Edge الجديدة:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui stop

3. استخدِم الأداة المساعدة apigee-setup لإعادة ضبط كلمة المرور في واجهة مستخدم Edge الجديدة من ملف الإعداد:

   /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile

4. (فقط إذا كان بروتوكول أمان طبقة النقل (TLS) مفعّلاً في واجهة مستخدم New Edge) أعِد تفعيل بروتوكول أمان طبقة النقل (TLS) في واجهة مستخدم New Edge كما هو موضّح في ضبط بروتوكول أمان طبقة النقل (TLS) لواجهة مستخدم New Edge.
5. على "خادم الإدارة"، أنشئ ملف XML جديدًا. في هذا الملف، اضبط رقم تعريف المستخدم على "admin" وعرِّف كلمة المرور والاسم الأول والاسم الأخير وعنوان البريد الإلكتروني باستخدام التنسيق التالي:

   <User id="admin">
     <Password><![CDATA[password]]></Password>
     <FirstName>first_name</FirstName>
     <LastName>last_name</LastName>
     <EmailId>email_address</EmailId>
   </User>

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

   curl -u "admin_email_address:admin_password" -H \
   "Content-Type: application/xml" -H "Accept: application/json" -X POST \
   "http://localhost:8080/v1/users/admin_email_address" -d @your_data_file
   

   حيث your_data_file هو الملف الذي أنشأته في الخطوة السابقة.

   يعدّل Edge كلمة مرور المشرف على "خادم الإدارة".

7. احذف ملف XML الذي أنشأته. يجب عدم تخزين كلمات المرور بشكل دائم في نص عادي.

في بيئة النسخ المتماثل لـ SymasLDAP التي تتضمّن عدة خوادم إدارة، تؤدي إعادة ضبط كلمة المرور على أحد خوادم الإدارة إلى تعديل خادم الإدارة الآخر تلقائيًا. ومع ذلك، عليك تحديث جميع عُقد واجهة مستخدم New 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

cp ~/Documents/tmp/hybrid_root/apigeectl_beta2_a00ae58_linux_64/README.md 
  ~/Documents/utilities/README.md

في ما يلي مثال على ملف إعدادات يمكنك استخدامه مع الخيار "-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

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

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

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

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

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

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

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

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

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

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

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

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

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

conf_security_rbac.password.validation.enabled=true

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

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

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

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

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

لمزيد من المعلومات، يُرجى الاطّلاع على أوامر CQL.

لإعادة ضبط كلمة مرور 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. على عُقدة Management Server، نفِّذ الأمر التالي:

   /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 'new_password';

      في حال نجاح العملية، يستجيب PostgreSQL بما يلي:

      ALTER ROLE

   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

   يمكنك ضبط كلمات مرور مستخدمي postgres وapigee على القيمة نفسها أو على قيم مختلفة.

4. المجموعة APIGEE_HOME:

   export APIGEE_HOME=/opt/apigee/edge-postgres-server

5. تشفير كلمة المرور الجديدة:

   sh /opt/apigee/edge-analytics/utils/scripts/utilities/passwordgen.sh new_password

   يعرض هذا الأمر كلمة مرور مشفّرة. تبدأ كلمة المرور المشفرة بعد الحرف ":" ولا تتضمّن هذا الحرف. على سبيل المثال، كلمة المرور المشفرة الخاصة بـ "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. أضِف السمات التالية إلى الملفات:
      • 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. خادم الإدارة:

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