Einrichten von Snowflake für Verwendung von Git¶

Konfiguration bei Verzicht auf Authentifizierung¶

Führen Sie die folgenden Schritte aus, um Snowflake für die Verwendung eines Git-Repositorys ohne Authentifizierung einzurichten:

1. Erstellen Sie eine API-Integration, die den Zugriff ohne Authentifizierung unterstützt, und geben Sie die folgenden Details an:

   • git_https_api als Wert des Parameters API_PROVIDER

   • HTTPS-Endpunkte, auf die Anforderungen als Werte des Parameters API_ALLOWED_PREFIXES beschränkt sein müssen

   Weitere Informationen dazu finden Sie unter CREATE API INTEGRATION.

   CREATE OR REPLACE API INTEGRATION my_git_api_integration
     API_PROVIDER = git_https_api
     API_ALLOWED_PREFIXES = ('https://example.com/my-account')
     ENABLED = TRUE;
   

   Copy

2. Erstellen Sie einen Git-Repository-Klon wie unter Erstellen eines Snowflake-Git-Repository-Klons beschrieben.

Konfiguration für die Authentifizierung mit einem Token¶

Damit sich Snowflake beim Git-Repository mit Benutzername und Token, wie etwa einem persönlichen Zugriffstoken (PAT), authentifiziert, gehen Sie wie folgt vor:

1. Stellen Sie Anmeldeinformationen in einem Geheimnis der Basisauthentifizierung bereit.

   Um die Anmeldeinformationen bereitzustellen, die Snowflake für die Authentifizierung beim Repository verwendet, erstellen Sie ein Geheimnis, das Folgendes enthält:

   • Ein TYPE-Wert von password

   • Ein Benutzername und ein Token, z. B. ein persönliches Zugriffstoken (PAT)

     Wenn Ihr Git-Repository auf Bitbucket gehostet wird, geben Sie x-token-auth als Wert für den Benutzernamen an.

     Bemerkung

     Informationen zum Erstellen eines persönlichen Zugriffstokens in GitHub finden Sie in der `-Dokumentation unter <https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens>Verwalten der persönlichen Zugangstokens `_GitHub.

   Weitere Informationen zum SQL-Befehl zum Erstellen eines Geheimnisses finden Sie unter CREATE SECRET.

   Der Code im folgenden Beispiel erstellt ein Geheimnis namens my_git_secret mit einem Benutzernamen und dem persönlichen Zugriffstoken des Benutzers, das als Anmeldeinformation verwendet wird:

   CREATE OR REPLACE SECRET db.schema.my_git_secret
     TYPE = password
     USERNAME = 'gladyskravitz'
     PASSWORD = 'ghp_token';
   

   Copy

2. Erstellen Sie eine API-Integration, die die Authentifizierung mit einem -Token unterstützt.

   Um eine API-Integration für den Zugriff auf ein Git-Repository ohne Authentifizierung zu erstellen, geben Sie die folgenden Details an:

   • git_https_api als Wert des Parameters API_PROVIDER

   • HTTPS-Endpunkte, auf die Anforderungen als Werte des Parameters API_ALLOWED_PREFIXES beschränkt sein müssen

   Weitere Informationen dazu finden Sie unter CREATE API INTEGRATION.

   CREATE OR REPLACE API INTEGRATION my_git_api_integration
     API_PROVIDER = git_https_api
     API_ALLOWED_PREFIXES = ('https://github.com/my-account')
     ALLOWED_AUTHENTICATION_SECRETS = (my_git_secret)
     ENABLED = TRUE;
   

   Copy

3. Erstellen Sie einen Git-Repository-Klon wie unter Erstellen eines Snowflake-Git-Repository-Klons beschrieben.

Konfiguration für die Authentifizierung mit OAuth¶

You can configure Snowflake to authenticate with the remote Git repository using an OAuth2 flow. How you set up for OAuth2 authentication differs depending on the repository provider.

• Wenn Sie GitHub verwenden, können Sie eine API-Integration erstellen, die die Snowflake GitHub-App zum Authentifizieren verwendet.

  Die Snowflake GitHub-App ist eine vorkonfigurierte OAuth2-Anwendung, die von Snowflake verwendet wird und die die Authentifizierung vereinfachen soll. Sie müssen diese App nicht konfigurieren. Sie müssen nur eine API-Integration erstellen, die die Snowflake GitHub-App angibt.

• Für alle Repository-Anbieter einschließlich GitHub können Sie stattdessen eine API-Integration erstellen, die Werte für OAuth2-Parameter angibt, einschließlich der Client-ID und des Geheimnisses, die bei der Authentifizierung verwendet werden sollen.

  Bevor Sie die API-Integration erstellen, sammeln Sie OAuth2-Parameter für Ihren Repository-Anbieter, einschließlich der Client-ID und des Geheimnisses. Sie geben diese Werte in der API-Integration an.

  Weitere Informationen dazu finden Sie in der Dokumentation des Repository-Anbieters.

