דף זה תורגם על ידי Cloud Translation API.

הגדרת מארחים וירטואליים

מוצג המסמך של Apigee Edge.
עוברים אל מסמכי תיעוד של Apigee X. מידע

לקוח של Cloud עם חשבון בתשלום וכל הלקוחות של Edge ללקוחות פרטיים של ענן פרטי יכול ליצור מארח וירטואלי בארגון. המשתמש/ת יצירת המארח הווירטואלי חייבת להיות בתפקיד מנהל מערכת ארגוני או תפקיד בהתאמה אישית עם הרשאות לשינוי מארח וירטואלי. למשתמשים בתפקידים אחרים אין הרשאה ליצירת מארחים וירטואליים.

צפייה בסרטון היכרות עם מארחים וירטואליים.

יצירת מארח וירטואלי

משתמשים בתהליך הבסיסי הבא כדי ליצור את המארח הווירטואלי. התהליך שבו משתמשים בפועל מבוסס על השאלה האם אתם לקוחות של Cloud או של ענן פרטי, ואם אתם מפעילים TLS:

יוצרים רשומת DNS ורשומת CNAME עבור הדומיין שגלוי לכולם.
הערה: לקוחות של ענן פרטי יכולים ליצור מארח וירטואלי כתובת IP, ללא רשומת DNS ורשומת CNAME. מידע נוסף זמין במאמר הגדרת מארחים וירטואליים לענן הפרטי לקבלת מידע נוסף.
אם מפעילים TLS במארח הווירטואלי:

יוצרים מאגר מפתחות ומגדירים אותו באמצעות התהליך שמתואר כאן: Keystores ו-Truststores
הערה: אם יש לכם חשבון Edge בתשלום ל-Cloud ואין לכם עדיין יש לך אישור ומפתח TLS, ניתן ליצור מארח וירטואלי שמשתמש באישור ובמפתח תקופת הניסיון בחינם של Apigee. למידע נוסף, ראו הגדרת מארחים וירטואליים בענן.
מעלים את האישור והמפתח למאגר המפתחות. ודא ששם הדומיין שצוין על ידי האישור תואם לכינוי המארח שבו רוצים להשתמש בשביל המארח הווירטואלי.
יוצרים הפניה למאגר המפתחות באמצעות ממשק המשתמש או ה-API של Edge. ההפניה מציין את השם של מאגר המפתחות וסוג ההפניה כ-KeyStore. צפייה עבודה עם קובצי עזר עבור על יצירה ושינוי של קובצי עזר.
אם אתם מבצעים TLS דו-כיווני, יוצרים מאגר אמון, מעלים את האישור, וניצור הפניה ל-Truststore. יצירת ה-Truststore באמצעות התהליך שמתואר כאן: Keystores and Truststores.

יוצרים את המארח הווירטואלי באמצעות יוצרים ממשק API של מארח וירטואלי. אם מפעילים TLS, חשוב לציין את ההפניה הנכונה למאגר המפתחות, והפניה ל-Truststore ומפתח חלופי.
אם יש לכם שרתי proxy ל-API, מוסיפים את המארח הווירטואלי ל-ProxyEndpoint. המארח הווירטואלי מתווסף באופן אוטומטי לכל שרתי ה-proxy החדשים ל-API. צפייה הגדרת שרת proxy ל-API לשימוש במארח וירטואלי.

זהירות: כל המארחים הווירטואליים מתווספים באופן אוטומטי לכל שרתי ה-proxy החדשים של ה-API. לכן, אם יוצרים שרת proxy חדש ל-API שלא אמור להיות נגיש דרך כתובת URL מסוימת לאחר מכן, עליך לערוך את שרת ה-proxy של ה-API כדי להסיר את המארח הווירטואלי ProxyEndpoint.

אחרי שמעדכנים את ה-Proxy ל-API לשימוש במארח הווירטואלי, ויצירת רשומת ה-DNS ורשומת ה-CNAME עבור כתובת האימייל החלופית של המארח, ניתן לגשת לשרת ה-proxy של ה-API כפי שמוצג בהמשך:

https://api.myCompany.com/v1/project-base-path/resource-path

לדוגמה:

https://api.myCompany.com/v1/weather/forecastrss?w=12797282

