Configuration de Snowflake pour utiliser Git¶

Configurer pour aucune authentification¶

Pour configurer Snowflake afin d’utiliser un référentiel Git sans authentification, procédez comme suit :

1. Créer une intégration API qui prend en charge l’accès sans authentification, et indiquez les détails suivants :

   • git_https_api comme valeur du paramètre API_PROVIDER.

   • Les points de terminaison HTTPS vers lesquels les requêtes doivent être limitées en tant que valeurs du paramètre API_ALLOWED_PREFIXES

   Pour plus d’informations, voir 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. Créez un référentiel Git clone comme décrit dans Créer un référentiel Git Snowflake clone.

Configurer pour l’authentification avec un jeton¶

Pour que Snowflake s’authentifie auprès du référentiel Git à l’aide d’un nom d’utilisateur et d’un jeton tel qu’un jeton d’accès personnel (PAT), procédez comme suit :

1. Fournissez des identifiants de connexion dans un secret d’authentification de base.

   Pour fournir les identifiants de connexion que Snowflake utilise pour s’authentifier auprès du référentiel, créez un secret qui contient les éléments suivants :

   • Une valeur TYPE de password

   • Un nom d’utilisateur et un jeton, comme un jeton d’accès personnel (PAT)

     Si votre référentiel Git est hébergé sur Bitbucket, spécifiez x-token-auth comme valeur du nom d’utilisateur.

     Note

     Pour plus d’informations sur la création d’un jeton d’accès personnel dans GitHub, voir Gestion de vos jetons d’accès personnels dans la documentation GitHub.

   Pour plus d’informations sur la commande SQL pour créer un secret, voir CREATE SECRET.

   Le code de l’exemple suivant crée un secret appelé my_git_secret avec un nom d’utilisateur et le jeton d’accès personnel de l’utilisateur à utiliser comme identifiants de connexion :

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

   Copy

2. Créez une intégration API qui prend en charge l’authentification avec un jeton.

   Pour créer une intégration API pour l’accès à un référentiel Git sans authentification, indiquez les détails suivants :

   • git_https_api comme valeur du paramètre API_PROVIDER.

   • Les points de terminaison HTTPS vers lesquels les requêtes doivent être limitées en tant que valeurs du paramètre API_ALLOWED_PREFIXES

   Pour plus d’informations, voir 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. Créez un référentiel Git clone comme décrit dans Créer un référentiel Git Snowflake clone.

Configurer pour l’authentification avec OAuth¶

Pour configurer Snowflake afin qu’il s’authentifie auprès du référentiel Git distant à l’aide d’un flux OAuth, procédez comme suit :

1. Créer une intégration API qui prend en charge l’authentification via OAuth.

   Lorsque vous spécifiez l’authentification avec un flux OAuth2, créez une intégration API qui spécifie ce qui suit :

   • git_https_api comme valeur du paramètre API_PROVIDER.

   • Les points de terminaison HTTPS vers lesquels les requêtes doivent être limitées en tant que valeurs du paramètre API_ALLOWED_PREFIXES

     Il doit s’agir d’un préfixe à https://github.com. L’authentification avec OAuth est prise en charge uniquement pour les référentiels hébergés sur github.com.

   • Une API_USER_AUTHENTICATION dont la valeur est (TYPE = SNOWFLAKE_GITHUB_APP)

   Pour plus d’informations, voir CREATE API INTEGRATION.

   Le code de l’exemple suivant crée une intégration d’API appelée 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. Créez un espace de travail connecté à un référentiel Git comme décrit dans la section Créer un espace de travail Git.

Configurer la connexion par lien privé¶

Avant de pouvoir configurer Snowflake pour l’accès au référentiel Git distant, vous devez configurer un lien privé entre Snowflake et votre fournisseur de services Cloud.

Pour appliquer les modifications de configuration à Snowflake et à votre infrastructure, procédez comme suit :

1. Dans votre fournisseur de services Cloud, créez un service lien privé pour recevoir des requêtes du service de point de terminaison privé Snowflake.

   Pour en savoir plus, consultez l’article de la base de connaissances Configuration de l’intégration Git avec Snowflake via Private Link.