To set up Snowflake so that it authenticates with the remote Git repository using an OAuth2 flow, follow these steps:

1. Create an API integration that supports authenticating through OAuth2.

   Create an API integration that specifies the following values:

   • An API_PROVIDER parameter value of git_https_api

   • Ein API_ALLOWED_PREFIXES-Parameterwert, der die HTTPS-Endpunkte angibt, auf die Anforderungen beschränkt sein müssen

   • Ein API_USER_AUTHENTICATION-Wert, der dem von Ihnen verwendeten Git-Repository-Anbieter entspricht

     • When authenticating with GitHub using the Snowflake GitHub App, specify (TYPE = SNOWFLAKE_GITHUB_APP).

     • Bei Authentifizierung bei einem Repository-Anbieter ohne Verwendung der Snowflake GitHub-App – wie bei einem beliebigen Repository-Anbieter außer GitHub – geben Sie Werte für die folgenden Parameter an, wie unter CREATE API INTEGRATION beschrieben:

       • OAUTH_CLIENT_ID

       • OAUTH_CLIENT_SECRET

       • API_USER_AUTHENTICATION

       • OAUTH_AUTHORIZATION_ENDPOINT

       • OAUTH_TOKEN_ENDPOINT

       • OAUTH_ACCESS_TOKEN_VALIDITY

       • OAUTH_REFRESH_TOKEN_VALIDITY

       • OAUTH_ALLOWED_SCOPES

   Code in the following examples creates an API integration called my_git_api_integration:

   GitHub appOAuth2 parameters

   CREATE OR REPLACE API INTEGRATION my_git_api_integration
     API_PROVIDER = git_https_api
     API_ALLOWED_PREFIXES = ('https://github.com')
     API_USER_AUTHENTICATION = (TYPE = SNOWFLAKE_GITHUB_APP)
     ENABLED = TRUE;
   

   Copy

2. Erstellen Sie einen Arbeitsbereich, der mit einem Git-Repository verbunden ist, wie unter Einen Git-Arbeitsbereich erstellen beschrieben.

Konfigurieren der Private Link-Verbindung¶

Bevor Sie Snowflake für den Zugriff auf das externe Git-Repository konfigurieren können, müssen Sie eine private Verbindung zwischen Snowflake und Ihrem Clouddienstanbieter einrichten.

Um Konfigurationsänderungen auf Snowflake und auf Ihre Infrastruktur anzuwenden, gehen Sie wie folgt vor:

1. Erstellen Sie bei Ihrem Clouddienstanbieter einen Private Link-Service, um Anforderungen vom Snowflake-Service für private Endpunkte zu empfangen.

   Weitere Informationen dazu finden Sie im Artikel Konfigurieren der Git-Integration mit Snowflake über Private Link in der Knowledge Base.

2. Stellen Sie in Snowflake einen privaten Endpunkt bereit, der Ihre Infrastruktur über eine private IP-Adresse erreicht.

   Um den Endpunkt bereitzustellen, verwenden Sie die Funktion SYSTEM$PROVISION_PRIVATELINK_ENDPOINT mit den folgenden beiden Argumenten:

   • Die Private Link-Service-ID Ihres Cloudanbieters

   • Der Name der Domäne Ihres Git-Servers

   AWSAzureGoogle Cloud

   SELECT SYSTEM$PROVISION_PRIVATELINK_ENDPOINT(
     'com.amazonaws.vpce.us-west-2.vpce-svc-xxx', // VPC Endpoint Service Name
     'git_address.com' // Git server domain
   );
   

   Copy

3. Akzeptieren Sie bei Ihrem Clouddienstanbieter die Einrichtung der privaten Snowflake-Endpunkte, um die Einrichtung der Private Link-Verbindung abzuschließen.

4. Um den Status der Bereitstellung zu prüfen, rufen Sie die Systemfunktion SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO auf.

Konfigurieren des Snowflake-Zugriffs auf das externe Git-Repository¶

Nachdem Sie eine private Verbindung zwischen Snowflake und Ihrem Clouddienstanbieter eingerichtet haben, können Sie den Snowflake-Zugriff auf das externe Git-Repository konfigurieren.

