การกำหนดค่าโฮสต์เสมือน

คุณกําลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X
info

ลูกค้า Cloud ที่มีบัญชีแบบชำระเงินและลูกค้า Edge for Private Cloud ทุกคนสามารถสร้างโฮสต์เสมือนในองค์กรได้ ผู้ใช้ที่สร้างโฮสต์เสมือนต้องมีบทบาทเป็นผู้ดูแลระบบองค์กร หรืออยู่ในบทบาทที่กำหนดเองซึ่งมีสิทธิ์แก้ไขโฮสต์เสมือน ผู้ใช้ในบทบาทอื่นๆ จะไม่มีสิทธิ์สร้างโฮสต์เสมือน

ดูวิดีโอแนะนำเกี่ยวกับโฮสต์เสมือน

การสร้างโฮสต์เสมือน

ใช้ขั้นตอนพื้นฐานต่อไปนี้เพื่อสร้างโฮสต์เสมือน ขั้นตอนจริงที่คุณใช้จะขึ้นอยู่กับว่าคุณเป็นลูกค้า Cloud หรือ Private Cloud และคุณเปิดใช้ TLS หรือไม่

  1. สร้างรายการ DNS และระเบียน CNAME สำหรับโดเมนที่แสดงต่อสาธารณะ
  2. หากเปิดใช้ TLS ในโฮสต์เสมือน ให้ทำดังนี้
    1. สร้างและกําหนดค่าคีย์สโตร์โดยใช้ขั้นตอนที่อธิบายไว้ที่นี่ คีย์สโตร์และทรัสต์สโตร์
    2. อัปโหลดใบรับรองและคีย์ไปยังคีย์สโตร์ ตรวจสอบว่าชื่อโดเมนที่ระบุโดยใบรับรองตรงกับชื่อแทนของโฮสต์ที่คุณต้องการใช้สำหรับโฮสต์เสมือน
    3. สร้างการอ้างอิงถึงคีย์สโตร์โดยใช้ UI หรือ API ของ Edge ข้อมูลอ้างอิงระบุชื่อของคีย์สโตร์และประเภทข้อมูลอ้างอิงเป็น KeyStore ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างและการแก้ไขข้อมูลอ้างอิงได้ที่การทํางานกับข้อมูลอ้างอิง
    4. หากคุณใช้ TLS แบบ 2 ทาง ให้สร้าง TrustStore, อัปโหลดใบรับรอง และสร้างการอ้างอิงถึง TrustStore สร้าง Truststore โดยใช้ขั้นตอนที่อธิบายไว้ที่นี่: Keystore และ Truststore
  3. สร้างโฮสต์เสมือนโดยใช้ Create a Virtual Host API หากเปิดใช้ TLS โปรดตรวจสอบว่าได้ระบุข้อมูลอ้างอิงคีย์สโตร์ ข้อมูลอ้างอิงคลังเก็บข้อมูลที่เชื่อถือ และชื่อแทนของคีย์ที่ถูกต้อง
  4. หากคุณมีพร็อกซี API อยู่แล้ว ให้เพิ่มโฮสต์เสมือนลงใน ProxyEndpoint ระบบจะเพิ่มโฮสต์เสมือนลงในพร็อกซี API ใหม่ทั้งหมดโดยอัตโนมัติ ดูการกำหนดค่าพร็อกซี API เพื่อใช้โฮสต์เสมือน

หลังจากอัปเดตพร็อกซี API เพื่อใช้โฮสต์เสมือน รวมถึงสร้างรายการ DNS และระเบียน CNAME สำหรับอีเมลแทนของโฮสต์แล้ว คุณจะเข้าถึงพร็อกซี API ได้ตามที่แสดงด้านล่าง

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

เช่น

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

การสร้างโฮสต์เสมือนโดยใช้ API หรือ UI

คุณสร้างโฮสต์เสมือนได้โดยใช้ Edge API หรือ Edge UI