יצירת מארח וירטואלי באמצעות API או ממשק משתמש

אפשר ליצור מארח וירטואלי באמצעות Edge API או ממשק המשתמש של Edge.

רוב הדוגמאות הבאות משתמשות ב-Edge API. כדי לגשת לממשק המשתמש כדי ליצור, לשנות ולמחוק מארחים וירטואליים בממשק המשתמש של Edge:

נכנסים לחשבון בכתובת apigee.com/edge
לקוחות Edge ללקוחות ענן פרטי משתמשים ב-http://ms-ip:9000 (בארגון), כאשר ms-ip הוא כתובת ה-IP או שם ה-DNS של הצומת של שרת הניהול.
בסרגל הניווט הימני, בוחרים באפשרות ניהול > מארחים וירטואליים.
בוחרים את הסביבה, למשל prod או test.
הווירטואלי מוצגים המארחים שהוגדרו לסביבה.
בוחרים באפשרות + מארח וירטואלי כדי ליצור מארח וירטואלי, או בוחרים את השם של מארח וירטואלי קיים כדי לערוך אותו.

יצירת מארח וירטואלי ל-HTTP

לקוחות Edge ללקוחות בענן פרטי יכולים ליצור מארח וירטואלי באמצעות HTTP.

כדי ליצור מארח וירטואלי שלא תומך ב-TLS, צריך ליצור אובייקט XML שמגדיר את מארח וירטואלי. לדוגמה, אובייקט ה-XML הבא מגדיר מארח וירטואלי שמשתמש ב-HTTP פרוטוקול:

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>api.myCompany.com</HostAlias>
   </HostAliases>
   <Interfaces/>
   <Port>80</Port>
</VirtualHost>

בהגדרה הזו:

מציינים את ה-name כ-myVHost. שימוש בשם לצורך התייחסות המארח הווירטואלי בשרת proxy ל-API או בקריאה ל-API.
מציינים את כינוי המארח בתור api.myCompany.com. כאן דומיין ציבורי המשמש לגישה לממשקי ה-API שלך, כפי שמוגדר בהגדרת DNS וב-CNAME רשומה.
מציינים את מספר היציאה בתור 80. אם לא צוין, כברירת מחדל היציאה מוגדרת ל-443.
יש מאפיינים נוספים שאפשר להגדיר במארח הווירטואלי. לעיון בכל הנכסים: חומר עזר בנושא נכס מארח וירטואלי.

אם יש לך שרתי proxy קיימים ל-API, צריך להוסיף את המארח הווירטואלי לרכיב <HTTPConnection> בנקודת הקצה של שרת ה-proxy. המארח הווירטואלי מתווסף באופן אוטומטי לכל שרתי ה-proxy החדשים ל-API. מידע נוסף זמין במאמר הגדרת שרת proxy ל-API לשימוש במארח וירטואלי. אם יוצרים שרת proxy חדש ל-API שלא צריך להיות נגיש דרך מארח וירטואלי מסוים, צריך לערוך את ה-Proxy ל-API כדי להסיר את המארח הווירטואלי מ-ProxyEndpoint שלו.

לאחר מכן תוכל לגשת לשרת ה-proxy ל-API דרך המארח הווירטואלי הזה, על ידי שליחת בקשה כדי:

http://api.myCompany.com/proxy-base-path/resource-path
https://api.myCompany.com/proxy-base-path/resource-path

יוצרים את המארח הווירטואלי באמצעות יוצרים API של מארח וירטואלי:

curl -X POST -H "Content-Type:application/xml" \
  http://ms-IP:8080/v1/o/org_name/environments/env_name/virtualhosts \
  -d '<VirtualHost name="myVHost">
        <HostAliases>
            <HostAlias>api.myCompany.com</HostAlias>
        </HostAliases>
        <Interfaces/>
        <Port>80</Port>
    </VirtualHost>' \
  -u sysAdminEmail:password

הערה: ב-Edge for Private Cloud, מבצעים קריאות ל-API שם הדומיין ms-ip:8080, כאשר ms-ip הוא כתובת ה-IP של שרת ניהול הקצה. Edge ללקוחות Cloud לשלוח בקשות לדומיין api.enterprise.apigee.com

יצירת מארח וירטואלי ל-TLS חד-כיווני

