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

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

فایل‌های گزارش OpenLDAP در فهرست راهنمای /opt/apigee/var/log قرار دارند. این فایل‌ها می‌توانند به‌صورت دوره‌ای بایگانی و حذف شوند تا مطمئن شویم فضای دیسک بیش‌ازحد اشغال نمی‌کنند. اطلاعات مربوط به نگهداری، بایگانی، و برداشتن گزارش‌های OpenLDAP را می‌توانید در بخش ‫۱۹.۲ دفترچه راهنمای OpenLDAP در http://www.openldap.org/doc/admin24/maintenance.html پیدا کنید.

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

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

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

1. برای بارگیری اطلاعات کاربر، از ldapsearch استفاده کنید:

   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 کاربر استفاده کنید:

   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"

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

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

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

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

1. از slappasswd برای ایجاد گذرواژه رمزگذاری‌شده SSHA برای گذرواژه جدید استفاده کنید:

   slappasswd -h {SSHA} -s newPassWord

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

   {SSHA}+DOup9d6l+czfWzkIvajwYPArjPurhS6

2. فایل /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}bdb.ldif را در ویرایشگر باز کنید:

   vi /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}bdb.ldif

3. خط را در فرم پیدا کنید:

   olcRootPW:: OldPasswordString

4. ‫OldPasswordString را با رشته برگشتی از slappasswd جایگزین کنید. اگر بعداز olcRootPw دو نقطه دونقطه وجود دارد، یکی را بردارید و مطمئن شوید بعداز نقطه دونقطه فاصله وجود دارد:

   olcRootPW: {SSHA}RGon+bLCe+Sk+HyHholFBj8ONQfabrhw

5. بازراه‌اندازی OpenLDAP:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restart

6. بررسی کنید گذرواژه جدیدتان با ldapsearch کار می‌کند یا نه:

   ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h LDAP_IP -p 10389

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

7. این مراحل را در هر سرور OpenLDAP دیگری که برای تکثیر استفاده می‌شود تکرار کنید.
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 استفاده کنید:

   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"

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

3. فایل پیکربندی را که برای نصب «میانای کاربر Edge» استفاده کرده‌اید با گذرواژه جدید سیستم Edge به‌روز کنید:

   APIGEE_ADMINPW=newPassWord

4. پیکربندی و بازراه‌اندازی «میانای کاربر Edge»:

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

5. (فقط درصورتی‌که «امنیت لایه انتقال» در «واسط کاربر» فعال باشد) «امنیت لایه انتقال» را در «واسط کاربر Edge» همان‌طور که در پیکربندی «امنیت لایه انتقال» برای «واسط کاربر مدیریت» توضیح داده شده است دوباره فعال کنید.

حذف فایل قفل SLAPD

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

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

/opt/apigee/apigee-service/bin/apigee-service apigee-openldap restart

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

slapd -h ldap://:10389/ -u apigee -d 255 -F /opt/apigee/data/apigee-openldap/slapd.d

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

درحال اصلاح کردن تکثیر OpenLDAP

این بخش توضیح می‌دهد که چگونه همتاسازی OpenLDAP را تغییر دهید.

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

1. وضعیت فعلی را بررسی کنید:

   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}bdb,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}: میزبان جدید OpenLDAP که قصد دارید در آن تکثیر کنید.
   • ‫{PORT}: درگاه OpenLDAP. درگاه پیش‌فرض 10389 است.
   • ‫{PASSWORD}: گذرواژه OpenLDAP.
3. فرمان ldapmodify را اجرا کنید:

   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}bdb,cn=config"

4. تأیید تکثیر:

   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 از هر سرور و اطمینان از مطابقت آن‌ها، درستی عملکرد تکثیر را تأیید کنید.

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

عیب‌یابی کردن مشکلات مربوط به تکثیر OpenLDAP

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

1. مطمئن شوید که ldapsearch داده‌ها را از هر سرور OpenLDAP برمی‌گرداند:

   ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h LDAP_IP -p 10389

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

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