Pular para o conteúdo principal
Voltar para Artigos

Um app, muitos clientes: multi-tenancy no mobile

Categoria
Arquitetura
Autor
Michel Lütz
Tópicos
Arquitetura Mobile, Gestão de Tecnologia
Publicado originalmente em
Medium
Um app, muitos clientes: multi-tenancy no mobile. O texto de 2025, revisto em 2026.

Multi-tenancy em apps mobile, do contrato ao teste: os modelos de isolamento, como o app descobre o tenant, a configuração por cliente, o dado no aparelho e o que quem gerencia decide.

A primeira versão deste texto saiu em 2025, no Medium, como um roteiro em tópicos para Tech Managers. Ela listava os modelos, os componentes e os desafios, e parava antes da parte mais difícil: como decidir. Reescrevi em 2026 para completar essa parte.

Multi-tenancy é atender vários clientes, os tenants, com o mesmo app e o mesmo backend, cada um vendo só os próprios dados, com a própria marca e as próprias regras. É a arquitetura de quem vende o mesmo produto para muitas empresas. Feita com pressa, também é a forma mais rápida de vazar o dado de um cliente para outro.

1. Os modelos, do mais compartilhado ao mais isolado

ModeloComo funcionaO preço
Banco e esquema compartilhadosTodos os tenants nas mesmas tabelas, separados por um campo tenant_idO mais barato e o mais simples de operar, e o que mais exige camadas de segurança: um filtro esquecido mostra o dado de outro cliente
Esquema por tenantO mesmo banco, com um esquema separado para cada clienteMais seguro que o anterior, com mais trabalho a cada migração
Banco por tenantCada cliente com o próprio bancoO maior isolamento e a operação mais pesada
Multi-instanceCada cliente com o próprio app, da mesma base de código ou de um forkSeparação total, com uma publicação na loja e uma manutenção por cliente

Não existe modelo certo. Existe o que o seu contrato, o seu time e o seu orçamento sustentam. Um cliente que exige o dado num banco só dele decide por você.

2. Como o app descobre de quem ele é

Antes de qualquer tela, o app precisa saber qual tenant está usando. Três formas comuns:

FormaExemploQuando usar
Subdomínio ou URLapp.empresaA.com e app.empresaB.comMais comum na web, e útil em APIs que o app consome
Prefixo no caminho da APIapi.com/empresaA/users e api.com/empresaB/usersQuando o backend resolve o tenant por rota, com um middleware
No token de acessoO id do tenant no payload do JWTQuando a API precisa validar o tenant a cada chamada, no momento da autenticação

Para a autenticação, OAuth 2.0 com OpenID Connect é o caminho mais escalável e seguro, com SSO e integração com provedores de identidade como Okta, Auth0, Firebase Authentication e Cognito. Dentro de cada tenant, o controle de acesso por papel (RBAC) ou por atributo (ABAC) define quem é admin, quem é usuário e quem é convidado.

3. Um app, muitas configurações

Nem todo tenant precisa da mesma experiência. A sequência que eu desenho na abertura do app:

%%{init: {"flowchart": {"nodeSpacing": 24, "padding": 10}}}%%
flowchart TD
    mtA["O app abre"] --> mtB["Identifica o tenant<br/>pelo login ou pelo token"]
    mtB --> mtC["Baixa a configuração<br/>do tenant"]
    mtC --> mtD["Aplica o tema,<br/>os textos e as flags"]
    mtD --> mtE["Carrega os dados<br/>só daquele tenant"]
O que muda por tenantComo
FuncionalidadesFeature toggles por tenant, com Firebase Remote Config, AWS AppConfig ou LaunchDarkly
MarcaCores, fontes e logotipo carregados de um JSON remoto ou do Remote Config
Idioma e textosArquivos de tradução remotos, por tenant
ComportamentoEndpoints, limites de uso e tempo de sessão vindos do backend

A configuração precisa ter um padrão que funcione sem rede. Um app que não abre porque o arquivo de tema não chegou é um app quebrado para todos os tenants ao mesmo tempo.

