Configurez Snowflake Open Catalog pour utiliser le SSO¶

Ajoutez une connexion Snowflake CLI pour Snowflake Open Catalog¶

Ajoutez une connexion pour le compte Snowflake Open Catalog sur lequel vous souhaitez activer le SSO.

• Ajoutez une connexion <https://docs.snowflake.com/en/developer-guide/snowflake-cli/connecting/configure-connections#add-a-connection>_ avec les valeurs suivantes. Pour tous les autres paramètres, appuyez sur Entrer pour ne pas spécifier de valeur pour le paramètre.

  Paramètres de configuration de la connexion	Valeur
  Nom de cette connexion	Indiquez un nom pour la connexion ; par exemple, myopencatalogconnection.
  Nom du compte	Indiquez le nom de votre organisation Snowflake, suivi du nom de votre compte Open Catalog, dans ce format : <orgnamemy-snowflake-open-catalog-account-name>-<>. Par exemple, ABCDEFG-MYACCOUNT1. Pour trouver ces noms, voir Avant de commencer_.
  Nom d’utilisateur	Spécifiez votre nom d’utilisateur pour Open Catalog ; par exemple, jsmith.
  Mot de passe [optionnel]	Ce paramètre est non optionnel lorsque vous créez une connexion pour Open Catalog. Saisissez votre mot de passe pour Open Catalog ; par exemple, MyPassword123456789.
  Rôle pour la connexion [optionnel]	Ce paramètre est non optionnel lorsque vous créez une connexion pour Open Catalog. Vous devez saisir POLARIS_ACCOUNT_ADMIN

Testez la connexion Snowflake CLI¶

• Pour tester votre connexion à CLI, suivez cet exemple, qui teste la connexion à myopencatalogconnection:

  snow connection test -c myopencatalogconnection
  

  Copy

  La réponse devrait ressembler à ceci :

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

Paramétrez votre connexion Snowflake CLI pour Snowflake Open Catalog comme connexion par défaut¶

Pour vous assurer que la connexion que vous utilisez dispose toujours du rôle POLARIS_ACCOUNT_ADMIN requis, vous pouvez définir la connexion Snowflake CLI que vous avez créée pour Open Catalog comme la connexion par défaut. Pour plus d’informations sur la connexion par défaut, voir Paramétrer la connexion par défaut <https://docs.snowflake.com/en/developer-guide/snowflake-cli/connecting/configure-connections#set-the-default-connection>_.

1. Suivez cet exemple, qui paramètre la connexion myopencatalogconnection par défaut :

   snow connection set-default myopencatalogconnection
   

   Copy

2. Pour confirmer que vous utilisez l’utilisateur et le rôle corrects, exécutez la procédure suivante :

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

   Copy

   La réponse devrait renvoyer votre nom d’utilisateur Open Catalog et le ROLE CURRENT devrait être POLARIS_ACCOUNT_ADMIN.

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

   Copy

Intégration de sécurité Auth0¶

• Pour créer une intégration de sécurité SAML pour Auth0, exécutez la commande suivante dans 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

  Où :

  • <Nom> spécifie l’identificateur de l’intégration de sécurité ; il doit être unique pour votre compte.

  • <Domaine Auth0> est copié dans la console Auth0. Pour trouver cette valeur, dans Auth0, naviguez vers Applications > Applications > Application Snowflake Open Catalog > Paramètres > Informations de base : champ Domaine.

  • <L'URL du protocoleSAML > est copiée dans la console Auth0. Pour trouver cette valeur, dans Auth0, naviguez vers Applications > Applications > Application Snowflake Open Catalog > Paramètres > Paramètres avancés > Onglet Points de terminaison : champ URL protocole SAML.

  • <Le certificat de Auth0> est copié dans la console Auth0. Pour trouver cette valeur, dans Auth0, naviguez vers : Applications > Applications > Application Snowflake Open Catalog > Paramètres > Paramètres avancés > Onglet Certificat : champ Certificats d’authentification. Copiez la valeur entre <BEGIN CERTIFICATE> et <END CERTIFICATE>.

  • <nomorga> est le nom de votre organisation Snowflake. Pour trouver ce nom, voir Avant de commencer.

  • <my-snowflake-open-catalog-account-name> est le nom de votre compte Snowflake Open Catalog. Pour trouver ce nom, voir Avant de commencer.

Intégration de sécurité Okta¶

• Pour créer une intégration de sécurité SAML pour Okta, exécutez la commande suivante dans 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

  Où :

  • <Nom> spécifie l’identificateur de l’intégration de sécurité ; il doit être unique pour votre compte.

  • <ENTITY ID> est la valeur de l’entité ID que vous avez copiée lorsque vous avez créé une application dans Okta.

  • <URLSSOIDP> est la valeur d’URL SSO IDP que vous avez copiée lorsque vous avez créé une application dans Okta.

  • <Certificat d'authentification> est la valeur du certificat d’authentification IDP que vous avez copiée lors de la création d’une application dans Okta.

  • <nomorga> est le nom de votre organisation Snowflake. Pour trouver ce nom, voir Avant de commencer.

  • <my-snowflake-open-catalog-account-name> est le nom de votre compte Snowflake Open Catalog. Pour trouver ce nom, voir Avant de commencer.