1. Erstellen Sie eine API-Integration, die die Authentifizierung mit einem Zertifikat unterstützt.

   Da Snowflake Ihren Git-Server über das HTTPS-Protokoll erreicht, muss der Domänenname ein gültiges Zertifikat haben. Die von Ihnen verwendete Konfiguration unterscheidet sich je nachdem, ob Sie ein selbstsigniertes Zertifikat oder ein von einer Zertifizierungsstelle signiertes Zertifikat verwenden.

   • Verwenden eines selbstsignierten Zertifikats:

     

     1. Stellen Sie Anmeldeinformationen in einem allgemeinen Zeichenfolgengeheimnis bereit.

        Dies sollte ein öffentlicher Schlüssel einer selbstsignierten Domäne sein, über die eine HTTPS-Verbindung hergestellt wird. Um Snowflake die Anmeldeinformationen zur Verfügung zu stellen, die für die Authentifizierung beim Server verwendet werden sollen, erstellen Sie ein Geheimnis mit den folgenden Details:

        • Ein TYPE-Parameterwert von GENERIC_STRING

        • Eine Zeichenfolge für das öffentliche Zertifikat als Wert des SECRET_STRING-Parameters

          Geben Sie für den Wert des Parameters eine Geheimnis-Zeichenfolge an, z. B. eine öffentliche Zertifizierungsstelle.

        CREATE OR REPLACE SECRET my_public_certificate
          TYPE = GENERIC_STRING
          SECRET_STRING = '-----BEGIN CERTIFICATE-----
                    <certificate_body>
                    -----END CERTIFICATE-----';
        

        Copy

     2. Erstellen Sie eine API-Integration zur Integration in die Git-API, und geben die folgenden Details an:

        • Ein API_PROVIDER-Parameter, der auf git_https_api gesetzt ist

        • Eine API_ALLOWED_PREFIXES, die auf die Basis-URL eingestellt ist, unterhalb derer der Zugriff erlaubt ist

        • Ein USE_PRIVATELINK_ENDPOINT-Parameter, der auf TRUE gesetzt ist

        • Ein TLS_TRUSTED_CERTIFICATES-Parameter, der auf den Namen des von Ihnen erstellten Geheimnisses mit dem Zertifikat gesetzt ist

        Weitere Informationen dazu finden Sie unter CREATE API INTEGRATION.

        CREATE OR REPLACE API INTEGRATION my_git_api_integration
          API_PROVIDER = git_https_api
          API_ALLOWED_PREFIXES = ('https://example.com/my-account')
          ALLOWED_AUTHENTICATION_SECRETS = ALL
          USE_PRIVATELINK_ENDPOINT = TRUE
          TLS_TRUSTED_CERTIFICATES = (my_public_certificate)
          ENABLED = TRUE;
        

        Copy

   • Verwenden eines von einer Zertifizierungsstelle signierten Zertifikats:

     

     1. Erstellen Sie eine API-Integration zur Integration in die Git-API, und geben die folgenden Details an:

        • Ein API_PROVIDER-Parameter, der auf git_https_api gesetzt ist

        • Eine API_ALLOWED_PREFIXES, die auf die Basis-URL eingestellt ist, unterhalb derer der Zugriff erlaubt ist

        • Ein USE_PRIVATELINK_ENDPOINT-Parameter, der auf TRUE gesetzt ist

        • Ein TLS_TRUSTED_CERTIFICATES-Parameter, der auf den Namen des von Ihnen erstellten Geheimnisses mit dem Zertifikat gesetzt ist

        Weitere Informationen dazu finden Sie unter CREATE API INTEGRATION.

        CREATE OR REPLACE API INTEGRATION my_git_api_integration
          API_PROVIDER = git_https_api
          API_ALLOWED_PREFIXES = ('https://example.com/my-account')
          ALLOWED_AUTHENTICATION_SECRETS = ALL
          USE_PRIVATELINK_ENDPOINT = TRUE
          ENABLED = TRUE;
        

        Copy

2. Stellen Sie Anmeldeinformationen in einem Geheimnis der Basisauthentifizierung bereit.

   Nachdem Sie erfolgreich eine Verbindung zum Git-Server über einen privaten Link hergestellt haben, müssen Sie sich weiterhin beim Repository authentifizieren, indem Sie ein weiteres Geheimnis erstellen, das Anmeldeinformationen für das Repository bereitstellt.

   Um die Anmeldeinformationen bereitzustellen, die Snowflake für die Authentifizierung beim Repository verwendet, erstellen Sie ein Geheimnis, das Folgendes enthält:

   • Ein TYPE-Wert von password

   • Ein Benutzername und ein Token, z. B. ein persönliches Zugriffstoken (PAT)

     Bemerkung

     Informationen zum Erstellen eines persönlichen Zugriffstokens in GitHub finden Sie in der `-Dokumentation unter <https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens>Verwalten der persönlichen Zugangstokens `_GitHub.

   Weitere Informationen zum SQL-Befehl zum Erstellen eines Geheimnisses finden Sie unter CREATE SECRET.

3. Erstellen Sie einen Git-Repository-Klon wie unter Erstellen eines Snowflake-Git-Repository-Klons beschrieben.