Autenticación de Snowflake

Conecta UiPath a Snowflake utilizando OAuth 2.0 o la autenticación JDBC personalizada en Automation Suite.

Requisitos previos

Dependiendo del tipo de autenticación que selecciones, necesitarás una de las siguientes credenciales:

• Traiga su propia aplicación OAuth 2.0:
  • ID de cliente
  • Secreto de cliente
  • Host de la base de datos
  • Almacén
  • Nombre del esquema de la base de datos
  • Nombre de la base de datos
  • Rol
• Token de acceso personal (utilizar tokens de acceso programáticos para la autenticación)
  • Nombre de usuario
  • Token de acceso personal
  • Almacén
  • Nombre del esquema de la base de datos
  • Nombre de la base de datos
  • Rol
• Autenticación personalizada (autenticación JDBC obsoleta):
  • Host de la base de datos
  • Nombre de usuario
  • Contraseña
  • Almacén
  • Nombre del esquema de la base de datos
  • Nombre de la base de datos
• RSA (autenticación de par de claves y rotación de pares de claves)
  • Host de la base de datos
  • Nombre de usuario
  • Clave privada RSA
  • Almacén
  • Nombre del esquema de la base de datos
  • Nombre de la base de datos

Nota:

Limitaciones conocidas:

• Para autenticarte mediante RSA, debes utilizar una clave privada RSA no cifrada.
• No se admiten las conexiones a través de AWS PrivateLink.
• Si tu instancia de Snowflake restringe el acceso por IP, debes configurar una lista de permisos para las IP utilizadas por Integration Service. Para obtener más información, consulta Configurar una lista de permisos para dominios de conector en la guía de instalación de Automation Suite.

Recuperar tus credenciales de Snowflake

Para recuperar las credenciales de Snowflake, sigue los siguientes pasos:

1. El host de la base de datos está disponible en la URL utilizada para conectarse a tu aplicación Snowflake:

Nota:

El formato del host de la base de datos puede variar en función del tipo de identificador de tu cuenta. Para obtener más información, consulta la sección sobre Host de base de datos disponible en esta página, así como la documentación oficial de Snowflake.

Por ejemplo, para la siguiente URL https://app.snowflake.com/east-us-2.azure/za96341/dashboards, accountID es za96341 y region es east-us-2.azure.

Para construir un host de base de datos, debes utilizar el formato accountID.region.snowflakecomputing.com. Por lo tanto, para la URL anterior, el host de la base de datos construido sería za96341.east-us-2.azure.snowflakecomputing.com.

2. Once you are logged in, on the left-side menu, select Data, then Databases.
   • Database name: A list of databases is displayed:

• Database schema name - Select a database to view the list of database schema names:

3. To retrieve the Warehouse, on the left-side menu, go to Admin > Warehouses:

Recuperar las credenciales de OAuth de Snowflake

Nota:

Solo los usuarios con un rol ADMINCUENTA pueden crear credenciales OAuth2. De forma predeterminada, los usuarios con los roles ACCOUNTADMIN, ORGADMIN y SECURITYADMIN no pueden utilizar la autenticación OAuth 2.0 para crear una conexión. 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 OAuth.

Esta consulta no muestra el ID de cliente. Debe ejecutar una segunda consulta para ver los detalles del cliente. Asegúrate de incluir la URL de redirección correcta en la consulta: 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. 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 del cliente. Copia el OAUTH_CLIENT_SECRET.

Esta consulta genera dos elementos: OAUTH_CLIENT_SECRET y OAUTH_CLIENT_SECRET_2. Debe utilizar OAUTH_CLIENT_SECRET.

select system$show_oauth_client_secrets('MY_OAUTH_INTEGRATION_UIPATH');

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

Añadir la conexión de Snowflake

1. Selecciona Integration Service en la barra izquierda.
2. En la lista Conectores , selecciona Snowflake. También puedes utilizar la barra de búsqueda para encontrar el conector.
3. Selecciona el botón Conectar a Snowflake y selecciona tu método de autenticación preferido.
4. Introduce las credenciales de Snowflake necesarias.
5. Select Connect.

Permisos

La conexión permite que UiPath lea, escriba, modifique y elimine datos de Snowflake en tu nombre.

Roles necesarios para conectarse a Snowflake

Al crear una conexión para Snowflake desde Integration Service, el conector siempre selecciona el rol predeterminado del usuario, como se muestra en la siguiente imagen.

Los administradores de Snowflake pueden configurar roles personalizados para los usuarios, ya que no todos tienen roles de administrador por razones de seguridad.

El siguiente ejemplo muestra exactamente lo que se necesita en Snowflake para que el proceso de conexión de Integration Service funcione sin problemas. En este ejemplo, creas una conexión utilizando el esquema de base de datos OFERTA_CANTIDAD y la base de datos JULY_DEMO.

El primer paso es asegurarse de que el rol predeterminado, en este caso SAMRAT, tenga privilegios de USO tanto en la base de datos (JULY_DEMO) como en el esquema de la base de datos (DEAL_AMOUNT) en Snowflake.

Una autenticación exitosa en Snowflake depende de esta configuración. Un rol siempre puede tener privilegios adicionales asignados por un administrador.

Para obtener más información, consulta Privilegios de control de acceso en la documentación de Snowflake.