עבודה עם מקורות מידע

הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.

לעיון במסמכי התיעוד של Apigee Edge

כשמגדירים TargetServer לתמיכה ב-TLS, מציינים מאגר מפתחות או מאגר אישורים באמצעות הפניה. הפניה היא משתנה שמכיל את השם של מאגר המפתחות או מאגר האישורים, ולא ציון ישיר של השם של מאגר המפתחות או מאגר האישורים.

אפשר לייצג הפניה באמצעות אובייקט XML כמו זה שבהמשך:

  <reference>
    <name>ReferenceName</name>
    <description>ReferencDescription</description>
    <resourceType>ReferredResourceType<resourceType>
    <refers>ReferredResource<refers>
  </reference>

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

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

הגבלות על שימוש בהפניות למאגרי מפתחות ולמאגרי אישורים

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

יצירת קובץ עזר

אפשר להשתמש בממשק המשתמש או ב-API של Apigee כדי ליצור הפניה חדשה.

ממשק המשתמש של Apigee

כדי ליצור הפניה באמצעות מסוף Google Cloud :

  1. במסוף Google Cloud , עוברים לדף Management > Environments (ניהול > סביבות).

    מעבר אל Environments

  2. בוחרים את הסביבה הרצויה שבה רוצים ליצור את ההפניה.

  3. לוחצים על הכרטיסייה קובצי עזר.

  4. לוחצים על יצירת הפניה.

  5. בחלונית Create Reference, מזינים את הפרטים הבאים:
    • שם: השם של ההפניה.
    • Keystore: מאגר המפתחות שאליו ההפניה מצביעה.

  6. לוחצים על יצירה.

API

כדי ליצור הפניה באמצעות קריאה ל-API‏ Create Reference:

      curl -H "Authorization: Bearer $TOKEN" \
        -X POST \
        -d '{
            "reference": {
              "name": MyReferenceName",
              "resourceType": "KeyStore",
              "refers": "KeyStoreID"
            }
           }' \
        https://apigee.googleapis.com/v1/{parent=organizations/*/environments/*}/references

שינוי קובץ עזר

אפשר להשתמש בממשק המשתמש או ב-API של Apigee כדי לשנות הפניה קיימת.

ממשק המשתמש של Apigee

כדי לשנות קובץ עזר באמצעות מסוף Google Cloud :

  1. במסוף Google Cloud , עוברים לדף Management > Environments (ניהול > סביבות).

    מעבר אל Environments

  2. בוחרים את הסביבה הרצויה שבה רוצים לשנות את ההפניה.

  3. לוחצים על הכרטיסייה קובצי עזר.

  4. ברשימה שמוצגת, בוחרים את ההפניה שרוצים לשנות.

  5. לוחצים על פעולות > עריכה.

  6. בחלונית עריכת הפניה, מעדכנים את ההפניה כדי לציין את מאגר המפתחות החדש.

  7. לוחצים על עדכון.

API

כדי לשנות את ההפניה כך שתצביע על מאגר מפתחות אחר, ולוודא שהכינוי במאגר המפתחות החדש זהה לכינוי במאגר המפתחות הישן, משתמשים ב-API‏ Update Reference:

        curl -H "Authorization: Bearer $TOKEN" \
          -X PUT \
          -d '{
              "name": "MyReferenceName",
              "resourceType": "KeyStore",
              "refers": "KeyStoreID"
              }' \
        https://apigee.googleapis.com/v1/{name=organizations/*/environments/*/references/*}