Autenticação do Snowflake Cortex

Conecte a UiPath ao Snowflake Cortex usando um Token de Acesso Pessoal, código de Autorização OAuth 2.0 ou credenciais do Cliente OAuth 2.0, fornecendo o identificador da sua conta e credenciais relacionadas.

Pré-requisitos

Esse conector é compatível com três métodos de autenticação: Token de acesso programático (padrão), Código de autorização OAuth 2.0 e credenciais do cliente OAuth 2.0.

Para criar uma conexão, você precisa das seguintes credenciais:

• Token de acesso programático:
  • Identificador da conta
  • Token de acesso pessoal
• Código de autorização do OAuth 2.0:
  • Identificador da conta
  • ID do Cliente
  • Segredo do Cliente
  • Escopo - O padrão é session:role:SYSADMIN. Você pode alterar isso para uma função diferente, desde que essa função seja concedida ao usuário que se conecta.
• Credenciais do cliente OAuth 2.0:
  • Identificador da conta
  • ID do cliente e Segredo do cliente - Do registro do aplicativo Microsoft Entra ID.
  • Escopo - O escopo do aplicativo Microsoft Entra ID representando o Snowflake, no formulário api://<application-id-uri>/.default.
  • ID do tenant – O ID do diretório do Microsoft Entra ID (tenant), disponível na seção Visão geral do seu registro do aplicativo Microsoft Entra ID.

Recuperação das suas credenciais

Você pode extrair o identificador de conta de seus Detalhes da conta ou do URL do servidor da conta. Por exemplo, na URL YQXMADF-EWA19151.snowflakecomputing.com o identificador é YQXMADF-EWA19151.

O Token de acesso pessoal (PAT) pode ser criado no painel do Snowflake em Configurações > Autenticação > Tokens de acesso programáticos. Você verá a opção PAT apenas se sua função permitir sua criação. Entre em contato com o administrador para obter detalhes.

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

Observação:

Por padrão, os usuários com a função ACCOUNTADMIN, ORGADMIN ou SECURITYADMIN são impedidos de usar a autenticação do OAuth 2.0 para criar uma conexão. A função que você insere no Scope deve ser concedida ao usuário de conexão e não deve ser uma dessas três. 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. Certifique-se de incluir o URL de redirecionamento correto: 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;
   

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 OAUTH_CLIENT_SECRET (não OAUTH_CLIENT_SECRET_2).

   select system$show_oauth_client_secrets('MY_OAUTH_INTEGRATION_UIPATH');
   

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

Uso do método de autenticação de credenciais do cliente OAuth 2.0

Esse método autentica-se por meio do OAuth externo do Snowflake com o Microsoft Entra ID em vez do próprio endpoint OAuth do Snowflake: o conector troca o ID e o segredo do cliente do aplicativo Microsoft Entra ID por um token de acesso e, em seguida, envia esse token para o Snowflake.

Para configurar a autenticação de credenciais do cliente OAuth 2.0, configure o Microsoft Entra ID e o Snowflake:

1. No Microsoft Entra ID, registre um aplicativo e crie um segredo do cliente para ele. Isso fornece o ID do cliente e o Segredo do cliente, e o ID do tenant está disponível na seção Visão geral do aplicativo.
2. No Microsoft Entra ID, identifique (ou registre) o aplicativo que representa o Snowflake e observe seu URI do ID do aplicativo. Use-o para criar o valor do Escopo : api://<application-id-uri>/.default.
3. No Snowflake, crie uma integração de segurança para o OAuth externo com o tipo de aplicativo definido como Azure, o público definido como o URI do ID do aplicativo na etapa 2 e um usuário do Snowflake mapeado para a declaração do token da entidade de serviço.

Para obter a sintaxe de configuração exata, consulte Snowflake External OAuth com Microsoft Entra ID na documentação do Snowflake.

Adicione a conexão do Snowflake Cortex

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. Selecione o tipo de autenticação: Token de acesso programático, Código de autorização OAuth 2.0 ou Credenciais do cliente OAuth 2.0.

6. Insira as credenciais necessárias e selecione Conectar.

   Quando disponível, selecione o menu ao lado de um campo e escolha Usar ativo de credencial ou Usar ativo do Orchestrator para fazer referência a um ativo do Orchestrator em vez de inserir o valor diretamente. Para obter mais informações, consulte Usar ativos de credenciais para conexões.