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

Edge for Private Cloud v4.18.01

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

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

بسته به پیکربندی Edge، می‌توانید OpenLDAP را به‌صورت زیر نصب کنید:

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

نحوه بازنشانی گذرواژه 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
    SMTPMAILFROM="My Company <myco@company.com>"

    توجه داشته باشید که هنگام انتقال گذرواژه جدید باید ویژگی‌های SMTP را اضافه کنید زیرا همه ویژگی‌های میانای کاربری بازنشانی می‌شوند.
  4. از ابزار apigee-setup برای بازنشانی گذرواژه در «میانای کاربری Edge» از فایل پیکربندی استفاده کنید:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
  5. (فقط درصورتی‌که «امنیت لایه انتقال» در «واسط کاربر» فعال باشد) «امنیت لایه انتقال» را در «واسط کاربر Edge» همان‌طور که در پیکربندی «امنیت لایه انتقال» برای «واسط کاربر مدیریت» توضیح داده شده است دوباره فعال کنید.

در محیط تکثیر 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

همچنین می‌توانید از 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

از این موارد برای تعیین ویژگی‌های کلی گذرواژه‌های معتبر استفاده کنید. حداقل رده‌بندی پیش‌فرض برای قدرت گذرواژه (که در ادامه جدول توضیح داده شده است) ۳ است.

توجه داشته باشید که password.validation.default.rating=2 از حداقل رده‌بندی موردنیاز پایین‌تر است، یعنی اگر گذرواژه‌ای که وارد می‌شود خارج از قوانین پیکربندی‌شده شما باشد، رده‌بندی گذرواژه ۲ می‌شود و بنابراین نامعتبر است (پایین‌تر از حداقل رده‌بندی ۳).

در زیر عبارات باقاعده‌ای آورده شده است که ویژگی‌های گذرواژه را شناسایی می‌کنند. توجه داشته باشید که هرکدام شماره‌گذاری شده است. برای مثال، «password.validation.regex.5=…» عبارت شماره ۵ است. از این اعداد در بخش بعدی فایل برای تنظیم ترکیب‌های مختلفی که قدرت کلی گذرواژه را تعیین می‌کنند استفاده خواهید کرد.

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.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=…» قانون شماره ۳ است.

هر قانون از قالب زیر استفاده می‌کند (سمت راست علامت مساوی):

<regex-index-list>,<AND|OR>,<rating>

regex-index-list فهرست عبارات باقاعده (براساس شماره از بخش قبلی)، همراه با عملگر AND|OR (یعنی، همه یا هریک از عبارات فهرست‌شده را درنظر بگیر) است.

رده‌بندی عبارت است از رده‌بندی قدرت عددی که به هر قانون داده می‌شود.

برای مثال، قانون ۵ یعنی هر گذرواژه‌ای که حداقل یک نویسه خاص یا یک زیرخط داشته باشد، رده قدرت ۴ را دریافت می‌کند. با password.validation.minimum.
rating.required=3 در بالای فایل، گذرواژه‌ای با رده‌بندی ۴ معتبر است.

conf_security_rbac.password.validation.enabled=true

وقتی ورود به سیستم یکپارچه (SSO) فعال است، اعتبارسنجی گذرواژه کنترل دسترسی نقش‌مبنا را روی نادرست تنظیم کنید. پیش‌فرض درست است.

درحال بازنشانی گذرواژه 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. بااستفاده از ابزار 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> اجرا کنید:
    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. مرحله ۴ را برای موارد زیر تکرار کنید:
    • همه پردازنده‌های پیام
    • همه رهیاب‌ها
    • همه سرورهای Qpid (edge-qpid-server)
    • سرورهای Postgres (edge-postgres-server)
  6. در گره BaaS Stack برای نسخه ۴.۱۶.۰۵.۰۴ و نسخه‌های جدیدتر:
    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 Stack مقدار را به‌عنوان رمزگذاری‌نشده تفسیر می‌کند.

      توجه: هر گره «پشته BaaS» کلید منحصربه‌فرد خود را دارد که برای رمزگذاری گذرواژه استفاده می‌شود. بنابراین، باید مقدار رمزگذاری‌شده را در هر گره BaaS Stack به‌صورت جداگانه تولید کنید.
    3. مالکیت فایل usergrid.properties را به کاربر «apigee» تغییر دهید:
      > chown apigee:apigee /opt/apigee/customer/application/usergrid.properties
    4. پیکربندی گره «پشته»:
      > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid configure
    5. بازراه‌اندازی پشته BaaS:
      > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid restart
    6. این مراحل را برای همه گره‌های BaaS Stack تکرار کنید.

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

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

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

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

  1. در گره Master 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. سرور مدیریت:
      > /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart