Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Hub API Apigee

Konektor hub API Apigee memungkinkan Anda mengelola, menemukan, dan mengatur API dalam portofolio organisasi Anda.

Versi yang didukung

Konektor ini mendukung hub API Apigee versi v1.

Sebelum memulai

• Di project Google Cloud Anda, lakukan tugas berikut:

  • Pastikan konektivitas jaringan telah disiapkan. Untuk mengetahui informasi tentang pola jaringan, lihat Konektivitas jaringan.
  • Berikan peran IAM roles/connectors.admin kepada pengguna yang mengonfigurasi konektor.
  • Aktifkan layanan berikut:
    • secretmanager.googleapis.com (Secret Manager API)
    • connectors.googleapis.com (Connectors API)

    Untuk memahami cara mengaktifkan layanan, lihat Mengaktifkan layanan. Jika layanan atau izin ini belum diaktifkan untuk project Anda sebelumnya, Anda akan diminta untuk mengaktifkannya saat mengonfigurasi konektor.

• Jika Anda menggunakan autentikasi akun layanan, bukan autentikasi OAuth 2.0, pastikan izin yang sesuai diberikan ke akun layanan. Untuk mengetahui informasi selengkapnya, lihat Peran IAM bawaan.

Membuat koneksi hub API Apigee

Koneksi khusus untuk sumber data. Artinya, jika Anda memiliki banyak sumber data, Anda harus membuat koneksi terpisah untuk setiap sumber data. Untuk membuat koneksi, lakukan hal berikut:

1. Di Konsol Cloud, buka halaman Integration Connectors > Connections lalu pilih atau buat project Google Cloud.

   Buka halaman Koneksi

2. Klik + Buat baru untuk membuka halaman Buat Koneksi.
3. Di bagian Lokasi, pilih lokasi dari daftar Wilayah, lalu klik Berikutnya.

   Untuk mengetahui daftar semua region yang didukung, lihat Lokasi.

4. Di bagian Detail Koneksi, lakukan hal berikut:
   1. Pilih Apigee API hub dari daftar Connector.
   2. Pilih versi konektor dari daftar Connector version.
   3. Di kolom Nama Koneksi, masukkan nama untuk instance koneksi. Nama koneksi dapat berisi huruf kecil, angka, atau tanda hubung. Nama harus diawali dengan huruf dan diakhiri dengan huruf atau angka, serta tidak boleh lebih dari 49 karakter.
   4. Secara opsional, masukkan Deskripsi untuk instance koneksi.
   5. Secara opsional, aktifkan Cloud Logging, lalu pilih level log. Secara default, level log ditetapkan ke Error.
   6. Akun Layanan: Pilih akun layanan yang memiliki peran yang diperlukan.
   7. (Opsional) Konfigurasi setelan node Koneksi.
   • Jumlah minimum node: Masukkan jumlah minimum node koneksi.
   • Maximum number of nodes: Masukkan jumlah maksimum node koneksi.

   Node adalah unit (atau replika) koneksi yang memproses transaksi. Jumlah node yang diperlukan untuk memproses lebih banyak transaksi untuk koneksi akan bertambah dan sebaliknya, jumlah node yang diperlukan untuk memproses lebih sedikit transaksi akan berkurang. Untuk memahami pengaruh node terhadap harga konektor, lihat Harga untuk node koneksi. Jika Anda tidak memasukkan nilai apa pun, secara default node minimum ditetapkan ke 2 (untuk ketersediaan yang lebih baik) dan node maksimum ditetapkan ke 50.

   Catatan: Anda hanya dapat menyesuaikan nilai node koneksi jika Anda adalah pelanggan Bayar sesuai penggunaan.
   8. Klik Berikutnya.
5. Di bagian Destinations, masukkan detail host jarak jauh (sistem backend) yang ingin Anda hubungkan.
   1. Di kolom Jenis Tujuan, pilih tujuan.
   2. Di kolom Alamat host, tentukan nama host atau alamat IP tujuan.

   3. Jika perlu, untuk memasukkan tujuan tambahan, klik +TAMBAHKAN TUJUAN.

   4. Klik Berikutnya.
6. Di bagian Authentication, masukkan detail autentikasi.
   1. Pilih Jenis autentikasi dan masukkan detail yang relevan.

      Jenis autentikasi berikut didukung oleh koneksi hub API Apigee:

      • OAuth 2.0 - Kode otorisasi
      • Autentikasi akun layanan

   Untuk memahami cara mengonfigurasi jenis autentikasi ini, lihat Mengonfigurasi autentikasi.

   2. Klik Berikutnya.
7. Tinjau detail koneksi dan autentikasi Anda, lalu klik Buat.

Mengonfigurasi autentikasi

Masukkan detail berdasarkan autentikasi yang ingin Anda gunakan.

• OAuth 2.0 - Kode otorisasi: Pilih opsi ini untuk mengautentikasi menggunakan alur login pengguna berbasis web. Tentukan detail berikut:
• Client ID: Client ID yang diperlukan untuk terhubung ke layanan hub Apigee API backend Anda.
• Cakupan: Daftar cakupan yang diinginkan yang dipisahkan koma. Untuk melihat semua cakupan OAuth 2.0 yang didukung untuk layanan Google yang Anda perlukan, lihat bagian yang relevan di halaman Cakupan OAuth 2.0 untuk Google API.
• Client secret: Pilih Secret Manager secret. Anda harus membuat Secret Manager secret sebelum mengonfigurasi otorisasi ini.
• Versi secret: Versi secret Secret Manager untuk secret klien.

