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

  여기서

  • <Name>은 보안 통합의 식별자를 지정하며, 계정에 대해 고유해야 합니다.

  • <Auth0 Domain>은 Auth0 콘솔에 복사됩니다. 이 값을 찾으려면 Auth0에서 애플리케이션 > 애플리케이션 > Snowflake Open Catalog 애플리케이션 > 설정 > 기본 정보: 도메인 필드로 이동하세요.

  • <SAML Protocol URL>은 Auth0 콘솔에 복사됩니다. 이 값을 찾으려면 Auth0에서 애플리케이션 > 애플리케이션 > Snowflake Open Catalog 애플리케이션 > 설정 > 고급 설정 > 엔드포인트 탭: SAML 프로토콜 URL 필드로 이동하세요.

  • <Certificate from Auth0>은 Auth0 콘솔에 복사됩니다. 이 값을 찾으려면 Auth0에서 애플리케이션 > 애플리케이션 > Snowflake Open Catalog 애플리케이션 > 설정 > 고급 설정 > 인증서 탭: 서명 인증서 필드로 이동하세요. <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

  여기서

  • <Name>은 보안 통합의 식별자를 지정하며, 계정에 대해 고유해야 합니다.

  • <ENTITY ID>는 Okta에서 애플리케이션 생성 시 복사한 엔터티 ID 값입니다.

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

  • <Authentication Certificate>은 Okta에서 애플리케이션을 생성할 때 복사한 IDP 인증서 값입니다.

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

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