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

אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע

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

הפעלת מכונות 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 restart

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

לנהל את זוגות המפתחות והערכים (KVM) כמו שמתואר בהמשך. מכונות KVM מוגדרות בהיקף הסביבה. לדוגמה, אם יוצרים KVM בסביבת 'test', ל-API proxy שפועלים בסביבת '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 for Public Cloud, שמות המפתחות לא יכולים להיות גדולים מ-2KB.

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

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

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

‫Classic Edge (ענן פרטי)

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

  1. מתחברים אל http://ms-ip:9000, כאשר ms-ip היא כתובת ה-IP או שם ה-DNS של צומת שרת הניהול.
  2. בוחרים באפשרות ממשקי API > הגדרת סביבה > מיפוי ערכי מפתח.
  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.
      ערך

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

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