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

Edge for Private Cloud نسخه ۴.۱۶.۰۵

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

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

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

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

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

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

  1. On the Management Server node, run the following command to create the new OpenLDAP password:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-password -o oldPword -n newPword
  2. فرمان زیر را اجرا کنید تا گذرواژه جدید برای دسترسی «سرور مدیریت» ذخیره شود:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server store_ldap_credentials -p newPword

    این فرمان «سرور مدیریت» را بازراه‌اندازی می‌کند.

در راه‌اندازی تکرار OpenLDAP با OpenLDAP نصب‌شده در گره‌های «سرور مدیریت»، مراحل بالا را در هر دو گره «سرور مدیریت» دنبال کنید تا گذرواژه به‌روز شود.

در راه‌اندازی تکرار OpenLDAP که OpenLDAP در گره‌ای غیراز Management Server باشد، مطمئن شوید که ابتدا گذرواژه را در هر دو گره OpenLDAP و سپس در هر دو گره Management Server تغییر دهید.

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

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

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

هشدار: قبل‌از بازنشانی گذرواژه سرپرست سیستم، باید Edge UI را متوقف کنید. چون ابتدا گذرواژه را در «سرور مدیریت» بازنشانی می‌کنید، ممکن است برای مدت کوتاهی واسط کاربر همچنان از گذرواژه قدیمی استفاده کند. اگر واسط کاربر بیش‌از سه تماس بااستفاده از گذرواژه قدیمی برقرار کند، سرور OpenLDAP حساب سرپرست سیستم را به‌مدت سه دقیقه قفل می‌کند.

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

  1. در گره میانای کاربر، Edge UI را متوقف کنید:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-ui stop
  2. در «سرور مدیریت»، فرمان زیر را برای بازنشانی گذرواژه اجرا کنید:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server change_sysadmin_password -o currentPW -n newPW
  3. فایل پیکربندی بی‌صدایی را که برای نصب Edge UI استفاده کردید ویرایش کنید تا ویژگی‌های زیر را تنظیم کنید:
    APIGEE_ADMINPW=newPW
    SMTPHOST=smtp.gmail.com
    SMTPPORT=465
    SMTPUSER=foo@gmail.com
    SMTPPASSWORD=bar
    SMTPSSL=y

    توجه داشته باشید که هنگام ارسال گذرواژه جدید باید ویژگی‌های SMTP را اضافه کنید زیرا همه ویژگی‌های UI بازنشانی می‌شوند.
  4. از ابزار apigee-setup برای بازنشانی گذرواژه در Edge UI از فایل پیکربندی استفاده کنید:
    > /<inst_root>/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
  5. Edge UI را در گره میانای کاربر راه‌اندازی کنید:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-ui start

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

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

برای بازنشانی گذرواژه کاربر سازمان، از ابزار کمکی apigee-servce برای فراخوانی apigee-setup استفاده کنید:

/<inst_root>/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]

برای مثال:

> /<inst_root>/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

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

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

از این بخش برای اعمال سطح مطلوب طول و استحکام گذرواژه برای کاربران مدیریت میانای برنامه‌سازی کاربردی خود استفاده کنید. این تنظیمات از مجموعه‌ای از عبارت‌های باقاعده ازپیش پیکربندی‌شده (و با شماره منحصربه‌فرد) برای بررسی محتوای گذرواژه (مانند حروف بزرگ، حروف کوچک، اعداد، و نویسه‌های خاص) استفاده می‌کند. این تنظیمات را در فایل /<inst_root>/apigee/customer/application/management-server.properties بنویسید. اگر آن فایل وجود ندارد، آن را ایجاد کنید.

پس‌از ویرایش management-server.properties، سرور مدیریت را بازراه‌اندازی کنید:

> /<inst_root>/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) فعال است، اعتبارسنجی گذرواژه کنترل دسترسی نقش‌مبنا را روی «نادرست» تنظیم کنید. پیش‌فرض true است.

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

به‌طور پیش‌فرض، Cassandra با اصالت‌سنجی غیرفعال عرضه می‌شود. اگر اصالت‌سنجی را فعال کنید، از کاربر ازپیش تعریف‌شده‌ای به‌نام «cassandra» با گذرواژه «cassandra» استفاده می‌کند. می‌توانید از این حساب استفاده کنید، گذرواژه دیگری برای این حساب تنظیم کنید، یا کاربر Cassandra جدیدی ایجاد کنید. بااستفاده از دستورات Cassandra CREATE/ALTER/DROP USER، کاربران را اضافه، حذف، و اصلاح کنید.

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

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

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

