Pular para o conteúdo
Blog

Autenticação e segurança de API de viagens: onde vaza

Redação Tekravel
Escrito com a ajuda de IA

Um desenvolvedor de uma das suas agências parceiras está testando a integração numa terça-feira à tarde. Ele percebe que o endpoint da lista de reservas recebe um agencyId na query string e, por curiosidade, troca 114 por 115. A resposta volta com as reservas de outra pessoa: nomes de passageiros, PNRs e a tarifa net que aquela agência pagou antes de aplicar a própria margem. Ninguém atacou nada. A API simplesmente acreditou no que o cliente disse. Aquela tarde resume quase tudo o que autenticação e segurança de API de viagens realmente envolve, e é por isso que o assunto merece mais cuidado do que a tela de login costuma receber.

APIs de viagem multi-tenant vazam de poucas maneiras, e quase sempre previsíveis. Vale a pena nomeá-las uma de cada vez, porque cada uma tem uma resposta de arquitetura que custa muito menos antes do lançamento do que depois.

O tenant não é um parâmetro

O erro da cena de abertura não é uma verificação que faltou. É um desenho que pergunta a quem chama quem ele é e depois confia na resposta. Num sistema de um único cliente isso é apenas desleixo. Numa plataforma em que dezenas de agências, subagentes e sites white-label compartilham um só banco de dados, é todo o modelo de segurança apoiado na honestidade de cada integrador que um dia vai segurar uma chave.

A regra que elimina a categoria inteira de bug: o tenant vem da credencial, nunca da requisição. Quando uma chave ou token é verificado, o servidor resolve a qual tenant ele pertence, a qual escritório dentro desse tenant e quais papéis o chamador tem. A partir daí, toda consulta roda dentro desse escopo. O corpo de uma requisição ainda pode trazer um id de agência por motivos legítimos — um consolidador criando uma reserva em nome de um dos seus subagentes, por exemplo —, mas o servidor confere esse id contra o escopo que a credencial já definiu. Ele nunca amplia o escopo porque um campo pediu.

Na prática, três coisas ficam do lado do servidor:

  • Escopo na camada de dados, não em cada handler. Um filtro aplicado automaticamente a toda consulta em tabelas que pertencem a um tenant faz com que o desenvolvedor que esquece a cláusula where receba um resultado vazio, e não os dados de outra pessoa. Verificações handler por handler falham na primeira vez que alguém adiciona um endpoint com pressa.
  • Verificação por objeto em cada id do caminho. GET /bookings/98231 precisa confirmar que a reserva 98231 pertence ao escopo de quem chama. Ids sequenciais fazem disso o furo mais comum em APIs de viagem, porque números de reserva e localizadores PNR são fáceis de adivinhar.
  • A mesma resposta para "não é seu" e "não existe". Devolva 404 para a reserva de outro tenant. Um 403 confirma que o registro existe, e só isso já é informação que um concorrente gostaria de ter.

As exceções pedem a mesma disciplina. Quase toda plataforma precisa de uma visão operacional que leia entre tenants — suporte, financeiro, o dono da plataforma. Faça disso um papel separado, concedido no código e registrado em log quando usado, e não um parâmetro de consulta que qualquer chamador autenticado pode ligar. Sobre como uma integração cliente deve se comportar em torno desses limites, o texto sobre integração de API de reserva de voos cobre o lado da requisição.

Credenciais de fornecedor nunca chegam a um navegador

Uma plataforma de viagens guarda dois tipos de segredo. O primeiro é seu: as chaves que você emite para parceiros. O segundo pertence à sua relação com fornecedores — credenciais de escritório no GDS, tokens de agregadores NDC, chaves de API de bedbanks, muitas vezes atreladas a um contrato que leva o nome da sua empresa e o seu número IATA. Toda requisição feita com elas é, para o fornecedor, uma requisição sua.

Essas credenciais têm um único lugar seguro: um processo de servidor que conversa com o fornecedor em nome de quem chamou. Elas não pertencem ao bundle JavaScript de uma single-page app, ao binário de um app móvel, a um arquivo de configuração entregue ao navegador "só para a página de busca", nem a uma mensagem de erro devolvida quando a chamada ao fornecedor falha. Cada um desses lugares já foi o vazamento em algum lugar. Qualquer pessoa abre a aba de rede do navegador, e um binário pode ser desmontado por quem tiver vontade.

As consequências são piores que uma fatura. Uma chave de fornecedor vazada deixa um estranho pesquisar, e às vezes reservar, na sua conta — queimando a relação look-to-book pela qual o fornecedor mede você e, no pior caso, emitindo contra o seu crédito. O fornecedor não vai distinguir esse tráfego do seu. O desfecho habitual é uma conta suspensa enquanto você prova que não foi você, o que, para uma agência que vende sobretudo uma companhia aérea ou um bedbank, significa loja fechada durante todo esse tempo.

Daí saem duas regras menores. O cliente nunca escolhe por qual conta de fornecedor a requisição passa; o servidor escolhe a partir da configuração do tenant. E os corpos de erro dos fornecedores são traduzidos antes de saírem da sua API, porque erros brutos de fornecedor às vezes devolvem os cabeçalhos da requisição tal como chegaram.

