Como utilizar a integração Scheduled Blocking através do Marketplace da Azion

Scheduled Blocking da Azion é uma integração serverless disponível no Marketplace da Azion.

Essa integração permite controlar o acesso à sua aplicação com base em um cronograma, de acordo com suas necessidades.

Obtenha a integração

Para usar a integração Scheduled Blocking fornecida pelo Marketplace da Azion, você deve seguir os passos:

Acesse o Azion Console > Marketplace.
Na homepage do Marketplace, selecione o card da integração.
Quando a página da integração abrir, clique no botão Install, localizado no canto inferior da direita.

Aparecerá uma mensagem indicando que sua integração foi instalada com sucesso.

Configure a integração

Configure um edge firewall

Para instanciar a integração Scheduled Blocking, siga as etapas:

Em Products menu, selecione Edge Firewall dentro da seção SECURE.
Clique no botão + Edge Firewall.
Dê um nome fácil de lembrar para o seu edge firewall.
Selecione os domínios que você deseja proteger.
Habilite o switch Edge Functions para que você rode edge functions no seu edge firewall.
Clique no botão Save.

Pronto. Agora você instanciou o edge firewall para sua função.

Instancie a integração

Para instanciar a integração Scheduled Blocking, ainda na página do Edge Firewall:

Selecione a aba Functions.
Clique no botão Add Function.
Dê um nome fácil de lembrar para a sua instância.
No menu suspenso, selecione a função Scheduled Blocking.

Esta ação carregará a função, mostrando um formulário com seu código-fonte e, logo acima dele, duas abas: Code e Args.

Ao clicar na aba Code, você poderá navegar pelo código, mas não alterá-lo. No mesmo formulário, você tem outra aba: Args, que é onde você passará os parâmetros que deseja usar com sua integração.

A aba Args carregará um arquivo JSON que se parece com o mostrado abaixo:

{
  "schedule": [
    {
      "action": "deny",
      "execute_action_when": "in_interval",
      "interval": {
        "starts_at_utc": "00:00",
        "finishes_at_utc": "00:59"
      },
      "week_days": {
        "Sun": true,
        "Mon": true,
        "Tue": true,
        "Wed": true,
        "Thu": true,
        "Fri": false,
        "Sat": true
      }
    },
    {
      "action": "drop",
      "execute_action_when": "not_in_interval",
      "interval": {
        "starts_at_utc": "01:00",
        "finishes_at_utc": "20:00"
      },
      "week_days": {
        "Mon": true,
        "Tue": true
      }
    },
    {
      "action": "static_response",
      "execute_action_when": "in_interval",
      "static_response_data": {
        "status": 503,
        "message": "You can write a custom message here",
        "html": "<!-- Some HTML can go here -->"
      },
      "interval": {
        "starts_at_utc": "20:00",
        "finishes_at_utc": "23:59"
      },
      "week_days": {
        "Sun": true,
        "Sat": true
      }
    }
  ]
}

Os argumentos que você pode passar para este arquivo JSON são os seguintes:

Atributo	Tipo de dado	Descrição
`action`	String	Define a ação que a função executará sempre que uma requisição corresponder aos critérios de disparo. Os valores possíveis são: `Deny`: fechará a requisição com uma resposta HTTP 403 Proibida. `Drop`: encerra o pedido sem enviar qualquer resposta ao cliente. `static_response`: encerrará a requisição com uma resposta estática a ela.
`execute_action_when`	String	Os valores possíveis são: `in_interval` `not_in_interval` Quando este argumento é definido como `in_interval`, a `action` será executada sempre que esta função for chamada durante o intervalo de tempo definido. Quando o argumento é definido como `not_in_interval` a `action` será executada mesmo que a função seja chamada fora do intervalo de tempo definido.
`interval`	Dicionário de Strings	Define o intervalo de tempo. Os valores devem estar no formato “HH ”, com base em um relógio de 24 horas. Esta função é usada no fuso horário UTC.
`interval.starts_at_utc`	String	Define a hora de início do intervalo.
`interval.finishes_at_utc`	String	Define a hora final do intervalo.
`week_days`	Dicionário de Booleanos	Define os dias da semana em que a função será executada. Os índices do dicionário representam cada dia da semana. Espera-se que eles usem um formato de data EEE, de 3 letras, começando com maiúsculas. Por exemplo: “Sun” para domingo, “Mon” para segunda. Se um dia inválido for usado, ele será ignorado. Se um dia não estiver presente no dicionário, ele será considerado `falso`.
`static_response_data`	Dicionário de Strings	Permite a personalização da página de resposta estática que será retornada sempre que a ação for definida como `static_response`.
`static_response_data.status`	Número	O código de status usado na resposta estática.
`static_response_data.message`	String	Este argumento permite que você personalize a mensagem exibida na página de resposta estática.
`static_response_data.html`	String	Permite que você forneça um HTML personalizado para ser usado ao fornecer a resposta estática.