ตัวอย่างส่วนใหญ่ด้านล่างใช้ Edge API วิธีเข้าถึง UI เพื่อสร้าง แก้ไข และลบโฮสต์เสมือนใน UI ของ Edge

  1. ลงชื่อเข้าใช้ apigee.com/edge

    ลูกค้า Edge for Private Cloud ใช้ http://ms-ip:9000 (ในองค์กร) โดยที่ ms-ip คือที่อยู่ IP หรือชื่อ DNS ของโหนดเซิร์ฟเวอร์การจัดการ

  2. เลือกผู้ดูแลระบบ > โฮสต์เสมือนในแถบนำทางด้านซ้าย
  3. เลือกสภาพแวดล้อม เช่น prod หรือ test
    โฮสต์เสมือนที่กําหนดไว้สําหรับสภาพแวดล้อมจะปรากฏขึ้น
  4. เลือก + โฮสต์เสมือนเพื่อสร้างโฮสต์เสมือน หรือเลือกชื่อของโฮสต์เสมือนที่มีอยู่เพื่อแก้ไข

การสร้างโฮสต์เสมือนสำหรับ HTTP

ลูกค้า Edge for Private Cloud จะสร้างโฮสต์เสมือนได้โดยใช้ HTTP

หากต้องการสร้างโฮสต์เสมือนที่ไม่รองรับ TLS ให้สร้างออบเจ็กต์ XML ที่กําหนดโฮสต์เสมือน ตัวอย่างเช่น ออบเจ็กต์ XML ต่อไปนี้จะกำหนดโฮสต์เสมือนที่ใช้โปรโตคอล HTTP

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

ในคำจำกัดความนี้ คุณจะทำสิ่งต่อไปนี้ได้

  • ระบุชื่อเป็น myVHost ใช้ชื่อเพื่ออ้างอิงโฮสต์เสมือนในพร็อกซี API หรือในการเรียก API
  • ระบุชื่อแทนโฮสต์เป็น api.myCompany.com ซึ่งเป็นโดเมนที่แสดงต่อสาธารณะซึ่งใช้เข้าถึง API ตามที่กําหนดโดยคําจํากัดความ DNS และระเบียน CNAME
  • ระบุหมายเลขพอร์ตเป็น 80 หากไม่ระบุ ระบบจะตั้งค่าพอร์ตเป็น 443 โดยค่าเริ่มต้น
  • มีพร็อพเพอร์ตี้เพิ่มเติมที่คุณตั้งค่าได้ในโฮสต์เสมือน ดูข้อมูลอ้างอิงสำหรับพร็อพเพอร์ตี้ทั้งหมดได้ที่ข้อมูลอ้างอิงพร็อพเพอร์ตี้โฮสต์เสมือน

หากมีพร็อกซี API อยู่แล้ว ให้เพิ่มโฮสต์เสมือนลงในองค์ประกอบ <HTTPConnection> ในปลายทางพร็อกซี ระบบจะเพิ่มโฮสต์เสมือนลงในพร็อกซี API ใหม่ทั้งหมดโดยอัตโนมัติ โปรดดูการกำหนดค่าพร็อกซี API เพื่อใช้โฮสต์เสมือน หากคุณสร้างพร็อกซี API ใหม่ที่ไม่ควรเข้าถึงผ่านโฮสต์เสมือนหนึ่งๆ คุณต้องแก้ไขพร็อกซี API เพื่อนำโฮสต์เสมือนนั้นออกจาก ProxyEndpoint

จากนั้นคุณจะเข้าถึงพร็อกซี API ผ่านโฮสต์เสมือนนี้ได้โดยการส่งคำขอไปยัง

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

สร้างโฮสต์เสมือนโดยใช้ Create a VM 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

การสร้างโฮสต์เสมือนสำหรับ TLS แบบ 1 ทิศทาง

ออบเจ็กต์ XML ต่อไปนี้กำหนดโฮสต์เสมือนสำหรับ TLS แบบ 1 ทิศทาง

<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> เป็น "จริง" และใช้องค์ประกอบ <KeyStore> และ <KeyAliase> เพื่อระบุคีย์สโตร์และอีเมลแทนคีย์ที่การเชื่อมต่อ TLS ใช้

ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ TLS ได้ที่ TLS/SSL

