Autenticação do Snowflake

Pré-requisitos

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

• Código de autorização do 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
• Autenticação personalizada (autenticação JDBC):
  • 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 Par 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.

• Independentemente do método de autenticação selecionado, se sua instância do Snowflake restringir o acesso pelo IP, você deverá configurar uma lista de permissão para os IPs usados pelo Integration Service. Para obter detalhes, consulte Configuração do firewall no guia do administrador do Automation Cloud.

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 do 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. Depois de fazer login, no menu do lado esquerdo, selecione Dados e Bancos de Dados.

   • Nome do banco de dados: uma lista de bancos de dados é exibida:

     
     

     

     
     

   • Nome do esquema de banco de dados - Selecione um banco de dados para exibir a lista de nomes de esquema de banco de dados:

     
     

     

     
     

3. Para recuperar o Armazenamento, no menu do lado esquerdo, acesse Administrador > Armazenamentos:

   
   

   

   
   

Como usar o método de autenticação do código de autorização do OAuth 2.0

Observação: apenas usuários com uma função ACcountADMIN podem criar credenciais OAuth2. Por padrão, usuários com as funções ACcountADMIN, ORGADMIN e SECURITYADMIN são impedidos de usar a autenticação OAuth 2.0 para criar uma conexão. Para obter detalhes, consulte 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 a URL de redirecionamento correta na consulta: 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. 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 na Automation Cloud^TM.

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. Selecione Conectar.

6. Sua conexão foi adicionada.

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égios de USício tanto no banco de dados (JULY_DEMO) quanto 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.