Clique no botão Save. Sua integração está instanciada.

Selecione a aba Functions Instances.
Clique no botão + Function Instance.
Dê um nome fácil de lembrar para a sua instância.
No menu suspenso, selecione a função Scheduled Blocking.

Esta ação irá carregar a aba Arguments.

A aba Args carregará um arquivo JSON que se parece com o mostrado abaixo:

{
  "schedule": [
    {
      "action": "deny",
      "execute_action_when": "in_interval",
      "interval": {
        "starts_at_utc": "00:00",
        "finishes_at_utc": "00:59"
      },
      "week_days": {
        "Sun": true,
        "Mon": true,
        "Tue": true,
        "Wed": true,
        "Thu": true,
        "Fri": false,
        "Sat": true
      }
    },
    {
      "action": "drop",
      "execute_action_when": "not_in_interval",
      "interval": {
        "starts_at_utc": "01:00",
        "finishes_at_utc": "20:00"
      },
      "week_days": {
        "Mon": true,
        "Tue": true
      }
    },
    {
      "action": "static_response",
      "execute_action_when": "in_interval",
      "static_response_data": {
        "status": 503,
        "message": "You can write a custom message here",
        "html": "<!-- Some HTML can go here -->"
      },
      "interval": {
        "starts_at_utc": "20:00",
        "finishes_at_utc": "23:59"
      },
      "week_days": {
        "Sun": true,
        "Sat": true
      }
    }
  ]
}

Os argumentos que você pode passar para este arquivo JSON são os seguintes:

Atributo	Tipo de dado	Descrição
`action`	String	Define a ação que a função executará sempre que uma requisição corresponder aos critérios de disparo. Os valores possíveis são: `Deny`: fechará a requisição com uma resposta HTTP 403 Proibida. `Drop`: encerra o pedido sem enviar qualquer resposta ao cliente. `static_response`: encerrará a requisição com uma resposta estática a ela.
`execute_action_when`	String	Os valores possíveis são: `in_interval` `not_in_interval` Quando este argumento é definido como `in_interval`, a `action` será executada sempre que esta função for chamada durante o intervalo de tempo definido. Quando o argumento é definido como `not_in_interval` a `action` será executada mesmo que a função seja chamada fora do intervalo de tempo definido.
`interval`	Dicionário de Strings	Define o intervalo de tempo. Os valores devem estar no formato “HH ”, com base em um relógio de 24 horas. Esta função é usada no fuso horário UTC.
`interval.starts_at_utc`	String	Define a hora de início do intervalo.
`interval.finishes_at_utc`	String	Define a hora final do intervalo.
`week_days`	Dicionário de Booleanos	Define os dias da semana em que a função será executada. Os índices do dicionário representam cada dia da semana. Espera-se que eles usem um formato de data EEE, de 3 letras, começando com maiúsculas. Por exemplo: “Sun” para domingo, “Mon” para segunda. Se um dia inválido for usado, ele será ignorado. Se um dia não estiver presente no dicionário, ele será considerado `falso`.
`static_response_data`	Dicionário de Strings	Permite a personalização da página de resposta estática que será retornada sempre que a ação for definida como `static_response`.
`static_response_data.status`	Número	O código de status usado na resposta estática.
`static_response_data.message`	String	Este argumento permite que você personalize a mensagem exibida na página de resposta estática.
`static_response_data.html`	String	Permite que você forneça um HTML personalizado para ser usado ao fornecer a resposta estática.

Clique no botão Save. Sua integração está instanciada.

Configure o Rules Engine

Para concluir, você precisa configurar o Rules Engine para determinar o behavior (comportamento) e os criteria (critérios) para executar a função.

Ainda na página Edge Firewall:

Selecione a aba Rules Engine e siga estes passos:
Clique no botão + Rule Engine.
Dê um nome fácil de lembrar para a sua regra.
Selecione um criteria para executar e selecione os domínios nos quais você deseja executar a integração.
Abaixo, selecione o Run Function behavior (comportamento) para os criteria (critérios).

Selecione a função de Scheduled Blocking adequada de acordo com o nome que você deu na etapa instanciada.

Clicar no botão Save.

Pronto. Agora, a integração Scheduled Blocking está em execução para cada requisição feita ao domínio que você indicou.