Autenticação do Snowflake

Pré-requisitos

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

• OAuth 2.0 Código de autorização do Snowflake Fluxo de autorização OAuth:
  • 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 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

• 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
  Observação:

  Revise como os administradores podem configurar políticas para definir a vida útil máxima dos tokens de acesso programático no Snowflake. Consulte Usando tokens de acesso programático para autenticação para obter mais detalhes.

Restriçõ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 na 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 na URL usada 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:

   

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

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://{baseURL}/provisioning_/callback (por exemplo, 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. Execute a consulta a seguir para exibir os detalhes do cliente. Copie o OAUTH_CLIENT_ID.

   DESCRIBE SECURITY INTEGRATION my_oauth_integration_uipathDESCRIBE 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');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 Orchestrator no inicializador do produto.

2. Selecione uma pasta e navegue até a aba Conexões .

3. Selecione Adicionar conexão.

4. Para abrir a página de criação de conexão, selecione o conector na lista. Você pode usar a barra de pesquisa para encontrar o conector.

5. Insira suas credenciais do Snowflake necessárias e selecione Conectar.

   For any secret-type field, you can select the menu next to the field and choose Use credential asset to reference an Orchestrator credential asset linked to an external vault instead of entering the value directly. For more information, see Use credential assets for connections.

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