بازنشانی گذرواژه‌های Edge

پس‌از تکمیل نصب، می‌توانید گذرواژه‌های زیر را بازنشانی کنید:

• OpenLDAP
• سرپرست سیستم Apigee Edge
• کاربر سازمان Edge
• Cassandra

دستورالعمل‌های بازنشانی هرکدام از این گذرواژه‌ها در بخش‌های زیر آمده است.

بازنشانی گذرواژه ال‌دپ باز

نحوه بازنشانی گذرواژه OpenLDAP به پیکربندی شما بستگی دارد. بسته به پیکربندی Edge، می‌توان OpenLDAP را به‌صورت زیر نصب کرد:

• یک نمونه از OpenLDAP نصب‌شده در گره «سرور مدیریت». برای مثال، در پیکربندی Edge با ۲ گره، ۵ گره، یا ۹ گره.
• چند نمونه OpenLDAP نصب‌شده در گره‌های «سرور مدیریت»، پیکربندی‌شده با تکرار OpenLDAP. برای مثال، در پیکربندی Edge با ۱۲ گره.
• چند نمونه ال‌دپ باز که روی گره‌های خودشان نصب شده‌اند و با تکرار ال‌دپ باز پیکربندی شده‌اند. برای مثال، در پیکربندی Edge با ۱۳ گره.

برای یک نمونه از OpenLDAP نصب‌شده در «سرور مدیریت»، مراحل زیر را انجام دهید:

1. در گره Management Server، فرمان زیر را برای ایجاد گذرواژه جدید 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 در گره‌ای غیراز Management Server باشد، مطمئن شوید که ابتدا گذرواژه را در هر دو گره OpenLDAP و سپس در هر دو گره Management Server تغییر دهید.

بازنشانی گذرواژه سرپرست سیستم

برای بازنشانی گذرواژه سرپرست سیستم، باید گذرواژه را در دو جا بازنشانی کنید:

• سرور مدیریت
• رابط کاربری

برای بازنشانی گذرواژه سرپرست سیستم:

1. فایل پیکربندی بی‌صدایی را که برای نصب Edge UI استفاده کردید ویرایش کنید تا ویژگی‌های زیر را تنظیم کنید:

   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 UI را متوقف کنید:

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

3. از ابزار کمکی apigee-setup برای بازنشانی گذرواژه در Edge UI از فایل پیکربندی استفاده کنید:

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

4. (فقط اگر TLS در واسط کاربر فعال باشد) TLS را در واسط کاربر Edge دوباره فعال کنید، همان‌طور که در پیکربندی TLS برای واسط کاربر مدیریت شرح داده شده است.
5. در Management Server، فایل 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 را که ایجاد کرده‌اید حذف کنید. گذرواژه‌ها هرگز نباید به‌صورت متن ساده به‌طور دائم ذخیره شوند.

در محیط تکرار ال‌دپ باز با چند «سرور مدیریت»، بازنشانی گذرواژه در یک «سرور مدیریت» باعث می‌شود «سرور مدیریت» دیگر به‌طور خودکار به‌روز شود. بااین‌حال، باید همه گره‌های Edge UI را جداگانه به‌روز کنید.

بازنشانی گذرواژه کاربر سازمان

برای بازنشانی گذرواژه کاربر سازمان، از ابزار کمکی 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

سپس می‌توانید با گروه‌بندی ترکیب‌های مختلف عبارت‌های باقاعده، رتبه‌بندی قدرت گذرواژه را تنظیم کنید. برای مثال، می‌توانید تعیین کنید که گذرواژه‌ای با حداقل یک حرف بزرگ و یک حرف کوچک رده‌بندی استحکام «۳» را دریافت کند، اما گذرواژه‌ای با حداقل یک حرف کوچک و یک عدد رده‌بندی قوی‌تر «۴» را دریافت کند.

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 جدیدی ایجاد کنید. بااستفاده از دستورات Cassandra CREATE/ALTER/DROP USER، کاربران را اضافه، حذف، و اصلاح کنید.

برای اطلاعات درباره نحوه فعال کردن اصالت‌سنجی Cassandra، به فعال کردن اصالت‌سنجی Cassandra مراجعه کنید.

برای بازنشانی گذرواژه Cassandra، باید:

• گذرواژه را در هریک از گره‌های Cassandra تنظیم کنید تا به همه گره‌های Cassandra در حلقه همه‌فرستی شود
• «سرور مدیریت»، «پردازشگرهای پیام»، «مسیریاب‌ها»، سرورهای Qpid، و سرورهای Postgres را در هر گره با گذرواژه جدید به‌روز کنید

برای اطلاعات بیشتر، فرمان‌های CQL را ببینید.

برای بازنشانی گذرواژه Cassandra:

1. بااستفاده از ابزار cqlsh و اطلاعات کاربری پیش‌فرض، به سیستم یکی از گره‌های Cassandra وارد شوید. فقط باید گذرواژه را در یک گره 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. مرحله ۴ را در این دستگاه‌ها تکرار کنید:
   • همه پردازشگرهای پیام
   • همه رهیاب‌ها
   • همه سرورهای Qpid‏ (edge-qpid-server)
   • سرورهای Postgres‏ (edge-postgres-server)

گذرواژه Cassandra اکنون تغییر کرده است.

بازنشانی گذرواژه PostgreSQL

به‌طور پیش‌فرض، پایگاه داده PostgreSQL دو کاربر تعریف‌شده دارد: postgres و apigee. گذرواژه پیش‌فرض هر دو کاربر postgres است. برای تغییر گذرواژه پیش‌فرض، از روش زیر استفاده کنید.

گذرواژه را در همه گره‌های اصلی Postgres تغییر دهید. اگر دو سرور Postgres را در حالت اصلی/آماده‌به‌کار پیکربندی کرده‌اید، فقط باید گذرواژه را در گره اصلی تغییر دهید. برای اطلاعات بیشتر، راه‌اندازی تکرار اصلی-آماده‌به‌کار برای Postgres را ببینید.

1. در گره Master Postgres، دایرکتوری‌ها را به /opt/apigee/apigee-postgresql/pgsql/bin تغییر دهید.
2. گذرواژه کاربر postgres PostgreSQL را تنظیم کنید:
   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. گذرواژه کاربر apigee PostgreSQL را تنظیم کنید:
   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 Server و Qpid Server را با گذرواژه رمزگذاری‌شده جدید به‌روز کنید.
   1. در گره Postgres Server یا Qpid Server، به فهرست راهنمای زیر بروید:

      /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. به گره‌ای که مؤلفه apigee-sso در آن درحال اجرا است متصل شوید یا به سیستم آن وارد شوید. به این سرور، سرور ورود یکپارچه نیز گفته می‌شود.

      در نصب‌های AIO یا ۳-گره‌ای، این گره همان گره «سرور مدیریت» است.

      اگر چند گره دارید که مؤلفه 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. این مراحل را برای هر سرور «ورود تک‌باره» تکرار کنید.
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