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 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

• 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

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.
• Independientemente del método de autenticación seleccionado, 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 el cortafuegos en la guía de administración de Automation Cloud.

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 redirección correcta en la consulta: 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;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_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. Select Orchestrator from the product launcher.
2. Select a folder, and then navigate to the Connections tab.
3. Selecciona Añadir conexión.
4. To open the connection creation page, select the connector from the list. You can use the search bar to find the connector.
5. Enter your required Snowflake credentials and 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 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.

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