Halaman ini diterjemahkan oleh Cloud Translation API.

Memulai target Integration proxy Apigee dan Application Integration

Tutorial ini menunjukkan cara menggunakan wizard proxy Apigee untuk membuat proxy dengan Target integrasi. Proxy menggunakan referensi pemicu API dari integrasi yang ada untuk memulai urutan langkah dalam integrasi.

Langkah-langkah di bawah menjelaskan cara mengonfigurasi proxy Target integrasi untuk menjalankan integrasi yang berhasil saat proxy dipanggil.

Sebelum memulai

Konfirmasi kredensial login Apigee dan detail organisasi Anda. Informasi ini diperlukan untuk mengakses fitur Integrasi Aplikasi dan wizard proxy dalam UI Apigee.
Buat dan publikasikan integrasi dengan Pemicu API dan setidaknya satu tugas.
- Jika Anda belum membuat integrasi yang menggunakan Pemicu API, ikuti langkah-langkah di Mengambil payload API dan mengirim email.
- Catat nama integrasi yang Anda buat, atau integrasi yang sudah ada yang ingin Anda gunakan, karena integrasi ini akan digunakan pada langkah berikutnya.
Buat akun layanan Google di project Google Cloud yang sama dengan tempat organisasi Apigee Anda dibuat, lalu lakukan hal berikut:
- Tetapkan peran Application Integration Invoker (roles/integrations.applicationIntegrationInvokerRole) ke akun layanan. Untuk mengetahui informasi tentang peran Integrasi Aplikasi bawaan, lihat Peran IAM bawaan.
- Izinkan akun pengguna (akun utama) Anda untuk melampirkan akun layanan ke resource dengan izin iam.serviceAccounts.actAs. Untuk informasi tentang izin akun layanan, lihat Peran untuk autentikasi akun layanan .
Anda harus memberikan akun layanan ini saat men-deploy proxy API.
Jika ingin menggunakan Application Integration tanpa batasan apa pun, Anda dapat membayar integrasi tersebut. Integrasi Aplikasi tersedia sebagai layanan add-on untuk langganan Anda. Jika Anda telah membeli hak istimewa Integrasi Aplikasi, dan ingin mengaktifkan hak istimewa ke project Google Cloud atau organisasi Apigee, hubungi dukungan Apigee. Namun, jika Anda ingin membeli hak Application Integration, hubungi tim penjualan Apigee. Setelah Integrasi Aplikasi diaktifkan untuk Anda, lakukan tugas berikut:
1. Aktifkan API berikut:
  - Apigee API (apigee.googleapis.com)
  - Application Integration API (integrations.googleapis.com)
  - Secret Manager API (secretmanager.googleapis.com)
  - Connectors API (connectors.googleapis.com)
  Untuk mengetahui informasi tentang cara mengaktifkan API, lihat Mengaktifkan layanan.
2. Aktifkan add-on Integrasi dan Konektor untuk organisasi Apigee Anda.
  - Jika Anda membuat organisasi baru untuk digunakan dalam Integrasi, jalankan perintah berikut:
```
curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" -d '{"name":"${ORG_ID}", "analyticsRegion":"us-west1", "authorized_network":"${NETWORK_ID}", "runtimeType":"CLOUD", "runtimeDatabaseEncryptionKeyName":"${ENCRYPTION_KEY_NAME}", "addonsConfig": {"integrationConfig": {"enabled": true}, "connectorsPlatformConfig":{"enabled":true}}}' "https://apigee.googleapis.com/v1/organizations?parent=projects/${PROJECT_ID}"
```
  - Jika Anda menggunakan organisasi yang sudah ada, jalankan perintah berikut:
```
curl -H "Authorization: Bearer $TOKEN" -H "content-type:application/json" "https://apigee.googleapis.com/v1/organizations/${ORG_ID}:setAddons" -XPOST -d '{"addonsConfig":{"integrationConfig":{"enabled":true},"connectorsPlatformConfig":{"enabled":true}}}'
```
3. Pastikan apakah add-on berhasil diaktifkan menggunakan perintah berikut:
```
curl -H "Authorization: Bearer $TOKEN"  -H "content-type:application/json" "https://apigee.googleapis.com/v1/organizations/${ORG_ID}"
```
  Menjalankan perintah akan menampilkan pesan yang mirip dengan berikut:
```
{
  "name": "Test....",
  "createdAt": "1615483867669",
  "lastModifiedAt": "1615483873468",
  …...
  "addonsConfig": {
    "integrationConfig": {
      "enabled": true,
    "connectorsPlatformConfig": {
      "enabled": true
    }
  }
  }
```
  Catatan:
  - Saat Anda menjalankan perintah add-on, perintah tersebut akan menimpa add-on yang ada. Oleh karena itu, jika Anda memiliki add-on yang sudah ada, sertakan dalam perintah add-on.
  - Menonaktifkan add-on akan menghapus semua konfigurasi add-on (fitur). Misalnya, jika Anda menonaktifkan add-on Integrasi, semua integrasi akan dihapus.
4. Tetapkan peran IAM berikut ke akun layanan Apigee default Anda(service-PROJECT_NUMBER@gcp-sa-apigee.iam.gserviceaccount.com):
  - Application Integration Invoker (roles/integrations.applicationIntegrationInvokerRole)
  Untuk mengetahui informasi tentang cara memberikan peran atau izin tambahan ke akun layanan, lihat Memberikan, mengubah, dan mencabut akses.

Membuat proxy target Application Integration

Lakukan hal berikut untuk membuat proxy Target integrasi di UI Apigee:

