mTLS nos módulos Teracom: autenticação mútua por certificado nas linhas TCG e TCW
MQTT com certificado já aparece na ficha técnica de módulos como o TCG120-4 e o TCW242 — mas certificado de cliente (mTLS) é a etapa que muita integração deixa pela metade. Este guia reúne o formato de certificado que funciona nas duas famílias de produto e os quatro pontos de configuração do lado do broker que decidem se a autenticação mútua realmente fecha.
O que muda entre TLS comum e mTLS
TLS comum — o cadeado do navegador — só prova quem é o servidor. O cliente confia na identidade apresentada, mas não precisa provar a própria. Em mTLS (mutual TLS, TLS mútuo), as duas pontas apresentam certificado: o broker prova que é ele mesmo, e o dispositivo prova que é um cliente autorizado antes de a sessão MQTT abrir.
Num projeto de telemetria isso importa porque migra de “qualquer um com a URL do broker publica” para “só quem tem o certificado emitido publica” — fecha um vetor de acesso que usuário e senha do MQTT, sozinhos, não fecham.
As duas linhas do parque Teracom já anunciam “MQTT com certificado” na ficha técnica: a linha TCG celular (caso do TCG120-4) e a linha TCW Ethernet (caso do TCW242). O que a ficha não conta é que as duas famílias usam pilhas de TLS diferentes por baixo — e isso muda o que funciona na prática.
Por que TCG e TCW pedem tratamento separado
A linha TCG usa módulo celular com pilha TLS própria embarcada no rádio; a linha TCW usa o hardware e a implementação de TLS da própria Teracom. São duas pilhas diferentes atrás da mesma palavra “certificado” na ficha técnica — o que funciona numa não é garantia de funcionar na outra.
Regra prática: um projeto que mistura os dois times no mesmo broker (ex.: um TCW242 no painel e um TCG120-4 no ponto remoto, publicando para o mesmo endereço) precisa validar a configuração de certificado nas duas pontas, não só numa — não confie na ficha de um produto para prever o comportamento do outro.
O formato de certificado que funciona nas duas famílias: RSA-2048 · PEM · PKCS#1
As duas famílias listam suporte a certificado ECDSA (curvas P-256 e P-384) na especificação. Na prática, certificado de cliente ECDSA não se mostrou confiável no modo cliente dos módulos TCW nos testes que embasam este guia — o formato que funcionou de forma consistente nas duas famílias foi RSA-2048.
| Algoritmo | RSA-2048 — ECDSA listado na ficha das duas famílias, mas não confirmado em cliente TCW |
|---|---|
| Codificação | PEM (texto, com marcador -----BEGIN CERTIFICATE-----) — não DER (binário) |
| Formato da chave privada | PKCS#1 (marcador -----BEGIN RSA PRIVATE KEY-----) — PKCS#8 usa -----BEGIN PRIVATE KEY----- e é independente de algoritmo |
Se a sua autoridade certificadora (CA) interna ou o serviço que emite os certificados gera por padrão ECDSA ou PKCS#8, peça explicitamente RSA-2048/PEM/PKCS#1 para os certificados de cliente — é o denominador comum testado entre as duas linhas.
Os quatro pontos de configuração que ficam do lado do broker
Certificado correto no dispositivo resolve metade do problema. A outra metade mora na configuração do broker/servidor MQTT — e os quatro pontos abaixo são onde a maioria das integrações mTLS trava.
- Negociação de curva elíptica. Mesmo usando certificado RSA, cipher suites como
ECDHE_RSAainda negociam uma curva elíptica na troca de chave. Configure o servidor para oferecer curvas de suporte amplo (P-256 ou P-384) — uma curva rara na lista trava o handshake antes mesmo de chegar no certificado. - Negociação de algoritmo de assinatura. Uma das duas famílias de dispositivo só suporta a assinatura RSA clássica PKCS#1 v1.5, não RSA-PSS. Se o servidor oferecer apenas algoritmos de assinatura baseados em PSS, a autenticação de cliente falha justo nessa família — sem uma mensagem de erro que aponte para a causa.
- Trust store do servidor. O broker precisa ter a CA que emitiu o certificado do cliente na própria lista de CAs de cliente confiáveis. Sem isso, o servidor até apresenta o certificado dele normalmente (TLS comum funciona), mas rejeita o certificado do dispositivo.
- Aplicação ativa do mTLS. O broker precisa exigir e verificar o certificado do cliente, não apenas aceitá-lo quando presente. Um broker configurado para aceitar certificado de forma opcional deixa a porta aberta para quem conecta sem certificado nenhum — o que anula o motivo de ter mTLS.
Regra prática: teste a configuração comum, não confie só na ficha de um produto
Quando o projeto combina TCG e TCW no mesmo broker, a ficha técnica de cada equipamento isoladamente não basta — o que decide é testar a mesma configuração de certificado e servidor contra as duas famílias antes de ir a campo. Achar a divergência em bancada custa uma tarde; achar em campo custa uma visita técnica.
Guia baseado num relato técnico publicado pelo fabricante Teracom Systems (setembro de 2026) sobre um projeto de integração real com certificados mTLS envolvendo as duas séries de produto.
Perguntas que aparecem em todo projeto com mTLS
Preciso de mTLS se já uso TLS comum (só o servidor com certificado)?
Depende do que está em jogo. TLS comum já criptografa a sessão e prova a identidade do broker; mTLS soma a prova de identidade do dispositivo, o que importa quando publicar no broker sem credencial correta precisa ser impossível, não só improvável — caso de broker exposto na internet pública ou setor regulado. Em rede fechada com poucos dispositivos, TLS comum mais usuário/senha do MQTT pode bastar.
ECDSA funciona nos módulos Teracom?
As duas famílias listam suporte a ECDSA P-256 e P-384 na especificação, mas nos testes que embasam este guia o certificado de cliente ECDSA não funcionou de forma confiável no modo cliente dos TCW. RSA-2048 foi o que se mostrou consistente nas duas famílias — comece por ele.
Como sei se o broker está exigindo certificado, e não só aceitando?
Verifique o parâmetro de verificação de cliente do seu broker (em geral algo como “require client certificate” ou verify=require). Testar é mais confiável que ler a documentação: tente conectar sem certificado de cliente — se conseguir, o mTLS não está sendo exigido de fato.
Isso vale pra qualquer módulo TCG ou TCW?
O relato que embasa este guia cobre as duas famílias de forma geral, sem apontar um modelo específico. Aqui tratamos TCG120-4 e TCW242, que já declaram MQTT com certificado na própria ficha técnica — para outro modelo da linha, confirme na ficha dele se o MQTT tem suporte a certificado antes de assumir compatibilidade.
Fechando um projeto com mTLS entre TCG e TCW? Conte o que já está configurado no broker.
A LRI é distribuidora oficial da Teracom Systems no Brasil. Atendimento por engenharia, NF-e e faturamento para CNPJ. Garantia de 3 anos do fabricante.