Allgemeine HTTP-Verbindungen konfigurieren und verwenden

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

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

HTTP-Verbindung erstellen

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

Bearertoken-Authentifizierung

  1. Erstellen Sie mit Secret Manager ein Secret und eine Secret-Version, die Ihr Token enthält.

    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.

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

Basisauthentifizierung

  1. Erstellen Sie mit Secret Manager ein Secret und eine Secret-Version, die Ihren Nutzernamen und Ihr Passwort enthält.

  2. Führen Sie den folgenden Befehl aus, um die Verbindung mit der Basisauthentifizierung 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 durch eine eindeutige ID für diese neue Verbindung.
    • REGION durch die Google Cloud-Region, in der Sie diese Verbindung erstellen.
    • PROJECT_ID durch die Google Cloud-Projekt-ID.
    • HOST_URI durch den HTTPS-Basisendpunkt (z. B. https://api.myservice.com).
    • USERNAME durch den Nutzernamen für die Basisauthentifizierung mit Nutzername und Passwort.
    • PASSWORD_SECRET_VERSION durch den Secret Manager Ressourcennamen der Secret-Version für das Passwort für die Basisauthentifizierung mit Nutzername und Passwort. Beispiel: projects/01234567890/secrets/exampletool-api-pw/versions/1.
    • SERVICE_DIRECTORY_SERVICE durch den Service Directory Ressourcennamen für den privaten Netzwerkzugriff. Dies ist optional.
    • SSL_CERTIFICATE_FILE_PATH durch den Pfad zu einer lokalen Datei mit dem Inhalt des SSL-CA-Zertifikats. Dies ist optional.
    • Fügen Sie die --git-proxy-config-enabled Option hinzu, um über den Developer Connect-Proxy auf diese Verbindung zuzugreifen.

Nachdem die Verbindung erstellt wurde, können Sie über den Ressourcennamen der Verbindung in Developer Connect darauf zugreifen.