Buka UI Apigee dan login.
Pilih organisasi Anda menggunakan menu drop-down di pojok kiri atas UI.
Klik API Proxies di tampilan utama.
Atau, Anda dapat memilih Develop > API Proxies di menu navigasi sebelah kiri.
Dari menu drop-down Environment, pilih lingkungan tempat Anda ingin membuat proxy API baru.
Klik Buat Baru.
Pilih Target integrasi dari tampilan jenis proxy.
Wizard Create Proxy akan dimulai.
Di halaman konfigurasi Proxy details, berikan detail berikut:
- Nama: Masukkan nama untuk proxy.
  Nama proxy dapat berisi karakter alfanumerik, tanda hubung, dan garis bawah.
- Base Path: Kolom ini terisi otomatis berdasarkan nama proxy.
  Jalur Dasar adalah bagian dari URL yang digunakan untuk membuat permintaan ke API Anda. Apigee menggunakan URL untuk mencocokkan dan merutekan permintaan masuk ke proxy API yang sesuai.
- Deskripsi: (Opsional) Masukkan deskripsi singkat tentang proxy.
  Misalnya, Proxy test for Application Integration.
- Region integrasi: Pilih region integrasi dari menu drop-down.
- Target integrasi: Pilih nama target integrasi dari menu drop-down. Perhatikan bahwa daftar target integrasi diisi berdasarkan region integrasi yang dipilih.
- Pemicu: Pilih pemicu API yang terkait dengan integrasi dari menu drop-down.
- Endpoint type: Pilih Sync.
Klik Berikutnya.
Di halaman konfigurasi Common policies, biarkan pilihan default, lalu klik Next.
Di halaman Ringkasan, klik Buat.
Proxy Target integrasi berhasil dibuat.

Men-deploy proxy

Lakukan langkah-langkah berikut untuk men-deploy proxy yang baru dibuat:

Di UI Apigee, pilih Develop > API Proxies.
UI menampilkan daftar proxy API dan status deployment-nya.
Dari menu drop-down Environment, pilih lingkungan tempat Anda ingin men-deploy proxy API.
Klik proxy yang baru dibuat yang ingin Anda deploy. UI menampilkan halaman Ringkasan secara default.
Untuk men-deploy perubahan, klik Deploy terlebih dahulu untuk menampilkan dialog Deploy.
Masukkan hal berikut:
- Revision: Nomor revisi proxy yang ingin Anda deploy.
- Lingkungan: Lingkungan tempat Anda ingin men-deploy proxy.
- Akun layanan: Akun layanan yang dibuat untuk proxy.
Klik Deploy.

UI memulai proses deployment revisi yang dipilih. Mungkin perlu waktu hingga satu menit untuk menyelesaikan deployment proxy.

Saat proxy di-deploy, kolom Status di bagian Deployment akan menampilkan ikon hijau untuk menunjukkan bahwa revisi 1 proxy telah di-deploy.

Catatan: Tidak ada elemen Authentication eksplisit dalam definisi kebijakan Set Integration Request proxy. Apigee menambahkan token autentikasi ke permintaan secara otomatis.

Agar kebijakan Set Integration Request berhasil diautentikasi, Anda harus men-deploy Integration target dengan akun layanan yang memiliki peran IAM yang diperlukan untuk menjalankan integrasi. Untuk mengetahui detail selengkapnya tentang cara men-deploy proxy API, lihat Men-deploy di Apigee.

Menguji proxy target Integrasi

Jalankan perintah berikut dari jendela terminal untuk memanggil proxy dan memicu integrasi:

curl -v https://YOUR_ENV_GROUP_HOSTNAME/PROXY_NAME

dengan YOUR_ENV_GROUP_HOSTNAME adalah nama host untuk grup lingkungan yang berisi lingkungan tempat proxy Anda di-deploy.

Contoh:

curl -v https://my-org-prod.hybrid.e2e.apigeeks.net/my-proxy

Untuk mengonfirmasi bahwa integrasi dipicu dengan memanggil proxy:

Buka UI Apigee.
Klik Develop > Integrations.
Telusuri atau pilih nama integrasi yang dibuat pada langkah-langkah di atas, lalu klik nama integrasi.
Klik Logs.
Pastikan log eksekusi ada untuk integrasi yang dipicu. Untuk melihat detail log, klik baris untuk meluaskan detail eksekusi.

Memperbarui payload permintaan proxy (Opsional)

Gunakan langkah-langkah berikut untuk memperbarui payload permintaan proxy:

Di UI Apigee, pilih Develop > API Proxies di menu navigasi sebelah kiri.
Klik proxy yang baru dibuat.
Secara default, UI menampilkan tab Ringkasan untuk proxy tersebut di Editor Proxy.
Klik tab Mengembangkan.
Di panel Navigator, pilih Set Integration Request di bagian judul Policies.
Hapus komentar pada blok <Parameters>, lalu masukkan detail parameter Anda.
Untuk menentukan setiap parameter, gunakan elemen <Parameter>. Untuk menentukan array parameter, gunakan elemen <ParameterArray>.

Catatan: Blok Parameters dibiarkan dikomentari dalam tutorial ini hanya untuk memudahkan. Integrasi Aplikasi mendukung sejumlah parameter yang dapat diteruskan sebagai bagian dari kebijakan Tetapkan Permintaan Integrasi. Untuk informasi dan contoh selengkapnya, lihat kebijakan SetIntegrationRequest.
Klik Simpan.

Langkah berikutnya

Jelajahi Tata letak desainer integrasi dan pahami berbagai konsep integrasi yang dijelaskan di Semua konsep.