SSO 를 사용하도록 Snowflake Open Catalog 구성하기¶

Snowflake Open Catalog에 대한 Snowflake CLI 연결 추가하기¶

SSO 를 사용하도록 설정하려는 Snowflake Open Catalog 계정에 대한 연결을 추가합니다.

• 다음 값으로 연결을 추가합니다. <https://docs.snowflake.com/en/developer-guide/snowflake-cli/connecting/configure-connections#add-a-connection>_ 다른 모든 매개 변수의 경우 Enter 키를 눌러 매개 변수 값 지정을 건너뛰십시오.

  연결 구성 매개 변수	값
  이 연결의 이름	연결 이름을 지정합니다(예: myopencatalogconnection).
  계정 이름	이 형식에 따라 Snowflake 조직 이름과 Open Catalog 계정 이름을 지정합니다. <orgname>-<my-snowflake-open-catalog-account-name>. 예: ABCDEFG-MYACCOUNT1. 이러한 이름을 찾으려면 시작하기 전에_ 섹션을 참조하십시오.
  사용자 이름	Open Catalog의 사용자 이름을 지정합니다(예: jsmith).
  비밀번호[선택 사항]	이 매개 변수는 Open Catalog 연결을 생성할 때 선택 사항이 아닙니다. Open Catalog 비밀번호를 입력합니다(예: MyPassword123456789).
  연결의 역할[선택 사항]	이 매개 변수는 Open Catalog 연결을 생성할 때 선택 사항이 아닙니다. POLARIS_ACCOUNT_ADMIN 을 입력해야 합니다.

Snowflake CLI 연결 테스트하기¶

• CLI 연결을 테스트하려면 myopencatalogconnection 에 대한 연결을 테스트하는 이 예제를 따르십시오.

  snow connection test -c myopencatalogconnection
  

  Copy

  응답은 다음과 같이 표시되어야 합니다.

  +------------------------------------------------------------------------------+
  | key              | value                                                     |
  |----------------------------+-------------------------------------------------|
  | Connection name  | myopencatalogconnection                                   |
  | Status           | OK                                                        |
  | Host             | ABCDEFG-MYACCOUNT1.snowflakecomputing.com                 |
  | Account          | ABCDEFG-MYACCOUNT1                                        |
  | User             | jsmith                                                    |
  | Role             | POLARIS_ACCOUNT_ADMIN                                     |
  | Database         | not set                                                   |
  | Warehouse        | not set                                                   |
  +------------------------------------------------------------------------------+
  

  Copy

Snowflake Open Catalog에 대해 Snowflake CLI 연결을 기본값으로 설정하기¶

사용 중인 연결에 항상 요구 사항인 POLARIS_ACCOUNT_ADMIN 역할이 부여되도록 하려면 Open Catalog용으로 생성한 Snowflake CLI 연결을 기본 연결로 설정할 수 있습니다. 기본 연결에 대한 자세한 내용은 기본 연결 설정하기 <https://docs.snowflake.com/en/developer-guide/snowflake-cli/connecting/configure-connections#set-the-default-connection>_ 섹션을 참조하십시오.

1. myopencatalogconnection 연결을 기본값으로 설정하는 이 예시를 따르십시오.

   snow connection set-default myopencatalogconnection
   

   Copy

2. 올바른 사용자와 역할을 사용하고 있는지 확인하려면 다음을 실행합니다.

   snow sql -q "Select current_user(); select current_role();"
   

   Copy

   응답은 Open Catalog 사용자 이름을 반환해야 하며 CURRENT ROLE 은 POLARIS_ACCOUNT_ADMIN 이어야 합니다.

   +----------------+
   | CURRENT_USER() |
   |----------------|
   | JSMITH        |
   +----------------+
   select current_role();
   +-----------------------+
   | CURRENT_ROLE()        |
   |-----------------------|
   | POLARIS_ACCOUNT_ADMIN |
   +-----------------------+
   

   Copy

Auth0 보안 통합¶