Quanto custa de verdade uma tarifa net vazada

Desenvolvedores costumam classificar vazamentos pelo quanto o dado é pessoal. Na distribuição de turismo, o campo comercialmente perigoso muitas vezes é o preço. Uma tarifa net é o valor que o fornecedor aceitou lhe dar com a condição de não ser mostrado ao público, e a distância entre ela e o preço de venda é a sua margem e a dos seus subagentes. A tabela abaixo é uma classificação aproximada. Você pode pesar as linhas de outro jeito para o seu negócio, e vale ter essa discordância com a equipe antes de um incidente, não durante.

O que vazaQuem costuma encontrarQuanto custa
Tarifa net dentro de uma resposta de busca B2C (escondida no JSON, não na tela)Concorrentes fazendo scraping, clientes curiososReclamações de paridade tarifária do fornecedor, e clientes perguntando por que pagaram o preço publicado
Margem ou preço net de outro subagenteSubagentes comparando anotaçõesPreços reabertos em toda a rede; o agente com o acordo melhor vira o assunto
Credenciais de fornecedor num bundle do clienteQualquer um que olheTráfego e reservas na sua conta, possível suspensão durante a investigação
Ids de reserva ou PNR enumeráveisScrapers, às vezes jornalistasExposição de dados de passageiros, com peso regulatório bem além da perda comercial
Limites de crédito e saldos de outras agênciasParceiros, concorrentesAs contas mais frágeis da sua rede viram alvo de aliciamento

A primeira linha é a que as equipes não percebem, porque a tela parece certa. A página mostra o preço de venda; a resposta que a alimentou traz o net e a margem como campos separados porque o frontend "pode precisar deles". Molde as respostas por público, no servidor. Um chamador B2C recebe um preço de venda e nada que permita a alguém fazer a subtração. O artigo sobre distribuir tarifas net para subagentes explica por que essa diferença é exatamente o que um consolidador vende.

Rotacionar credenciais sem parar o serviço

Toda credencial vai precisar ser trocada. Um desenvolvedor sai de uma agência parceira, uma chave aparece num repositório público, um fornecedor rotaciona no próprio calendário. Se rotacionar significa "troca e tudo quebra até o parceiro publicar de novo", ninguém rotaciona, e as chaves vivem anos.

Desenhe para sobreposição desde o primeiro dia. Cada parceiro pode ter duas chaves ativas ao mesmo tempo: cria a nova, coloca em produção, vê o tráfego migrar e só então revoga a antiga. Para isso funcionar, a plataforma precisa de algumas peças nada glamorosas:

  1. Um identificador visível da chave — um prefixo ou id guardado ao lado do segredo —, para que logs e chamados de suporte digam qual chave fez uma chamada sem que ninguém veja o segredo.
  2. Segredos guardados como hash, mostrados uma única vez na criação e nunca mais. Se a sua equipe de suporte consegue ler a chave de um parceiro, qualquer pessoa que comprometa as ferramentas de suporte também consegue.
  3. Um registro de último uso por chave, para que o parceiro veja que a antiga ficou em silêncio antes de revogá-la.
  4. Revogação com efeito imediato, inclusive em qualquer cache que esteja na frente da autenticação.

Credenciais de fornecedor pedem a mesma sobreposição no sentido contrário. Guarde-as num cofre de segredos ou numa configuração criptografada que o serviço em execução relê, e não embutidas num build, para que a troca seja uma mudança de configuração e não um deploy. Tokens de acesso de vida curta sobre chaves de vida longa também ajudam: se um token vaza, ele expira antes que a maioria das pessoas perceba que sumiu.

A rotação também é onde o log se paga. Registrar qual chave e qual tenant fizeram cada chamada — sem registrar o segredo nem os dados de pagamento do passageiro — é o que permite responder "fomos nós?" em uma hora, e não em uma semana.

Antes de entregar uma chave a um parceiro

Uma lista curta, porque a versão longa é o resto deste texto:

  • Algo na requisição consegue mudar o tenant da chave? Não deveria.
  • Todo endpoint que recebe um id verifica a propriedade, e responde 404 quando essa verificação falha?
  • Alguma credencial de fornecedor, ou campo derivado dela, é acessível a partir de um navegador?
  • Alguma resposta B2C contém preço net ou margem em algum lugar, campos ocultos incluídos?
  • O parceiro consegue rotacionar sem ligar para você, e você consegue revogar sem ligar para ele?

Como o acesso à nossa API funciona

A plataforma por trás deste blog expõe APIs de voos e hotéis. Cada tenant já trabalha com o próprio painel administrativo, as próprias reservas e permissões de equipe por papel, e o conteúdo de fornecedores chega a um tenant por meio de grupos de fornecedores, e não por acordos um a um. O acesso à API começa com uma conversa, e não com uma chave self-service, em parte pelos motivos acima: preferimos saber quem está integrando, e para qual mercado, antes que exista uma credencial. A página de APIs de viagem descreve o que está disponível e como essa conversa começa.

Redação Tekravel

Mesa de tecnologia de viagens

A mesa de tecnologia de viagens da Tekravel escreve para o setor: donos de agências, consolidadores e os programadores que os integram. Cada artigo é verificado na plataforma que descreve antes de ser publicado.