Como instalar a solução Send Event to Endpoint através do Marketplace da Azion
Visão geral
Azion Send Event to Endpoint é uma solução serverless disponível no Marketplace da Azion. Essa solução permite transmitir dados de uma solicitação para um endpoint HTTP, recolhendo os dados de solicitação e os transmitindo para um endpoint definido pelo usuário por meio de uma API Javascript.
A solução também possibilita que você especifique que tipo de dados deseja recolher editando um arquivo JSON.
Após o envio dos dados coletados, a solução permite que a solicitação prossiga através do Rules Engine.
1. Instalando a solução
Para usar a solução Enviar Send Event to Endpoint, siga estes passos:
- Faça login na sua conta do Real-Time Manager (RTM).
- Se você ainda não tem uma conta, crie uma visitando a página de inscrição.
- No canto superior esquerdo da página inicial do RTM, selecione Products menu, identificado pelas três linhas horizontais , > Marketplace.
- Selecione o campo de busca e digite “Endpoint” ou navegue pelos cards para encontrar a solução Send Event to Endpoint.
- Depois de encontrar o card da solução Send Event to Endpoint, selecione-o para ser direcionado para a página da solução.
- Na página da solução, procure a seção Subscribe for no canto inferior direito.
- Clique no botão Get it now.
Você receberá uma mensagem indicando que sua solução foi instalada com sucesso e está pronta para uso.
2. Usando a solução
2.1 Configurando a regra no Edge Firewall
Para instanciar a solução Send Event to Endpoint, siga os passos:
- Em Products menu, selecione Edge Firewall na seção SECURE.
- Clique no botão Add Rule Set.
- Dê um nome fácil de lembrar à sua nova regra.
- Selecione os domínios que deseja proteger com a função.
- Habilite o switch para Edge Functions.
- Clique no botão Save
Pronto. Você instanciou a regra para sua função.
2.2 Configurando a solução
Para instanciar a solução Send Event to Endpoint, enquanto ainda estiver na página do Edge Firewall, selecione a guia Functions e siga estas passos:
- Clique no botão Add Function.
- Dê um nome fácil de lembrar à sua instância.
- No menu suspenso, selecione a função Send Event to Endpoint.
Depois de selecionar a solução, um formulário com o código-fonte da solução será carregado. O código-fonte da solução não pode ser modificado. No mesmo formulário, você tem outra aba: Args. Na aba Args, você passará os parâmetros para configurar sua solução.
O formulário JSON das Args para esta solução ficará assim:
{
"metadata": ["remote_addr"],
"headers": ["x-hello"],
"body": ["message", "user.id"],
"connection_args": {
"endpoint": "http://example_api:3000/test",
"headers": {
"Authorization": "FakeAuth",
"X-Provider": "Azion Cells"
}
}
}
Onde:
| Campo | Obrigatório | Tipo de Dado | Notas |
|---|---|---|---|
metadata |
Não | Null ou Array | Define quais campos de metadados serão transmitidos. Quando for definido como null (ou não for definido), todos os campos de metadados serão transmitidos.Se você não quiser transmitir nenhum metadado, deverá definir uma matriz vazia [ ] como o valor desse campo. |
headers |
Não | Null ou Array | Define quais cabeçalhos de solicitação serão transmitidos. Quando for definido como null (ou não for definido), todos os cabeçalhos de solicitação serão transmitidos.Se você não quiser transmitir nenhum cabeçalho, deverá definir uma matriz vazia [ ] como o valor desse campo |
body |
Não | Null ou Array | Define quais o campos do body request serão transmitidos.Quando for definido como null (ou não for definido), todos os campos do corpo da solicitação serão transmitidos.Se você não quiser transmitir nenhum campo body request, você deverá definir uma matriz vazia [ ] como o valor desse campo.Para filtrar campos de vários níveis, use a notação de ponto. Por exemplo, se você usar a string user.name, a função procurará o campo “name” dentro do objeto “user” no body request. |
connection_args |
Sim | Objeto | Define os dados que serão usados para transmitir os dados da solicitação. A URL na qual os dados serão postados é definida pelo endpoint. Os cabeçalhos especificam quais cabeçalhos serão incluídos na solicitação de busca. Um cabeçalho adicional Content-Type: application/json será usado. |
Esta solução retornará uma resposta com os dados transmitidos em um arquivo JSON com a seguinte aparência:
{
"body": {
"field_a": <data>,
...
},
"geoip_asn": <data>,
"geoip_city": <data>,
"geoip_city_continent_code": <data>,
"geoip_city_country_code": <data>,
"geoip_city_country_name": <data>,
"geoip_continent_code": <data>,
"geoip_country_code": <data>,
"geoip_country_name": <data>,
"geoip_region": <data>,
"geoip_region_name": <data>,
"headers": {
"x-header-a": <data>,
...
},
"remote_addr": <data>,
"remote_port": <data>,
"remote_user": <data>,
"request_id": <data>,
"request_url": <data>,
"server_protocol": <data>,
"ssl_cipher": <data>,
"ssl_protocol": <data>
}
Observe como os campos request_id, request_url e metadados serão entregues na raiz do arquivo JSON, enquanto os campos body e os cabeçalhos da solicitação serão enviados nos objetos.
Importante: você também pode usar um arquivo JSON “catch-all” para as Args, como este:
{
"connection_args": {
"endpoint": "http://example_api:3000/test",
}
}
Configurando o Rules Engine
Para concluir, você precisa configurar o Rules Engine para definir o comportamento e os critérios para executar a solução.
Ainda na página Edge Firewall, selecione a aba Rules Engine e siga estes passos:
- Clique no botão New Rule.
- Dê um nome fácil de lembrar à sua nova regra.
- Selecione um criterio (criteria) para executar a solution. Por exemplo:
if Hostname is equal xxxxxxxxxxxx.map.azionedge.net/classes. - Abaixo, selecione um comportamento para os criteria. Neste caso, será Run Function. Em seguida, selecione a função Send Event to Endpoint de acordo com o nome que você deu a ela na etapa instanciada.
Pronto. Agora, a solução Send Event to Endpoint está sendo executada para cada solicitação feita ao domínio indicado.
Não encontrou o que procurava? Abra um ticket.