Authentification Snowflake Cortex

Connectez UiPath à Snowflake Cortex à l’aide d’un jeton d’accès par programme, d’un code d’autorisation OAuth 2.0, d’informations d’identification client OAuth 2.0 avec Microsoft Entra ID ou d’un code d’autorisation OAuth 2.0 externe avec PKCE, en fournissant votre identifiant de compte et les informations d’identification associées.

Prérequis

Ce connecteur prend en charge quatre méthodes d’authentification: Jeton d’accès par programme (par défaut), Code d’autorisation OAuth 2.0, Informations d’identification du client OAuth 2.0 avec Microsoft Entra ID et Code d’autorisation OAuth 2.0 externe avec PKCE.

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 avec Microsoft Entra ID:
  • 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.
• Code d'autorisation OAuth 2.0 externe avec PKCE:
  • Identifiant de compte
  • URL d’autorisation, URL de jeton et URL de jeton d’actualisation : les points de terminaison OAuth 2.0 de votre fournisseur d’identité.
  • ID client : à partir de l’enregistrement de l’application dans votre fournisseur d’identité. Cette méthode utilise un client public, donc aucune clé secrète n’est requise.
  • Étendue : offline_access est toujours inclus, car la connexion a besoin qu’il actualise son jeton. Ajoutez les étendues requises par votre fournisseur d’identité pour Snowflake.

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 des informations d’identification du client OAuth 2.0 avec la méthode d’authentification Microsoft Entra ID

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 les informations d’identification du client OAuth 2.0 avec l’authentification Microsoft Entra ID, 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.

Utilisation du code d'autorisation OAuth 2.0 externe avec la méthode d'authentification PKCE

Cette méthode se connecte via votre propre fournisseur d’identité à l’aide du flux de code d’autorisation OAuth 2.0 avec la clé de preuve pour l’échange de code, sans clé secrète du client. Il fonctionne avec n’importe quel fournisseur d’identité dont Snowflake accepte les jetons via une intégration de sécurité OAuth externe. Microsoft Entra ID est le fournisseur d’identité de référence.

Pour configurer cette méthode d'authentification, configurez votre fournisseur d'identité et Snowflake:

1. Dans votre fournisseur d'identité, enregistrez une application en tant que client public et ajoutez l'URI de redirection https://{baseURL}/provisioning_/callback (par exemple, pour Automation Cloud https://cloud.uipath.com/provisioning_/callback). L'ID client de l'application est l' ID client de la connexion.
2. Dans Snowflake, créez une Intégration de sécurité OAuth externe pour votre fournisseur d’identité. L'intégration mappe une revendication dans le jeton, telle que upn, à un utilisateur Snowflake via le LOGIN_NAME de l'utilisateur.
3. Assurez-vous que le jeton accorde le rôle utilisé par la connexion. Le rôle doit se situer dans l'étendue du jeton, par exemple session:role:<role>, sauf si l'intégration définit EXTERNAL_OAUTH_ANY_ROLE_MODE sur ENABLE.
4. Lorsque vous créez la connexion, remplacez les valeurs dans URL d’autorisation, URL de jeton et Actualiser l’URL de jeton par les points de terminaison de votre fournisseur d’identité.

Pour la syntaxe de configuration exacte, consultez la section Vue d’ensemble d’OAuth externe 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, OAuth 2.0 Code d’autorisation, OAuth 2.0 Informations d’identification du client avec Microsoft Entra ID ou Code d’autorisation OAuth 2.0 externe avec PKCE.

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.