Configurare e utilizzare connessioni HTTP generiche

Questa pagina descrive come configurare una connessione a un endpoint HTTP generico.

Oltre alle connessioni ai repository Git e ai connettori dell'account, puoi anche configurare una connessione Developer Connect a un endpoint HTTP generico. In questo modo puoi stabilire e gestire connessioni a molti servizi, API e strumenti per sviluppatori di terze parti, a condizione che questi strumenti siano accessibili tramite endpoint HTTP.

Ad esempio, puoi configurare una connessione HTTP a una pagina di Confluence e poi Gemini Code Assist può utilizzare questa connessione per accedere ai contenuti di quella pagina di Confluence come contesto.

Crea una connessione HTTP

Le connessioni HTTP supportano l'autenticazione Basic (nome utente e password) e l'autenticazione con token di autenticazione. Entrambi i tipi di autenticazione richiedono di creare un secret in Secret Manager.

Autenticazione con token di connessione

  1. Utilizza Secret Manager per creare un secret e una versione del secret contenente il token.

    Il token è il tuo token di accesso personale o token API che ti consente di accedere allo strumento per cui stai creando questa connessione. Ad esempio, per Confluence, utilizzeresti il token API per il tuo account Atlassian.

  2. Per creare la connessione utilizzando l'autenticazione con token di autenticazione, esegui questo comando:

    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

    Sostituisci quanto segue:

    • CONNECTION_ID con un ID univoco per questa nuova connessione.
    • REGION con la regione Google Cloud in cui stai creando questa connessione.
    • PROJECT_ID con l'ID progetto Google Cloud.
    • HOST_URI con l'endpoint HTTPS di base (ad esempio, https://api.myservice.com).
    • TOKEN_SECRET_VERSION con il nome della risorsa versione del secret di Secret Manager per il token di autenticazione.
    • SERVICE_DIRECTORY_SERVICE con il nome della risorsa Service Directory per l'accesso alla rete privata. Questa opzione è facoltativa.
    • SSL_CERTIFICATE_FILE_PATH con il percorso di un file locale contenente il contenuto del certificato CA SSL. Questa opzione è facoltativa.
    • Includi l'opzione --git-proxy-config-enabled per accedere a questa connessione utilizzando il proxy Developer Connect.

Autenticazione di base

  1. Utilizza Secret Manager per creare un secret e una versione del secret contenente il nome utente e la password.

  2. Per creare la connessione utilizzando l'autenticazione di base, esegui questo comando:

    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 \

    Sostituisci quanto segue:

    • CONNECTION_ID con un ID univoco per questa nuova connessione.
    • REGION con la regione Google Cloud in cui stai creando questa connessione.
    • PROJECT_ID con l'ID progetto Google Cloud.
    • HOST_URI con l'endpoint HTTPS di base (ad esempio, https://api.myservice.com).
    • USERNAME con il nome utente per l'autenticazione di base con nome utente e password.
    • PASSWORD_SECRET_VERSION con il nome della risorsa versione secret di Secret Manager per la password, per l'autenticazione di base con nome utente e password. (Ad esempio: projects/01234567890/secrets/confluence-api-pw/versions/1.)
    • SERVICE_DIRECTORY_SERVICE con il nome della risorsa Service Directory per l'accesso alla rete privata. Questa opzione è facoltativa.
    • SSL_CERTIFICATE_FILE_PATH con il percorso di un file locale contenente il contenuto del certificato CA SSL. Questa opzione è facoltativa.
    • Includi l'opzione --git-proxy-config-enabled per accedere a questa connessione utilizzando il proxy Developer Connect.

Una volta creata la connessione, puoi accedervi utilizzando il nome della risorsa di connessione in Developer Connect. Ad esempio, puoi utilizzare questa connessione per concedere l'accesso RAG di Gemini Code Assist alle risorse in Confluence.