Mengonfigurasi penerusan proxy untuk proxy API

Proxy penerusan menyediakan satu titik yang digunakan beberapa mesin untuk mengirim permintaan ke server eksternal. Mereka dapat menerapkan kebijakan keamanan, mencatat dan menganalisis permintaan, serta melakukan tindakan lain agar permintaan mematuhi aturan bisnis Anda.

Dengan menggunakan proxy teruskan di Apigee Hybrid, Anda dapat mencegat dan mengelola semua traffic keluar dari cluster Kubernetes. Hal ini mencakup permintaan proxy API ke Endpoint Target dan komunikasi dengan *.googleapis.com yang dilakukan runtime hybrid untuk pipeline debug dan analisisnya serta untuk kebijakan seperti MessageLogging dan kebijakan AI (seperti SanitizeUserPrompt dan SemanticCacheLookup).

Untuk menggunakan proxy teruskan HTTP antara hybrid dan TargetEndpoint, Anda harus mengonfigurasi setelan proxy keluar dalam file penggantian. Properti yang tercakup dalam lingkungan ini mengarahkan permintaan target dari hybrid ke proxy penerusan HTTP. Anda juga perlu memastikan use.proxy disetel ke "true" untuk TargetEndpoint yang ingin Anda lewati melalui proxy penerusan HTTP. Lihat bagian bawah halaman untuk mengetahui petunjuknya.

Untuk mengonfigurasi lingkungan hybrid untuk proxy penerusan, tambahkan properti envs.httpProxy ke file penggantian Anda dan terapkan ke cluster. Contoh:

envs:
  - name: test
    httpProxy:
      scheme: HTTP
      host: 10.12.0.47
      port: 3128
      ...

Untuk mengetahui detail setiap properti konfigurasi envs.httpProxy, lihat Referensi properti konfigurasi.

Proxy penerusan dikonfigurasi untuk lingkungan; semua traffic yang berasal dari proxy API di lingkungan tersebut ke target backend melewati proxy penerusan HTTP yang ditentukan. Jika traffic untuk target tertentu dari proxy API harus langsung menuju target backend, dengan melewati proxy penerusan, tetapkan properti berikut di TargetEndpoint untuk mengganti proxy penerusan HTTP:

<Property name="use.proxy">false</Property>

Untuk mengetahui informasi selengkapnya tentang cara menyetel properti TargetEndpoint, termasuk cara mengonfigurasi koneksi ke endpoint target, lihat Referensi properti endpoint.

Tetapkan use.proxy ke "true" untuk TargetEndpoint yang ingin Anda teruskan melalui proxy teruskan HTTP:

<Property name="use.proxy">true</Property>

Jika Anda memiliki firewall di backend yang dikonfigurasi agar Host Header selalu menyertakan nama host server backend, sementara Message Processor mengirimkan nama host server proxy, lakukan langkah-langkah berikut untuk mengonfigurasi opsi ini:

Tetapkan properti use.proxy.host.header.with.target.uri ke benar (true) di TargetEndpoint seperti yang ditunjukkan dalam contoh berikut:

Contoh konfigurasi TargetEndpoint:

  <TargetEndpoint name="default">
    <HTTPTargetConnection>
      <URL>https://mocktarget.apigee.net/json</URL>
      <Properties>
        <Property name="use.proxy.host.header.with.target.uri">true</Property>
      </Properties>
    </HTTPTargetConnection>
  </TargetEndpoint>

Untuk mengetahui detail properti use.proxy.host.header.with.target.uri, lihat Referensi properti endpoint.

Kebijakan AI dan proxy teruskan

Kebijakan Model Armor (SanitizeUserPrompt dan SanitizeModelResponse) serta kebijakan cache semantik (SemanticCacheLookup dan SemanticCachePopulate) melakukan panggilan keluar saat memproses permintaan dan respons. Hal ini mencakup panggilan sanitasi Model Armor, dan embedding teks Agent Platform, Penelusuran Vektor findNeighbors, dan panggilan upsertDatapoints.

Jika proxy penerusan dikonfigurasi untuk lingkungan dengan envs.httpProxy, semua panggilan di atas akan dirutekan melalui proxy penerusan secara default, tanpa memerlukan konfigurasi tingkat kebijakan. Perilaku ini berlaku bahkan untuk endpoint yang tidak berada di bawah *.googleapis.com, seperti endpoint Penelusuran Vektor publik yang dipanggil oleh SemanticCacheLookup.

Panggilan kebijakan ini ke layanan eksternal diperlakukan sama dengan traffic analisis dan rekaman aktivitas runtime: menyetel envs[].managementCallsSkipProxy ke true akan membuat panggilan tersebut melewati proxy penerusan dan langsung keluar. Melewati proxy penerusan berlaku untuk semua panggilan yang tercantum di atas (yaitu, pembersihan, penyematan teks, findNeighbors, dan upsertDatapoints). Perilaku proxy penerusan tingkat proxy ini terpisah dari TargetEndpoint, yang perilaku proxy penerusannya dikontrol oleh properti use.proxy-nya sendiri.