Configurar e usar conexões HTTP genéricas

Nesta página, descrevemos como configurar uma conexão com um endpoint HTTP genérico.

Além das conexões de repositório Git e dos conectores de conta, também é possível configurar uma conexão do Developer Connect com um endpoint HTTP genérico. Isso permite estabelecer e gerenciar conexões com muitas ferramentas, serviços e APIs de desenvolvedores terceirizados, desde que essas ferramentas sejam acessíveis usando endpoints HTTP.

Por exemplo, você pode configurar uma conexão HTTP com uma página do Confluence, e o Gemini Code Assist pode usar essa conexão para acessar o conteúdo dessa página como contexto.

Criar uma conexão HTTP

As conexões HTTP aceitam autenticação básica (nome de usuário e senha) e autenticação de token de portador. Os dois tipos de autenticação exigem que você crie um secret no Secret Manager.

Autenticação de token do portador

  1. Use o Secret Manager para criar um secret e uma versão do secret que contenha seu token.

    O token é seu token de acesso pessoal ou token de API que dá acesso à ferramenta para a qual você está criando essa conexão. Por exemplo, para o Confluence, use o token de API da sua conta da Atlassian.

  2. Para criar a conexão usando a autenticação de token de portador, execute o seguinte 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

    Substitua:

    • CONNECTION_ID com um ID exclusivo para essa nova conexão.
    • REGION com a região do Google Cloud em que você está criando essa conexão.
    • PROJECT_ID pelo ID do projeto do Google Cloud.
    • HOST_URI com o endpoint HTTPS de base (por exemplo, https://api.myservice.com).
    • TOKEN_SECRET_VERSION com o nome do recurso da versão do secret do Secret Manager para o token de autenticação.
    • SERVICE_DIRECTORY_SERVICE com o nome do recurso Diretório de serviços para acesso a redes privadas. Isso é opcional.
    • SSL_CERTIFICATE_FILE_PATH com o caminho para um arquivo local que contém o conteúdo do certificado da CA SSL. Isso é opcional.
    • Inclua a opção --git-proxy-config-enabled para acessar essa conexão usando o proxy do Developer Connect.

Autenticação básica

  1. Use o Secret Manager para criar um secret e uma versão do secret, contendo seu nome de usuário e senha.

  2. Para criar a conexão usando a autenticação básica, execute o seguinte 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 \

    Substitua:

    • CONNECTION_ID com um ID exclusivo para essa nova conexão.
    • REGION com a região do Google Cloud em que você está criando essa conexão.
    • PROJECT_ID pelo ID do projeto do Google Cloud.
    • HOST_URI com o endpoint HTTPS de base (por exemplo, https://api.myservice.com).
    • USERNAME com o nome de usuário para autenticação básica de nome de usuário e senha.
    • PASSWORD_SECRET_VERSION com o nome do recurso de versão do secret do Secret Manager para a senha, para autenticação básica de nome de usuário e senha. Por exemplo: projects/01234567890/secrets/confluence-api-pw/versions/1.
    • SERVICE_DIRECTORY_SERVICE com o nome do recurso Diretório de serviços para acesso a redes privadas. Isso é opcional.
    • SSL_CERTIFICATE_FILE_PATH com o caminho para um arquivo local que contém o conteúdo do certificado da CA SSL. Isso é opcional.
    • Inclua a opção --git-proxy-config-enabled para acessar essa conexão usando o proxy do Developer Connect.

Depois que a conexão é criada, é possível acessá-la usando o nome do recurso de conexão no Developer Connect. Por exemplo, é possível usar essa conexão para dar ao Gemini Code Assist acesso RAG a recursos no Confluence.