משימות תחזוקה של SymasLDAP

מיקום קובץ היומן

קובצי היומן של SymasLDAP נמצאים בספרייה /opt/apigee/var/log. אפשר להעביר את הקבצים האלה לארכיון מדי פעם ולהסיר אותם כדי לוודא שהם לא תופסים יותר מדי מקום בכונן. מידע על תחזוקה, ארכיון והסרה של יומני SymasLDAP זמין בקטע 19.2 במדריך 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 -x -H ldap://LDAP_IP: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 -x -H ldap://LDAP_IP: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-openldap/slapd.d/cn=config/olcDatabase={2}mdb.ldif בעורך: 
    vi /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}mdb.ldif
  3. מוצאים את השורה בטופס: 
    olcRootPW:: OldPasswordString
  4. מחליפים את OldPasswordString במחרוזת שהתקבלה מ-slappasswd. אם יש 2 נקודתיים אחרי olcRootPw, מסירים אחת ומוודאים שיש רווח אחרי הנקודתיים: 
    olcRootPW: {SSHA}RGon+bLCe+Sk+HyHholFBj8ONQfabrhw
  5. מפעילים מחדש את SymasLDAP: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restart
  6. כדי לבדוק אם הסיסמה החדשה פועלת, נכנסים ל-ldapsearch: 
    /opt/symas/bin/ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -x -H ldap://LDAP_IP: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. בצומת של ממשק המשתמש החדש של Edge, עוצרים את ממשק המשתמש החדש של Edge: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui stop
  2. משתמשים ב-ldappasswd כדי להגדיר את הסיסמה של מנהל המערכת של Edge: 
    /opt/symas/bin/ldappasswd -x -H ldap://localhost: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 ue -f configFile
  5. (רק אם TLS מופעל בממשק המשתמש החדש של Edge) מפעילים מחדש את TLS בממשק המשתמש החדש של Edge כמו שמתואר במאמר הגדרת TLS בממשק המשתמש החדש של Edge.

מחיקת קובץ הנעילה של SLAPD

אם מופיעה שגיאה כשמנסים להפעיל את SymasLDAP, שלפיה קובץ הנעילה slapd.pid קיים, אפשר למחוק את הקובץ.

הקובץ נמצא במיקום /opt/apigee/apigee-openldap/var/run/slapd.pid. מוחקים את הקובץ ומנסים להפעיל מחדש את SymasLDAP:

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

אם SymasLDAP לא מתחיל, נסו להפעיל אותו במצב ניפוי באגים ובדקו אם יש שגיאות:

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

שגיאות יכולות להצביע על בעיות במשאבים, בזיכרון או בניצול המעבד.

שינוי הרפליקציה של SymasLDAP

בקטע הזה מוסבר איך לשנות את הרפליקציה של SymasLDAP.

מבצעים את השלבים הבאים בצומת הרפליקציה של SymasLDAP, שמשכפל את הנתונים שלו לצומת השני של SymasLDAP. לדוגמה, אם אתם מגדירים שכפול מ-node1 ל-node2, הריצו את הפקודות ב-node1.

  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.ldif ומדביקים בו את הפקודות הבאות: 
    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

    חשוב להחליף את ה-placeholders הבאים בערכים המתאימים:

    • ‫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

    הפלט אמור להיראות כך:

    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 -x -H ldap://localhost: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 -x -H ldap://LDAP_IP:10389

    תתבקשו להזין את סיסמת האדמין של SymasLDAP.

  2. בודקים את הגדרות הרפליקציה בקובץ /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}mdb.ldif.
  3. חשוב לוודא שהסיסמה של המערכת זהה בכל שרת OpenLDAP.
  4. בודקים את ההגדרות של iptables ו-tcp wrapper.