אובייקט ה-XML הבא מגדיר מארח וירטואלי ל-TLS חד-כיווני:

<VirtualHost name="myTLSVHost">
    <HostAliases>
        <HostAlias>api.myCompany.com</HostAlias>
    </HostAliases>
    <Port>443</Port>
    <SSLInfo>
        <Enabled>true</Enabled>
        <ClientAuthEnabled>false</ClientAuthEnabled>
        <KeyStore>ref://myTestKeystoreRef</KeyStore>
        <KeyAlias>myKeyAlias</KeyAlias>
    </SSLInfo>
</VirtualHost>

בהגדרה הזו מפעילים TLS על ידי הגדרת הרכיב <Enable> עד True, ומשתמשים ברכיבים <KeyStore> ו-<KeyAliase> כדי לציין את מאגר המפתחות ואת הכינוי של המפתחות שמשמשים את חיבור ה-TLS.

הערה: מכיוון ש-Edge תומך במקור ב-SSL, התג שבו משתמשים כדי להגדיר השם של פרוטוקול TLS הוא <SSLInfo>.

מידע נוסף זמין ב-TLS/SSL. על השימוש ב-TLS.

מחליטים איך לציין את השם של מאגר המפתחות ושל מאגר האישורים במארח הווירטואלי

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

    <SSLInfo>
        <Enabled>true</Enabled>
        <ClientAuthEnabled>false</ClientAuthEnabled>
        <KeyStore>ref://myTestKeystoreRef</KeyStore>
        <KeyAlias>myKeyAlias</KeyAlias>
    </SSLInfo>

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

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

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

צריך להביא בחשבון את ההגבלה הבאה כשמשתמשים בהפניות למאגרי מפתחות Truststores:

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

יצירת מארח וירטואלי ל-TLS דו-כיווני

כדי להפעיל TLS דו-כיווני, צריך להגדיר את הרכיב <ClientAuthEnabled> כ- true, ומציינים מאגר אמון לפי באמצעות הפניה עם הרכיב <TrustStore>. ה-Truststore מכילה את מנפיק האישור של הלקוח ואת שרשרת ה-CA של האישור, והנחוצה. הלקוח/ה חייב להיות מוגדר נכון גם עבור TLS דו-כיווני.

כדי ליצור מארח וירטואלי ל-TLS דו-כיווני, צריך ליצור אובייקט XML שמגדיר את Host (מארח):

<VirtualHost name="myTLSVHost">
    <HostAliases>
        <HostAlias>api.myCompany.com</HostAlias>
    </HostAliases>
    <Port>443</Port>
    <SSLInfo>
        <Enabled>true</Enabled>
        <ClientAuthEnabled>true</ClientAuthEnabled>
        <KeyStore>ref://myTestKeystoreRef</KeyStore>
        <KeyAlias>myKeyAlias</KeyAlias>
        <TrustStore>ref://myTestTruststoreRef</TrustStore>
    </SSLInfo>
</VirtualHost>

בהגדרה הזו:

כדי להפעיל TLS דו-כיווני צריך להגדיר את <ClientAuthEnabled> כ-True.
מציינים את ההפניה ל-Truststore באמצעות הרכיב <TrustStore>. ה-Truststore מכילה את מנפיק האישור של הלקוח ואת שרשרת ה-CA של האישור, והנחוצה.

מידע נוסף זמין ב-TLS/SSL. על השימוש ב-TLS.

שינוי מארח וירטואלי

לקוח Cloud עם חשבון בתשלום וכל לקוחות Edge עבור ענן פרטי יכולים להשתמש מעדכנים ממשק API של מארח וירטואלי כדי לעדכן מארח וירטואלי. ה-API הזה מאפשר להגדיר מאפיינים של המארח הווירטואלי שמתוארים בחומר עזר בנושא נכס מארח וירטואלי.

מעדכנים את המארח הווירטואלי באמצעות עדכון API של מארח וירטואלי. כשמשתמשים ב-API, צריך לציין את ההגדרה המלאה של המארח הווירטואלי בגוף הבקשה, לא רק את הרכיבים שרוצים לשנות.

בדוגמה הזו מגדירים את הערך של המאפיין proxy_read_timeout:

