تکالیف نگهداری SymasLDAP

مکان فایل گزارش

فایل‌های گزارش SymasLDAP در فهرست راهنمای /opt/apigee/var/log قرار دارند. این فایل‌ها می‌توانند به‌صورت دوره‌ای بایگانی و حذف شوند تا مطمئن شویم فضای دیسک بیش‌ازحد اشغال نمی‌کنند. اطلاعات مربوط به نگهداری، بایگانی، و برداشتن گزارش‌های SymasLDAP را می‌توانید در بخش ۱۹.۲ دفترچه راهنمای SymasLDAP در https://kb.symas.com/configuration/logging-configuration پیدا کنید.

گذرواژه کاربر را به‌صورت دستی تنظیم کنید

کاربران می‌توانند گذرواژه جدید Edge را در «واسط کاربر Edge» درخواست کنند. سپس کاربر ایمیلی حاوی اطلاعاتی درباره تنظیم گذرواژه دریافت می‌کند. بااین‌حال، اگر سرور SMTP شما ازکار افتاده است، یا کاربر نمی‌تواند به هر دلیلی ایمیل دریافت کند، می‌توانید بااستفاده از دستورات SymasLDAP گذرواژه کاربر را به‌صورت دستی تنظیم کنید.

برای تنظیم گذرواژه کاربر:

  1. برای بارگیری اطلاعات کاربر، از ldapsearch استفاده کنید: 
    /opt/symas/bin/ldapsearch -w ldapAdminPWord -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h LDAP_IP -p 10389 > ldap.txt
  2. نشانی ایمیل کاربر را در فایل ldap.txt جستجو کنید. باید یک بلوک به این شکل ببینید: 
    dn: uid=29383a67-9279-4aa8-a75b-cfbf901578fc,ou=users,ou=global,dc=apigee,dc=com
mail: foo@bar.com
userPassword:: e1NTSEF9a01UUDdSd01BYXRuUURXdXN5OWNPRzBEWWlYZFBRTm14MHlNVWc9PQ==
uid: 29383a67-9279-4aa8-a75b-cfbf901578fc
  3. از ldappasswd برای تنظیم گذرواژه کاربر براساس uid کاربر استفاده کنید: 
    /opt/symas/bin/ldappasswd -h LDAP_IP -p 10389 -D "cn=manager,dc=apigee,dc=com" -W -s newPassWord \
  "uid=29383a67-9279-4aa8-a75b-cfbf901578fc,ou=users,ou=global,dc=apigee,dc=com"

    از شما خواسته می‌شود گذرواژه سرپرست SymasLDAP را وارد کنید.

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

گذرواژه سیستم SymasLDAP را به‌صورت دستی تنظیم کنید

بازنشانی گذرواژه‌های Edge نحوه تغییر گذرواژه سیستم SymasLDAP را توضیح می‌دهد اما لازم است گذرواژه موجود را بدانید. اگر آن گذرواژه را ازدست داده‌اید، می‌توانید از روش زیر برای بازنشانی آن استفاده کنید.

  1. از slappasswd برای ایجاد گذرواژه رمزگذاری‌شده SSHA برای گذرواژه جدید استفاده کنید: 
    /opt/symas/sbin/slappasswd -h {SSHA} -s newPassWord

    این فرمان رشته‌ای را در قالب زیر برمی‌گرداند: 

    {SSHA}+DOup9d6l+czfWzkIvajwYPArjPurhS6
  2. فایل /opt/apigee/data/apigee-symasldap/slapd.d/cn=config/olcDatabase={2}mdb.ldif را در ویرایشگر باز کنید: 
    vi /opt/apigee/data/apigee-symasldap/slapd.d/cn=config/olcDatabase={2}mdb.ldif
  3. خط را در فرم پیدا کنید: 
    olcRootPW:: OldPasswordString
  4. ‫OldPasswordString را با رشته برگشتی از slappasswd جایگزین کنید. اگر بعداز olcRootPw دو نقطه دونقطه وجود دارد، یکی را بردارید و مطمئن شوید بعداز نقطه دونقطه فاصله وجود دارد: 
    olcRootPW: {SSHA}RGon+bLCe+Sk+HyHholFBj8ONQfabrhw
  5. بازراه‌اندازی SymasLDAP: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-symasldap restart
  6. بررسی کنید گذرواژه جدیدتان با ldapsearch کار می‌کند یا نه: 
    /opt/symas/bin/ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h LDAP_IP -p 10389

    از شما خواسته می‌شود گذرواژه سرپرست SymasLDAP را وارد کنید.

  7. این مراحل را در هر سرور SymasLDAP دیگری که برای تکثیر استفاده می‌شود تکرار کنید.
  8. «سرور مدیریت» را به‌روز کنید تا از گذرواژه جدید استفاده کند: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server store_ldap_credentials -p newPassWord

تنظیم دستی گذرواژه سرپرست Edge

بازنشانی گذرواژه‌های Edge نحوه تغییر گذرواژه سیستم Edge را توضیح می‌دهد اما لازم است گذرواژه فعلی را بدانید. اگر گذرواژه سیستم Edge را گم کرده‌اید، می‌توانید از روش زیر برای بازنشانی آن استفاده کنید.

  1. در گره UI، رابط کاربری Edge را متوقف کنید: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui stop
  2. برای تنظیم گذرواژه سرپرست سیستم Edge، از ldappasswd استفاده کنید: 
    /opt/symas/bin/ldappasswd -h localhost -p 10389 -D "cn=manager,dc=apigee,dc=com" -W -s newPassWord \
  "uid=admin,ou=users,ou=global,dc=apigee,dc=com"

    از شما خواسته می‌شود گذرواژه سرپرست SymasLDAP را وارد کنید.

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

