Authentification Snowflake Cortex

Connectez UiPath à Snowflake Cortex à l’aide d’un jeton d’accès personnel, d’un code d’autorisation OAuth 2.0 ou d’informations d’identification de client OAuth 2.0 en fournissant votre identifiant de compte et les informations d’identification associées.

Prérequis

Ce connecteur prend en charge trois méthodes d'authentification: Jeton d'accès par programme (par défaut), Code d'autorisation OAuth 2.0 et Informations d'identification du client OAuth 2.0.

Pour créer une connexion, vous avez besoin des informations d'identification suivantes :

• Jeton d’accès par programme:
  • Identifiant de compte
  • Jeton d’accès personnel
• Code d'autorisation OAuth 2.0:
  • Identifiant de compte
  • ID de client
  • Clé secrète du client
  • Étendue : la valeur par défaut est session:role:SYSADMIN. Vous pouvez remplacer cela par un autre rôle, à condition que ce rôle soit accordé à l’utilisateur qui se connecte.
• Informations d’identification du client OAuth 2.0:
  • Identifiant de compte
  • ID client et Secret client : à partir de l’enregistrement de l’application Microsoft Entra ID.
  • Étendue : l’étendue de l’application Microsoft Entra ID représentant Snowflake, sous la forme api://<application-id-uri>/.default.
  • ID de locataire : l'ID d'annuaire (locataire) Microsoft Entra ID, disponible dans la section Aperçu de votre enregistrement d'application Microsoft Entra ID.

Récupération de vos identifiants

Vous pouvez extraire l'identifiant du compte à partir des détails de votre compte ou de l' URL du serveur de compte. Par exemple, dans l'URL YQXMADF-EWA19151.snowflakecomputing.com l'identifiant est YQXMADF-EWA19151.

Le jeton d'accès personnel (PAT) peut être créé dans le tableau de bord Snowflake sous Paramètres > Authentification > Jetons d'accès programmés. L'option PAT n'est visible que si votre rôle autorise sa création. Contactez votre administrateur pour plus de détails.

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

Remarque :

Par défaut, les utilisateurs ayant le rôle ACCOUNTADMIN, ORGADMIN ou SECURITYADMIN ne peuvent pas utiliser l'authentification OAuth 2.0 pour créer une connexion. Le rôle que vous saisissez dans Étendue doit être accordé à l’utilisateur qui se connecte et ne doit pas être l’un de ces trois rôles. Pour plus de détails, consultez la section Snowflake 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. Assurez-vous d’inclure l’URL de redirection correcte: https://{baseURL}/provisioning_/callback (par exemple, pour Automation Cloud, 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. 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 le secret du client. Copiez OAUTH_CLIENT_SECRET (non OAUTH_CLIENT_SECRET_2).

   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.

Utilisation de la méthode d’authentification des informations d’identification du client OAuth 2.0

Cette méthode s’authentifie via Snowflake External OAuth avec Microsoft Entra ID au lieu du propre point de terminaison OAuth de Snowflake: le connecteur échange l’ID client et la clé secrète de l’application Microsoft Entra ID contre un jeton d’accès, puis envoie ce jeton à Snowflake.

Pour configurer l’authentification par informations d’identification du client OAuth 2.0, configurez à la fois Microsoft Entra ID et Snowflake:

1. Dans Microsoft Entra ID, enregistrez une application et créez une clé secrète de client pour elle. Cela fournit l’ ID de client et la Clé secrète du client, et l’ ID de locataire est disponible dans la section Vue d’ensemble de l’application.
2. Dans Microsoft Entra ID, identifiez (ou enregistrez) l’application représentant Snowflake et notez son URI d’ID d’application. Utilisez-le pour créer la valeur Étendue : api://<application-id-uri>/.default.
3. Dans Snowflake, créez une intégration de sécurité pour OAuth externe avec le type d'application défini sur Azure, l'audience définie sur l'URI d'ID d'application de l'étape 2 et un utilisateur Snowflake mappé à la revendication de jeton du principal du service.

Pour obtenir la syntaxe de configuration exacte, consultez la section OAuth externe Snowflake avec Microsoft Entra ID dans la documentation Snowflake.

Ajouter la connexion Snowflake Cortex

1. Sélectionnez Orchestrator dans le lanceur du produit.

2. Sélectionnez un dossier, puis accédez à l'onglet Connexions .

3. Sélectionnez Ajouter une connexion (Add connecion).

4. Pour ouvrir la page de création de connexion, sélectionnez le connecteur dans la liste. Vous pouvez utiliser la barre de recherche pour trouver le connecteur.

5. Sélectionnez le type d'authentification: Jeton d'accès par programme, Code d'autorisation OAuth 2.0 ou Informations d'identification du client OAuth 2.0.

6. Saisissez les informations d’identification requises et sélectionnez Connect.

   Lorsque cette option est disponible, sélectionnez le menu à côté d'un champ et choisissez Utiliser la ressource d'informations d’identification ou Utiliser la ressource Orchestrator pour référencer une ressource Orchestrator au lieu d'entrer directement la valeur. Pour plus d'informations, consultez Utiliser des ressources d'informations d'identification pour les connexions.