Gitを使用するためのSnowflakeの設定¶

認証なし用に構成する¶

認証なしでGitリポジトリを使用するためにSnowflakeを設定するには、次のステップに従います。

1. 認証なしでアクセスをサポートする API 統合を作成し、次の詳細を指定します。

   • API_PROVIDER パラメーターの値としての git_https_api

   • API_ALLOWED_PREFIXES パラメーターの値として、リクエストを制限する必要がある HTTPS エンドポイント

   詳細については、 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. Snowflake Gitリポジトリクローンを作成する の説明に従って、Gitリポジトリのクローンを作成します。

トークンによる認証用に構成する¶

ユーザー名と個人アクセストークン（PAT）などのトークンを使用して、SnowflakeにGitリポジトリで認証させるには、次のステップに従います。

1. 基本認証シークレット に認証情報を提供します。

   Snowflakeがリポジトリでの認証に使用する認証情報を提供するには、以下を含むシークレットを作成します。

   • password の TYPE 値

   • ユーザー名と、個人アクセストークン（PAT）などのトークン

     GitリポジトリがBitbucketでホストされている場合は、ユーザー名の値として x-token-auth を指定します。

     注釈

     GitHub で個人用アクセストークンを作成する方法については、 ` ドキュメントの <https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens>個人用アクセストークンの管理 `_GitHub をご参照ください。

   シークレットを作成するための SQL コマンドの詳細については、CREATE SECRET をご参照ください。

   次の例のコードは、ユーザー名と、認証情報として使用するユーザーの個人アクセストークンを含む my_git_secret というシークレットを作成します。

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

   Copy

2. トークンでの認証をサポートする API 統合を作成します。

   認証なしでGitリポジトリにアクセスできる API 統合を作成するには、次の詳細を指定します。

   • API_PROVIDER パラメーターの値としての git_https_api

   • API_ALLOWED_PREFIXES パラメーターの値として、リクエストを制限する必要がある HTTPS エンドポイント

   詳細については、 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. Snowflake Gitリポジトリクローンを作成する の説明に従って、Gitリポジトリのクローンを作成します。

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.

• GitHubを使用している場合、認証に Snowflake GitHubアプリ を使用するAPI統合を作成できます。

  Snowflake GitHubアプリは、Snowflakeによって使用される、容易に認証するために設計された、事前に構成されたOAuth2アプリケーションです。このアプリを構成する必要はありません。 Snowflake GitHubアプリ を指定するAPI統合を作成するだけです。

• GitHubを含むすべてのリポジトリプロバイダーの場合、代わりに認証時に使用するクライアントIDとシークレット含む OAuth2パラメーター の値を指定するAPI統合を作成できます。

  API統合を作成する前に、クライアントIDおよびシークレット含むリポジトリプロバイダー用のOAuth2パラメーターを収集します。これらの値はAPI統合で指定します。

  詳細については、リポジトリプロバイダーのドキュメントをご参照ください。

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

   • リクエストを制限する必要があるHTTPSエンドポイントを指定するAPI_ALLOWED_PREFIXESパラメーター値

   • 使用しているGitリポジトリプロバイダーに対応するAPI_USER_AUTHENTICATION値

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

     • Snowflake GitHubアプリを使用せずにリポジトリプロバイダーで認証する場合（GitHub以外の任意のリポジトリプロバイダーなど）、 CREATEAPIINTEGRATION で説明されているように、次のパラメーターに値を指定します。

       • 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. Gitワークスペースの作成 の説明に従って、Gitリポジトリに接続されたワークスペースを作成します。

プライベートリンクの接続を構成する¶

リモートGitリポジトリにアクセスできるようSnowflakeを構成する前に、Snowflakeとクラウドサービスプロバイダーの間にプライベートリンクを設定する必要があります。

Snowflakeとインフラストラクチャの両方に構成の変更を適用するには、次のステップに従います。

