Allgemeine HTTP-Verbindungen konfigurieren und verwenden

Auf dieser Seite wird beschrieben, wie Sie eine Verbindung zu einem generischen HTTP-Endpunkt konfigurieren.

Zusätzlich zu den Git-Repository-Verbindungen und Konto-Connectors können Sie auch eine Developer Connect-Verbindung zu einem generischen HTTP-Endpunkt einrichten. So können Sie Verbindungen zu vielen Entwicklertools, Diensten und APIs von Drittanbietern herstellen und verwalten, sofern diese Tools über HTTP-Endpunkte zugänglich sind.

Sie könnten beispielsweise eine HTTP-Verbindung zu einer Seite in Confluence einrichten. Gemini Code Assist könnte dann über diese Verbindung auf Inhalte auf dieser Confluence-Seite als Kontext zugreifen.

HTTP-Verbindung erstellen

HTTP-Verbindungen unterstützen die Basisauthentifizierung (Nutzername und Passwort) und die Authentifizierung mit Bearer-Token. Für beide Authentifizierungstypen müssen Sie ein Secret im Secret Manager erstellen.

Authentifizierung mit Inhabertoken

  1. Verwenden Sie Secret Manager, um ein Secret und eine Secret-Version mit Ihrem Token zu erstellen.

    Das Token ist Ihr persönliches Zugriffstoken oder API-Token, mit dem Sie Zugriff auf das Tool erhalten, für das Sie diese Verbindung erstellen. Für Confluence würden Sie beispielsweise das API-Token für Ihr Atlassian-Konto verwenden.

  2. Führen Sie den folgenden Befehl aus, um die Verbindung mit der Bearertoken-Authentifizierung zu erstellen:

    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

    Ersetzen Sie Folgendes:

    • CONNECTION_ID mit einer eindeutigen ID für diese neue Verbindung.
    • REGION mit der Google Cloud-Region, in der Sie diese Verbindung erstellen.
    • PROJECT_ID durch die Google Cloud-Projekt-ID.
    • HOST_URI mit dem HTTPS-Basisendpunkt (z. B. https://api.myservice.com).
    • TOKEN_SECRET_VERSION durch den Secret Manager-Ressourcennamen der Secret-Version für das Authentifizierungstoken.
    • SERVICE_DIRECTORY_SERVICE mit dem Service Directory-Ressourcennamen für den privaten Netzwerkzugriff. Dies ist optional.
    • SSL_CERTIFICATE_FILE_PATH mit dem Pfad zu einer lokalen Datei, die den Inhalt des SSL-CA-Zertifikats enthält. Dies ist optional.
    • Fügen Sie die Option --git-proxy-config-enabled ein, um über den Developer Connect-Proxy auf diese Verbindung zuzugreifen.

Basisauthentifizierung

  1. Erstellen Sie mit Secret Manager ein Secret und eine Secret-Version mit Ihrem Nutzernamen und Passwort.

  2. Führen Sie den folgenden Befehl aus, um die Verbindung mit der einfachen Authentifizierung zu erstellen:

    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 \

    Ersetzen Sie Folgendes:

    • CONNECTION_ID mit einer eindeutigen ID für diese neue Verbindung.
    • REGION mit der Google Cloud-Region, in der Sie diese Verbindung erstellen.
    • PROJECT_ID durch die Google Cloud-Projekt-ID.
    • HOST_URI mit dem HTTPS-Basisendpunkt (z. B. https://api.myservice.com).
    • USERNAME durch den Nutzernamen für die einfache Nutzername-Passwort-Authentifizierung.
    • PASSWORD_SECRET_VERSION mit dem Namen der Secret Manager-Secret-Versionsressource für das Passwort für die einfache Nutzername-Passwort-Authentifizierung. Beispiel: projects/01234567890/secrets/confluence-api-pw/versions/1.
    • SERVICE_DIRECTORY_SERVICE mit dem Service Directory-Ressourcennamen für den privaten Netzwerkzugriff. Dies ist optional.
    • SSL_CERTIFICATE_FILE_PATH mit dem Pfad zu einer lokalen Datei, die den Inhalt des SSL-CA-Zertifikats enthält. Dies ist optional.
    • Fügen Sie die Option --git-proxy-config-enabled ein, um über den Developer Connect-Proxy auf diese Verbindung zuzugreifen.

Nachdem die Verbindung erstellt wurde, können Sie über den Namen der Verbindungsressource in Developer Connect darauf zugreifen. Sie können diese Verbindung beispielsweise verwenden, um Gemini Code Assist RAG-Zugriff auf Ressourcen in Confluence zu gewähren.