Skip to content

Latest commit

 

History

History
131 lines (82 loc) · 7.62 KB

bot-starter-kit.mdx

File metadata and controls

131 lines (82 loc) · 7.62 KB
title Description meta_tags namespace permalink
Como testar o Bot Manager usando um template
Este template é ideal para entender como o Bot Manager funciona e como ele pode ajudá-lo a proteger suas aplicações.
templates, guides, Azion Marketplace, security, edge firewall
docs_guides_templates_bot_manager_starter_kit
/documentacao/produtos/guias/bot-manager-starter-kit/

import Badge from '~/components/Badge.astro';

Preview

O template Bot Manager Starter Kit cria um novo stack edge para permitir que os clientes vejam o Bot Manager em ação.

A implantação cria automaticamente uma edge application, uma edge function, um edge firewall e um domínio para acessar e testar os recursos do Bot Manager. Este template é ideal para entender como funciona essa integração e como ela pode ajudá-lo a proteger suas aplicações e ativos digitais.


Pré-requisitos

Antes de implantar esse template, você precisa:

  • Ter o módulo Edge Functions ativo na sua conta.
    • Para fazer isso, vá na seção Billing & Subscriptions e ative o switch do módulo.
    • Se este módulo não estiver ativado, a execução falhará e um log explicando o motivo será mostrado.
    • Se este módulo estiver ativado, a execução deste template poderá gerar custos relacionados ao uso. Consulte a página de preços para obter mais informações.
  • Instalar a versão mais recente do Bot Manager.
    • Vá no Marketplace da Azion e clique no botão Install. Consulte o guia sobre Como instalar o Azion Bot Manager para mais detalhes.
    • Se você não instalou a função Bot Manager antes de tentar usar este template, a execução falhará e um log explicando o motivo será mostrado.

Obtenha o template

Para obter este template, acesse o Azion Console e clique no botão + Create na página inicial.

Isso abrirá um modal onde você pode selecionar Templates > Bot Manager Starter Kit.


Configure o template

No formulário de configuração, você deve fornecer as informações para configurar sua aplicação. Preencha os campos apresentados.

Os campos identificados com asterisco são obrigatórios.

  • Edge Application Name *: o nome da sua nova edge application na Azion. Também será usado para nomear sua instância do Edge Firewall.
  • Sample Edge Function Name *: o nome da edge function de teste que será criada.
    • Use um nome único e fácil de lembrar para esses campos.

Depois de preencher todas as informações, clique no botão Save, localizado no canto inferior direito. Isso iniciará o processo de deployment.

:::note Se você não instalou o Bot Manager antes de implantar este template, a execução falhará e um log explicando o motivo será mostrado. :::

Durante a implantação, você poderá acompanhar o processo através de uma janela mostrando os logs. Quando estiver concluída, a página mostra informações sobre a aplicação e algumas opções para continuar sua jornada.

:::note O link para sua edge application permite que você veja como ela fica no navegador. No entanto, leva um certo tempo para propagar e configurá-la nas edge locations da Azion. Pode ser necessário aguardar alguns minutos para que a URL seja ativada e para que a página da aplicação seja efetivamente exibida no navegador. :::

Principais configurações

Este template implanta um stack edge totalmente novo, incluindo:

  • Uma nova edge application, com o módulo Edge Functions habilitado, para instanciar sua função recém-criada. A aplicação receberá as requisições que acionam a função.
  • Um novo domínio, para acessar sua aplicação e testar o Bot Manager.
  • Um novo edge firewall, incluindo a instância da versão mais recente da integração do Bot Manager e uma regra do Rules Engine para acionar sua execução.
  • Uma nova edge function, fornecendo uma aplicação com uma interface básica que pode ser usada para testar o Bot Manager.

Teste o template

Após executar o template, você poderá acessar o domínio Azion, com o formato xxxxxxxxxx.map.azionedge.net/. Ele mostrará uma interface de teste, onde você pode enviar requisições "boas" e "maliciosas" para o Bot Manager.

A página de teste renderizará a resposta à requisição:

  • Quando uma requisição boa é enviada, ela renderiza uma mensagem de sucesso.
  • Quando uma requisição maliciosa é enviada, ela renderizará uma resposta HTTP 403 response status code padrão, porque a ação do Bot Manager está definida para executar um deny.
    • Você pode modificar os JSON Args da função para redirecionar a requisição maliciosa para um domínio customizado.

Consulte os logs

A instância da função do Bot Manager está configurada para sempre gravar logs. Dessa forma, sempre que você clicar em qualquer um dos botões para "enviar requisição", serão gerados logs que podem ser monitorados em Real-Time Events e Data Stream.



Gerencie o template

Sendo um template de teste, a configuração inicial é principalmente demonstrativa. No entanto, você pode usá-lo como base para criar uma aplicação funcional. Você pode configurar uma nova origem para a aplicação e usá-la como Default Origin. Você também pode modificar os argumentos JSON da sua instância do Bot Manager para uma configuração mais personalizada.

Para gerenciar e editar as configurações da sua aplicação, siga estas etapas:

  1. Acesse o Azion Console > Edge Application.
  • Você será redirecionado para a página de Edge Application. Ela lista todas as edge applications que você criou.
  1. Selecione a edge application relacionada com o template.
  • A lista é organizada em ordem alfabética. Você também pode usar a barra de busca localizada no canto superior esquerdo da lista; atualmente, ela é filtrada apenas pelo Application Name, ou nome da edge application.

Depois de selecionar a aplicação em que você trabalhará, você será direcionado para uma página que contém todas as configurações que você pode ajustar.

:::tip Leia a documentação sobre o gerenciamento de edge applications para obter mais detalhes. :::

Adicione um domínio personalizado

A edge application criada tem um domínio Azion atribuído para torná-la acessível através do navegador. O domínio tem o seguinte formato: xxxxxxxxxx.map.azionedge.net/. No entanto, você pode adicionar um domínio personalizado para que os usuários acessem sua aplicação por meio dele.

import Button from '~/components/Button.astro';


import ContributorList from '~/components/ContributorList.astro'

Contribuidores Contributor