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 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 で認証するために構成する¶

OAuth フローを使用してリモートGitリポジトリで認証するようにSnowflakeを設定するには、以下のステップに従います。

1. OAuth による認証をサポートする API 統合を作成します。

   OAuth2 フローで認証コードを指定する場合、次を指定する API 統合を作成します。

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

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

     これは https://github.com のプレフィックスである必要があります。OAuth を使用した認証は、github.comでホストされているリポジトリでのみサポートされます。

   • API_USER_AUTHENTICATION の値が (TYPE = SNOWFLAKE_GITHUB_APP)

   詳細については、 CREATE API INTEGRATION をご参照ください。

   次の例のコードは、 API という 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. 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リポジトリのクローンを作成します。