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 au 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 de développement tiers, à condition que ces outils soient accessibles à l'aide de points de terminaison HTTP.

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 porteur. Les deux types d'authentification nécessitent que vous créiez un secret dans Secret Manager.

Authentification par jeton porteur

  1. Utilisez Secret Manager pour créer un secret et une version de 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.

  2. Pour créer la connexion à l'aide de l'authentification par jeton 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 par 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 par le point de terminaison HTTPS de base (par exemple, https://api.myservice.com).
    • TOKEN_SECRET_VERSION par le nom de ressource de la version de secret Secret Manager pour le jeton d'authentification.
    • SERVICE_DIRECTORY_SERVICE par le nom de ressource de l'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 CA SSL. 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 de 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 par 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 par le point de terminaison HTTPS de base (par exemple, https://api.myservice.com).
    • USERNAME par le nom d'utilisateur pour l'authentification de base par nom d'utilisateur et mot de passe.
    • PASSWORD_SECRET_VERSION par le nom de ressource de la version de secret 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/exampletool-api-pw/versions/1.)
    • SERVICE_DIRECTORY_SERVICE par le nom de ressource de l'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 CA SSL. 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.