Autenticación de Snowflake Cortex

Conecta UiPath a Snowflake Cortex utilizando un token de acceso programático, un código de autorización OAuth 2.0, credenciales de cliente OAuth 2.0 con Microsoft Entra ID o un código de autorización OAuth 2.0 externo con PKCE, proporcionando tu identificador de cuenta y las credenciales relacionadas.

Requisitos previos

Este conector admite cuatro métodos de autenticación: token de acceso programático (predeterminado), código de autorización OAuth 2.0, credenciales de cliente OAuth 2.0 con Microsoft Entra ID y código de autorización OAuth 2.0 externo con PKCE.

Para crear una conexión, necesita las siguientes credenciales:

• Token de acceso programático:
  • Identificador de cuenta
  • Token de acceso personal
• Código de autorización OAuth 2.0:
  • Identificador de cuenta
  • ID de cliente
  • Secreto de cliente
  • Ámbito : el valor predeterminado es session:role:SYSADMIN. Puedes cambiar esto a un rol diferente, siempre que ese rol se otorgue al usuario que se conecta.
• Credenciales de cliente OAuth 2.0 con Microsoft Entra ID:
  • Identificador de cuenta
  • ID de cliente y secreto de cliente : desde el registro de la aplicación Microsoft Entra ID.
  • Ámbito : el ámbito de la aplicación Microsoft Entra ID que representa a Snowflake, en el formulario api://<application-id-uri>/.default.
  • ID de tenant : el ID del directorio (tenant) de Microsoft Entra ID, disponible en la sección Información general de tu registro de aplicación de Microsoft Entra ID.
• Código de autorización OAuth 2.0 externo con PKCE:
  • Identificador de cuenta
  • URL de autorización, URL del token y URL del token de actualización : los puntos finales OAuth 2.0 de tu proveedor de identidades.
  • ID de cliente : desde el registro de la aplicación en tu proveedor de identidad. Este método utiliza un cliente público, por lo que no se requiere ningún secreto de cliente.
  • Ámbito : offline_access siempre se incluye, porque la conexión lo necesita para actualizar su token. Añade los ámbitos que requiere tu proveedor de identidades para Snowflake.

Recuperar sus credenciales

Puedes extraer el identificador de la cuenta de tus Detalles de la cuenta o de la URL del servidor de la cuenta. Por ejemplo, en la URL YQXMADF-EWA19151.snowflakecomputing.com el identificador es YQXMADF-EWA19151.

El token de acceso personal (PAT) puede crearse en el panel de Snowflake en Configuración > Autenticación > Tokens de acceso programáticos. Verás la opción PAT solo si tu rol permite su creación. Ponte en contacto con tu administrador para obtener más información.

Utilizar el método de autenticación del código de autorización OAuth 2.0

Nota:

De forma predeterminada, los usuarios con el rol ACCOUNTADMIN, ORGADMIN o SECURITYADMIN no pueden utilizar la autenticación OAuth 2.0 para crear una conexión. El rol que introduzcas en Ámbito debe concederse al usuario que se conecta y no debe ser uno de estos tres. Para obtener más información, consulta Flujo de autorización OAuth de Snowflake.

Para crear un cliente OAuth 2.0 para Snowflake, sigue los siguientes pasos:

1. Ejecuta la siguiente consulta para crear la integración de OAuth. Asegúrate de incluir la URL de redirección correcta: https://{baseURL}/provisioning_/callback (por ejemplo, para 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. Ejecuta la siguiente consulta para ver los detalles del cliente. Copia el OAUTH_CLIENT_ID.

   DESCRIBE SECURITY INTEGRATION my_oauth_integration_uipath
   

3. Ejecuta la siguiente consulta para ver el secreto de cliente. Copiar OAUTH_CLIENT_SECRET (no OAUTH_CLIENT_SECRET_2).

   select system$show_oauth_client_secrets('MY_OAUTH_INTEGRATION_UIPATH');
   

Para obtener más información, consulta Configurar Snowflake OAuth para clientes personalizados.

