Mengonfigurasi dan menggunakan koneksi HTTP generik

Halaman ini menjelaskan cara mengonfigurasi koneksi ke endpoint HTTP generik.

Selain koneksi repositori Git dan konektor akun, Anda juga dapat menyiapkan koneksi Developer Connect ke endpoint HTTP generik. Hal ini memungkinkan Anda membuat dan mengelola koneksi ke banyak alat, layanan, dan API developer pihak ketiga, selama alat tersebut dapat diakses menggunakan endpoint HTTP.

Misalnya, Anda dapat menyiapkan koneksi HTTP ke halaman di Confluence, lalu Gemini Code Assist dapat menggunakan koneksi tersebut untuk mengakses konten di halaman Confluence tersebut sebagai konteks.

Membuat koneksi HTTP

Koneksi HTTP mendukung Autentikasi Dasar (nama pengguna dan sandi) dan autentikasi token pembawa. Kedua jenis autentikasi mengharuskan Anda membuat secret di Secret Manager.

Autentikasi token pemilik

  1. Gunakan Secret Manager untuk membuat secret dan versi secret yang berisi token Anda.

    Token ini adalah token akses pribadi atau token API yang memberi Anda akses ke alat yang koneksinya sedang Anda buat. Misalnya, untuk Confluence, Anda akan menggunakan token API untuk akun Atlassian Anda.

  2. Untuk membuat koneksi menggunakan autentikasi token pembawa, jalankan perintah berikut:

    gcloud developer-connect connections create CONNECTION_ID \
--location=REGION \
--project=PROJECT_ID \
--http-config-host-uri=HOST_URI \
--http-config-bearer-token-authentication-secret-version=TOKEN_SECRET_VERSION \
--http-config-service-directory=SERVICE_DIRECTORY_SERVICE \
--http-config-ssl-ca-certificate=SSL_CERTIFICATE_FILE_PATH \
--git-proxy-config-enabled

    Ganti kode berikut:

    • CONNECTION_ID dengan ID unik untuk koneksi baru ini.
    • REGION dengan region Google Cloud tempat Anda membuat koneksi ini.
    • PROJECT_ID dengan ID project Google Cloud.
    • HOST_URI dengan endpoint HTTPS dasar (misalnya, https://api.myservice.com).
    • TOKEN_SECRET_VERSION dengan nama resource versi rahasia Secret Manager untuk token autentikasi.
    • SERVICE_DIRECTORY_SERVICE dengan nama resource Service Directory untuk akses jaringan pribadi. Tindakan tersebut bersifat opsional.
    • SSL_CERTIFICATE_FILE_PATH dengan jalur ke file lokal yang berisi konten sertifikat CA SSL. Tindakan tersebut bersifat opsional.
    • Sertakan opsi --git-proxy-config-enabled untuk mengakses koneksi ini menggunakan proxy Developer Connect.

Autentikasi dasar

  1. Gunakan Secret Manager untuk membuat secret dan versi secret, yang berisi nama pengguna dan sandi Anda.

  2. Untuk membuat koneksi menggunakan autentikasi dasar, jalankan perintah berikut:

    gcloud developer-connect connections create CONNECTION_ID \
--location=REGION \
--project=PROJECT_ID \
--http-config-host-uri=HOST_URI \
--http-config-basic-authentication-username=USERNAME \
--http-config-basic-authentication-password-secret-version=PASSWORD_SECRET_VERSION \
--http-config-service-directory=SERVICE_DIRECTORY_SERVICE \
--http-config-ssl-ca-certificate=SSL_CERTIFICATE_FILE_PATH \
--git-proxy-config-enabled \

    Ganti kode berikut:

    • CONNECTION_ID dengan ID unik untuk koneksi baru ini.
    • REGION dengan region Google Cloud tempat Anda membuat koneksi ini.
    • PROJECT_ID dengan ID project Google Cloud.
    • HOST_URI dengan endpoint HTTPS dasar (misalnya, https://api.myservice.com).
    • USERNAME dengan nama pengguna untuk autentikasi nama pengguna-sandi dasar.
    • PASSWORD_SECRET_VERSION dengan nama resource versi secret Secret Manager untuk sandi, untuk autentikasi nama pengguna-sandi dasar. (Misalnya: projects/01234567890/secrets/confluence-api-pw/versions/1.)
    • SERVICE_DIRECTORY_SERVICE dengan nama resource Service Directory untuk akses jaringan pribadi. Tindakan tersebut bersifat opsional.
    • SSL_CERTIFICATE_FILE_PATH dengan jalur ke file lokal yang berisi konten sertifikat CA SSL. Tindakan tersebut bersifat opsional.
    • Sertakan opsi --git-proxy-config-enabled untuk mengakses koneksi ini menggunakan proxy Developer Connect.

Setelah koneksi dibuat, Anda dapat mengaksesnya menggunakan nama resource koneksi di Developer Connect. Misalnya, Anda dapat menggunakan koneksi ini untuk memberikan akses RAG Gemini Code Assist ke resource di Confluence.