Autenticación de Snowflake

Requisitos previos

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

• Código de autorizació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
• Autenticación personalizada (autenticación JDBC):
  • 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 diferir 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:

   

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

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 redireccionamiento 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;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_uipathDESCRIBE 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');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 Automation Suite.
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.
6. Se ha agregado su conexión.

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 lo que se necesita exactamente 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 DEAL\_AMOUNT y la base de datos JULY\_DEMO.

El primer paso es asegurarse de que el rol predeterminado, en este caso SAMRAT, tenga privilegios USAGE 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.