שלב 1: יצירת proxy ל-API

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

בקטע הזה מוסבר איך ליצור שרת proxy פשוט ל-API.

Edge

כדי ליצור proxy ל-API באמצעות ממשק המשתמש של Edge:

  1. נכנסים לחשבון בכתובת apigee.com/edge.
  2. בחלון הראשי, לוחצים על API Proxies (שרתי proxy ל-API):

  3. לוחצים על +Proxy (שרת proxy).

    יצירת שרת Proxy

    מערכת Apigee מנחה אתכם בתהליך של יצירת שרת proxy חדש. קודם בוחרים את סוג ה-proxy:

  4. לוחצים על שרת proxy הפוך (הנפוץ ביותר).

    מוצג הדף Proxy details.

  5. מגדירים את פרטי ה-Proxy באופן הבא:
    • שם: מזינים getstarted. אם כבר קיים שרת proxy עם השם הזה, צריך להשתמש בשם אחר.
    • נתיב בסיס: מוודאים שהנתיב מוגדר ל-/getstarted.

      נתיב הבסיס הוא חלק מכתובת ה-URL שמשמשת לשליחת בקשות ל-API. ‫Edge משתמש בכתובת ה-URL כדי להתאים ולנתב בקשות נכנסות ל-proxy ל-API המתאים.

    • תיאור (אופציונלי): מזינים תיאור לשרת ה-proxy החדש של ה-API, למשל Get started proxy.
    • יעד (API קיים): מזינים https://mocktarget.apigee.net. כתובת ה-URL הזו מגדירה את כתובת היעד שאליה Apigee Edge שולח בקשה ל-API proxy.

      שירות mocktarget מתארח ב-Apigee ומחזיר נתונים פשוטים. לא נדרש מפתח API או טוקן גישה.

    הפרטים של השרת הפרוקסי צריכים להיראות כך:

  6. לוחצים על הבא.
  7. בדף Common policies, בקטע Security: Authorization מוודאים שהאפשרות Pass through (no authorization) מסומנת ולוחצים על Next.

  8. בדף Virtual hosts (מארחים וירטואליים), בוחרים באפשרויות default (ברירת מחדל) ו-secure (מאובטח) ולוחצים על Next (הבא).
  9. בדף סיכום, מוודאים שסביבת הבדיקה מסומנת בקטע פריסה אופציונלית ולוחצים על יצירה ופריסה:

    מערכת Apigee יוצרת את proxy ל-API החדש ופורסת אותו בסביבת הבדיקה:

  10. לוחצים על Edit proxy (עריכת ה-proxy) כדי להציג את דף הסקירה הכללית של ה-API proxy:

    שימו לב שאם מרחיבים את [ + ], בממשק המשתמש מופיעות גם כתובות URL מסוג HTTP וגם כתובות URL מסוג HTTPS עבור סביבת הבדיקה:

    לכן, אפשר לשלוח בקשות לכל אחת מהן, אבל במדריך הזה נעשה שימוש ב-HTTPS.

Classic Edge (ענן פרטי)

כדי ליצור proxy ל-API באמצעות ממשק המשתמש של Classic Edge:

  1. מתחברים אל http://ms-ip:9000, כאשר ms-ip היא כתובת ה-IP או שם ה-DNS של צומת שרת הניהול.
  2. בחלון הראשי, לוחצים על API Proxies (שרתי proxy ל-API):

  3. לוחצים על + API Proxy (שרת proxy של API) בפינה השמאלית העליונה:

    יצירת שרת Proxy

    מערכת Apigee מנחה אתכם בתהליך של יצירת שרת proxy חדש. ההחלטה הראשונה היא לגבי סוג ה-proxy:

  4. בוחרים באפשרות שרת proxy הפוך (הנפוץ ביותר) ולוחצים על הבא.

    אחרי כן מוצג מסך פרטים.

  5. מגדירים את ה-proxy עם ההגדרות הבאות:
    • שם ה-Proxy: מזינים getstarted. אם כבר קיים שרת proxy בשם הזה, צריך לבחור שם אחר.
    • נתיב בסיס של שרת proxy: מוודאים שהערך מוגדר כ-‎/getstarted.

      נתיב הבסיס של ה-Proxy הוא חלק מכתובת ה-URL שמשמשת לשליחת בקשות ל-API. ‫Edge משתמש בכתובת ה-URL כדי להתאים בקשות נכנסות ולנתב אותן אל שרת ה-API המתאים.

    • API קיים: מזינים את הכתובת https://mocktarget.apigee.net. ההגדרה הזו מגדירה את כתובת ה-URL של היעד שאליו Apigee Edge שולח בקשה לשרת ה-proxy של ה-API.

      שירות mocktarget מתארח ב-Apigee ומחזיר נתונים פשוטים. לא נדרש מפתח API או טוקן גישה.

    • (אופציונלי) תיאור: מזינים תיאור ל-proxy ל-API החדש, למשל Getting Started proxy.

    הפרטים של השרת הפרוקסי צריכים להיראות כך:

  6. לוחצים על הבא.
  7. במסך אבטחה, בוחרים באפשרות העברה (ללא) כאפשרות האבטחה ולוחצים על הבא:

  8. במסך Virtual Hosts (מארחים וירטואליים), מאשרים את אפשרויות ברירת המחדל ולוחצים על Next (הבא).
  9. במסך Build (בנייה), מוודאים שסביבת test (בדיקה) נבחרה לצד Deploy Environments (פריסת סביבות) ולוחצים על Build and Deploy (בנייה ופריסה):

    מערכת Apigee יוצרת את proxy ל-API החדש ופורסת אותו בסביבת הבדיקה:

  10. לוחצים על View getstarted proxy in the editor (הצגת proxy ל-API של getstarted בעורך) כדי להציג את הדף Overview (סקירה כללית) של proxy ל-API:

    שימו לב שאם מרחיבים את [ + ], בממשק המשתמש מופיעות גם כתובות URL מסוג HTTP וגם כתובות URL מסוג HTTPS עבור סביבת הבדיקה:

    לכן, אפשר לשלוח בקשות לכל אחת מהן, אבל במדריך הזה נעשה שימוש ב-HTTPS.

השלב הבא

שלב 1 שלב 2: בדיקת השרת הפרוקסי החדש שלב 3 שלב 4