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 a 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.

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.

  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 nueva conexión.
    • 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 nueva conexión.
    • 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/exampletool-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.