Saiba mais sobre Notificações REST

Quando se trata de enviar chamadas de API REST para outros aplicativos em que não há um conector OCI nativo implementado (por exemplo, Funções), o OCI só permite o uso de HTTPS e não HTTP.

Isso garante um grau de segurança e a adoção de boas práticas. No entanto, para um demonstrador criar um cliente fictício que nos permita ver o recebimento de uma mensagem, ele cria um esforço de configuração extra para estabelecer um certificado que será confiável (ou seja, não certificados de autoassinatura). À medida que estamos trabalhando com APIs, podemos simplesmente usar um produto de ferramenta de teste/mock. Para esta demonstração, vamos usar Postman. Há muitas outras ferramentas, mas como produto, tem um nível de uso livre e é bem conhecido.

Configurar um Ponto Final Mock

Se você não tiver uma conta Postman, a primeira etapa será criar uma conta na nuvem.

Com a configuração da conta na nuvem, podemos começar a configurar o Postman. Você precisará de um Espaço de Trabalho; use seu espaço padrão ou crie outro. Em seguida, queremos criar um servidor simulado.

Uma vez concluída a configuração do servidor mock, precisamos ver o URL do servidor, pois isso será necessário para ajudar a configurar a assinatura do ONS. Podemos ver isso na guia de configuração da view do servidor Mock.

Configurar a Assinatura REST no ONS

O processo de configurar a assinatura no OCI é muito semelhante ao Slack. Basicamente, apenas fornecemos o ponto final REST Postman do nosso servidor mock.

Como na configuração do Slack, a primeira mensagem enviada ao assinante é o validador de URL, que pode ser feito com a console de assinatura do OCI. Nesse caso, vemos isso como um URL no atributo de cabeçalho de mensagem POST e como um payload de mensagem no corpo. O URL fornecido precisa ser chamado para permitir que mensagens subsequentes sejam enviadas. Portanto, o URL precisa ser copiado para um navegador. O resultado será uma página da Web confirmando a ativação.

Para um aplicativo cliente real, torna-se necessário fornecer a lógica de acionamento necessária ou as chamadas são roteadas por proxy que podem filtrar as chamadas iniciais e ativar o ponto do consumidor.

Consulte Explorar Mais para obter links para instruções de configuração detalhadas.

Reexecutar o Aplicativo Cliente

Anteriormente, as mensagens de notificação que enviamos estavam em texto claro. No entanto, um aplicativo espera que o corpo do payload seja JSON. Ao reexecutar nosso aplicativo e enviar mensagens de notificação, veremos os dados que fluem para o Slack e para nosso servidor mock. Podemos ver mensagens subsequentes que chegam ao servidor mock. Uma vez ativadas, podemos ver mensagens como esta usando Postman.