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

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

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

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

אפשר לייצג הפניה באמצעות אובייקט 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/*}