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

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

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

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

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

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

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

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

1. در گره «سرور مدیریت»، فرمان زیر را برای ایجاد گذرواژه جدید 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. فایل پیکربندی بی‌صدایی را که برای نصب New 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 را اضافه کنید زیرا همه خصوصیات در «واسط کاربر Edge جدید» بازنشانی می‌شوند.

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

در محیط تکثیر SymasLDAP با چند «سرور مدیریت»، بازنشانی گذرواژه در یک «سرور مدیریت» به‌طور خودکار «سرور مدیریت» دیگر را به‌روز می‌کند. بااین‌حال، باید همه گره‌های New 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

همچنین می‌توانید از API به‌روزرسانی کاربر برای تغییر گذرواژه کاربر استفاده کنید.

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

از این بخش برای اعمال سطح مطلوب طول و قدرت گذرواژه برای کاربران مدیریت API خود استفاده کنید. این تنظیمات از مجموعه‌ای از عبارت‌های باقاعده ازپیش پیکربندی‌شده (و با شماره منحصربه‌فرد) برای بررسی محتوای گذرواژه (مانند حروف بزرگ، حروف کوچک، اعداد، و نویسه‌های خاص) استفاده می‌کند. این تنظیمات را در فایل /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» و «سرور 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