Authentification Snowflake

Prérequis

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

• Pour l' 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
• OAuth 2.0 Authorization code:
  • 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
• 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.

• Irrespective of the selected authentication method, if your Snowflake instance restricts access by IP, you must configure an allow list for the IPs used by Integration Service. For details, refer to the Configuring the firewall section from the Automation Cloud Admin guide.

Retrieving your credentials from Snowflake

To retrieve the credentials from Snowflake, take the following steps:

1. L'hôte de la base de données est disponible dans l'URL utilisée pour se connecter à votre application Snowflake :

   Note: The Database host format may differ depending on your account identifier type. To learn more, refer to the section on Database Host available on this page, as well as the official Snowflake documentation.
   
   

   

   
   
   For example, for the following URL https://app.snowflake.com/east-us-2.azure/za96341/dashboards, the accountID is za96341 and the region is 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:

   
   

   

   
   

Using the OAuth 2.0 Authorization code authentication method

Note: Only users with an ACCOUNTADMIN role can create OAuth2 credentials. By default, users with ACCOUNTADMIN, ORGADMIN, and SECURITYADMIN roles are blocked from using OAuth 2.0 authentication to create a connection. For details, refer to Snowflake OAuth authorization flow.

To create an OAuth 2.0 client for Snowflake, take the following steps:

1. Run the following query to create the OAuth integration.
   This query does not show the Client ID. You must run a second query to view the client details. Make sure to include the correct redirect URL in the query: https://cloud.uipath.com/provisioning_/callback.

    CREATE SECURITY INTEGRATION my_oauth_integration_uipath
   
      TYPE=OAUTH
      OAUTH_CLIENT= CUSTOM
      OAUTH_REDIRECT_URI='https://cloud.uipath.com/provisioning_/callback'
      OAUTH_CLIENT_TYPE='CONFIDENTIAL'
      OAUTH_ISSUE_REFRESH_TOKENS=true
      OAUTH_REFRESH_TOKEN_VALIDITY= 86400
      ENABLED=true;

2. Run the following query to view the client details. Copy the OAUTH_CLIENT_ID.

    DESCRIBE SECURITY INTEGRATION my_oauth_integration_uipath

3. Run the following query to view the client secret. Copy the OAUTH_CLIENT_SECRET.
   This query outputs two items: OAUTH_CLIENT_SECRET and OAUTH_CLIENT_SECRET_2. You must use OAUTH_CLIENT_SECRET.

    select system$show_oauth_client_secrets('MY_OAUTH_INTEGRATION_UIPATH');

For details, refer to Configure Snowflake OAuth for custom clients.

Adding the Snowflake connection

1. Sélectionnez Integration Service à partir d' Automation Cloud^TM.

2. Dans la liste Connecteurs , sélectionnez Snowflake. Vous pouvez également utiliser la barre de recherche pour trouver le connecteur.
3. Select the Connect to Snowflake button and select your preferred authentication method.
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

While creating a connection for Snowflake from Integration Service, the connector always selects the default role of the user, as shown in the following image.

Snowflake administrators can set up custom roles for users, because not everyone is granted administrator roles for security reasons.

The following example shows what exactly is needed in Snowflake for the Integration Service connection process to work smoothly. In this example, you create a connection using the DEAL_AMOUNT database schema and JULY_DEMO database.

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.