เลือกวิธีระบุชื่อคีย์สโตร์และทรัสต์สโตร์ในโฮสต์เสมือน

เมื่อกำหนดค่าโฮสต์เสมือนให้รองรับ TLS คุณจะระบุคีย์สโตร์ได้โดยใช้ข้อมูลอ้างอิง การอ้างอิงคือตัวแปรที่มีชื่อของคีย์สโตร์หรือที่เก็บข้อมูลเชื่อถือ แทนที่จะระบุชื่อคีย์สโตร์หรือที่เก็บข้อมูลเชื่อถือโดยตรง ดังที่แสดงด้านล่าง

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

ข้อดีของการใช้ข้อมูลอ้างอิงคือคุณสามารถเปลี่ยนค่าของข้อมูลอ้างอิงเพื่อเปลี่ยนที่เก็บคีย์ที่โฮสต์เสมือนใช้ ซึ่งมักจะเป็นเพราะใบรับรองในที่เก็บคีย์ปัจจุบันกำลังจะหมดอายุในเร็วๆ นี้ การเปลี่ยนค่าของข้อมูลอ้างอิงไม่จําเป็นต้องรีสตาร์ทเราเตอร์ Edge ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างและการแก้ไขข้อมูลอ้างอิงได้ที่การทํางานกับข้อมูลอ้างอิง

คุณใช้การอ้างอิงถึงคีย์สโตร์และทรัสต์สโตร์ได้เท่านั้น จะใช้การอ้างอิงถึงอีเมลแทนไม่ได้ เมื่อเปลี่ยนการอ้างอิงไปยังคีย์สโตร์ ให้ตรวจสอบว่าชื่อแทนของใบรับรองเหมือนกับในคีย์สโตร์เดิม

ข้อจํากัดในการใช้การอ้างอิงไปยังคีย์สโตร์และทรัสต์สโตร์

คุณต้องคำนึงถึงข้อจำกัดต่อไปนี้เมื่อใช้การอ้างอิงถึงคีย์สโตร์และที่เก็บข้อมูลเชื่อถือ

  • คุณจะใช้การอ้างอิงคีย์สโตร์และทรัสต์สโตร์ในโฮสต์เสมือนได้ก็ต่อเมื่อรองรับ SNI และสิ้นสุด SSL ในเราเตอร์ Apigee
  • หากคุณมีตัวจัดสรรภาระงานอยู่หน้าเราเตอร์ Apigee และสิ้นสุด TLS ในตัวจัดสรรภาระงาน คุณจะไม่สามารถใช้การอ้างอิงคีย์สโตร์และ TrustStore ในโฮสต์เสมือน

การสร้างโฮสต์เสมือนสำหรับ TLS แบบ 2 ทาง

หากต้องการเปิดใช้ TLS แบบ 2 ทาง ให้ตั้งค่าองค์ประกอบ <ClientAuthEnabled> เป็น true และระบุที่เก็บข้อมูลที่เชื่อถือโดยใช้การอ้างอิงกับองค์ประกอบ <TrustStore> ไฟล์ Truststore จะเก็บผู้ออกใบรับรองของไคลเอ็นต์และเชน CA ของใบรับรอง ซึ่งจําเป็น นอกจากนี้ ยังต้องกำหนดค่าไคลเอ็นต์อย่างถูกต้องสำหรับ TLS แบบ 2 ทางด้วย

หากต้องการสร้างโฮสต์เสมือนสำหรับ TLS แบบ 2 ทาง ให้สร้างออบเจ็กต์ XML ที่กําหนดโฮสต์เสมือน ดังนี้

<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 แบบ 2 ทางโดยตั้งค่า <ClientAuthEnabled> เป็น true
  • ระบุการอ้างอิงถึงที่เก็บข้อมูลเชื่อถือโดยใช้องค์ประกอบ <TrustStore> ไฟล์ Truststore จะเก็บผู้ออกใบรับรองของไคลเอ็นต์และเชน CA ของใบรับรอง ซึ่งจําเป็น

ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ TLS ได้ที่ TLS/SSL

การแก้ไขโฮสต์เสมือน