2. Dans Snowflake, fournissez un point de terminaison privé qui atteindra votre infrastructure via une adresse IP privée.

   Pour fournir le point de terminaison, utilisez la fonction SYSTEM$PROVISION_PRIVATELINK_ENDPOINT avec les deux arguments suivants :

   • ID du service de lien privé de votre fournisseur Cloud

   • Nom de domaine de votre serveur Git

   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. Dans votre fournisseur de services Cloud, acceptez la configuration du point de terminaison privé Snowflake pour terminer la configuration de la connexion par lien privé.

4. Pour vérifier l’état du provisionnement, appelez la fonction système SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO.

Configurer l’accès de Snowflake au référentiel Git distant¶

Après avoir configuré un lien privé entre Snowflake et votre fournisseur de services Cloud, vous pouvez configurer l’accès de Snowflake au référentiel Git distant.

1. Créez une intégration API qui prend en charge l’authentification avec un certificat.

   Étant donné que Snowflake accédera à votre serveur Git à l’aide du protocole HTTPS, le nom de domaine doit disposer d’un certificat valide. La configuration que vous utilisez diffère selon que vous utilisez un certificat auto-signé ou un certificat signé par une autorité de certification.

   • Utiliser un certificat auto-signé :

     

     1. Fournissez des identifiants de connexion dans un secret de chaîne générique.

        Il doit s’agir d’une clé publique d’un domaine auto-signé pour établir une connexion HTTPS. Pour fournir à Snowflake les identifiants de connexion qu’il utilisera pour s’authentifier auprès du serveur, créez un secret contenant les informations suivantes :

        • Une valeur de paramètre TYPE de GENERIC_STRING

        • Une chaîne de certificats publics comme valeur de paramètre SECRET_STRING

          Pour la valeur du paramètre, spécifiez une chaîne secrète, telle qu’un organisme de certification public.

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

        Copy

     2. Créez une intégration API pour intégrer l’API Git, et indiquez les détails suivants :

        • Un paramètre API_PROVIDER défini sur git_https_api

        • Un paramètre API_ALLOWED_PREFIXES défini sur l’URL de base en fonction de laquelle l’accès est autorisé

        • Un paramètre USE_PRIVATELINK_ENDPOINT défini sur TRUE

        • Un paramètre TLS_TRUSTED_CERTIFICATES défini sur le nom du secret que vous avez créé, qui contient le certificat

        Pour plus d’informations, voir 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

   • Utilisez un certificat signé par une autorité de certification :

     

     1. Créez une intégration API pour intégrer l’API Git, et indiquez les détails suivants :

        • Un paramètre API_PROVIDER défini sur git_https_api

        • Un paramètre API_ALLOWED_PREFIXES défini sur l’URL de base en fonction de laquelle l’accès est autorisé

        • Un paramètre USE_PRIVATELINK_ENDPOINT défini sur TRUE

        • Un paramètre TLS_TRUSTED_CERTIFICATES défini sur le nom du secret que vous avez créé, qui contient le certificat

        Pour plus d’informations, voir 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. Fournissez des identifiants de connexion dans un secret d’authentification de base.

   Après vous être connecté avec succès au serveur Git via un lien privé, vous devez encore vous authentifier auprès du référentiel en créant un autre secret qui fournit des identifiants de connexion pour le référentiel.

   Pour fournir les identifiants de connexion que Snowflake utilise pour s’authentifier auprès du référentiel, créez un secret qui contient les éléments suivants :

   • Une valeur TYPE de password

   • Un nom d’utilisateur et un jeton, comme un jeton d’accès personnel (PAT)

     Note

     Pour plus d’informations sur la création d’un jeton d’accès personnel dans GitHub, voir Gestion de vos jetons d’accès personnels dans la documentation GitHub.

   Pour plus d’informations sur la commande SQL pour créer un secret, voir CREATE SECRET.

3. Créez un référentiel Git clone comme décrit dans Créer un référentiel Git Snowflake clone.