Untuk jenis autentikasi Authorization code, setelah membuat koneksi, Anda harus mengizinkan koneksi.

• Autentikasi akun layanan: Pilih opsi ini untuk mengautentikasi menggunakan akun layanan yang Anda berikan pada langkah sebelumnya saat mengonfigurasi koneksi ini. Pastikan Anda telah memberikan peran dan izin IAM yang relevan kepada akun layanan yang diperlukan untuk autentikasi.
  • Cakupan: Pilih cakupan OAuth 2.0 yang diperlukan dari drop-down. Untuk mengetahui informasi selengkapnya, lihat Cakupan akses.

Memberi otorisasi koneksi

Jika Anda menggunakan kode otorisasi OAuth 2.0 untuk mengautentikasi koneksi, selesaikan tugas berikut setelah Anda membuat koneksi.

1. Di halaman Koneksi, temukan koneksi yang baru dibuat.

   Perhatikan bahwa Status untuk konektor baru akan menjadi Otorisasi diperlukan.

2. Klik Otorisasi diperlukan.

   Tindakan ini akan menampilkan panel Edit otorisasi.

3. Salin nilai Redirect URI ke aplikasi eksternal Anda.
4. Verifikasi detail otorisasi.
5. Klik Otorisasi.

   Jika otorisasi berhasil, status koneksi akan disetel ke Aktif di halaman Koneksi.

Otorisasi ulang untuk kode otorisasi

Jika Anda menggunakan jenis autentikasi Authorization code dan telah melakukan perubahan konfigurasi di hub Apigee API, Anda harus mengotorisasi ulang koneksi hub Apigee API. Untuk memberikan kembali otorisasi koneksi, lakukan langkah-langkah berikut:

1. Klik koneksi yang diperlukan di halaman Koneksi.

   Tindakan ini akan membuka halaman detail koneksi.

2. Klik Edit untuk mengedit detail koneksi.
3. Verifikasi detail OAuth 2.0 - Authorization code di bagian Authentication.

   Jika diperlukan, lakukan perubahan yang diperlukan.

4. Klik Simpan. Tindakan ini akan mengarahkan Anda ke halaman detail koneksi.
5. Klik Edit otorisasi di bagian Autentikasi. Tindakan ini akan menampilkan panel Authorize.
6. Klik Otorisasi.

   Jika otorisasi berhasil, status koneksi akan disetel ke Aktif di halaman Koneksi.

Batasan sistem

Konektor hub API Apigee dapat memproses maksimum 20 transaksi per detik, per node, dan membatasi transaksi apa pun yang melebihi batas ini. Secara default, Integration Connectors mengalokasikan 2 node (untuk ketersediaan yang lebih baik) untuk koneksi.

Untuk mengetahui informasi tentang batas yang berlaku untuk Integration Connectors, lihat Batas.

Catatan: Jumlah node Integration Connectors akan diskalakan otomatis secara dinamis berdasarkan penggunaan Anda. Namun, jika ingin mencadangkan kapasitas untuk volume besar tanpa menunggu penskalaan otomatis, Anda dapat menyesuaikan nilai node minimum untuk koneksi. Jumlah node yang diperlukan meningkat saat jumlah transaksi yang diproses untuk koneksi bertambah. Sebaliknya, jumlah node yang diperlukan lebih sedikit jika koneksi memproses lebih sedikit transaksi. Untuk mengonfigurasi nilai node, lakukan hal berikut:

• Jika Anda adalah pelanggan prabayar, konfigurasikan nilai node minimum dan maksimum di halaman edit koneksi.
• Jika Anda adalah pelanggan berbasis langganan, hubungi dukungan.

Jumlah transaksi maksimum yang dapat ditangani oleh sebuah node bergantung pada berbagai faktor. Jadi, sebelum menyesuaikan node minimum untuk mendapatkan throughput yang lebih baik, sebaiknya periksa apakah sistem backend Anda telah disiapkan secara optimal untuk menangani traffic yang diperlukan.

Menggunakan koneksi hub API Apigee dalam integrasi

Setelah Anda membuat koneksi, koneksi tersebut akan tersedia di Integrasi Aplikasi. Anda dapat menggunakan koneksi dalam integrasi melalui tugas Konektor.

Tindakan

Konektor ini menyediakan lapisan abstraksi untuk objek layanan backend yang terhubung. Anda hanya dapat mengakses objek backend melalui abstraksi ini. Abstraksi ini ditampilkan kepada Anda sebagai tindakan. Action adalah fungsi kelas utama yang tersedia untuk integrasi melalui antarmuka konektor. Tindakan memungkinkan Anda membuat perubahan pada satu atau beberapa entitas, dan bervariasi dari konektor ke konektor. Namun, ada kemungkinan konektor tidak mendukung tindakan apa pun, dalam hal ini daftar Actions akan kosong.

Masalah umum

Konektor hub API Apigee memiliki batas konfigurasi. Resource yang dapat ditelusuri dibatasi hingga 2,5 MB, dan file spesifikasi API memiliki batas 10 MB. Untuk mengetahui informasi selengkapnya, lihat Batas pada hub API Apigee.

Mendapatkan bantuan dari komunitas Google Cloud

Anda dapat memposting pertanyaan dan mendiskusikan konektor ini di komunitas Google Cloud di Forum Cloud.

Langkah berikutnya

• Pahami cara menangguhkan dan melanjutkan koneksi.
• Pahami cara memantau penggunaan konektor.
• Pahami cara melihat log konektor.