curl -X PUT -H "Content-Type:application/xml" \
    https://api.enterprise.apigee.com/v1/o/org_name/e/env_name/virtualhosts/vhost_name \
    -d '<VirtualHost  name="myTLSVHost">
         <HostAliases>
           <HostAlias>api.myCompany.com</HostAlias>
         </HostAliases>
         <Port>443</Port>
         <SSLInfo>
           <Enabled>true</Enabled>
           <ClientAuthEnabled>false</ClientAuthEnabled>
           <KeyStore>ref://myTestKeystoreRef</KeyStore>
           <KeyAlias>myKeyAlias</KeyAlias>
         </SSLInfo>
         <Properties>
           <Property name="proxy_read_timeout">50</Property>
         </Properties>
     </VirtualHost>' \
    -u orgAdminEmail:password

מחיקת מארח וירטואלי

לפני שאפשר למחוק מארח וירטואלי מסביבה, צריך לעדכן את שרתי ה-proxy ל-API להפנות למארח הווירטואלי כדי להסיר את ההפניה. צפייה הגדרת שרת proxy ל-API לשימוש בשרת וירטואלי מארח.

מוחקים את המארח הווירטואלי באמצעות מחיקת ממשק API של מארח וירטואלי:

curl -X DELETE \
  https://api.enterprise.apigee.com/v1/o/org_name/e/env_name/virtualhosts/vhost_name \
  -u orgAdminEmail:password

הצגת מידע על מארח וירטואלי

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

Edge

כדי להציג מידע על מארח וירטואלי באמצעות ממשק המשתמש של Edge:

נכנסים לחשבון בכתובת apigee.com/edge.
לקוחות Edge ללקוחות ענן פרטי משתמשים ב-http://ms-ip:9000 (בארגון), כאשר ms-ip הוא כתובת ה-IP או שם ה-DNS של הצומת של שרת הניהול.
בוחרים באפשרות ניהול > מארחים וירטואליים בסרגל הניווט הימני.
בוחרים את הסביבה, למשל prod או test.
הווירטואלי יופיעו מארחים שהוגדרו לסביבה. אם המארח הווירטואלי מוגדר לשימוש במאגר מפתחות או במאגר אמון, כדי לראות מידע נוסף, לוחצים על הצגה.

אם המארח הווירטואלי מוגדר לשימוש ב-TLS/SSL, יופיע סמל נעילה לצד השם של מארח וירטואלי. המשמעות היא שאישור, מפתח ושרשרת אישורים של TLS/SSL הועלו אל Edge ומשויך למארח הווירטואלי. כדי לראות מידע על הזמינות אישורים:

בוחרים באפשרות ניהול > סביבה > TLS Keystores בסרגל הניווט הימני.
בוחרים את הסביבה (בדרך כלל prod או test).
כדי להציג את האישור, צריך להרחיב את מאגרי המפתחות.

Classic Edge (ענן פרטי)

כדי להציג מידע על מארח וירטואלי באמצעות ממשק המשתמש של Classic Edge:

יש להיכנס אל http://ms-ip:9000, כאשר ms-ip הוא כתובת ה-IP או שם ה-DNS של הצומת של שרת הניהול.
בוחרים באפשרות ניהול > מארחים וירטואליים בסרגל הניווט הימני.
בוחרים את הסביבה, למשל prod או test.
לוחצים על הכרטיסייה מארחים וירטואליים.
הווירטואלי יופיעו מארחים שהוגדרו לסביבה. אם המארח הווירטואלי מוגדר לשימוש במאגר מפתחות או במאגר אמון, כדי לראות מידע נוסף, לוחצים על הצגה.

בוחרים באפשרות ניהול > אישורי TLS בסרגל הניווט העליון.
בוחרים את הסביבה (בדרך כלל prod או test).
כדי להציג את האישור, צריך להרחיב את מאגרי המפתחות.

הצגה מארח וירטואלי עם Edge API

אפשר גם להשתמש בממשקי ה-API של Edge כדי להציג מידע על מארחים וירטואליים. עבור לדוגמה, הצגת רשימה וירטואלית Hosts API מחזיר רשימה של כל המארחים הווירטואליים:

