
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
| Modelo | Como funciona | O preço |
|---|---|---|
| Banco e esquema compartilhados | Todos os tenants nas mesmas tabelas, separados por um campo tenant_id | O 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 tenant | O mesmo banco, com um esquema separado para cada cliente | Mais seguro que o anterior, com mais trabalho a cada migração |
| Banco por tenant | Cada cliente com o próprio banco | O maior isolamento e a operação mais pesada |
| Multi-instance | Cada cliente com o próprio app, da mesma base de código ou de um fork | Separaçã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:
| Forma | Exemplo | Quando usar |
|---|---|---|
| Subdomínio ou URL | app.empresaA.com e app.empresaB.com | Mais comum na web, e útil em APIs que o app consome |
| Prefixo no caminho da API | api.com/empresaA/users e api.com/empresaB/users | Quando o backend resolve o tenant por rota, com um middleware |
| No token de acesso | O id do tenant no payload do JWT | Quando 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 tenant | Como |
|---|---|
| Funcionalidades | Feature toggles por tenant, com Firebase Remote Config, AWS AppConfig ou LaunchDarkly |
| Marca | Cores, fontes e logotipo carregados de um JSON remoto ou do Remote Config |
| Idioma e textos | Arquivos de tradução remotos, por tenant |
| Comportamento | Endpoints, 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_idem 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-label | Configuração dinâmica | |
|---|---|---|
| O que é | Um app por cliente, da mesma base de código | Um app só, que muda pela configuração do tenant |
| Na loja | O nome e o ícone de cada cliente, uma publicação por cliente | Uma publicação só, com o nome do produto |
| Mudar a interface | Versão nova de cada app | Remote Config e feature flags, sem versão nova |
| Escolha quando | O cliente exige o app com a marca dele | Os 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:
| Desafio | A pergunta para o time |
|---|---|
| Entregar sem afetar todos | Como publicamos para um tenant de cada vez, e como voltamos atrás em um só? |
| Versionamento | Até quantas versões do app o backend aceita ao mesmo tempo? |
| Compliance | Onde mora o dado de cada cliente, e como atendemos LGPD e GDPR por tenant? |
| Monitoramento | Conseguimos ver um erro ou uma anomalia por tenant, e não só no total? |
| Desempenho | O 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
ifcom 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
- Projetos mobile escaláveis começam antes do código
- Integrando inovação e liderança em times mobile
- Arquitetura de Software: Além das Siglas
Referências
- SaaS Tenant Isolation Strategies (AWS)
- Architect multitenant solutions (Microsoft Azure Architecture Center)
- How OpenID Connect works (OpenID Foundation)
- Keychain Services (Apple) e Android Keystore (Android Developers)
- Firebase Remote Config e AWS AppConfig
- OWASP Mobile Top 10
- A primeira versão deste texto: Arquitetura Multi-Tenancy Mobile: Desafios e Estratégias para Tech Managers (Medium, 2025)
Tags
- multi-tenancy
- arquitetura
- mobile
- seguranca
- white-label
- saas

