URL dinâmica por tenant
5 min
Objetivo
Habilitar a configuração e uso de uma URL específica por tenant para o portal de chamados, permitindo personalização e isolamento entre clientes.
- Quando configurada, a aplicação retorna a URL correspondente ao tenant atual.
- Caso não exista configuração, o sistema utiliza a URL padrão definida na variável de ambiente VITE_APP_ITSM_URL.
Referência: treants.itsm.url
Contexto técnico
Anteriormente, o front-end utilizava uma URL fixa para todos os tenants. Agora, a camada de back-end expõe a configuração dinâmica de itsm.url, retornando o valor correto de acordo com o tenant autenticado.
Exemplo de configuração no banco de dados
{
"description": "Configuração de portal ITSM por tenant",
"settings": [
{
"key": "itsm.url",
"type": "text",
"scope": "tenant",
"value": "https://suporte.tenantx.com",
"origin": "custom",
"group": "portal",
"display_name": "URL do portal de chamados"
}
]
}Se o tenant não possuir essa configuração, o sistema utiliza o valor padrão:
VITE_APP_ITSM_URL=https://suporte.fluidapi.io
Como funciona
- Ao carregar o portal, o back-end consulta a configuração itsm.url do tenant.
- Se existir, o valor é retornado e injetado no front-end.
- Caso contrário, o front-end usa a variável de ambiente padrão (VITE_APP_ITSM_URL).
- O front-end redireciona os usuários/clientes para o portal ITSM correto.
Impacto
- Usuários finais: passam a acessar o portal correto do seu tenant.
- Administradores: podem definir URLs diferentes para cada ambiente ou cliente.
- Front-end: não precisa de alteração manual em variáveis de ambiente por tenant.
Observações adicionais
- O campo itsm.url deve ser configurado manualmente via base de dados ou painel de administração.
- Apenas tenants com configuração explícita terão comportamento diferenciado.
- Compatível com fluxos já existentes de autenticação e abertura de chamados.
Conclusão
Esta melhoria garante maior flexibilidade multi-tenant para o módulo de suporte, eliminando a dependência de uma URL única e centralizada.