ลูกค้า Cloud ที่มีบัญชีแบบชำระเงินและลูกค้า Edge for Private Cloud ทั้งหมดสามารถใช้ อัปเดตโฮสต์เสมือน 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

การลบโฮสต์เสมือน

คุณต้องอัปเดตพร็อกซี API ที่อ้างอิงโฮสต์เสมือนเพื่อนำการอ้างอิงออกก่อนจึงจะลบโฮสต์เสมือนออกจากสภาพแวดล้อมได้ ดูการกำหนดค่าพร็อกซี API เพื่อใช้โฮสต์เสมือน

ลบโฮสต์เสมือนโดยใช้ Delete a Virtual Host API

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

การดูข้อมูลเกี่ยวกับโฮสต์เสมือน

ดูข้อมูลเกี่ยวกับโฮสต์เสมือนที่กําหนดไว้ในสภาพแวดล้อม ตามที่อธิบายไว้ด้านล่าง

Edge

วิธีดูข้อมูลเกี่ยวกับโฮสต์เสมือนโดยใช้ UI ของ Edge

  1. ลงชื่อเข้าใช้ apigee.com/edge

    ลูกค้า Edge for Private Cloud ใช้ http://ms-ip:9000 (ในองค์กร) โดยที่ ms-ip คือที่อยู่ IP หรือชื่อ DNS ของโหนดเซิร์ฟเวอร์การจัดการ

  2. เลือกผู้ดูแลระบบ > โฮสต์เสมือนในแถบนำทางด้านซ้าย
  3. เลือกสภาพแวดล้อม เช่น prod หรือ test

    โฮสต์เสมือนที่กําหนดไว้สําหรับสภาพแวดล้อมจะปรากฏขึ้น หากกำหนดค่าโฮสต์เสมือนให้ใช้คีย์สโตร์หรือทรัสต์สโตร์ ให้คลิกแสดงเพื่อดูข้อมูลเพิ่มเติม

หากกำหนดค่าโฮสต์เสมือนให้ใช้ TLS/SSL ไอคอนแม่กุญแจจะปรากฏข้างชื่อโฮสต์เสมือน ซึ่งหมายความว่ามีการอัปโหลดใบรับรอง TLS/SSL, คีย์ และเชนใบรับรองไปยัง Edge และเชื่อมโยงกับโฮสต์เสมือนแล้ว วิธีดูข้อมูลเกี่ยวกับใบรับรองที่มี

  1. เลือกผู้ดูแลระบบ > สภาพแวดล้อม > กระเป๋าสตางค์ TLS ในแถบนําทางด้านซ้าย
  2. เลือกสภาพแวดล้อม (ปกติจะเป็น prod หรือ test)
  3. ขยายที่เก็บคีย์เพื่อดูใบรับรอง

Edge แบบคลาสสิก (ระบบคลาวด์ส่วนตัว)

วิธีดูข้อมูลเกี่ยวกับโฮสต์เสมือนโดยใช้ UI ของ Edge แบบคลาสสิก

  1. ลงชื่อเข้าใช้ http://ms-ip:9000 โดยที่ ms-ip คือที่อยู่ IP หรือชื่อ DNS ของโหนดเซิร์ฟเวอร์การจัดการ
  2. เลือกผู้ดูแลระบบ > โฮสต์เสมือนในแถบนำทางด้านซ้าย
  3. เลือกสภาพแวดล้อม เช่น prod หรือ test
  4. คลิกแท็บโฮสต์เสมือน

    โฮสต์เสมือนที่กําหนดไว้สําหรับสภาพแวดล้อมจะปรากฏขึ้น หากกำหนดค่าโฮสต์เสมือนให้ใช้คีย์สโตร์หรือทรัสต์สโตร์ ให้คลิกแสดงเพื่อดูข้อมูลเพิ่มเติม

    แท็บโฮสต์เสมือนจะแสดงข้อมูลเกี่ยวกับชื่อ พอร์ต และอีเมลแทน และอื่นๆ