curl -X GET -H "accept:application/xml" \
    https://api.enterprise.apigee.com/v1/o/org_name/environments/env_name/virtualhosts \
    -u orgAdminEmail:pWord

כאשר orgAdminEmail:pWord הוא שם המשתמש והסיסמה של מנהל הארגון, וכן org_name/env_name מציינים את הערך הארגון והסביבה שמכילים את המארח הווירטואלי. דוגמה לתגובה:

[
 "default",
 "secure"
]

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

curl -X GET -H "accept:application/xml" \
    https://api.enterprise.apigee.com/v1/o/org_name/environments/env_name/virtualhosts/vhost_name \
    -u orgAdminEmail:pWord

כאשר vhost_name הוא השם של המארח הווירטואלי. לדוגמה, אפשר לציין את vhost_name כ'מאובטח' אל לראות את התצורה של המארח הווירטואלי המאובטח שמוגדר כברירת מחדל שנוצר על ידי Apigee:

<VirtualHost name="secure">
    <HostAliases>
        <HostAlias>api.myCompany.com</HostAlias>
    </HostAliases>
    <Port>443</Port>
    <Properties/>
    <Interfaces/>
    <RetryOptions/>
    <SSLInfo>
        <ClientAuthEnabled>false</ClientAuthEnabled>
        <Enabled>true</Enabled>
        <KeyAlias>freetrial</KeyAlias>
        <KeyStore>ref://freetrial</KeyStore>
        <IgnoreValidationErrors>false</IgnoreValidationErrors>
    </SSLInfo>
</VirtualHost>

הערה: ב-Edge for Private Cloud, מחליפים את שם הדומיין api.enterprise.apigee.com ב- ms-ip:8080 כאשר ms-ip הוא כתובת ה-IP של ניהול הקצה שרת.

הגדרת שרת proxy ל-API לשימוש בשרת וירטואלי לארח

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

https://host-alias/proxy-base-path/resource-path

כאשר:

host-alias הוא בדרך כלל שם ה-DNS של המארח הווירטואלי.
proxy-base-path מוגדר כשיוצרים שרת proxy ל-API, והוא ייחודי לכל אחד מהם שרת proxy ל-API.
resource-path הנתיב למשאב שאפשר לגשת אליו דרך שרת ה-proxy ל-API.

שליטה במארחים הווירטואליים שמשמשים את שרת ה-proxy ל-API

בתצורת ה-XML של שרת proxy ל-API, משתמשים בתג virtualhost כדי לציין name של המארח הווירטואלי המשויך לשרת ה-proxy ל-API:

<HTTPProxyConnection>
  <BasePath>/v1/my/proxy/basepath</BasePath>
  <VirtualHost>secure</VirtualHost>
  <VirtualHost>default</VirtualHost>
</HTTPProxyConnection>

לדוגמה, המשמעות של <VirtualHost>secure</VirtualHost> לקוח יכול לקרוא לשרת ה-proxy של ה-API באמצעות כינוי המארח של התג "מאובטח" מארח וירטואלי.

בדרך כלל משנים את המארחים הווירטואליים שמשויכים לשרת proxy ל-API כאשר:

אתם יוצרים מארח וירטואלי חדש ויש לכם שרתי proxy ל-API. צריך לערוך כל ממשק API קיים שרתי proxy כדי להוסיף את המארח הווירטואלי החדש.
אתם יוצרים שרת proxy חדש של API שלא צריך להיות נגיש דרך מארח וירטואלי מסוים. עליכם לערוך את שרת ה-proxy של ה-API כדי להסיר את המארח הווירטואלי הזה מההגדרה שלו.

כדי לשנות את המארחים הווירטואליים שמשויכים לשרת proxy של API:

ניגשים לעורך ה-proxy ל-API, כמו שמתואר בהמשך.
Edge

כדי לגשת לעורך ה-proxy ל-API באמצעות ממשק המשתמש של Edge:
1. נכנסים לחשבון בכתובת apigee.com/edge.
  לקוחות Edge ללקוחות ענן פרטי משתמשים ב-http://ms-ip:9000 (בארגון), כאשר ms-ip הוא כתובת ה-IP או שם ה-DNS של הצומת של שרת הניהול.
