Um guia completo para apontar um domínio de portal do cliente com marca própria para o Tridens e utilizá-lo nos portais Tridens EV Charge e Tridens Monetization.
Este guia destina-se aos administradores de clientes e às equipas de TI que pretendem utilizar um URL de portal de marca branca, em vez de encaminhar os utilizadores para um domínio genérico da aplicação. Com um registo CNAME personalizado, os seus clientes podem aceder aos seus portais a partir de um endereço com a marca da empresa, como, por exemplo, https://portal.example.com/ev-charge ou https://portal.example.com/monetization.
A configuração do DNS é simples, mas os detalhes são importantes. O destino do CNAME deve apontar para app.tridenstechnology.com. Não adicione https:// no interior do registo DNS. O HTTPS é utilizado quando os utilizadores abrem o URL final do portal no seu navegador.
Visão geral rápida
Um URL de portal «white label» permite que os seus clientes utilizem o seu próprio subdomínio para aceder à experiência do portal Tridens. O URL público mantém a identidade da sua marca, enquanto a Tridens gere a aplicação subjacente.
Por exemplo, se a sua empresa for proprietária de example.com, pode criar o subdomínio portal.example.com. Depois de configurar o DNS e ativar o domínio do portal, os seus clientes podem aceder ao endereço correto do portal:
https://portal.example.com/ev-chargepara o portal Tridens EV Charge.https://portal.example.com/monetizationpara o portal Tridens Monetization.
O que precisa antes de começar
Antes de alterar os registos DNS, certifique-se de que já tomou as decisões corretas em matéria de acesso e nomenclatura. Isto evita atrasos na propagação do DNS, na ativação do SSL e nos testes do portal.
- Um ambiente Tridens ativo com o portal necessário ativado.
- Acesso às definições de DNS do domínio da sua empresa.
- Um subdomínio escolhido, como, por exemplo,
portal,o meu,contaouclientes. - Confirmação de que o subdomínio selecionado ainda não está a ser utilizado por outro site ou aplicação.
- Autorização da sua equipa interna de TI, segurança ou administração de domínios, caso o DNS seja gerido de forma centralizada.
Utilize um subdomínio em vez do domínio raiz. Por exemplo, utilize portal.example.com, não example.com. Isto mantém o seu site principal separado do portal Tridens.
Como funciona o URL do portal de marca branca
A configuração de marca branca liga o seu domínio à aplicação Tridens através do DNS. O seu cliente acede ao URL com a sua marca, o registo DNS direciona o subdomínio para o Tridens e o Tridens encaminha o visitante para o caminho correto do portal.
O mesmo subdomínio com a marca pode ser utilizado para ambos os percursos do portal, desde que ambos estejam ativados na sua conta. Isto mantém o URL visível para o cliente simples e previsível.
| Portal | Exemplo de URL com marca | Caso de utilização |
|---|---|---|
| Carga Tridens EV | https://portal.example.com/ev-charge | Clientes de recarga de veículos elétricos, condutores, utilizadores de frotas ou utilizadores do portal. |
| Tridens Monetization | https://portal.example.com/monetization | Utilizadores do portal de faturação, subscrições, contas de clientes e gestão de receitas. |
Se utilizar ambos Carga Tridens EV e Tridens Monetization, confirme quais os percursos do portal que devem estar visíveis para os seus utilizadores finais antes de partilhar publicamente o link com a marca.
Configurar o registo CNAME
Os fornecedores de DNS utilizam denominações ligeiramente diferentes, mas a estrutura dos registos é normalmente a mesma. É necessário criar um registo CNAME para o subdomínio escolhido e direcioná-lo para o servidor da aplicação Tridens.
Passo 1: Escolha o subdomínio
Escolha um nome curto que os clientes consigam reconhecer. Entre as opções mais comuns encontram-se portal, conta, o meuou clientes. Neste guia, utilizamos portal.example.com.
Passo 2: Abra o seu gestor de DNS
Inicie sessão no sistema onde os registos DNS do seu domínio são geridos. Pode tratar-se do seu registador de domínios, do seu fornecedor de alojamento, da sua conta Cloudflare, do painel de DNS do Microsoft 365 ou de outro serviço de DNS gerido.
Passo 3: Adicionar o registo CNAME
Crie um novo registo CNAME com estes valores:
| Campo DNS | Valor | Notas |
|---|---|---|
| Tipo | CNAME | Utilize o CNAME, e não o A ou o AAAA. |
| Nome, anfitrião ou alias | portal | Utilize apenas a parte do subdomínio. Alguns fornecedores de DNS podem exigir o valor completo portal.example.com. |
| Alvo, valor ou pontos para | app.tridenstechnology.com | Introduza apenas o nome do anfitrião. Não inclua https://. |
| TTL | Padrão | Mantenha o valor predefinido, a menos que a sua equipa de TI exija o contrário. |
Guarde o registo. As alterações no DNS costumam aparecer em poucos minutos, mas a propagação pode demorar mais tempo, dependendo do fornecedor de DNS e do cache existente.
Passo 4: Pedir à Tridens para ativar o domínio do portal
Depois de guardar o registo CNAME, contacte o responsável pelo seu projeto Tridens ou o serviço de apoio e indique o domínio do portal personalizado que pretende ativar. A Tridens irá associar o domínio ao seu ambiente e confirmará quando estiver pronto para ser testado.
Não divulgue o link do novo portal aos clientes até que a ativação e os testes estejam concluídos.
Testar os URLs do Portal
Assim que o Tridens confirmar que o domínio está ativo, teste o portal tal como um cliente o utilizaria. Comece numa janela privada ou de navegação anónima do navegador, para que as sessões em cache não ocultem eventuais problemas de configuração.
- Abrir
https://portal.example.com/ev-chargese utilizar o portal EV Charge. - Abrir
https://portal.example.com/monetizationse utilizar o portal de Monetização. - Confirme se a página é carregada através de HTTPS e se o navegador indica que a ligação é segura.
- Verifique a identidade visual, a navegação, o início de sessão e quaisquer ações no portal destinadas aos clientes.
- Peça a outro utilizador ou a um testador interno para validar a ligação a partir de uma rede diferente.
Se utilizar ferramentas de análise ou de rastreamento no portal, certifique-se de que os eventos previstos são registados após a entrada em funcionamento do domínio com a marca.
Resolução de Problemas
A maioria dos problemas de configuração deve-se a conflitos de registos DNS, atrasos na propagação ou à introdução do valor de destino num formato incorreto.
O portal não carrega
Verifique se existe um registo CNAME para o subdomínio exato que pretende utilizar. Confirme também que não existe nenhum registo A, AAAA ou outro registo CNAME que utilize o mesmo subdomínio.
O destino DNS foi introduzido com HTTPS
Os registos DNS não utilizam protocolos de URL. Se o destino estiver definido como https://app.tridenstechnology.com, substitua-o por app.tridenstechnology.com.
O URL da marca abre a página errada
Verifique se os utilizadores estão a aceder ao caminho correto após o domínio. O portal EV Charge utiliza /ev-charge. O portal de monetização utiliza /monetização.
O HTTPS ainda não está pronto
A ativação do SSL pode demorar algum tempo após a ligação do domínio. Se o HTTPS continuar a não funcionar após a Tridens ter confirmado a ativação, contacte o apoio técnico da Tridens ou o responsável pelo projeto, indicando o nome do domínio e o erro apresentado pelo navegador.
Onde utilizar o URL do seu portal de marca branca
Depois de o domínio estar ativo e ter sido testado, utilize o URL do portal personalizado em qualquer local onde os clientes esperem poder gerir a sua conta, as transações de cobrança, as faturas ou o acesso ao portal.
- Links no cabeçalho e no rodapé do site.
- E-mails de integração de clientes.
- Códigos QR em material impresso ou nas instruções do carregador.
- Documentação de apoio e artigos da central de ajuda.
- Gestão de contas e notificações de faturação.
Mantenha o formato dos links consistente. Se utilizar ambos os caminhos do portal, identifique-os claramente para que os clientes saibam qual devem abrir.
Perguntas frequentes sobre o URL do portal de marca branca
O que é um URL de portal de marca branca?
Um URL de portal «white label» é um endereço web com a marca da empresa que permite aos clientes aceder a um portal através do seu próprio domínio ou subdomínio, em vez de um domínio genérico da aplicação.
Para onde deve apontar o CNAME?
O destino do CNAME deve apontar para app.tridenstechnology.com. Introduza apenas o nome do anfitrião, sem https://, no registo DNS.
É possível que um subdomínio aceda a ambos os percursos do portal Tridens?
Sim, quando os portais estiverem ativados e configurados para a sua conta, os clientes podem utilizar percursos como /ev-charge e /monetization no mesmo subdomínio com a marca da sua empresa.
Quanto tempo demora a propagação do DNS?
As alterações no DNS costumam aparecer em poucos minutos, mas a propagação pode demorar mais tempo, dependendo do seu fornecedor de DNS, das definições de TTL e dos registos em cache.
Devo usar o domínio principal ou um subdomínio?
Utilize um subdomínio como portal.example.com. Isto mantém o seu site principal separado do portal Tridens e evita conflitos com os registos DNS existentes.