หากกำหนดค่าโฮสต์เสมือนให้ใช้ TLS/SSL ไอคอนแม่กุญแจจะปรากฏข้างชื่อโฮสต์เสมือน ซึ่งหมายความว่ามีการอัปโหลดใบรับรอง TLS/SSL, คีย์ และเชนใบรับรองไปยัง Edge และเชื่อมโยงกับโฮสต์เสมือนแล้ว วิธีดูข้อมูลเกี่ยวกับใบรับรองที่มี

  1. เลือกผู้ดูแลระบบ > ใบรับรอง TLS ในแถบนำทางด้านบน
  2. เลือกสภาพแวดล้อม (ปกติจะเป็น prod หรือ test)
  3. ขยายที่เก็บคีย์เพื่อดูใบรับรอง

การดูโฮสต์เสมือนด้วย Edge API

นอกจากนี้ คุณยังใช้ Edge API เพื่อดูข้อมูลเกี่ยวกับโฮสต์เสมือนได้ด้วย เช่น List Virtual 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"
]

หากต้องการดูข้อมูลเกี่ยวกับโฮสต์เสมือนที่เฉพาะเจาะจง ให้ใช้ Get Virtual Host 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 เป็น "secure" เพื่อดูการกําหนดค่าของโฮสต์เสมือนที่ปลอดภัยเริ่มต้นที่ 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>

การกำหนดค่าพร็อกซี API ให้ใช้โฮสต์เสมือน

เมื่อคุณสร้างพร็อกซี API ใหม่ Edge จะกําหนดค่าให้ใช้โฮสต์เสมือนทั้งหมดที่มีอยู่ในองค์กรโดยอัตโนมัติ คําขอพร็อกซี API ผ่านโฮสต์เสมือนใช้รูปแบบดังนี้

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

สถานที่:

  • host-alias มักจะเป็นชื่อ DNS ของโฮสต์เสมือน
  • proxy-base-path จะกำหนดเมื่อคุณสร้างพร็อกซี API และจะไม่ซ้ำกันสำหรับพร็อกซี API แต่ละรายการ
  • resource-path เส้นทางไปยังทรัพยากรที่เข้าถึงได้ผ่านพร็อกซี API

การควบคุมโฮสต์เสมือนที่พร็อกซี API ใช้

ในการกำหนดค่า XML ของพร็อกซี API คุณใช้แท็ก virtualhost เพื่อระบุชื่อของโฮสต์เสมือนที่เชื่อมโยงกับพร็อกซี API ดังนี้

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

เช่น <VirtualHost>secure</VirtualHost> หมายความว่าไคลเอ็นต์สามารถเรียกใช้พร็อกซี API โดยใช้อีเมลแทนของโฮสต์เสมือน "ปลอดภัย"

โดยทั่วไป คุณควรแก้ไขโฮสต์เสมือนที่เชื่อมโยงกับพร็อกซี API ในกรณีต่อไปนี้

  • คุณสร้างโฮสต์เสมือนใหม่และมีพร็อกซี API ที่มีอยู่ คุณต้องแก้ไขพร็อกซี API ที่มีอยู่เพื่อเพิ่มโฮสต์เสมือนใหม่
  • คุณสร้างพร็อกซี API ใหม่ที่ไม่ควรเข้าถึงได้ผ่านโฮสต์เสมือนหนึ่งๆ คุณต้องแก้ไขพร็อกซี API เพื่อนำโฮสต์เสมือนดังกล่าวออกจากคําจํากัดความ