• Auth0에 대한 SAML 보안 통합을 만들려면 Snowflake CLI 에서 다음 명령을 실행합니다.

  snow sql -q “create security integration <Name>
      type = saml2
      enabled = true
      saml2_issuer = 'urn:<Auth0 Domain>'
      saml2_sso_url = '<SAML Protocol URL>'
      saml2_provider = 'Custom'
      saml2_x509_cert='<Certificate from Auth0>'
      saml2_sp_initiated_login_page_label = 'Auth0'
      saml2_enable_sp_initiated = true
      saml2_snowflake_acs_url = 'https://<orgname>-<my-snowflake-open-catalog-account-name>.snowflakecomputing.com/fed/login'
      saml2_snowflake_issuer_url = 'https://<orgname>-<my-snowflake-open-catalog-account-name>.snowflakecomputing.com'
      saml2_requested_nameid_format = 'urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress';”
  

  Copy

  여기서:

  • <이름> 은 보안 통합을 위한 식별자를 지정하며, 계정에 고유해야 합니다.

  • Auth0 콘솔에서 <Auth0 도메인> 이 복사됩니다. 이 값을 찾으려면 Auth0에서 Applications > Applications > Snowflake Open Catalog application > Settings > Basic Information: Domain 필드로 이동합니다.

  • Auth0 콘솔에서 <SAML Protocol URL> 이 복사됩니다. 이 값을 찾으려면 Auth0에서 Applications > Applications > Snowflake Open Catalog application > Settings > Advanced settings > Endpoints 탭: SAML Protocol URL 필드로 이동합니다.

  • Auth0 콘솔에서 <Certificate from Auth0> 이 복사됩니다. 이 값을 찾으려면 Auth0에서 Applications > Applications > Snowflake Open Catalog application > Settings > Advanced Settings > Certificate 탭: Signing Certificates 필드로 이동합니다. <BEGIN CERTIFICATE>와 <END CERTIFICATE> 사이의 값을 복사합니다.

  • <orgname> 은 Snowflake 조직의 이름입니다. 이 이름을 찾으려면 시작하기 전에 섹션을 참조하십시오.

  • <my-snowflake-open-catalog-account-name> 은 Snowflake Open Catalog 계정의 이름입니다. 이 이름을 찾으려면 시작하기 전에 섹션을 참조하십시오.

Okta 보안 통합¶

• Okta에 대한 SAML 보안 통합을 만들려면 Snowflake CLI 에서 다음 명령을 실행하십시오.

  snow sql -q “CREATE SECURITY INTEGRATION <Name>
      TYPE = SAML2 
      ENABLED = TRUE 
      SAML2_ISSUER = '<ENTITY ID>' 
      SAML2_SSO_URL = '<IDP SSO URL>' 
      SAML2_PROVIDER = 'OKTA' 
      SAML2_X509_CERT='<Authentication Certificate>' 
      SAML2_SP_INITIATED_LOGIN_PAGE_LABEL = 'OKTA SSO'
      SAML2_ENABLE_SP_INITIATED = TRUE
      SAML2_SNOWFLAKE_ACS_URL = 'https://<orgname>-<my-snowflake-open-catalog-account-name>.snowflakecomputing.com/fed/login'
      SAML2_SNOWFLAKE_ISSUER_URL = 'https://<orgname>-<my-snowflake-open-catalog-account-name>.snowflakecomputing.com';”
  

  Copy

  여기서:

  • <이름> 은 보안 통합을 위한 식별자를 지정하며, 계정에 고유해야 합니다.

  • <ENTITY ID> 는 Okta에서 애플리케이션을 만들 때 복사한 Entity ID 값입니다.

  • <IDP SSO URL> 은 Okta에서 애플리케이션을 만들 때 복사한 IDP SSO URL 값입니다.

  • <인증 인증서> 는 Okta에서 애플리케이션을 만들 때 복사한 IDP 인증 인증서 값입니다.

  • <orgname> 은 Snowflake 조직의 이름입니다. 이 이름을 찾으려면 시작하기 전에 섹션을 참조하십시오.

  • <my-snowflake-open-catalog-account-name> 은 Snowflake Open Catalog 계정의 이름입니다. 이 이름을 찾으려면 시작하기 전에 섹션을 참조하십시오.