O Finch é um cliente HTTP de alta performance desenvolvido em Elixir, otimizado para eficiência e minimização de cópias de memória. Construído sobre pilares como Mint para a camada de protocolo e NimblePool para o gerenciamento de conexões, ele oferece uma solução robusta para aplicações que demandam comunicação HTTP rápida e escalável, suoprtando os protocolos HTTP/1 e HTTP/2 através de um conjunto de pools de conexão.

Inicializando e Realizando Requisições HTTP com Finch

Um dos primeiros desafios para novos usuários do Finch é compreender como integrar e utilizar o cliente para enviar suas primeiras requisições. O processo envolve a adição do Finch à árvore de supervisão da sua aplicação ou a sua inicialização dinâmica, seguida pela construção e execução da requisição.

Passos para Configurar e Enviar uma Requisição:

1. Integração na Árvore de Supervisão: Para que o Finch seja gerenciado pelo sistema de supervisão do OTP, inclua-o na lista de processos filhos da sua aplicação.

supervisores_filhos = [
  {Finch, name: MeuClienteWeb}
]

Alternativamente, você pode iniciar uma instância do Finch dinamicamente:

Finch.start_link(name: MeuClienteWeb)

5. Executando uma Requisição: Após a inicialização, utilize as funções build/2 e request/2 do módulo Finch para criar e despachar uma requisição HTTP.

:get
|> Finch.build("https://api.servicoexterno.com/dados")
|> Finch.request(MeuClienteWeb)

Otimizando o Gerenciamento de Conexões com Pools no Finch

A configuração de pools de conexão é crucial para maximizar a performance do Finch, permitindo que o cliente mentenha um conjunto de conexões abertas e prontas para uso, reduzindo a latência de handshake. Usuários frequentemente buscam otimizar esses pools para diferentes destinos.

Passos para Configurar Pools de Conexão:

1. Definindo Parâmetros dos Pools na Inicialização: Configure os pools de conexão ao adicionar o Finch à sua árvore de supervisão, especificando o tamanho e a contagem para pools padrão ou específicos por host.

supervisores_filhos = [
  {Finch, name: FinchAPI, pools: %{
    :padrao => [tamanho: 10, contagem: 2],
    "https://api.outrosite.org" => [tamanho: 20, contagem: 4]
  }}
]

Neste exemplo, um pool padrão de 10 conexões por pool (com 2 pools) é configurado, e um pool específico de 20 conexões por pool (com 4 pools) é definido para https://api.outrosite.org.

4. Garantindo a Disponibilidade: Certifique-se de que a instância do Finch com os pools configurados esteja devidamente iniciada e disponível antes de tentar enviar requisições através dela.

Gerenciamento de Segredos TLS com Finch

Em ambientes de produção ou de alta segurança, o tratamento de segredos TLS (Transport Layer Security) é uma preocupação primordial. O Finch oferece mecanismos para configurar as opções de transporte, incluindo o registro de segredos TLS para depuração ou a persistência de chaves para sessões TLS 1.3.

Passos para Configurar Segredos TLS:

1. Configuração de Opções de Transporte TLS: Adicione a opção transport_opts na configuração do pool de conexões para especificar como os segredos TLS devem ser tratados, como diercioná-los para um arquivo.

supervisores_filhos = [
  {Finch, name: FinchSeguro, pools: %{
    :padrao => [opcoes_conexao: [opcoes_transporte: [registrar_segredos: "/var/log/finch_tls_secrets.log"]]]
  }}
]

3. Habilitando a Persistência de Segredos para TLSv1.3: Para protocolos TLS 1.3, pode ser necessário habilitar a opção keep_secrets: true dentro das opções de transporte para reuso de chaves ou depuração avançada.

supervisores_filhos = [
  {Finch, name: FinchTLS1_3, pools: %{
    :padrao => [opcoes_conexao: [opcoes_transporte: [manter_segredos: true]]]
  }}
]