1. クラウドサービスプロバイダーで、Snowflakeプライベートエンドポイントサービスからリクエストを受信するプライベートリンクサービスを作成します。

   詳細については、ナレッジベース記事 プライベートリンクを介してSnowflakeとのGit統合を構成する をご参照ください。

2. Snowflakeで、プライベート IP を介してインフラストラクチャにアクセスする、プライベートエンドポイントをプロビジョニングします。

   エンドポイントをプロビジョニングするには、次の2つの引数を持つ SYSTEM$PROVISION_PRIVATELINK_ENDPOINT 関数を使用します。

   • クラウドプロバイダーのプライベートリンクサービス ID

   • 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. クラウドサービスプロバイダーで、Snowflakeプライベートエンドポイント設定を受け入れて、プライベートリンク接続の設定を完了します。

4. プロビジョニングのステータスを確認するには、SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO システム関数を呼び出します。

リモートGitリポジトリへのSnowflakeアクセスを構成する¶

Snowflakeとクラウドサービスプロバイダーの間にプライベートリンクを設定したら、リモートGitリポジトリへのSnowflakeアクセスを構成できます。

1. トークンでの認証をサポートする API 統合を作成します。

   Snowflakeは HTTPS プロトコルを使用してGitサーバーにアクセスするため、ドメイン名には有効な証明書が必要です。使用する構成は、自己署名証明書を使用するか、証明機関によって署名された証明書を使用するかによって異なります。

   • 自己署名証明書の使用。

     

     1. 一般的なシークレット文字列 で認証情報を提供します。

        これは、HTTPS 接続を確立するために自己署名ドメインのパブリックキーである必要があります。サーバーとの認証に使用する認証情報をSnowflakeに提供するには、次の詳細を含むシークレットを作成します。

        • GENERIC_STRING の TYPE パラメーター値

        • SECRET_STRING パラメーターの値としてのパブリック証明書文字列

          パラメーターの値には、パブリック証明書本文のような秘密文字列を指定します。

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

        Copy

     2. Git API と統合するための API 統合を作成し、次の詳細を指定します。

        • git_https_api に設定された API_PROVIDERパラメーター

        • ベースの URLに API_ALLOWED_PREFIXES を設定すると、その下でアクセスが許可されます

        • TRUE に設定されたUSE_PRIVATELINK_ENDPOINTパラメーター

        • TLS_TRUSTED_CERTIFICATES パラメーターを作成したシークレットの名前に設定します。これには証明書が含まれます

        詳細については、 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

   • 証明機関によって署名された証明書の使用。

     

     1. Git API と統合するための API 統合を作成し、次の詳細を指定します。

        • git_https_api に設定された API_PROVIDERパラメーター

        • ベースの URLに API_ALLOWED_PREFIXES を設定すると、その下でアクセスが許可されます

        • TRUE に設定されたUSE_PRIVATELINK_ENDPOINTパラメーター

        • TLS_TRUSTED_CERTIFICATES パラメーターを作成したシークレットの名前に設定します。これには証明書が含まれます

        詳細については、 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. 基本認証シークレット に認証情報を提供します。

   プライベートリンクを介して正常にGitサーバーに接続した後も、リポジトリの認証情報を提供する別のシークレットを作成して、リポジトリで認証する必要があります。

   Snowflakeがリポジトリでの認証に使用する認証情報を提供するには、以下を含むシークレットを作成します。

   • password の TYPE 値

   • ユーザー名と、個人アクセストークン（PAT）などのトークン

     注釈

     GitHub で個人用アクセストークンを作成する方法については、 ` ドキュメントの <https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens>個人用アクセストークンの管理 `_GitHub をご参照ください。

   シークレットを作成するための SQL コマンドの詳細については、CREATE SECRET をご参照ください。

3. Snowflake Gitリポジトリクローンを作成する の説明に従って、Gitリポジトリのクローンを作成します。