برای اطلاعات بیشتر، به http://www.datastax.com/documentation/cql/3.0/cql/cql_reference/cqlCommandsTOC.html مراجعه کنید.

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

  1. بااستفاده از ابزار cqlsh و اطلاعات کاربری پیش‌فرض، به سیستم یکی از گره‌های Cassandra وارد شوید. You only have to change the password on one Cassandra node and it will be broadcast to all Cassandra nodes in the ring:
    > /<inst_root>/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p cassandra

    Where:
    • cassIP نشانی IP گره Cassandra است.
    • 9042 درگاه Cassandra است.
    • کاربر پیش‌فرض cassandra است.
    • گذرواژه پیش‌فرض cassandra است. اگر قبلاً گذرواژه را تغییر داده‌اید، از گذرواژه فعلی استفاده کنید.
  2. فرمان زیر را به‌عنوان پیام‌واره cqlsh> برای به‌روزرسانی گذرواژه اجرا کنید:
    cqlsh> ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';

    اگر گذرواژه جدید حاوی نویسه نقل‌قول تکی است، با قرار دادن یک نویسه نقل‌قول تکی قبل‌از آن، آن را گریز دهید.
  3. از ابزار cqlsh خارج شوید:
    cqlsh> exit
  4. در گره «سرور مدیریت»، فرمان زیر را اجرا کنید:
    > /<inst_root>/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 برای نسخه ۴.۱۶.۰۵.۰۴ و جدیدتر:
    1. Run the following command to generate an encrypted password:
      > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid secure_password

      This command prompts you for the plain text password and returns the encrypted password in the form:
      SECURE:ae1b6dedbf6b26aaab8bee815a910737c1c15b55f3505c239e43bc09f8050
    2. نشان‌های زیر را در /opt/apigee/customer/application/usergrid.properties تنظیم کنید. If that file does not exist, create it:
      usergrid-deployment_cassandra.username=cassandra
      usergrid-deployment_cassandra.password=SECURE:ae1b6dedbf6b26aaab8bee815a910737c1c15b55f3505c239e43bc09f8050

      This example uses the default username for Cassandra. اگر نام کاربری را تغییر داده‌اید، مقدار usergrid-deployment_cassandra.username را مطابق با آن تنظیم کنید.

      مطمئن شوید که پیشوند «SECURE:» را در گذرواژه اضافه کرده‌اید. درغیراین‌صورت، BaaS Stack مقدار را به‌عنوان رمزگذاری‌نشده تفسیر می‌کند.

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

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

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

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

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

  1. On the Master Postgres node, change directory to /<inst_root>/apigee/apigee-postgresql/pgsql/bin, where /<inst_root> defaults to /opt.
  2. گذرواژه کاربر «postgres» در PostgreSQL را تنظیم کنید:
    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. گذرواژه کاربر «apigee» در PostgreSQL را تنظیم کنید:
    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=/<inst_root>/apigee/edge-postgres-server
  5. گذرواژه جدید را رمزگذاری کنید:
    > sh /<inst_root>/apigee/edge-postgres-server/utils/scripts/utilities/passwordgen.sh apigee1234

    این فرمان گذرواژه رمزگذاری‌شده را به‌صورت زیر برمی‌گرداند. گذرواژه رمزگذاری‌شده بعداز نویسه «:» شروع می‌شود و شامل «:» نمی‌شود.
    رشته رمزگذاری‌شده :WheaR8U4OeMEM11erxA3Cw==
  6. گره «سرور مدیریت» را با گذرواژه‌های رمزگذاری‌شده جدید برای کاربران «postgres» و «apigee» به‌روز کنید.
    1. در Management Server، دایرکتوری را به /<inst_root>/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 Server و Qpid Server را با گذرواژه رمزگذاری‌شده جدید به‌روز کنید.
    1. در گره Postgres Server یا Qpid Server، دایرکتوری را به /<inst_root>/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:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
    2. Qpid Server:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
    3. سرور Postgres:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
    4. سرور مدیریت:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server restart