# Testar as funções de conexão do CloudFront antes da implantação
<a name="test-connection-functions"></a>

É possível testar a função de conexão do CloudFront no estágio DESENVOLVIMENTO usando a operação de API TestConnectionFunction. O teste permite validar a lógica da função com exemplos de evento de conexão antes da publicação no estágio ATIVO.

**Topics**
+ [Processo de teste](#connection-function-testing-process)
+ [Resultados do teste](#connection-function-test-results)
+ [Objeto de teste de conexão](#connection-test-object)

## Processo de teste
<a name="connection-function-testing-process"></a>

Para testar uma função de conexão:

1. Crie uma função de conexão no estágio DESENVOLVIMENTO.

1. Prepare um objeto de conexão de teste que represente o evento de conexão TLS.

1. Use a operação de API TestConnectionFunction para executar a função com os dados de teste.

1. Analise os resultados do teste, inclusive a saída da função, os logs de execução e quaisquer mensagens de erro.

1. Atualize o código da função conforme necessário e repita o processo de teste.

## Resultados do teste
<a name="connection-function-test-results"></a>

Ao testar uma função de conexão, alguns dos resultados são:
+ **Resumo da função**: metadados sobre a função que foi testada.
+ **Utilização de computação**: métricas de desempenho que mostram o uso de recursos.
+ **Logs de execução**: saída do console da função, inclusive quaisquer instruções de registro em log.
+ **Saída da função**: o resultado exibido pela função.
+ **Mensagens de erro**: quaisquer erros ou exceções de runtime que ocorreram durante a execução.

## Objeto de teste de conexão
<a name="connection-test-object"></a>

O objeto de teste de conexão é um blob binário (de até 40 KB) que representa o evento de conexão TLS que a função processará. Esse objeto contém as informações de certificado e conexão que a função usa para tomar decisões de autenticação.

**nota**  
A estrutura e o formato específicos do objeto de teste de conexão são definidos pelo runtime das funções de conexão do CloudFront. Consulte a documentação do CloudFront Functions ou entre em contato com o AWS Support para obter detalhes sobre a criação de objetos de teste apropriados para seu caso de uso.

Depois de criar a função de conexão, você pode:
+ **Testar a função**: use a funcionalidade de teste no console ou na CLI para validar a função com exemplos de evento de conexão. Para ter mais informações, consulte “Testar funções de conexão”.
+ **Atualizar a função**: modifique o código e a configuração da função conforme necessário. As funções de conexão no estágio DESENVOLVIMENTO podem ser atualizadas a qualquer momento.
+ **Publicar a função**: quando a função estiver pronta para produção, publique-a para movê-la do estágio DESENVOLVIMENTO para o ATIVO. Para ter mais informações, consulte “Associar funções de conexão”.
+ **Associar a uma distribuição**: associe a função publicada à sua distribuição habilitada para mTLS para lidar com conexões ativas. Para ter mais informações, consulte “Associar funções de conexão”.