Checklist Provedores

Um provedor que deseja se integrar tecnicamente ao ecossistema do BR-UTM pode utilizar os checklists abaixo como balizadores para o desenvolvimento dodas suas soluções. ~~É esperado~~

Os checklists estão dividos em três. O primeiro, de autenticação, é obrigatório para todos o provedores e deve ser completado por primeiro, visto que todos os outros checklists dependem da autenticação. O checklist de desconflito visa guiar o desenvolvimento para provedores que desejam criar liberações de espaço aéreo para seus operadores, em alternativa à liberação obtida através do SARPAS. Já o checklist de identificação guia o desenvolvimento de aplicações que provêm em tempo real a posição dos drones via internet. A obrigatoriedade da identificação durante a operação ainda está em debate pelo grupo. Orienta-se que provedores tenham essa capacidade para todos os voos.

Autenticação

O protocolo de autenticação utilizada no ecossistema no BR-UTM segue a arquitetura definida em ASTM F3548-21 Anexo X1.1 "Base Deployment: Access Tokens with Audience Claims", baseado no padrão de tokens JWT: IETC RFC 7519.

Checklist:

Obter apikey
Realizar autenticação
Validar autenticação de outro USS

Os detalhes técnicos podem ser obtidos abaixo. A referência técnica da etapa de autenticação pode ser encontrada em Autenticação Service Provider

Desconflito

Para ser um provedor de desconflito, o provedor deve seguir a especificação ASTM F3548-21. Os detalhes técnicos estão em: [Desconflito][Autenticação] Roteiro Etapa 1

Checklist

OIR Isolada
OIR próxima a constraint
OIR com conflito
Endpoints de coordenação
Ativação de OIR
Exibição da OIR no viewer do ICEA (Entrar em contato com a equipe técnica)

Identificação

Para ser um provedor de identificação, o provedor deve seguir a especificaçao ASTM F3411-22a. Os detalhes técnicos estão em: [Remote ID] Onboarding Service Provider.

O protocolo de comunicação entre DRONE <-> USS não é escopo do BR-UTM, ficando cada USS livre para implementar da melhor maneira possível. É esperado que o provedor atualize a posição de seus drones no mínimo a cada 4 segundos

Checklist

Criação ISA sem subscription
Criação ISA com subcription
Exibição da posição do drone no viewer do ICEA (Entrar em contato com a equipe técnica)

Autenticação

Autenticar-se

A URL base é GET http://montreal.icea.decea.mil.br:64235/token

A requisição deve conter as seguintes query_strings

intended_audience

USS de destino da mensagem (Vem na OIR ou Constraint no campo manager)

scope

escopo da requisição. Ex.: utm.strategic_coordination.

O scope esperado de cada endpoint está definido no OpenAPI

apikey

chave recebida do ICEA. Pode-se optar em enviar esse campo no Header da requisição

Validar autenticação de outro USS

Ao receber uma requisição de outro USS em seu servidor, é necessário validar o token de autenticação fornecido pelo outro USS. O payload do token contém as seguintes informações:

aud	Nome do provedor destino da requisição	"core-service"
exp	Timestamp epoch do horário de expiração do token. O token não deve ser aceito a partir desse horário	1719777868
iss	Nome do provedor emissor do token	ICEA
scope	Scope autorizado pelo token. Cada endpoint deve aceitar apenas determinados scopes, conforme definido no OpenAPI	utm.strategic_coordination
sub	Nome do provedor origem da requisição	"USS1"

Os passos para verificação são

Verificar assinatura do token
1. Deve-se validar a assinatura do token utilizando a chave pública do ICEA
Verificar a validade do token
1. Deve-se validar que o campo "exp" não seja menor do que o horário atual
Verficiar audiência do token
1. Deve-se validar que o campo "aud" seja o seu nome, ou seja, o nome do provedor que está recebendo a requisição
Verificar o scope
1. Deve-se validar que o campo "scope" contenha o scope necessário para requisitar o endpoint. Um token pode possuir mais de um scope separados por espaço em branco.

Eco-UTM Autenticator Public Key