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

אתם צופים במסמכי העזרה של Apigee Edge.
כניסה למסמכי העזרה של Apigee X.
info

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

הפעלת מכונות KVM מוצפנות בממשק המשתמש של Edge באמצעות Edge for Private Cloud

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

  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 restart

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

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

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, כפי שמתואר בהמשך.
      שם הנכס תיאור
      מפתח

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

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

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

      ערך

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

      הערה: הגודל הכולל של קובץ 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, כפי שמתואר בהמשך.
      שם הנכס תיאור
      מפתח

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

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

      ערך

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

      הערה: הגודל הכולל של קובץ KVM לא יכול לחרוג מ-15MB.

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