Configurar o Snowflake Open Catalog para usar SSO¶

Adicionar uma conexão Snowflake CLI para o Snowflake Open Catalog¶

Adicione uma conexão para a conta do Snowflake Open Catalog na qual deseja ativar o SSO.

• Adicione uma conexão <https://docs.snowflake.com/en/developer-guide/snowflake-cli/connecting/configure-connections#add-a-connection>_ com os seguintes valores. Para todos os outros parâmetros, pressione Enter para pular a especificação de um valor para o parâmetro.

  Parâmetros de configuração da conexão	Valor
  Nome para essa conexão	Especifique um nome para a conexão; por exemplo, myopencatalogconnection.
  Nome da conta	Especifique o nome da organização do Snowflake, seguido do nome da conta do Open Catalog, neste formato: <orgname>-<my-snowflake-open-catalog-account-name>. Por exemplo, ABCDEFG-MYACCOUNT1. Para encontrar esses nomes, consulte Antes de começar_.
  Nome de usuário	Especifique seu nome de usuário para o Open Catalog; por exemplo, jsmith.
  Senha [opcional]	Esse parâmetro não é opcional quando você cria uma conexão para o Open Catalog. Digite sua senha para o Open Catalog; por exemplo, MyPassword123456789.
  Função para a conexão [opcional]	Esse parâmetro não é opcional quando você cria uma conexão para o Open Catalog. Você deve inserir POLARIS_ACCOUNT_ADMIN

Teste a conexão do Snowflake CLI¶

• Para testar sua conexão CLI, siga este exemplo, que testa a conexão para myopencatalogconnection:

  snow connection test -c myopencatalogconnection
  

  Copy

  A resposta deve ser semelhante a esta:

  +------------------------------------------------------------------------------+
  | 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

Defina sua conexão do Snowflake CLI para o Snowflake Open Catalog como padrão¶

Para garantir que a conexão que você está usando sempre tenha a função POLARIS_ACCOUNT_ADMIN necessária concedida a ela, é possível definir a conexão do Snowflake CLI criada para o Open Catalog como a conexão padrão. Para obter mais informações sobre a conexão padrão, consulte Definir a conexão padrão <https://docs.snowflake.com/en/developer-guide/snowflake-cli/connecting/configure-connections#set-the-default-connection>_.

1. Siga este exemplo, que define a conexão myopencatalogconnection como padrão:

   snow connection set-default myopencatalogconnection
   

   Copy

2. Para confirmar que está usando o usuário e a função corretos, execute o seguinte:

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

   Copy

   A resposta deve retornar seu nome de usuário do Open Catalog e CURRENT ROLE deve ser POLARIS_ACCOUNT_ADMIN.

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

   Copy

Integração de segurança Auth0¶

• Para criar uma integração de segurança SAML para o Auth0, execute o seguinte comando no 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

  Onde:

  • <Name> especifica o identificador da integração de segurança; deve ser exclusivo para sua conta.

  • <Auth0 Domain> é copiado no console Auth0. Para encontrar esse valor, em Auth0, navegue até Applications > Applications > Snowflake Open Catalog application > Settings > Basic Information: campo Domain.

  • <SAML Protocol URL> é copiado no console Auth0. Para encontrar esse valor, em Auth0, navegue até Applications > Applications > Snowflake Open Catalog application > Settings > Advanced settings > guia Endpoints: campo SAML Protocol URL.

  • <O certificado do Auth0> é copiado no console do Auth0. Para encontrar esse valor, no Auth0, navegue até: Applications > Applications > Snowflake Open Catalog application > Settings > Advanced Settings > guia Certificate tab: campo Signing Certificates. Copie o valor entre <BEGIN CERTIFICATE> e <END CERTIFICATE>.

  • <orgname> é o nome da sua organização do Snowflake. Para encontrar esse nome, consulte Antes de começar.

  • <my-snowflake-open-catalog-account-name> é o nome da sua conta do Snowflake Open Catalog. Para encontrar esse nome, consulte Antes de começar.

Integração de segurança do Okta¶

• Para criar uma integração de segurança SAML para o Okta, execute o seguinte comando no 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

  Onde:

  • <Name> especifica o identificador da integração de segurança; deve ser exclusivo para sua conta.

  • <ENTITY ID> é o valor de ID de entidade que você copiou quando criou um aplicativo no Okta.

  • <IDP SSO URL> é o valor de IDP SSO URL que você copiou quando criou um aplicativo no Okta.

  • <Authentication Certificate> é o valor do Authentication Certificate IDP que copiou quando criou um aplicativo no Okta.

  • <orgname> é o nome da sua organização do Snowflake. Para encontrar esse nome, consulte Antes de começar.

  • <my-snowflake-open-catalog-account-name> é o nome da sua conta do Snowflake Open Catalog. Para encontrar esse nome, consulte Antes de começar.