נדרשת הגדרה של פרטי הכניסה למערכת ה-Sysadmin

Edge for Private Cloud גרסה 4.17.09

בפעם הראשונה שהתקנתם את Edge, נוצר סוג מיוחד של משתמש שנקרא sysadmin, ובמקביל עודכנו כמה קובצי תצורה נוספים עם פרטי המשתמש הזה. אם אתם מגדירים את שרת ה-LDAP החיצוני לאימות באמצעות שם משתמש שהוא לא כתובת אימייל, או אם יש לכם סיסמה אחרת בשרת ה-LDAP החיצוני למשתמש ה-sysadmin הזה, תצטרכו לבצע את השינויים שמתוארים בקטע הזה.

יש שני מקומות שצריך לעדכן:

  • ממשק המשתמש של Edge מתחבר לשרת הניהול באמצעות פרטי כניסה שמאוחסנים בצורה מוצפנת בקובץ תצורה בממשק המשתמש של Edge. צריך לבצע את העדכון הזה אם שם המשתמש או הסיסמה של משתמש ה-sysadmin שונים.
  • ‫Edge שומר את שם המשתמש של ה-sysadmin בקובץ אחר, שמשמש להרצת סקריפטים שונים של שירותים. צריך לעדכן את שם המשתמש רק אם הוא שונה משם המשתמש של ה-sysadmin.

שינוי הסיסמה של ממשק המשתמש של Edge

הדרך שבה משנים את הסיסמה של ממשק המשתמש של Edge תלויה באופן שבו שרת ה-LDAP החיצוני מייצג שמות משתמשים:

  • אם שמות המשתמשים הם כתובות אימייל, משתמשים בכלי setup.sh כדי לעדכן את ממשק המשתמש של Edge.
  • אם שמות המשתמשים הם מזהים, במקום כתובת אימייל, צריך להשתמש בקריאות ל-API ובקובצי מאפיינים כדי לעדכן את ממשק המשתמש של Edge.

שני התהליכים מתוארים בהמשך.

שינוי פרטי הכניסה לממשק המשתמש של Edge לכתובת אימייל

  1. עורכים את קובץ התצורה השקט שבו השתמשתם כדי להתקין את ממשק המשתמש של Edge, כדי להגדיר את המאפיינים הבאים:
    ADMIN_EMAIL=newUser
    APIGEE_ADMINPW=newPW
    SMTPHOST=smtp.gmail.com
    SMTPPORT=465
    SMTPUSER=foo@gmail.com
    SMTPPASSWORD=bar
    SMTPSSL=y
    SMTPMAILFROM="My Company <myco@company.com>"

    שימו לב שצריך לכלול את מאפייני ה-SMTP כשמעבירים את הסיסמה החדשה, כי כל המאפיינים בממשק המשתמש מאופסים.
  2. משתמשים בכלי apigee-setup כדי לאפס את הסיסמה בממשק המשתמש של Edge מקובץ התצורה:
    > ‎/opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile

שינוי פרטי הכניסה לממשק המשתמש של Edge למזהה משתמש

  1. מצפינים את מזהה המשתמש והסיסמה:
    > java -cp "/opt/apigee/edge-ui/conf:/opt/apigee/edge-ui/lib/*" utils.EncryptUtil 'userName:PWord'
  2. פותחים את הקובץ ui.properties בכלי עריכה. אם הקובץ לא קיים, יוצרים אותו:
    > vi /opt/apigee/customer/application/ui.properties
  3. ב-ui.properties, מגדירים את האסימון conf_apigee_apigee.mgmt.credential לערך שהוחזר בקריאה בשלב 1:
    conf_apigee_apigee.mgmt.credential="STRING_RETURNED_IN_STEP_1"
  4. מגדירים את הבעלים של ui.properties ל-"apigee":
    > chown apigee:apigee /opt/apigee/customer/application/ui.properties
  5. מפעילים מחדש את ממשק המשתמש של Edge:
    > /opt/ apigee/apigee-service/bin/apigee-service edge-ui restart

בדיקת ההגדרות האישיות

  1. פותחים את ממשק המשתמש לניהול בדפדפן בכתובת:
    http://<management-server-IP>:9000/

    לדוגמה:
    http://192.168.52.100:9000/
  2. מתחברים באמצעות פרטי הכניסה החדשים. אם ההתחברות מצליחה, סימן שההגדרות נכונות.

עריכת מאגר שמות המשתמשים של מנהל המערכת של Edge עבור סקריפטים של כלי שירות של Apigee

  1. עורכים את קובץ התצורה השקט שבו השתמשתם כדי להתקין את ממשק המשתמש של Edge, כדי להגדיר את המאפיין הבא לשינוי הערך של ADMIN_EMAIL לשם המשתמש שבו תשתמשו למשתמש sysadmin ב-LDAP החיצוני:
    APIGEE_EMAIL=newUser
     ?IS_EXTERNAL_AUTH="true"

    המאפיין IS_EXTERNAL_AUTH מגדיר את Edge כך שיתמוך בשם חשבון, ולא בכתובת אימייל, כשם המשתמש.
  2. משתמשים בכלי apigee-setup כדי לאפס את שם המשתמש בכל רכיבי Edge מקובץ התצורה:
    > /opt/apigee/apigee-setup/bin/setup.sh -p edge -f configFile

    צריך להריץ את הפקודה הזו בכל רכיבי Edge בכל צומתי Edge, כולל: שרת הניהול, הנתב, מעבד הבקשות, Qpid ו-Postgres.

בדיקת ההגדרות האישיות

מוודאים שיש לכם גישה ל-POD המרכזי. בשרת הניהול, מריצים את פקודת ה-CURL הבאה:

> curl -u sysAdminEmail:password http://localhost:8080/v1/servers?pod=central

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

[ {
 "internalIP" : "192.168.1.11",
 "isUp" : true,
 "pod" : "central",
 "reachable" : true,
 "region" : "dc-1",
 "tags" : {
   "property" : [ ]
 },
 "type" : [ "application-datastore", "scheduler-datastore", "management-server", "auth-datastore", "apimodel-datastore", "user-settings-datastore", "audit-datastore" ],
 "uUID" : "d4bc87c6-2baf-4575-98aa-88c37b260469"
}, {
 "externalHostName" : "localhost",
 "externalIP" : "192.168.1.11",
 "internalHostName" : "localhost",
 "internalIP" : "192.168.1.11",
 "isUp" : true,
 "pod" : "central",
 "reachable" : true,
 "region" : "dc-1",
 "tags" : {
   "property" : [ {
     "name" : "started.at",
     "value" : "1454691312854"
   }, ... ]
 },
 "type" : [ "qpid-server" ],
 "uUID" : "9681202c-8c6e-4da1-b59b-23e3ef092f34"
} ]