Autenticação do Snowflake Cortex

Conecte o UiPath ao Snowflake Cortex usando um Token de Acesso Programático, código de autorização OAuth 2.0, Credenciais do cliente OAuth 2.0 com Microsoft Entra ID ou Código de autorização externo OAuth 2.0 com PKCE, fornecendo o identificador da sua conta e credenciais relacionadas.

Pré-requisitos

Esse conector é compatível com quatro métodos de autenticação: Token de acesso programático (padrão), código de autorização OAuth 2.0, Credenciais do cliente OAuth 2.0 com Microsoft Entra ID e Código de autorização externo OAuth 2.0 com PKCE.

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 com o Microsoft Entra ID:
  • 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.
• Código de autorização do OAuth 2.0 externo com PKCE:
  • Identificador da conta
  • URL de autorização, URL do token e URL de atualização do token - Os pontos de extremidade OAuth 2.0 do seu provedor de identidade.
  • ID do cliente - A partir do registro do aplicativo em seu provedor de identidade. Esse método usa um cliente público, portanto, nenhum segredo do cliente é necessário.
  • Escopo - offline_access é sempre incluído, porque a conexão precisa dele para atualizar seu token. Adicione os escopos que seu provedor de identidade exige para o Snowflake.

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 das credenciais do cliente OAuth 2.0 com o método de autenticação do Microsoft Entra ID

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 Credenciais de cliente OAuth 2.0 com a autenticação do Microsoft Entra ID, 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.

Usando o código de autorização do OAuth 2.0 externo com o método de autenticação PKCE

Esse método faz login por meio de seu próprio provedor de identidade usando o fluxo de Código de Autorização do OAuth 2.0 com Chave de Prova para Troca de Código (PKCE), sem um segredo do cliente. Funciona com qualquer provedor de identidade cujos tokens o Snowflake aceita por meio de uma integração de segurança OAuth externa. O Microsoft Entra ID é o provedor de identidade de referência.

Para configurar esse método de autenticação, configure seu provedor de identidade e o Snowflake:

1. Em seu provedor de identidade, registre um aplicativo como cliente público e adicione o URI de redirecionamento https://{baseURL}/provisioning_/callback (por exemplo, para Automation Cloud https://cloud.uipath.com/provisioning_/callback). O ID do cliente do aplicativo é o ID do cliente para a conexão.
2. No Snowflake, crie uma integração de segurança do OAuth externo para seu provedor de identidade. A integração mapeia uma declaração no token, como upn, para um usuário do Snowflake por meio do LOGIN_NAME do usuário.
3. Certifique-se de que o token conceda a função que a conexão usa. A função deve estar no escopo do token, por exemplo, session:role:<role>, a menos que a integração defina EXTERNAL_OAUTH_ANY_ROLE_MODE como ENABLE.
4. Quando você criar a conexão, substitua os valores em URL de autorização, URL do token e Atualizar URL do token pelos pontos de extremidade do seu provedor de identidade.

Para obter a sintaxe de configuração exata, consulte Visão geral do OAuth externo 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 do OAuth 2.0, Credenciais do cliente OAuth 2.0 com Microsoft Entra ID ou Código de autorização externo OAuth 2.0 com PKCE.

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.