วิธีแก้ไขโฮสต์เสมือนที่เชื่อมโยงกับพร็อกซี API

  1. เข้าถึงเครื่องมือแก้ไขพร็อกซี API ตามที่อธิบายไว้ด้านล่าง

    Edge

    วิธีเข้าถึงเครื่องมือแก้ไขพร็อกซี API โดยใช้ UI ของ Edge

    1. ลงชื่อเข้าใช้ apigee.com/edge

      ลูกค้า Edge for Private Cloud ใช้ http://ms-ip:9000 (ในองค์กร) โดยที่ ms-ip คือที่อยู่ IP หรือชื่อ DNS ของโหนดเซิร์ฟเวอร์การจัดการ

    2. เลือกพัฒนา > พร็อกซี API ในแถบนําทางด้านซ้าย
    3. เลือกพร็อกซี API ที่ต้องการแก้ไขในรายการ

    Edge แบบคลาสสิก (ระบบคลาวด์ส่วนตัว)

    วิธีเข้าถึงเครื่องมือแก้ไขพร็อกซี API โดยใช้ UI ของ Edge แบบคลาสสิก

    1. ลงชื่อเข้าใช้ http://ms-ip:9000 โดยที่ ms-ip คือที่อยู่ IP หรือชื่อ DNS ของโหนดเซิร์ฟเวอร์การจัดการ
    2. เลือก API > พร็อกซี API ในแถบนําทางด้านบน
    3. เลือกพร็อกซี API ที่ต้องการแก้ไขในรายการ
  2. คลิกแท็บพัฒนา
  3. เลือกค่าเริ่มต้นในส่วนปลายทางพร็อกซี
  4. ในพื้นที่โค้ด ให้ทำดังนี้
    1. นําองค์ประกอบ <VirtualHost> ออกสําหรับโฮสต์เสมือนที่พร็อกซี API ไม่รองรับ
    2. เพิ่มองค์ประกอบ <VirtualHost> ใหม่ที่มีชื่อของโฮสต์เสมือนใหม่ ตัวอย่างเช่น หากโฮสต์เสมือนใหม่ชื่อ MyVirtualHost ให้เพิ่มแท็กต่อไปนี้
      <HTTPProxyConnection>
        <BasePath>/v1/my/proxy/basepath</BasePath>
        <VirtualHost>default</VirtualHost>
        <VirtualHost>secure</VirtualHost>
        <VirtualHost>MyVirtualHost</VirtualHost>
      </HTTPProxyConnection>
  5. บันทึกพร็อกซี API หากมีการใช้พร็อกซี API อยู่แล้ว การบันทึกจะทําให้ระบบนําพร็อกซีไปใช้ใหม่ด้วยการตั้งค่าใหม่

การตั้งค่า URL พื้นฐานที่แสดงโดย UI ของ Edge สําหรับพร็อกซี API

UI ของ Edge จะแสดง URL ของพร็อกซี API ตามการตั้งค่าในโฮสต์เสมือนซึ่งสอดคล้องกับตำแหน่งที่ติดตั้งใช้งานพร็อกซี การแสดงผลนี้อาจมีหมายเลขพอร์ตเราเตอร์ของโฮสต์เสมือน

ในกรณีส่วนใหญ่ URL ที่แสดงใน UI ของ Edge คือ URL ที่ถูกต้องสำหรับการส่งคำขอภายนอกไปยังพร็อกซี อย่างไรก็ตาม URL ที่แสดงไม่ถูกต้องสำหรับการกำหนดค่าบางอย่าง ตัวอย่างเช่น การกําหนดค่าอย่างใดอย่างหนึ่งต่อไปนี้อาจทําให้ URL ที่แสดงไม่ตรงกับ URL จริงที่ใช้ส่งคําขอภายนอกไปยังพร็อกซี

  • การสิ้นสุด SSL เกิดขึ้นที่ตัวจัดสรรภาระงาน
  • การแมปพอร์ตเกิดขึ้นระหว่างตัวจัดสรรภาระงานกับเราเตอร์ Apigee
  • ตัวจัดสรรภาระงานที่กําหนดค่าด้วยการเขียนเส้นทางใหม่

Edge รองรับแอตทริบิวต์ในโฮสต์เสมือนที่เรียกว่า <BaseUrl> ซึ่งให้คุณลบล้าง URL ที่แสดงโดย UI ของ Edge ได้ ต่อไปนี้คือตัวอย่างที่แสดงออบเจ็กต์โฮสต์เสมือนที่มีแอตทริบิวต์ <BaseUrl> ในตัวอย่างนี้ ค่า "http://myCo.com" จะปรากฏใน UI ของ 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 เริ่มต้นที่แสดงผลโดย UI ของ Edge จะปรากฏเป็น "api.myCompany.com" ส่วนอีเมลแทนของโฮสต์จริงคือ "http://myCo.com"