Configuração do Snowflake para usar o Git¶

Configurar para nenhuma autenticação¶

Para configurar o Snowflake para usar um repositório Git sem autenticação, siga estas etapas:

1. Crie uma integração de API que ofereça suporte ao acesso sem autenticação e especifique os seguintes detalhes:

   • git_https_api como o valor do parâmetro API_PROVIDER

   • Pontos de extremidade HTTPS aos quais solicitações devem ser limitadas como valores do parâmetro API_ALLOWED_PREFIXES

   Para obter mais informações, consulte 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. Criar um clone do repositório Git conforme descrito em Criação de um clone do repositório Git do Snowflake

Configuração do para autenticação com um token¶

Para que o Snowflake seja autenticado no repositório Git usando um nome de usuário e token, como um token de acesso pessoal (PAT), siga estes passos:

1. Fornecimento de credenciais em um segredo de autenticação básica.

   Para fornecer as credenciais que o Snowflake usa para autenticar no repositório, crie um segredo contendo o seguinte:

   • Um valor TYPE de password

   • Um nome de usuário e token, como um token de acesso pessoal (PAT)

     Se seu repositório Git estiver hospedado no Bitbucket, especifique x-token-auth como o valor do nome de usuário.

     Nota

     Para obter informações sobre como criar um token de acesso pessoal em GitHub, consulte Como gerenciar seus tokens de acesso pessoal na documentação do GitHub.

   Para obter mais informações sobre o comando SQL para criar um segredo, consulte CREATE SECRET.

   O código no exemplo a seguir cria um segredo chamado my_git_secret com um nome de usuário e o token de acesso pessoal do usuário para usar como credenciais:

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

   Copy

2. Crie uma integração de API que ofereça suporte à autenticação com um token.

   Para criar uma integração de API para acesso a um repositório Git sem autenticação, especifique os seguintes detalhes:

   • git_https_api como o valor do parâmetro API_PROVIDER

   • Pontos de extremidade HTTPS aos quais solicitações devem ser limitadas como valores do parâmetro API_ALLOWED_PREFIXES

   Para obter mais informações, consulte 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. Criar um clone do repositório Git conforme descrito em Criação de um clone do repositório Git do Snowflake

Configuração do para autenticação com 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.

• Se você usa o GitHub, pode criar uma integração de API que utiliza o app Snowflake GitHub para autenticação.

  O app Snowflake GitHub é um aplicativo OAuth2 pré-configurado usado pelo Snowflake e projetado para simplificar a autenticação. Você não precisa configurar esse app; basta criar uma integração de API que especifica o app Snowflake GitHub.

• Para todos os provedores de repositórios, incluindo o GitHub, você pode criar uma integração de API que especifica valores para os parâmetros do OAuth2, como ID e segredo do cliente, para usar na autenticação.

  Antes de criar a integração de API, colete os parâmetros do OAuth2 referentes ao seu provedor de repositório, incluindo o ID e segredo do cliente. Você especificará esses valores na integração de API.

  Para obter mais informações, consulte a documentação do provedor do repositório.

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

   • Um valor de parâmetro API_ALLOWED_PREFIXES que especifica pontos de extremidade HTTPS aos quais as solicitações devem ser limitadas

   • Um valor API_USER_AUTHENTICATION que corresponde ao provedor do repositório Git que você usa

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

     • Sempre que autenticar com um provedor de repositório sem usar o app Snowflake GitHub, por exemplo, com qualquer provedor de repositório diferente do GitHub, especifique valores para os seguintes parâmetros, conforme descrito em CREATE API INTEGRATION:

       • 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. Crie um espaço de trabalho conectado a um repositório Git, conforme descrito em Criar um espaço de trabalho Git.

Configuração da conexão do Private Link¶

Antes de configurar o Snowflake para acessar o repositório Git remoto, você deve configurar um link privado entre o Snowflake e seu provedor de serviços de nuvem.

Para aplicar alterações de configuração ao Snowflake e à sua infraestrutura, siga estas etapas:

