Configurer Snowflake Open Catalog pour utiliser la SSO¶

Ajouter une connexion CLI Snowflake pour Snowflake Open Catalog¶

Ajoutez une connexion pour le compte Snowflake Open Catalog où vous souhaitez activer la SSO.

• Ajouter 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 Entrée pour ne pas spécifier de valeur pour le paramètre.

  Paramètres de configuration de la connexion	Valeur
  Nom de cette connexion	Spécifiez un nom pour la connexion ; par exemple, myopencatalogconnection.
  Nom d’utilisateur	Indiquez le nom de votre organisation Snowflake, suivi de votre nom d’utilisateur Open Catalog, au format suivant : <orgname>-<my-snowflake-open-catalog-account-name>. Par exemple, ABCDEFG-MYACCOUNT1. Pour trouver ces noms, voir Avant de commencer_.
  Nom d’utilisateur	Indiquez votre nom d’utilisateur pour Open Catalog ; par exemple, jsmith.
  Mot de passe [facultatif]	Ce paramètre n’est pas facultatif 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 [facultatif]	Ce paramètre n’est pas facultatif lorsque vous créez une connexion pour Open Catalog. Vous devez saisir POLARIS_ACCOUNT_ADMIN

Test de la connexion CLI Snowflake¶

• Pour tester votre connexion CLI, suivez cet exemple, qui teste la connexion pour 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

Définissez votre connexion CLI Snowflake pour Snowflake Open Catalog comme connexion par défaut¶

Pour que la connexion que vous utilisez dispose toujours du bon rôle POLARIS_ACCOUNT_ADMIN qui lui est attribué, vous pouvez définir la connexion CLI Snowflake que vous avez créée pour Open Catalog comme connexion par défaut. Pour plus d’informations sur la connexion par défaut, voir Définir 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 définit la connexion myopencatalogconnection par défaut :

   snow connection set-default myopencatalogconnection
   

   Copy

2. Pour confirmer que vous utilisez le bon utilisateur et le bon rôle, exécutez la commande suivante :

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

   Copy

   La réponse doit renvoyer votre nom d’utilisateur Open Catalog et le CURRENT ROLE 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 la CLI Snowflake :

  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ù :

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

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

  • <SAML Protocol URL> est copié dans la console Auth0. Pour trouver cette valeur, dans Auth0, accédez à Applications > Applications > Application Snowflake Open Catalog > Paramètres > Paramètres avancés > Onglet Points de terminaison : champ URL de protocole SAML.

  • <Certificate from Auth0> est copié dans la console Auth0. Pour trouver cette valeur, dans Auth0, accédez à : Applications > Applications > Application Snowflake Open Catalog > Paramètres > Paramètres avancés > Onglet Certificat : champ Certificats de signature. Copiez la valeur entre <BEGIN CERTIFICATE> et <END CERTIFICATE>.

  • <orgname> 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 la connexionCLI Snowflake :

  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ù :

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

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

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

  • <Authentication Certificate> est la valeur Certificat d’authentification IDP que vous avez copiée lorsque vous avez créé une application dans Okta.

  • <orgname> 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.