4. O dado de um tenant não pode sobrar no aparelho

O backend pode ser impecável e o vazamento acontecer no celular, quando a mesma pessoa troca de empresa no app ou quando o aparelho é compartilhado:

  • Credenciais e chaves no armazenamento seguro de cada plataforma: Keychain no iOS, Keystore no Android.
  • Banco local (SQLite, Room, Core Data, Realm) com separação por tenant: um arquivo por tenant, ou o tenant_id em toda consulta.
  • Cache e preferências (UserDefaults, SharedPreferences, MMKV) com um namespace por tenant.
  • Na troca de tenant ou no logout, apague o que era do anterior: banco, cache, imagens e configuração.

5. API e sincronização

No backend, a identificação do tenant vai em cada requisição: um cabeçalho como X-Tenant-ID, ou a rota, como /api/tenantA/orders. Com GraphQL, diretivas restringem o que cada contexto pode ler. No app, sincronização em segundo plano evita perder dado em conexão ruim, e a resolução de conflitos cuida do que vários usuários editaram offline. Uma CDN na frente ajuda no tempo de resposta.

6. White-label ou configuração dinâmica

White-labelConfiguração dinâmica
O que éUm app por cliente, da mesma base de códigoUm app só, que muda pela configuração do tenant
Na lojaO nome e o ícone de cada cliente, uma publicação por clienteUma publicação só, com o nome do produto
Mudar a interfaceVersão nova de cada appRemote Config e feature flags, sem versão nova
Escolha quandoO cliente exige o app com a marca deleOs clientes aceitam o produto com a sua marca

Nos dois casos, uma arquitetura modular ajuda a ligar e desligar partes do app por tenant. No Android, módulos como estes:

:core-ui
:feature-orders
:feature-custom-reports

E no iOS, pacotes equivalentes:

CoreUI
FeatureOrders
FeatureCustomReports

7. Os desafios de quem gerencia

A parte técnica tem solução conhecida. O que tira o sono de quem gerencia é o efeito de uma decisão em todos os clientes de uma vez:

DesafioA pergunta para o time
Entregar sem afetar todosComo publicamos para um tenant de cada vez, e como voltamos atrás em um só?
VersionamentoAté quantas versões do app o backend aceita ao mesmo tempo?
ComplianceOnde mora o dado de cada cliente, e como atendemos LGPD e GDPR por tenant?
MonitoramentoConseguimos ver um erro ou uma anomalia por tenant, e não só no total?
DesempenhoO isolamento e a configuração inicial deixam a abertura do app lenta para alguém?

8. Testes de isolamento, o artefato que mais importa

Em 2026, um agente de código gera a tela de um tenant novo, a variação de tema e a configuração com pouco esforço. O risco mudou de lugar: gerar ficou fácil, garantir que nada vaze entre clientes continua difícil. O teste que prova o isolamento (o usuário do tenant A nunca vê dado do tenant B, nem no app, nem no cache, nem depois da troca de empresa) é o que eu escreveria primeiro, e o que o agente tem de passar a cada mudança.

Conclusão: como escolher

  • Comece pelo contrato. O que os clientes exigem de isolamento, de marca e de localização do dado decide o modelo antes da preferência técnica.
  • Isole por padrão. Tenant em todo token, toda requisição, toda consulta e toda chave de cache.
  • Configure, não ramifique. O que muda por cliente vem de configuração e de flag, não de um if com o nome do cliente no código.
  • Limpe na troca. Nada do tenant anterior sobra no aparelho.
  • Teste o isolamento. É o teste que não pode faltar, com ou sem agente.

O que continua em aberto

  • Quando vale sair do banco compartilhado para um banco por tenant?
  • Um cliente grande pede uma funcionalidade só para ele: flag, módulo ou fork?
  • Como medir o custo de cada tenant para precificar o produto?

Se você opera um app para muitos clientes, me conte qual dessas decisões foi a mais cara. A conversa continua no LinkedIn.

Leia também

Referências

Tags

  • multi-tenancy
  • arquitetura
  • mobile
  • seguranca
  • white-label
  • saas