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 siano accessibili tramite endpoint HTTP.

Crea una connessione HTTP

Le connessioni HTTP supportano l'autenticazione Basic (nome utente e password) e l'autenticazione con token di tipo Bearer. 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.

  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/exampletool-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.