حذف فایل قفل SLAPD

اگر هنگام تلاش برای شروع SymasLDAP با خطایی مواجه شدید که فایل قفل slapd.pid وجود دارد، می‌توانید فایل را حذف کنید.

فایل در /opt/apigee/apigee-symasldap/var/run/slapd.pid قرار دارد. فایل را حذف کنید و SymasLDAP را بازراه‌اندازی کنید:

/opt/apigee/apigee-service/bin/apigee-service apigee-symasldap restart

اگر SymasLDAP شروع نمی‌شود، آن را در حالت اشکال‌زدایی شروع کنید و خطاها را بررسی کنید:

/opt/symas/lib/slapd -h ldap://:10389/ -u apigee -d 255 -F /opt/apigee/data/apigee-symasldap/slapd.d

خطاها ممکن است به مشکلات منابع، حافظه، یا مشکلات استفاده از واحد پردازش مرکزی اشاره کنند.

درحال اصلاح کردن همانندسازی SymasLDAP

این بخش نحوه اصلاح همتاسازی SymasLDAP را توضیح می‌دهد.

مراحل روش زیر را در گره تکثیرکننده SymasLDAP که داده‌هایش را در گره SymasLDAP دیگر تکثیر می‌کند انجام دهید. برای مثال، اگر درحال تنظیم تکثیر از گره ۱ به گره ۲ هستید، فرمان‌ها را در گره ۱ اجرا کنید.

  1. وضعیت فعلی را بررسی کنید: 
          /opt/symas/bin/ldapsearch -H ldap://{HOST}:{PORT} -LLL -x -b "cn=config" -D "cn=admin,cn=config" -w {PASSWORD} -o ldif-wrap=no 'olcSyncRepl' | grep olcSyncrepl

    برونداد باید شبیه به موارد زیر باشد:

    olcSyncrepl: {0}rid=001 provider=ldap://{HOST}:{PORT}/ binddn="cn=manager,dc=apigee,dc=com" bindmethod=simple credentials={PASSWORD} searchbase="dc=apigee,dc=com" attrs="*,+" type=refreshAndPersist retry="60 1 300 12 7200 +" timeout=1
  2. فایل repl.lidf را ایجاد کنید و فرمان‌های زیر را در فایل جای‌گذاری کنید: 
    dn: olcDatabase={2}mdb,cn=config
changetype: modify
replace: olcSyncRepl
    olcSyncRepl: rid=001
    provider=ldap://{NEW_HOST}:{PORT}/
    binddn="cn=manager,dc=apigee,dc=com"
    bindmethod=simple
    credentials={PASSWORD}
    searchbase="dc=apigee,dc=com"
    attrs="*,+"
    type=refreshAndPersist
    retry="60 1 300 12 7200 +"
    timeout=1

    مطمئن شوید که مقدار مناسب را برای جای‌بان‌های زیر جایگزین کنید:

    • ‫{NEW_HOST}: میزبان جدید SymasLDAP که قصد دارید در آن تکثیر کنید.
    • ‫{PORT}: درگاه SymasLDAP. درگاه پیش‌فرض 10389 است.
    • ‫{PASSWORD}: گذرواژه SymasLDAP.
  3. فرمان ldapmodify را اجرا کنید: 
          /opt/symas/bin/ldapmodify -x -w {PASSWORD} -D "cn=admin,cn=config" -H "ldap://{HOST}:{PORT}/" -f repl.ldif
    
    The output should be similar to the following:
    
    
    modifying entry "olcDatabase={2}mdb,cn=config"
  4. تأیید تکثیر: 
          /opt/symas/bin/ldapsearch -H ldap://{HOST}:{PORT} -LLL -x -b "cn=config" -D "cn=admin,cn=config" -w {PASSWORD} -o ldif-wrap=no 'olcSyncRepl' | grep olcSyncrepl

    برونداد باید شبیه به موارد زیر باشد: 

    olcSyncrepl: {0}rid=001 provider=ldap://{NEW_HOST}:{PORT}/ binddn="cn=manager,dc=apigee,dc=com" bindmethod=simple credentials={PASSWORD} searchbase="dc=apigee,dc=com" attrs="*,+" type=refreshAndPersist retry="60 1 300 12 7200 +" timeout=1

    می‌توانید با خواندن و مقایسه مقدار contextCSN از هر سرور و اطمینان از مطابقت آن‌ها، درستی عملکرد تکثیر را تأیید کنید.

          /opt/symas/bin/ldapsearch -w {PASSWORD} -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h localhost -p 10389 contextCSN | grep contextCSN

عیب‌یابی مشکلات تکثیر SymasLDAP

اگر نصب شما از چندین سرور SymasLDAP استفاده می‌کند، می‌توانید تنظیمات تکثیر را بررسی کنید تا مطمئن شوید سرورها به‌درستی کار می‌کنند.

  1. مطمئن شوید که ldapsearch داده‌ها را از هر سرور SymasLDAP برمی‌گرداند: 
    /opt/symas/bin/ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h LDAP_IP -p 10389

    از شما خواسته می‌شود گذرواژه سرپرست SymasLDAP را وارد کنید.

  2. پیکربندی تکثیر را با بررسی فایل /opt/apigee/conf/symasldap/slapd.d/cn=config/olcDatabase={2}mdb.ldif بررسی کنید.
  3. مطمئن شوید گذرواژه سیستم در هر سرور OpenLDAP یکسان باشد.
  4. تنظیمات iptables و tcp wrapper را بررسی کنید.