Autenticação do Snowflake

Conecte a UiPath ao Snowflake usando o OAuth 2.0 ou a autenticação JDBC personalizada no Automation Suite.

Pré-requisitos

Dependendo do tipo de autenticação selecionado, você precisará de uma das seguintes credenciais:

• Traga seu próprio aplicativo OAuth 2.0:
  • ID do Cliente
  • Segredo do cliente
  • Host do banco de dados
  • Warehouse
  • Nome do esquema de banco de dados
  • Nome do banco de dados
  • Role
• Token de acesso pessoal (Usando tokens de acesso programático para autenticação)
  • Username
  • Token de acesso pessoal
  • Warehouse
  • Nome do esquema de banco de dados
  • Nome do banco de dados
  • Role
• Autenticação personalizada (autenticação JDBC obsoleta):
  • Host do banco de dados
  • Username
  • Senha
  • Warehouse
  • Nome do esquema de banco de dados
  • Nome do banco de dados
• RSA (Autenticação de par de chaves e rotação de pares de chaves)
  • Host do banco de dados
  • Username
  • Chave privada RSA
  • Warehouse
  • Nome do esquema de banco de dados
  • Nome do banco de dados

Observação:

Limitações conhecidas:

• Para autenticar usando RSA, você deve usar uma chave privada RSA não criptografada.
• As conexões via AWS PrivateLink não são compatíveis.
• Se sua instância do Snowflake restringir o acesso por IP, você deve configurar uma lista de permissão para os IPs usados pelo Integration Service. Para obter detalhes, consulte Configuração de uma lista de permissões para domínios de conector no guia de instalação do Automation Suite.

Recuperação de suas credenciais do Snowflake

Para recuperar as credenciais do Snowflake, siga as seguintes etapas:

1. O host do banco de dados está disponível no URL usado para se conectar ao seu aplicativo Snowflake:

Observação:

O formato do host do banco de dados pode ser diferente, dependendo do seu tipo de identificador de conta. Para saber mais, consulte a seção Host de banco de dados disponível nesta página, bem como a documentação oficial do Snowflake.

Por exemplo, para o seguinte URL https://app.snowflake.com/east-us-2.azure/za96341/dashboards, o accountID é za96341 e o region é east-us-2.azure.

Para construir um Host de banco de dados, você deve usar o formato accountID.region.snowflakecomputing.com. Portanto, para o URL anterior, o host do banco de dados construído seria 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 credenciais do OAuth do Snowflake

Observação:

Apenas usuários com a função ACcountADMIN podem criar credenciais do OAuth2. Por padrão, os usuários com as funções login. Para obter detalhes, consulte o Fluxo de autorização do Snowflake OAuth.

Para criar um cliente OAuth 2.0 para o Snowflake, execute as seguintes etapas:

1. Execute a consulta a seguir para criar a integração do OAuth.

Esta consulta não mostra o ID do Cliente. Você deve executar uma segunda consulta para exibir os detalhes do cliente. Certifique-se de incluir o URL de redirecionamento correto na 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. Execute a consulta a seguir para exibir os detalhes do cliente. Copie o OAUTH_CLIENT_ID.

   DESCRIBE SECURITY INTEGRATION my_oauth_integration_uipath
   

3. Execute a seguinte consulta para exibir o segredo do cliente. Copie o OAUTH_CLIENT_SECRET.

Essa consulta gera dois itens: OAUTH_CLIENT_SECRET e OAUTH_CLIENT_SECRET_2. Você deve usar OAUTH_CLIENT_SECRET.

select system$show_oauth_client_secrets('MY_OAUTH_INTEGRATION_UIPATH');

Para obter detalhes, consulte Configurar o Snowflake OAuth para clientes personalizados.

Adição da conexão do Snowflake

1. Selecione Integration Service no menu de navegação esquerdo.
2. Na lista Conectores , selecione Snowflake. Você também pode usar a barra de pesquisa para encontrar o conector.
3. Selecione o botão Conectar ao Snowflake e selecione seu método de autenticação preferido.
4. Insira suas credenciais do Snowflake necessárias.
5. Select Connect.

Permissões

A conexão permite que a UiPath leia, grave, modifique e exclua dados do Snowflake em seu nome.

Funções necessárias para conexão com o Snowflake

Ao criar uma conexão para o Snowflake a partir do Integration Service, o conector sempre seleciona a função padrão do usuário, conforme mostrado na imagem a seguir.

Os administradores do Snowflake podem configurar funções personalizadas para os usuários, porque nem todos recebem funções de administrador por razões de segurança.

O exemplo a seguir mostra o que exatamente é necessário no Snowflake para que o processo de conexão do Integration Service funcione sem problemas. Neste exemplo, você cria uma conexão usando o esquema de banco de dados DEAL_AMOUNT e o banco de dados JULY_DEMO.

A primeira etapa é garantir que a função padrão, neste caso SAMRAT, tenha privilégio de USAGE no Banco de dados (JULY_DEMO) e no Esquema de banco de dados (DEAL_AMOUNT) no Snowflake.

Uma autenticação bem-sucedida no Snowflake depende dessas configurações. Uma função sempre pode ter privilégios adicionais atribuídos a ela por um Administrador.

Para obter detalhes, consulte Privilégios de controle de acesso na documentação do Snowflake.