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 et rotation des 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 de Snowflake restreint l'accès par IP, vous devez configurer une liste d'autorisation pour les IP utilisées par Integration Service. Pour plus de détails, consultez la section Configuration d'une liste d'autorisation pour les domaines de 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, reportez-vous à la section sur l' hôte de base de données disponible sur cette page, ainsi qu'à 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. Une fois connecté, dans le menu de gauche, sélectionnez Données, puis Bases de données .

   • Nom de la base de données : une liste de bases de données s'affiche :

     
     

     

     
     

   • Nom du schéma de la base de données - Sélectionnez une base de données pour afficher la liste des noms de schéma de base de données :

     
     

     

     
     

3. Pour récupérer l ' entrepôt, dans le menu de gauche, accédez à Admin > Entrepôts:

   
   

   

   
   

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

Remarque : seuls les utilisateurs disposant d'un rôle ACAccountADMIN peuvent créer des informations d'identification OAuth2. Par défaut, les utilisateurs disposant des rôles ACAccountADMIN, ORGADMIN et SecurityADMIN ne peuvent pas utiliser l'authentification OAuth 2.0 pour créer une connexion. Pour plus de détails, consultez Snowflake section Flux d'autorisation 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 de 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;

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_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');

Pour plus de détails, consultez la section Configurer Snowflake OAuth pour des 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 Se connecter à Snowflake (Connect to Snowflake) et sélectionnez votre méthode d'authentification préférée.
4. Entrez vos informations d'identification Snowflake requises.

5. Sélectionnez Se connecter (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 du privilège USAGE sur la base de données (JULY_DEMO) et le schéma de base de données (DEAL_AMOUNT) 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.