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 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¶

Gehen Sie wie folgt vor, um Snowflake so einzurichten, dass es sich beim externen Git-Repository über einen OAuth-Ablauf authentifiziert:

1. Erstellen Sie eine API-Integration, die die Authentifizierung über OAuth unterstützt.

   Wenn Sie die Authentifizierung mit einem OAuth2-Ablauf angeben, erstellen Sie eine API-Integration, die Folgendes angibt:

   • 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

     Dies muss ein Präfix bei https://github.com sein. Die Authentifizierung mit OAuth wird nur für Repositorys unterstützt, die auf github.com gehostet werden.

   • Eine API_USER_AUTHENTICATION mit dem Wert (TYPE = SNOWFLAKE_GITHUB_APP)

   Weitere Informationen dazu finden Sie unter CREATE API INTEGRATION.

   Der Code im folgenden Beispiel erstellt eine API-Integration namens my_git_api_integration:

   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

   AWSAzure

   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.