יצירה ועריכה של מפות של ערכי מפתח של הסביבה

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X. מידע

בנושא הזה נסביר איך ליצור ולערוך מפות של ערכי מפתח (KVMs) בממשק המשתמש. מכונות ה-KVM שיוצרים בממשק המשתמש מותאמות להיקף הסביבה. מידע נוסף על מכונות KVM ועל היקפים זמין במאמר עבודה עם מפות של ערכי מפתח.

הפעלה של מכונות KVM מוצפנות בממשק המשתמש של Edge עם Edge לענן פרטי

יש תמיכה במכונות KVM מוצפנות ב-Edge for Private Cloud בגרסה 4.17.01 ואילך. עם זאת, התמיכה במכונות KVM מוצפנות בממשק המשתמש של Edge מושבתת כברירת מחדל. כדי לאפשר לממשק המשתמש של Edge לתמוך במכונות KVM מוצפנות:

  1. בשרת ממשק המשתמש של Edge, פותחים את הקובץ ui.properties בכלי עריכה. אם הקובץ לא קיים, יוצרים אותו:
    > vi /opt/apigee/customer/application/ui.properties
  2. מגדירים את האסימון conf_apigee_apigee.feature.kvmencryption כ-true:
    conf_apigee_apigee.feature.kvmencryption=true
  3. שומרים את השינויים.
  4. משנים את הבעלים של ui.properties ל-"apigee":
    > chown apigee:apigee /opt/apigee/customer/application/ui.properties
  5. מפעילים מחדש את ממשק המשתמש של Edge:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-ui הפעלה מחדש

ניהול של מיפוי ערכי המפתח של הסביבה

מנהלים את מכונות ה-KVM לפי ההוראות שבהמשך. מכונות KVM מוגדרות בהיקף environment. לדוגמה, אם יוצרים KVM בסביבת הבדיקה, לשרתי proxy של API שפועלים בסביבה prod לא תהיה גישה ל-KVM.

Edge

כדי לנהל מכונות KVM באמצעות ממשק המשתמש של Edge:

  1. נכנסים לאתר apigee.com/edge.
  2. בסרגל הניווט הימני, בוחרים באפשרות ניהול > סביבות > מפות של ערכי מפתח.
  3. כדי ליצור KVM:
    1. לוחצים על + מפת ערך מפתח.
    2. מזינים את ערכי המאפיינים ל-KVM החדש. הטבלה הבאה מתארת את ההגדרות.
      שם הנכס התיאור
      שם שם ה-KVM. חייב להיות ייחודי בסביבה. צריך להפנות לשם הזה מכללי מדיניות שמקיימים אינטראקציה עם ה-KVM.
      מוצפנתסימון שמציין אם ה-KVM מוצפן. בממשק המשתמש יופיעו ערכים מוצפנים ככוכביות (*****). ההצפנה מוגדרת בכל המפה. לא ניתן להגדיר רשומת הצפנה לפי רשומה.
      הערה: אפשר להצפין מכונות KVM רק כשיוצרים אותן. לא ניתן להצפין או לפענח מפה של ערך המפתח אחרי שהיא נוצרה.
    3. לוחצים על הוספה.
  4. כדי להוסיף רשומה ל-KVM:
    1. לוחצים על שם ה-KMV ברשימה כדי להציג את הערכים הנוכחיים.
    2. לוחצים על הסימן +.
    3. מזינים את ערכי המאפיינים עבור רשומת ה-KVM החדשה, כפי שמתואר בהמשך.
      שם הנכס התיאור
      מפתח

      שם מפתח שבו תשתמש כדי לגשת לערך הנתונים בשרתי ה-proxy של ה-API.

      ב-Apigee Edge לענן הציבורי, שמות מפתחות לא יכולים להיות גדולים מ-2KB.

      בממשק המשתמש של Edge, השמות לא יכולים להכיל "/".
      Value

      הערך של המפתח. צריך להזין כל שילוב של מספרים, אותיות או תווים מיוחדים.

      הערה: הגודל הכולל של KVM לא יכול להיות גדול מ-15MB.
    4. לוחצים על הוספה.
  5. כדי לנהל את רשומות המפתח ב-KVM:
    1. לוחצים על שם ה-KVM ברשימה כדי להציג את הערכים הנוכחיים.
    2. ממקמים את הסמן מעל רשומת ה-KVM כדי להציג את תפריט הפעולות ומבצעים אחת מהמשימות הבאות:
      • כדי להעתיק את הערך של רשומה, לוחצים על ה-.
      • כדי לערוך רשומה, לוחצים על . לאחר מכן, עורכים את הרשומה ולוחצים על עדכון.
      • כדי למחוק רשומה, לוחצים על . לאחר מכן, לוחצים על מחיקה כדי לאשר את הפעולה.

Classic Edge (ענן פרטי)

כדי ליצור ולערוך מכונות KVM באמצעות ממשק המשתמש הקלאסי Edge:

  1. נכנסים אל http://ms-ip:9000. ms-ip הוא כתובת ה-IP או שם ה-DNS של הצומת של שרת הניהול.
  2. בוחרים באפשרות APIs > Environment Configuration > Key Value Maps.
  3. בוחרים את הסביבה שעבורה רוצים להגדיר מטמון, למשל test או prod.
  4. כדי ליצור KVM:
    1. לוחצים על + מפת ערכי מפתח.
    2. מזינים את ערכי המאפיינים עבור ה-KVM החדש, כפי שמתואר בהמשך.
      שם הנכס התיאור
      שם שם ה-KVM. חייב להיות ייחודי בסביבה. צריך להפנות לשם הזה מכללי מדיניות שמקיימים אינטראקציה עם ה-KVM.
      מוצפנתסימון שמציין אם ה-KVM מוצפן. בממשק המשתמש יופיעו ערכים מוצפנים ככוכביות (*****). ההצפנה מוגדרת בכל המפה. לא ניתן להגדיר רשומת הצפנה לפי רשומה.
      הערה: אפשר להצפין מכונות KVM רק כשיוצרים אותן. לא ניתן להצפין או לפענח מפה של ערך המפתח אחרי שהיא נוצרה.
    3. לוחצים על הוספה.
  5. כדי להוסיף רשומה ל-KVM:
    1. לוחצים על השם של ה-KVM ברשימה כדי להרחיב את רשימת הרשומות שלו.
    2. לוחצים על + רשומה.
    3. מזינים את ערכי המאפיינים עבור רשומת ה-KVM החדשה, כפי שמתואר בהמשך.
      שם הנכס התיאור
      מפתח

      שם מפתח שבו תשתמש כדי לגשת לערך הנתונים בשרתי ה-proxy של ה-API. בממשק המשתמש של Edge, השמות לא יכולים להכיל "/".

      הערה: ב-Edge for Public Cloud, שמות מפתחות לא יכולים להיות גדולים מ-2KB.
      Value

      הערך של המפתח. צריך להזין כל שילוב של מספרים, אותיות או תווים מיוחדים.

      הערה: הגודל הכולל של KVM לא יכול להיות גדול מ-15MB.
    4. לוחצים על שמירה.
  6. כדי לערוך או למחוק את רשומות המפתח ב-KVM:
    1. לוחצים על השם של ה-KVM ברשימה כדי להרחיב את רשימת רשומות המפתח שלו.
    2. מבצעים אחת מהפעולות הבאות:
      • כדי לערוך רשומה, לוחצים על עריכה, עורכים אותה ולוחצים על שמירה.
      • כדי למחוק רשומה, לוחצים על מחיקה.