Configurer et utiliser des connexions HTTP génériques

Cette page explique comment configurer une connexion à un point de terminaison HTTP générique.

En plus des connexions de dépôt Git et des connecteurs de compte, vous pouvez également configurer une connexion Developer Connect à un point de terminaison HTTP générique. Cela vous permet d'établir et de gérer des connexions à de nombreux outils, services et API pour les développeurs tiers, à condition que ces outils soient accessibles à l'aide de points de terminaison HTTP.

Par exemple, vous pouvez configurer une connexion HTTP à une page Confluence, puis Gemini Code Assist peut utiliser cette connexion pour accéder au contenu de cette page Confluence en tant que contexte.

Créer une connexion HTTP

Les connexions HTTP sont compatibles avec l'authentification de base (nom d'utilisateur et mot de passe) et l'authentification par jeton du porteur. Les deux types d'authentification nécessitent que vous créiez un secret dans Secret Manager.

Authentification par jeton de support

  1. Utilisez Secret Manager pour créer un secret et une version du secret contenant votre jeton.

    Le jeton est votre jeton d'accès personnel ou votre jeton d'API qui vous donne accès à l'outil pour lequel vous créez cette connexion. Par exemple, pour Confluence, vous devez utiliser le jeton d'API de votre compte Atlassian.

  2. Pour créer la connexion à l'aide de l'authentification par jeton du porteur, exécutez la commande suivante :

    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

    Remplacez les éléments suivants :

    • CONNECTION_ID avec un ID unique pour cette nouvelle connexion.
    • REGION par la région Google Cloud dans laquelle vous créez cette connexion.
    • PROJECT_ID par l'ID du projet Google Cloud.
    • HOST_URI avec le point de terminaison HTTPS de base (par exemple, https://api.myservice.com).
    • TOKEN_SECRET_VERSION avec le nom de ressource de la version du secret Secret Manager pour le jeton d'authentification.
    • SERVICE_DIRECTORY_SERVICE avec le nom de ressource Annuaire des services pour l'accès au réseau privé. Cette opération est facultative.
    • SSL_CERTIFICATE_FILE_PATH par le chemin d'accès à un fichier local contenant le contenu du certificat SSL CA. Cette opération est facultative.
    • Incluez l'option --git-proxy-config-enabled pour accéder à cette connexion à l'aide du proxy Developer Connect.

Authentification de base

  1. Utilisez Secret Manager pour créer un secret et une version du secret contenant votre nom d'utilisateur et votre mot de passe.

  2. Pour créer la connexion à l'aide de l'authentification de base, exécutez la commande suivante :

    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 \

    Remplacez les éléments suivants :

    • CONNECTION_ID avec un ID unique pour cette nouvelle connexion.
    • REGION par la région Google Cloud dans laquelle vous créez cette connexion.
    • PROJECT_ID par l'ID du projet Google Cloud.
    • HOST_URI avec le point de terminaison HTTPS de base (par exemple, https://api.myservice.com).
    • USERNAME avec le nom d'utilisateur pour l'authentification de base par nom d'utilisateur et mot de passe.
    • PASSWORD_SECRET_VERSION avec le nom de ressource de la version secrète Secret Manager pour le mot de passe, pour l'authentification de base par nom d'utilisateur et mot de passe. (Par exemple : projects/01234567890/secrets/confluence-api-pw/versions/1.)
    • SERVICE_DIRECTORY_SERVICE avec le nom de ressource Annuaire des services pour l'accès au réseau privé. Cette opération est facultative.
    • SSL_CERTIFICATE_FILE_PATH par le chemin d'accès à un fichier local contenant le contenu du certificat SSL CA. Cette opération est facultative.
    • Incluez l'option --git-proxy-config-enabled pour accéder à cette connexion à l'aide du proxy Developer Connect.

Une fois la connexion créée, vous pouvez y accéder à l'aide du nom de ressource de connexion dans Developer Connect. Par exemple, vous pouvez utiliser cette connexion pour accorder à Gemini Code Assist un accès RAG aux ressources de Confluence.