Capítulo 34 — Arquitetura e engenharia de segurança: integração

Capítulo 34 — Arquitetura e engenharia de segurança: integração

Mapa da aula

Aula 34 publicada. Mapa, exemplo, EX100.

flowchart TD
  N0["34.1 Integrações com parceiros"]
  N1["34.2 Projeto de APIs para parceiros"]
  N2["34.3 Responsabilidade compartilhada"]
  N3["Síntese"]
  N0 --> N1 --> N2 --> N3
  N3 --> EX["Exemplo resolvido"]
  EX --> Q["Exercício EX100"]

Desenho lógico

flowchart LR
  N0["34.1 Integrações com parceiros"]
  N1["34.2 Projeto de APIs para parceiros"]
  N2["34.3 Responsabilidade compartilhada"]
  N3["Síntese"]
  N0 --> N1 --> N2 --> N3 --> Q["EX100"]

[34.1 Integrações com parceiros]
    |
    v
[34.2 Projeto de APIs para parceiros]
    |
    v
[34.3 Responsabilidade compartilhada]
    |
    v
[Síntese]
    |
    v
[Exemplo resolvido] --> [Exercício EX100]

Objetivos de aprendizagem

Você vai (1) proteger integrações com parceiros externos; (2) projetar a autenticação e a autorização de APIs para o acesso de parceiros; (3) gerenciar a responsabilidade compartilhada nas fronteiras de integração.

34.1 Integrações com parceiros

A Corvia se integra a um provedor de pagamentos, a um aplicativo regional de mobilidade que vende passagens da Corvia, ao fornecedor de energia e a uma consultoria de análise de dados. Cada integração atravessa uma fronteira de confiança e traz obrigações contratuais e técnicas. Sofia lista para cada uma os dados trocados, a direção, o método de autenticação e a parte responsável por cada controle. Ela descobre que o aplicativo de mobilidade usa uma única API key de longa duração compartilhada por todos os seus servidores, enquanto a consultoria recebe exportações mensais de dados por e-mail. As duas são fraquezas de integração que a arquitetura deve tratar.

34.2 Projeto de APIs para parceiros

Sofia propõe um API gateway para parceiros. Os parceiros se autenticam com tokens de curta duração obtidos com client credentials vinculadas a certificados, em vez de chaves estáticas. Cada token carrega escopos que limitam o que o parceiro pode fazer: o aplicativo de mobilidade pode vender passagens e consultar tarifas, mas não ler históricos de viagem. O gateway aplica rate limits, valida os esquemas e registra cada requisição com a identidade do parceiro. As exportações de dados para a consultoria passam para um serviço de transferência segura, com dados pseudonimizados e expiração do acesso. Essas escolhas aplicam o menor privilégio e a mediação completa na fronteira.

34.3 Responsabilidade compartilhada

Em toda integração, alguns controles pertencem à Corvia e outros ao parceiro. Sofia escreve uma matriz de responsabilidades: a Corvia protege o gateway e valida as requisições; o parceiro protege suas credenciais e seus próprios usuários; ambos devem comunicar incidentes dentro de prazos acordados. A matriz é anexada aos contratos. Quando o aplicativo de mobilidade mais tarde sofre um vazamento das contas dos seus próprios clientes, a matriz deixa claro qual parte notifica quais passageiros e quais tokens a Corvia revoga. A clareza sobre as responsabilidades evita lacunas em que cada parte supõe que a outra cuida de um controle.

Exemplo resolvido

Sofia inventaria quatro integrações com parceiros, substitui uma API key estática compartilhada por tokens de curta duração, com escopo e vinculados a certificados, e escreve uma matriz de responsabilidades usada durante um vazamento de um parceiro.

Caso sintético. Os parceiros, as integrações e o vazamento são sintéticos.

Erros e limites

Os gateways se tornam pontos únicos de falha e precisam ser resilientes. Os contratos não conseguem obrigar os parceiros a proteger os próprios sistemas.

Exercícios

• EX100 — Duas fraquezas. Que duas fraquezas de integração Sofia encontrou? Rubrica: 3 = API key compartilhada e de longa duração do aplicativo de mobilidade; exportações da consultoria por e-mail;; 2 = as duas;; 1 = uma;; 0 = nenhuma.

• EX101 — Exemplo de escopo. O que os tokens do aplicativo de mobilidade podem permitir, e o que não? Rubrica: 3 = vender passagens e consultar tarifas, não ler históricos de viagem;; 2 = as duas partes;; 1 = acesso total;; 0 = nenhuma.

• EX102 — Matriz no vazamento. Como a matriz de responsabilidades ajudou durante o vazamento do parceiro? Rubrica: 3 = esclareceu quem notifica os passageiros e quais tokens a Corvia revoga;; 2 = clareza;; 1 = vago;; 0 = nenhuma.

Síntese

A integração segura combina, nos gateways, credenciais com escopo e de curta duração com responsabilidade compartilhada por escrito.

Continue estudando — aula 34 (capítulo 34 de 50)

← Capítulo 33 · Índice das aulas · Capítulo 35 →

Continue para a próxima aula já escrita.