Authentification Snowflake

Prérequis

Selon le type d'authentification que vous sélectionnez, vous avez besoin de l'une des informations d'identification suivantes :

• Code d'autorisation OAuth 2.0 :
  • ID de client
  • Secret du client
  • Hôte de base de données
  • Entrepôt
  • Nom du schéma de base de données
  • Nom de la base de données
  • Rôle
• Authentification personnalisée (authentification JDBC) :
  • Hôte de base de données
  • Nom d'utilisateur (Username)
  • Mot de passe (Password)
  • Entrepôt
  • Nom du schéma de base de données
  • Nom de la base de données
• RSA (Authentification de paire de clés et rotation de paires de clés)
  • Hôte de base de données
  • Nom d'utilisateur (Username)
  • Clé privée RSA
  • Entrepôt
  • Nom du schéma de base de données
  • Nom de la base de données

Remarque :

Limites connues :

• Pour vous authentifier à l'aide de RSA, vous devez utiliser une clé privée RSA non chiffrée.
• Les connexions via AWS PrivateLink ne sont pas prises en charge.
• Si votre instance Snowflake restreint l'accès par adresse IP, vous devez configurer une liste d'autorisations pour les adresses IP utilisées par Integration Service. Pour plus de détails, reportez-vous à la section Configuration d’une liste d’autorisation pour les domaines du connecteur dans le guide d’installation d’Automation Suite.

Récupérer vos informations d’identification depuis Snowflake

Pour récupérer les informations d'identification depuis Snowflake, procédez comme suit :

1. L'hôte de la base de données est disponible dans l'URL utilisée pour se connecter à votre application Snowflake : Remarque : Le format de l'hôte de la base de données peut différer selon le type d'identifiant de votre compte. Pour en savoir plus, consultez la section sur l' hôte de base de données disponible sur cette page, ainsi que la documentation officielle de Snowflake.

   

   Par exemple, pour l'URL suivante https://app.snowflake.com/east-us-2.azure/za96341/dashboards, le accountID est za96341 et le region est east-us-2.azure.

   Pour construire un hôte de base de données, vous devez utiliser le format accountID.region.snowflakecomputing.com. Ainsi, pour l'URL précédente, l'hôte de base de données construit serait za96341.east-us-2.azure.snowflakecomputing.com.

2. Once you are logged in, on the left-side menu, select Data, then Databases.

   • Database name: A list of databases is displayed:

     

   • Database schema name - Select a database to view the list of database schema names:

     

3. To retrieve the Warehouse, on the left-side menu, go to Admin > Warehouses:

   

Utilisation de la méthode d'authentification du code d'autorisation OAuth 2.0

Remarque :

Seuls les utilisateurs avec un rôle ACCountADMIN peuvent créer des informations d'identification OAuth2. Par défaut, les utilisateurs disposant de rôles ACCountADMIN, ORGADMIN et SURITIADMIN ne peuvent pas utiliser l'authentification OAuth 2.0 pour créer une connexion. Pour plus de détails, consultez la section Flux d’autorisation Snowflake OAuth.

Pour créer un client OAuth 2.0 pour Snowflake, procédez comme suit :

1. Exécutez la requête suivante pour créer l'intégration OAuth.

   Cette requête n'affiche pas l'ID client. Vous devez exécuter une deuxième requête pour afficher les détails du client. Assurez-vous d’inclure l’URL de redirection correcte dans la requête : https://{yourDomain}/provisioning\_/callback.

   CREATE SECURITY INTEGRATION my_oauth_integration_uipath   TYPE=OAUTH   OAUTH_CLIENT= CUSTOM   OAUTH_REDIRECT_URI='https://{yourDomain}/provisioning_/callback'   OAUTH_CLIENT_TYPE='CONFIDENTIAL'   OAUTH_ISSUE_REFRESH_TOKENS=true   OAUTH_REFRESH_TOKEN_VALIDITY= 86400   ENABLED=true;CREATE SECURITY INTEGRATION my_oauth_integration_uipath   TYPE=OAUTH   OAUTH_CLIENT= CUSTOM   OAUTH_REDIRECT_URI='https://{yourDomain}/provisioning_/callback'   OAUTH_CLIENT_TYPE='CONFIDENTIAL'   OAUTH_ISSUE_REFRESH_TOKENS=true   OAUTH_REFRESH_TOKEN_VALIDITY= 86400   ENABLED=true;

2. Exécutez la requête suivante pour afficher les détails du client. Copiez le fichier OAUTH_CLIENT_ID.

   DESCRIBE SECURITY INTEGRATION my_oauth_integration_uipathDESCRIBE SECURITY INTEGRATION my_oauth_integration_uipath

3. Exécutez la requête suivante pour afficher la clé secrète du client. Copiez le fichier OAUTH_CLIENT_SECRET.

   Cette requête génère deux éléments : OAUTH_CLIENT_SECRET et OAUTH_CLIENT_SECRET_2. Vous devez utiliser OAUTH_CLIENT_SECRET.

   select system$show_oauth_client_secrets('MY_OAUTH_INTEGRATION_UIPATH');select system$show_oauth_client_secrets('MY_OAUTH_INTEGRATION_UIPATH');

Pour de plus amples informations, consultez la section Configurer Snowflake OAuth pour les clients personnalisés.

Ajouter la connexion Snowflake

1. Sélectionnez Integration Service dans Automation Suite.
2. Dans la liste Connecteurs , sélectionnez Snowflake. Vous pouvez également utiliser la barre de recherche pour trouver le connecteur.
3. Sélectionnez le bouton Connect to Snowflake et sélectionnez votre méthode d'authentification préférée.
4. Entrez vos informations d'identification Snowflake requises.
5. Select Connect.
6. Votre connexion a été ajoutée.

Autorisations

La connexion permet à UiPath de lire, écrire, modifier et supprimer les données Snowflake en votre nom.

Rôles requis pour la connexion à Snowflake

Lors de la création d'une connexion pour Snowflake à partir d'Integration Service, le connecteur sélectionne toujours le rôle par défaut de l'utilisateur, comme illustré dans l'image suivante.

Les administrateurs Snowflake peuvent configurer des rôles personnalisés pour les utilisateurs, car tout le monde ne dispose pas de rôles d'administrateur pour des raisons de sécurité.

L'exemple suivant montre ce qui est exactement nécessaire dans Snowflake pour que le processus de connexion Integration Service fonctionne correctement. Dans cet exemple, vous créez une connexion à l'aide du schéma de base de données DEAL\_AMUNT et de la base de données JULY\_DEMO.

La première étape consiste à s'assurer que le rôle par défaut, dans ce cas SAMRAT, dispose des privilèges USAGE sur la base de données (JULY\_DEMO) et le schéma de base de données (DEAL\_AMUNT) dans Snowflake.

Une authentification réussie à Snowflake dépend de ces paramètres. Un rôle peut toujours se voir attribuer des privilèges supplémentaires par un administrateur.