1. No seu provedor de serviços de nuvem, crie um serviço de link privado para receber solicitações do serviço de ponto de extremidade privado do Snowflake.

   Para obter mais detalhes, consulte o artigo da base de conhecimento Configuração da integração do Git com o Snowflake pelo Private Link.

2. No Snowflake, forneça um ponto de extremidade privado que chegará à sua infraestrutura por meio de um IP privado.

   Para provisionar o ponto de extremidade, use a função SYSTEM$PROVISION_PRIVATELINK_ENDPOINT com os dois argumentos a seguir:

   • ID do serviço de link privado de seu provedor de nuvem

   • Nome de domínio do seu servidor Git

   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. Em seu provedor de serviços de nuvem, aceite a configuração do ponto de extremidade privado do Snowflake para terminar de configurar a conexão do link privado.

4. Para verificar o status do provisionamento, chame a função do sistema SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO.

Configuração do acesso do Snowflake ao repositório Git remoto¶

Depois de configurar um link privado entre o Snowflake e seu provedor de serviços de nuvem, você pode configurar o acesso do Snowflake ao repositório Git remoto.

1. Crie uma integração de API que ofereça suporte à autenticação com um certificado.

   Como o Snowflake acessará seu servidor Git usando o protocolo HTTPS, o nome de domínio precisa ter um certificado válido. A configuração usada difere dependendo se você usa um certificado autoassinado ou um certificado assinado por uma autoridade de certificação.

   • Uso de um certificado autoassinado:

     

     1. Fornecimento de credenciais em um segredo da cadeia de caracteres genérica.

        Esta deve ser uma chave pública de um domínio autoassinado para estabelecer uma conexão HTTPS. Para fornecer ao Snowflake as credenciais que ele usará para autenticação no servidor, crie um segredo que contenha os seguintes detalhes:

        • Um valor de parâmetro TYPE de GENERIC_STRING

        • Uma cadeia de caracteres de certificado público como o valor do parâmetro SECRET_STRING

          Para o valor do parâmetro, especifique uma cadeia de caracteres secreta, como um corpo de certificação público.

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

        Copy

     2. Crie uma integração de API para integrar com a API Git e especifique os seguintes detalhes:

        • Um parâmetro API_PROVIDER definido como git_https_api

        • Um API_ALLOWED_PREFIXES definido como a URL base abaixo da qual o acesso é permitido

        • Um parâmetro USE_PRIVATELINK_ENDPOINT definido como TRUE

        • Um parâmetro TLS_TRUSTED_CERTIFICATES definido como o nome do segredo que você criou, que contém o certificado

        Para obter mais informações, consulte 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

   • Usando um certificado assinado por uma autoridade de certificação:

     

     1. Crie uma integração de API para integrar com a API Git e especifique os seguintes detalhes:

        • Um parâmetro API_PROVIDER definido como git_https_api

        • Um API_ALLOWED_PREFIXES definido como a URL base abaixo da qual o acesso é permitido

        • Um parâmetro USE_PRIVATELINK_ENDPOINT definido como TRUE

        • Um parâmetro TLS_TRUSTED_CERTIFICATES definido como o nome do segredo que você criou, que contém o certificado

        Para obter mais informações, consulte 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. Fornecimento de credenciais em um segredo de autenticação básica.

   Após conectar-se com sucesso ao servidor Git por meio do link privado, você ainda deve se autenticar no repositório criando outro segredo que fornece credenciais para o repositório.

   Para fornecer as credenciais que o Snowflake usa para autenticar no repositório, crie um segredo contendo o seguinte:

   • Um valor TYPE de password

   • Um nome de usuário e token, como um token de acesso pessoal (PAT)

     Nota

     Para obter informações sobre como criar um token de acesso pessoal em GitHub, consulte Como gerenciar seus tokens de acesso pessoal na documentação do GitHub.

   Para obter mais informações sobre o comando SQL para criar um segredo, consulte CREATE SECRET.

3. Criar um clone do repositório Git conforme descrito em Criação de um clone do repositório Git do Snowflake