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

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

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

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

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

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

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

بالنسبة إلى مثيل واحد من 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 لضبط السمات التالية:

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

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

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

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

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

4. (فقط في حال تفعيل بروتوكول أمان طبقة النقل (TLS) في واجهة المستخدم) أعِد تفعيل بروتوكول أمان طبقة النقل (TLS) في واجهة مستخدم Edge كما هو موضّح في ضبط بروتوكول أمان طبقة النقل (TLS) لواجهة مستخدم الإدارة.
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 الذي أنشأته. يجب عدم تخزين كلمات المرور بشكل دائم في نص عادي.

في بيئة النسخ المماثل لـ 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

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 على كل عقدة باستخدام كلمة المرور الجديدة

لمزيد من المعلومات، يُرجى الاطّلاع على 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 '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. تحديث مكوّن الدخول المُوحَّد (SSO) (في حال تفعيل الدخول المُوحَّد):

   1. اتصِل بالعقدة التي يعمل عليها مكوّن apigee-sso أو سجِّل الدخول إليها. ويُشار إليه أيضًا باسم خادم الدخول المُوحَّد (SSO).

      في عمليات التثبيت على جهاز واحد أو على 3 عُقد، تكون هذه العقدة هي نفسها عقدة خادم الإدارة.

      إذا كان لديك عدة عُقد تشغّل مكوّن apigee-sso، عليك تنفيذ هذه الخطوات على كل عقدة.

   2. افتح الملف التالي للتعديل:

      /opt/apigee/customer/application/sso.properties 

      إذا لم يكن الملف متوفّرًا، أنشِئه.

   3. أضِف السطر التالي إلى الملف:

      conf_uaa_database_password=new_password_in_plain_text

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

      conf_uaa_database_password=apigee1234

   4. نفِّذ الأمر التالي لتطبيق تغييرات الإعدادات على مكوّن apigee-sso:

      /opt/apigee/apigee-service/bin/apigee-service apigee-sso configure

   5. كرِّر هذه الخطوات لكل خادم SSO.
9. أعِد تشغيل المكوّنات التالية بالترتيب التالي:
   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

   5. خادم الدخول الموحّد (SSO):

      /opt/apigee/apigee-service/bin/apigee-service apigee-sso restart