Ir para o conteúdo

Guia de conexão do Snowflake para o Jitterbit App Builder

Introdução

Este guia mostra como conectar um app do App Builder a uma conta do Snowflake usando OAuth ou autenticação baseada em certificado.

Autenticação OAuth

Pré-requisitos

1. Configurar um provedor de segurança

  1. Selecione IDE > Security Providers.

  2. Clique no botão + Security Provider.

  3. Defina valores para os seguintes campos:

    • Na seção Settings:

      • Name: Insira um nome para o provedor de segurança.
      • Type: Selecione OAuth.
      • Enabled: Selecionado.
    • Na seção Authentication:

      • OAuth Grant: Selecione Authorization Code.
      • OAuth Client Authentication: Selecione Basic.
      • OAuth Resource Authentication: Selecione Bearer.
    • Na seção Tokens:

      • Owner: Selecione User.
    • Na seção Sign In:

      • Redirect On Challenge: Selecionado.
  4. Clique no botão Save. Painéis adicionais aparecem.

  5. Na seção Endpoints, clique no botão + Endpoint e adicione os seguintes endpoints:

    Tipo de Endpoint URL
    Authorization Endpoint https://{Snowflake account URL}/oauth/authorize
    Token Endpoint https://{Snowflake account URL}/oauth/token-request
  6. Na seção Credentials, clique no botão + Credential e adicione a seguinte credencial:

    Tipo Nome de Usuário Senha
    Client OAUTH_CLIENT_ID OAUTH_CLIENT_SECRET

    Nota

    OAUTH_CLIENT_ID e OAUTH_CLIENT_SECRET são saídas do comando SYSTEM$SHOW_OAUTH_CLIENT_SECRETS.

  7. Na seção Properties, clique em + Property e adicione a seguinte propriedade:

    Parâmetro Valor
    Scopes session:role:SYSADMIN

2. Configurar um servidor de dados

  1. Selecione IDE > Data Servers.
  2. Clique no botão + Server.
  3. Na janela Server, defina valores para o seguinte:

    • Na seção Server Settings:

      • Server Name: Insira um nome para este servidor Snowflake.
      • Type: Selecione Snowflake. Campos adicionais aparecem. Defina valores para o seguinte:
        • URL: A URL.
        • Warehouse: O nome do seu warehouse Snowflake.
        • Database Name: O nome do seu banco de dados Snowflake.
        • Schema Name: O nome do seu schema Snowflake.
    • Na seção Security:

      • Security Provider: Selecione o provedor de segurança OAuth criado anteriormente.
      • User Name: Deixe em branco.
      • Password: Deixe em branco.
    • Description: (Opcional) Insira uma descrição para este servidor de dados.

  4. Clique no botão Save.

  5. Na seção Server Settings, clique no botão Advanced Settings. A janela Server (Advanced Settings) abre.
  6. Clique no botão Edit.
  7. No campo Advanced, insira AuthScheme=OAuth.
  8. Clique no botão Save e depois feche as janelas Server (Advanced Settings) e Server.

Agora use o servidor de dados em seus apps.

Autenticação baseada em certificado

A autenticação baseada em certificado usa um par de chaves RSA. A chave pública é registrada na conta do usuário do Snowflake e o App Builder usa o arquivo de chave privada para se autenticar.

Pré-requisitos

  • Uma conta Snowflake ativa.
  • Um par de chaves RSA gerado. Consulte Gerar a chave privada na documentação do Snowflake para obter instruções. O arquivo de chave privada (.p8) deve estar no sistema de arquivos do servidor do App Builder e ser legível pelo processo do App Builder.

1. Configurar Snowflake

Execute os seguintes comandos SQL no Snowflake como um usuário com a função ACCOUNTADMIN.

  1. Criar um usuário Snowflake com a chave pública atribuída:

    CREATE USER {username}
      LOGIN_NAME = {username}
      DISPLAY_NAME = 'App Builder (Key Auth)'
      -- The public key must be a single, continuous string.
      -- Do not include the '-----BEGIN PUBLIC KEY-----' or '-----END PUBLIC KEY-----' header lines.
      RSA_PUBLIC_KEY = '{public_key_content}';
    
  2. Conceder a função necessária ao usuário:

    GRANT ROLE {role_name} TO USER {username};
    
  3. Conceder uso no banco de dados e no esquema para a função:

    GRANT USAGE ON DATABASE {database_name} TO ROLE {role_name};
    GRANT USAGE ON SCHEMA {database_name}.{schema_name} TO ROLE {role_name};
    
  4. Definir o contexto padrão para o usuário:

    ALTER USER {username} SET
        DEFAULT_ROLE = {role_name},
        DEFAULT_WAREHOUSE = '{warehouse_name}',
        DEFAULT_NAMESPACE = '{database_name}.{schema_name}';
    

2. Configurar um servidor de dados

  1. Selecione IDE > Servidores de Dados.
  2. Clique no botão + Servidor.
  3. No popup Servidor, defina valores para o seguinte:

    • Na seção Configurações do Servidor:

      • Nome do Servidor: Digite um nome para este servidor Snowflake.
      • Tipo: Selecione Snowflake. Campos adicionais aparecem. Defina valores para o seguinte:
        • URL: A URL.
        • Warehouse: O nome do seu warehouse Snowflake.
        • Nome do Banco de Dados: O nome do seu banco de dados Snowflake.
        • Nome do Esquema: O nome do seu esquema Snowflake.
    • Na seção Segurança:

      • Provedor de Segurança: Deixe em branco.
      • Nome de Usuário: Digite o nome de usuário Snowflake criado na etapa 1.
      • Senha: Deixe em branco.
    • Descrição: (Opcional) Digite uma descrição para este servidor de dados.

  4. Clique no botão Salvar.

  5. Na seção Configurações do Servidor, clique no botão Configurações Avançadas. O popup Servidor (Configurações Avançadas) abre.
  6. Clique no botão Editar.
  7. No campo Avançado, digite a seguinte string de conexão, substituindo {path_to_private_key_file} pelo caminho absoluto do arquivo de chave privada .p8 no servidor do App Builder:

    AuthScheme=PrivateKey;PrivateKeyType=PEMKEY_FILE;PrivateKey={path_to_private_key_file}
    
  8. Clique no botão Salvar, depois feche os popups Servidor (Configurações Avançadas) e Servidor.

Agora é possível usar o servidor de dados nos apps.

Solução de problemas

Se tiver problemas com o Snowflake, recomenda-se seguir estas etapas de solução de problemas:

  1. Ative o registro de dados para gerar arquivos de log e dados, que você pode baixar e inspecionar.

  2. Consulte a documentação do CData ADO.NET Provider para Snowflake para obter informações detalhadas.