2. בוחרים באפשרות פיתוח > ממשקי proxy ל-API בסרגל הניווט הימני.
3. בוחרים ברשימה את שרת ה-proxy ל-API שרוצים לערוך.
Classic Edge (ענן פרטי)

הערה: הממשק הקלאסי של Edge זמין רק ב-Edge לענן פרטי.

כדי לגשת לעורך ה-proxy ל-API באמצעות ממשק המשתמש של Classic Edge:
1. יש להיכנס אל http://ms-ip:9000, כאשר ms-ip הוא כתובת ה-IP או שם ה-DNS של הצומת של שרת הניהול.
2. בוחרים באפשרות APIs > ממשקי proxy ל-API בסרגל הניווט העליון.
3. בוחרים ברשימה את שרת ה-proxy ל-API שרוצים לערוך.
לוחצים על הכרטיסייה פיתוח.
בקטע נקודות קצה לשרת proxy, בוחרים באפשרות ברירת מחדל.
באזור הקוד:
1. מסירים את כל רכיבי <VirtualHost> של מארחים וירטואליים שלא נתמכים על ידי שרת ה-proxy של ה-API.
2. הוספת רכיב <VirtualHost> חדש בשם של המארח הווירטואלי החדש. לדוגמה, אם השם של המארח הווירטואלי החדש הוא MyVirtualHost, יש להוסיף את התג הבא:
```
<HTTPProxyConnection>
  <BasePath>/v1/my/proxy/basepath</BasePath>
  <VirtualHost>default</VirtualHost>
  <VirtualHost>secure</VirtualHost>
  <VirtualHost>MyVirtualHost</VirtualHost>
</HTTPProxyConnection>
```
שומרים את ה-Proxy ל-API. אם שרת ה-proxy ל-API נפרס, לאחר שמירתו, המערכת תפרוס אותו מחדש עם הגדרה אישית.

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

בממשק המשתמש של Edge מוצגת כתובת ה-URL של שרת ה-proxy ל-API, על סמך ההגדרות במארח הווירטואלי שתואם למיקום שבו שרת ה-proxy נפרס. המסך הזה יכול לכלול את מספר יציאת הנתב של המארח הווירטואלי.

ברוב המקרים, כתובת ה-URL שמוצגת בממשק המשתמש של Edge היא כתובת ה-URL הנכונה להטמעה של קבצים חיצוניים בקשות לשרת ה-proxy. עם זאת, בחלק מהתצורות, כתובת ה-URL שמוצגת שגויה. עבור לדוגמה, כל אחת מהתצורות הבאות יכולה לגרום לכתובת האתר שמוצגת שתואמים לכתובת ה-URL בפועל ששימשה לשליחת בקשות חיצוניות אל שרת ה-proxy:

סיום SSL מתרחש במאזן עומסים
מיפוי היציאות מתרחש בין מאזן עומסים לנתבים של Apigee
מאזן עומסים שהוגדר עם שכתוב של נתיבים

Edge תומך במאפיין במארח הווירטואלי בשם <BaseUrl> שמאפשר מבטלים את כתובת ה-URL שמוצגת בממשק המשתמש של Edge. דוגמה לאובייקט של המארח הווירטואלי עם המאפיין <BaseUrl>. בדוגמה הזו, הערך http://myCo.com מופיעה בממשק המשתמש של Edge:

<VirtualHost name="myTLSVHost">
  <HostAliases>
    <HostAlias>api.myCompany.com</HostAlias>
  </HostAliases>
  <BaseUrl>http://myCo.com</BaseUrl>
  <Port>443</Port>
  <SSLInfo>
    <Enabled>true</Enabled>
    <ClientAuthEnabled>false</ClientAuthEnabled>
    <KeyStore>ref://myTestKeystoreRef</KeyStore>
    <KeyAlias>myKeyAlias</KeyAlias>
  </SSLInfo>
</VirtualHost>

יש לשים לב שהערך של <BaseUrl> חייב לכלול את הפרוטוקול (כלומר, "http:// " או https:// ).

אם המדיניות <BaseUrl> לא מוגדרת, כתובת ה-URL שמוגדרת כברירת מחדל ועוברת רינדור על ידי ממשק המשתמש של Edge: מופיעה בתור: "api.myCompany.com", ואילו הכינוי של המארח בפועל הוא "http://myCo.com".