Configura y usa conexiones HTTP genéricas

En esta página, se describe cómo configurar una conexión a un extremo HTTP genérico.

Además de las conexiones de repositorios de Git y los conectores de cuentas, también puedes configurar una conexión de Developer Connect a un extremo HTTP genérico. Esto te permite establecer y administrar conexiones a muchas herramientas, servicios y APIs de desarrolladores externos, siempre y cuando se pueda acceder a esas herramientas a través de extremos HTTP.

Por ejemplo, podrías configurar una conexión HTTP a una página de Confluence y, luego, Gemini Code Assist podría usar esa conexión para acceder al contenido de esa página de Confluence como contexto.

Crea una conexión HTTP

Las conexiones HTTP admiten la autenticación básica (nombre de usuario y contraseña) y la autenticación con token de portador. Ambos tipos de autenticación requieren que crees un secreto en Secret Manager.

Autenticación con token del portador

  1. Usa Secret Manager para crear un secreto y una versión del secreto que contenga tu token.

    El token es tu token de acceso personal o token de API que te da acceso a la herramienta para la que creas esta conexión. Por ejemplo, para Confluence, usarías el token de API de tu cuenta de Atlassian.

  2. Para crear la conexión con la autenticación de token de portador, ejecuta el siguiente 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

    Reemplaza lo siguiente:

    • CONNECTION_ID con un ID único para esta conexión nueva.
    • REGION con la región de Google Cloud en la que crearás esta conexión.
    • PROJECT_ID por el ID del proyecto de Google Cloud.
    • HOST_URI con el extremo HTTPS base (por ejemplo, https://api.myservice.com).
    • TOKEN_SECRET_VERSION con el nombre del recurso de la versión del secreto de Secret Manager para el token de autenticación.
    • SERVICE_DIRECTORY_SERVICE con el nombre del recurso Directorio de servicios para el acceso a la red privada. Esto es opcional.
    • SSL_CERTIFICATE_FILE_PATH con la ruta de acceso a un archivo local que contiene el contenido del certificado de CA SSL. Esto es opcional.
    • Incluye la opción --git-proxy-config-enabled para acceder a esta conexión con el proxy de Developer Connect.

Autenticación básica

  1. Usa Secret Manager para crear un secreto y una versión del secreto que contengan tu nombre de usuario y contraseña.

  2. Para crear la conexión con la autenticación básica, ejecuta el siguiente 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 \

    Reemplaza lo siguiente:

    • CONNECTION_ID con un ID único para esta conexión nueva.
    • REGION con la región de Google Cloud en la que crearás esta conexión.
    • PROJECT_ID por el ID del proyecto de Google Cloud.
    • HOST_URI con el extremo HTTPS base (por ejemplo, https://api.myservice.com).
    • USERNAME con el nombre de usuario para la autenticación básica con nombre de usuario y contraseña.
    • PASSWORD_SECRET_VERSION con el nombre del recurso de la versión secreta de Secret Manager para la contraseña, para la autenticación básica con nombre de usuario y contraseña. (Por ejemplo, projects/01234567890/secrets/confluence-api-pw/versions/1).
    • SERVICE_DIRECTORY_SERVICE con el nombre del recurso Directorio de servicios para el acceso a la red privada. Esto es opcional.
    • SSL_CERTIFICATE_FILE_PATH con la ruta de acceso a un archivo local que contiene el contenido del certificado de CA SSL. Esto es opcional.
    • Incluye la opción --git-proxy-config-enabled para acceder a esta conexión con el proxy de Developer Connect.

Después de crear la conexión, puedes acceder a ella con el nombre del recurso de conexión en Developer Connect. Por ejemplo, puedes usar esta conexión para otorgarle a Gemini Code Assist acceso RAG a los recursos de Confluence.