Authorizations

Na tela Authorizations, você pode configurar endpoints para validar client ID e/ou tokens de acesso dos publicadores de eventos, permitindo que eles enviem requisições ao Events Hub.

Para definir requisições com autorização, você pode adicionar interceptores de segurança nas políticas aplicadas a handlers. Veja alguns exemplos de interceptores:

• OAuth Validation
• JWT Validation
• Client ID Validation
• Access Token Validation

Quando pelo menos um desses interceptores for usado, o Events Hub enviará requisições às URLs de autorização definidas na tela para validar os publicadores e aceitar suas requisições.

IMPORTANT

A utilização de interceptores de segurança é opcional. No entanto, se adicionar políticas ao seu handler, você precisa configurar a URL da autorização vinculada ao interceptor. Com exceção do "IP Filtering Validation", todos dependem dessa configuração para funcionar. Se for utilizar a Sensedia API Platform para isso, veja como obter a URL de autorização.

NOTE

Clientes do Sensedia API Management v5: para obter a URL de autorização, você deverá importar a API de autorização do Events Hub.

Como funciona

A configuração de URLs de autorização é feita por contexto, que é um dos marcadores da URL de publicação de eventos, formada por: URL base + context + handler + topic.

Essa configuração por contexto facilita o envio de eventos de diferentes cenários para o mesmo tópico, por exemplo, eventos de ambiente produtivo e de teste.

Exemplo de uso

Digamos que você quer testar tópicos já usados por publicadores e subscritores parceiros, mas prefere usar um mock de autorização para os testes em vez dos endpoints reais de autorização. Nesse caso, você pode:

1. Criar um contexto para seus testes e habilitá-lo para os tópicos desejados.
2. Vincular publicadores e subscritores para enviar e receber eventos dos tópicos correspondentes ao contexto.
3. Configurar um mock de autorização de OAuth e/ou JWT para o contexto na tela Authorizations.

Com isso, os publicadores que enviarem requisições para tópicos no contexto que você criou serão validados pelo mock configurado. Já aqueles que enviarem eventos para os mesmos tópicos no contexto padrão ("Default") serão validados pela URL configurada para esse contexto.

IMPORTANT

Os contextos são divisões lógicas que facilitam a criação e manutenção de tópicos, permitindo reutilizá-los em diferentes cenários. Eles não são ambientes fisicamente separados uns dos outros.

Isso quer dizer que, se você usa o contexto "Default" para eventos produtivos e o contexto "Testing" para eventos de teste, consegue controlar os publicadores, subscritores e endpoints de autorização para cada contexto. No entanto, todos os eventos recebidos e distribuídos no Events Hub compartilham a mesma infraestrutura.

Testes que sobrecarreguem a infraestrutura, mesmo feitos no contexto de teste, poderão afetar o recebimento e distribuição de eventos nos outros contextos.

Acesse mais informações sobre o funcionamento dos contextos.

Configuração

A tela Authorizations tem duas seções: OAUTH e JWT. Em ambas são mostrados todos os contextos cadastrados no Events Hub, indicando a URL de autorização que está definida para cada um.

• Se nenhum endpoint de autorização estiver cadastrado para o contexto, haverá o ícone na coluna ACTIONS para adicionar uma URL.
• Se uma URL já estiver cadastrada, clique no ícone do lápis para editá-la e no ícone da lixeira para excluí-la.

IMPORTANT

• Se você não cadastrar ou remover a URL de autorização para um contexto, as publicações enviadas para ele usando os interceptores de segurança não serão aceitas. Você receberá uma mensagem de erro com o código de estado 401, indicando que não está autorizado.
• Nesse caso, publicações para tópicos interceptados por OAuth ou JWT são impedidas.

Obter a URL de autorização usando a Sensedia API Platform

Para utilizar a Sensedia API Platform como servidor de validação das políticas, você deve fazer algumas configurações:

TIP

Se você cadastrar um contexto de teste para a autorização, na seção Environments, copie o link do seu ambiente de teste.

A seção Resources and Operations está dividida entre OAuth e JWT. Na hora de copiar o path da sua URL, atente-se que:

• A URL da autorização deve ser gerada respeitando as políticas inseridas no contexto.
• Se inseriu interceptores de OAuth Validation, copie o path de OAuth.
• Se inseriu interceptores de JWT Validation, copie o path de JWT.

Os interceptores são configurados em políticas, que são aplicadas a handlers na criação ou edição dos mesmos. Todos os tópicos agrupados em um handler utilizam os interceptores configurados na política aplicada ao handler.

NOTE

Veja como usar a Sensedia API Platform para autorização dos publicadores.