Utilizar las credenciales de cliente OAuth 2.0 con el método de autenticación de Microsoft Entra ID

Este método se autentica a través de OAuth externo de Snowflake con Microsoft Entra ID en lugar del propio punto final OAuth de Snowflake: el conector intercambia el ID de cliente y el secreto de la aplicación Microsoft Entra ID por un token de acceso y luego envía ese token a Snowflake.

Para configurar las credenciales de cliente OAuth 2.0 con la autenticación de Microsoft Entra ID, configura tanto Microsoft Entra ID como Snowflake:

1. En Microsoft Entra ID, registra una aplicación y crea un secreto de cliente para ella. Esto proporciona el ID de cliente y el Secreto de cliente, y el ID de tenant está disponible en la sección Información general de la aplicación.
2. En Microsoft Entra ID, identifica (o registra) la aplicación que representa a Snowflake y anota su URI de ID de aplicación. Úsalo para crear el valor Ámbito : api://<application-id-uri>/.default.
3. En Snowflake, crea una integración de seguridad para OAuth externo con el tipo de aplicación establecido en Azure, la audiencia establecida en el URI de ID de aplicación del paso 2 y un usuario de Snowflake asignado a la solicitud de token de la entidad de servicio.

Para obtener la sintaxis de configuración exacta, consulta OAuth externo de Snowflake con Microsoft Entra ID en la documentación de Snowflake.

Utilizar el código de autorización OAuth 2.0 externo con el método de autenticación PKCE

Este método inicia sesión a través de tu propio proveedor de identidad utilizando el flujo de código de autorización OAuth 2.0 con clave de prueba para intercambio de código (PKCE), sin un secreto de cliente. Funciona con cualquier proveedor de identidades cuyos tokens acepte Snowflake a través de una integración de seguridad OAuth externa. Microsoft Entra ID es el proveedor de identidad de referencia.

Para configurar este método de autenticación, configura tu proveedor de identidad y Snowflake:

1. En tu proveedor de identidades, registra una aplicación como cliente público y añade el URI de redirección https://{baseURL}/provisioning_/callback (por ejemplo, para Automation Cloud https://cloud.uipath.com/provisioning_/callback). El ID de cliente de la aplicación es el ID de cliente para la conexión.
2. En Snowflake, crea una integración de seguridad OAuth externa para tu proveedor de identidades. La integración asigna una reclamación en el token, como upn, a un usuario de Snowflake a través del LOGIN_NAME del usuario.
3. Asegúrate de que el token otorga el rol que utiliza la conexión. El rol debe estar en el ámbito del token, por ejemplo, session:role:<role>, a menos que la integración establezca EXTERNAL_OAUTH_ANY_ROLE_MODE en ENABLE.
4. Al crear la conexión, reemplaza los valores en URL de autorización, URL del token y Actualizar URL del token con los puntos finales de tu proveedor de identidades.

Para obtener la sintaxis de configuración exacta, consulta Descripción general de OAuth externo en la documentación de Snowflake.

Añadir la conexión Snowflake Cortex

1. Selecciona Orchestrator en el lanzador de productos.

2. Selecciona una carpeta y luego navega a la pestaña Conexiones .

3. Selecciona Añadir conexión.

4. Para abrir la página de creación de conexiones, selecciona el conector de la lista. Puedes utilizar la barra de búsqueda para encontrar el conector.

5. Selecciona el tipo de autenticación: Token de acceso programático, Código de autorización OAuth 2.0, Credenciales de cliente OAuth 2.0 con Microsoft Entra ID o Código de autorización OAuth 2.0 externo con PKCE.

6. Introduce las credenciales necesarias y selecciona Conectar.

   Cuando esté disponible, selecciona el menú junto a un campo y elige Usar activo de credenciales o Usar activo de Orchestrator para hacer referencia a un activo de Orchestrator en lugar de introducir el valor directamente. Para obtener más información, consulta Usar activos de credenciales para las conexiones.