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 agli account connector, puoi anche configurare una connessione Developer Connect a un endpoint HTTP generico. In questo modo, puoi stabilire e gestire le connessioni a molti strumenti, servizi e API di sviluppatori di terze parti, a condizione che questi strumenti siano accessibili tramite endpoint HTTP.

Creare una connessione HTTP

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

Autenticazione con token di autenticazione

  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 della versione del secret di Secret Manager per il token di autenticazione.
    • SERVICE_DIRECTORY_SERVICE con il nome della risorsaService 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 della versione del 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 risorsaService 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.

Dopo aver creato la connessione, puoi accedervi utilizzando il nome della risorsa di connessione in Developer Connect.