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 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 Bearer-Token-Authentifizierung. 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.

  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 Authentifizierung mit Nutzername und Passwort. Beispiel: projects/01234567890/secrets/exampletool-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.