Um portal GlobalProtect servido por um equipamento que gera o seu próprio certificado falha no Mac com Could not verify the server certificate of the gateway. O cliente está instalado, o portal responde, as credenciais estão certas — e mesmo assim a ligação não sobe. Falta o único elemento que o macOS não adivinha: a autoridade que assinou aquele certificado.
O que se segue é o procedimento completo, na ordem em que o problema aparece: confirmar a cadeia que o portal serve, extrair a raiz, instalá-la no keychain, provar que ficou confiável e saber distinguir o que se resolve no Mac do que tem de ser corrigido no servidor.
ℹ Quando este procedimento se aplica
Sempre que o certificado GlobalProtect for emitido por uma CA que só existe dentro do equipamento que serve o portal — appliances de operador, CPEs geridas pelo fornecedor, portais internos com PKI própria. Se o certificado vier de uma CA pública, o macOS já o aceita e não há nada para instalar.
✓ O processo em três passos
Extrair o segundo certificado da cadeia (a raiz, com CA:TRUE) → security add-trusted-cert -r trustRoot → confirmar com security verify-cert antes de testar a VPN. Instalar o primeiro certificado, o do servidor, é o erro mais comum e não resolve nada.
Neste artigo
- O sintoma aparece em dois sítios e tem a mesma causa
- Ler a cadeia antes de tocar no keychain
- Instalar a CA no macOS
- Verificar antes de dizer que está resolvido
- Firefox não usa o keychain do macOS
- Remover o trust quando já não é preciso
- Quando instalar a CA não chega
- Os erros que aparecem sempre
- Referências
O sintoma aparece em dois sítios e tem a mesma causa
No cliente GlobalProtect o erro é explícito:
Connection Failed
Gateway globalprotect.exemplo.local: Could not verify the server certificate
of the gateway. If the issue persists, contact your administrator.
No browser a mesma coisa com outra roupa: ao abrir https://IP-DO-PORTAL/global-protect/login.esp, o Safari e o Chrome mostram aviso de ligação não segura. Os dois validam contra o mesmo repositório de confiança do sistema, e nenhum deles conhece uma CA que só existe dentro do equipamento que serve o portal.
Isto acontece quase sempre em portais de VPN entregues por operador, em appliances de escritório pequeno e em plataformas cujo portal é gerido pela própria CPE: o fabricante gera uma raiz privada por equipamento, com um CN do tipo UUID.cloudwall.local ou equipamento.local, e assina com ela o certificado GlobalProtect que apresenta no portal. Não há nada de errado com o desenho — simplesmente essa raiz tem de ser distribuída a quem se liga.
Ler a cadeia antes de tocar no keychain
Antes de instalar seja o que for, ver o que o servidor envia. Sem este passo instala-se o certificado errado, o keychain fica com uma entrada inútil e a VPN continua a falhar — a diferença entre uma correcção e uma tarde perdida está aqui.
Ver o certificado que o portal serve
echo | openssl s_client -connect 203.0.113.10:4443 -showcerts 2>/dev/null \
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
Saída esperada, com o leaf à cabeça:
subject=C = PT, O = Operador Exemplo, OU = Servidores Privados, CN = 203.0.113.10
issuer=C = PT, O = Operador Exemplo, OU = Servidores Privados, CN = UUID-da-CA.cloudwall.local
notBefore=Nov 4 16:46:17 2026 GMT
notAfter=Nov 4 16:46:17 2027 GMT
X509v3 Subject Alternative Name: <-- se esta linha não aparecer, não há SAN
Dois nomes diferentes: o subject é o certificado do portal, o issuer é quem o assinou. O primeiro é descartável. O segundo é a CA que falta ao macOS.
Extrair a raiz — é esta que se instala
A cadeia traz normalmente dois certificados: o do servidor e a raiz auto-assinada. Este comando guarda o segundo:
cd ~/Desktop
openssl s_client -connect 203.0.113.10:4443 -showcerts </dev/null 2>/dev/null \
| awk '/-----BEGIN CERTIFICATE-----/{n++} n==2' > ca.pem
openssl x509 -in ca.pem -noout -subject -ext basicConstraints
O resultado tem de mostrar CA:TRUE. Se mostrar CA:FALSE, o awk apanhou o certificado do servidor — não continuar, porque instalar um leaf como âncora de confiança cria uma excepção que morre na próxima renovação e não cobre mais nenhum serviço do mesmo equipamento.
Duas fragilidades a conhecer: o -showcerts repete o leaf no fim e o ca.pem fica com esse excesso (o openssl x509 lê apenas o primeiro bloco, por isso funciona, mas confirme sempre o CA:TRUE) e há servidores que nem enviam a raiz na cadeia — nesse caso o segundo certificado pode ser um intermédio, ou não existir.
✓ Alternativa: distribuir a CA pelo próprio portal
Na consola do portal, a aba Agent inclui um campo Trusted Root CA: ao anexar aí a raiz, o cliente instala-a sozinho no primeiro connect, sem trabalho manual no Mac. É a via certa em parque gerido e a solução quando o servidor nem envia a raiz (documentado nas respostas da comunidade Palo Alto e no guia de administração do GlobalProtect).
⚠ Instalar o certificado do portal em vez da CA não resolve
Um certificado GlobalProtect de leaf é emitido por um ano e amarrado ao nome ou IP daquele serviço. Confiá-lo à mão funciona até ao dia em que o equipamento reemite, e nessa manhã a VPN falha outra vez sem que ninguém tenha mudado nada. A raiz cobre o leaf actual e os seguintes.
Sem SAN, o browser continua a avisar
Há uma limitação que não se resolve do lado do Mac. Se o certificado não tiver a extensão subjectAltName, o macOS deixa de confiar em nomes DNS no CommonName desde o macOS 10.15 (e o iOS 13) — para todos os certificados de servidor TLS, sem data de corte por emissão. As regras com data de 1 de Julho de 2019 são outras: o certificado tem de ter a extensão serverAuth no EKU e validade máxima de 825 dias. Em qualquer destes casos, o browser recusa o nome. Confirmar:
openssl x509 -in ca.pem -noout -ext subjectAltName
# O -ext exige OpenSSL 1.1.1+ — o /usr/bin/openssl do macOS costuma ser LibreSSL
openssl version
# Alternativa universal:
openssl x509 -in ca.pem -noout -text | grep -A1 "Alternative Name"
Nesse caso instalar a CA resolve o GlobalProtect e não resolve o aviso do Safari. O que o cliente da Palo Alto valida é a âncora de confiança — no teste deste guia, com a CA confiada o Connect subiu mesmo com CN de IP no certificado servido. Os browsers, esses, exigem SAN por nome. É a diferença entre «a VPN funciona» e «o browser está contente» — quem promete as duas coisas com um certificado destes está a prometer o que o servidor não tem.
Instalar a CA no macOS
Método A — terminal, dois comandos
Converter para DER e entregar ao security. O -d escreve no domínio de administração, que é o que interessa num Mac gerido:
openssl x509 -inform PEM -outform DER -in ca.pem -out ca.cer
sudo security add-trusted-cert -d -r trustRoot \
-k /Library/Keychains/System.keychain ~/Desktop/ca.cer
Aparece uma folha do sistema com o título Certificate Trust Settings, o utilizador já preenchido e um campo de password. Carregar em Update Settings depois de escrever a password. Sem esse clique não fica nada configurado — o comando não falha, simplesmente não aplica.
⚠ -k ~/Library/Keychains/login.keychain-db falha no macOS 26
O keychain do utilizador deixou de estar nesse ficheiro — em instalações recentes a pasta tem system-keychain-2.db e mais nada. O comando devolve SecCertificateAddToKeychain: The specified keychain could not be found. Duas saídas: usar o caminho de sistema como acima, ou omitir o -k e deixar o security resolver o keychain por omissão.
Método B — arrastar do Safari, sem terminal
- Abrir o portal no Safari e, no aviso, escolher Mostrar Detalhes → visitar este website.
- Clicar em Não Seguro na barra de endereço → Mostrar Certificado.
- Na hierarquia do certificado, seleccionar a entrada de topo (a
.local, não a do IP) e arrastar o ícone grande para o Desktop. - Duplo clique no ficheiro
.cer→ Acesso às Keychains → adicionar ao keychain Sistema. - Duplo clique no certificado dentro do Acesso às Keychains → expandir Confiança → Ao usar este certificado = Confiar Sempre → fechar com a password.
Sistema ou utilizador?
A escolha não é indiferente e explica metade dos «instalei e não funcionou».
| Domínio | Quem beneficia | Quando usar |
|---|---|---|
Sistema (/Library/Keychains) |
Todos os utilizadores e serviços | Mac geridos, serviços que correm fora da sessão, política de empresa |
| Utilizador (keychain de sessão) | Só aquele utilizador | Correcção rápida num portátil pessoal, sem acesso de administração |
Um trust de utilizador não chega ao ecrã de login, nem a nenhum processo que arranque antes da sessão. Num parque gerido, instalar no domínio do utilizador é dívida técnica: funciona hoje, falha quando o mesmo Mac é usado por outra conta.
Verificar antes de dizer que está resolvido
O teste que conta é a validação da cadeia, não a presença do certificado na lista:
security verify-cert -c ca.cer
# ...certificate verification successful.
Se imprimir o erro, o trust não ficou aplicado — voltar ao passo da password, porque o mais provável é a folha ter sido cancelada.
⚠ security dump-trust-settings mente neste macOS
Mesmo com o trust activo, o comando responde SecTrustSettingsCopyCertificates: No Trust Settings were found. O backend de confiança mudou e o utilitário não o lê. Quem se guiar por esta saída vai concluir que falhou e repetir a instalação do certificado GlobalProtect três vezes. Usar verify-cert e o teste real do cliente.
Depois disso, abrir o GlobalProtect e carregar em Connect. O resultado esperado é Connected com o gateway identificado — se continuar a falhar, o passo seguinte é ler o erro — e o parágrafo abaixo diz qual é o próximo suspeito.
Firefox não usa o keychain do macOS
Quem usa Firefox no mesmo Mac continua a ver o aviso depois de instalar o certificado GlobalProtect no sistema, porque o Firefox tem armazenamento de autoridades próprio. Importar em about:preferences#privacy → Ver Certificados → Autoridades → Importar, com a opção Confiar nesta CA para identificar sites marcada. É trabalho separado e não se herda do sistema.
Remover o trust quando já não é preciso
# 1. Remover as trust settings (o delete-certificate sozinho não as garante)
sudo security remove-trusted-cert -d ca.cer
# 2. Remover o certificado do keychain
sudo security delete-certificate \
-c "UUID-da-CA.cloudwall.local" \
/Library/Keychains/System.keychain
A alternativa em um só comando é security delete-certificate -t, que remove as trust settings em conjunto com a entrada. Confiando uma CA confia-se tudo o que ela assinar. Num equipamento de operador a chave privada está fechada no equipamento e o risco é limitado — num endpoint público é outra conversa. Quando o contrato acaba ou o equipamento é substituído, apagar a entrada faz parte do encerramento — não é limpeza cosmética.
Quando instalar a CA não chega
Há cinco situações em que instalar o certificado GlobalProtect está certo e o problema continua. Todas se diagnosticam com os mesmos dois comandos do início.
| Situação | Como se reconhece | O que fazer |
|---|---|---|
| O nome do gateway não está no certificado | O cliente fala de gateway.exemplo.local e o certificado GlobalProtect só tem CN com o IP, sem SAN |
Pedir ao fornecedor um certificado com SAN para esse nome. No Mac não há solução limpa |
| Porta 443 fechada | openssl s_client na 443 não abre — só a 4443 responde |
Confirmar o endereço configurado no cliente — o portal e o gateway podem partilhar porta |
| SNI não muda o certificado | Ligar com -servername do gateway devolve o mesmo CN de IP |
Não há certificado alternativo escondido: o que falha é o que está lá |
| A CA foi regenerada | Equipamento substituído, factory reset, ou o CN da raiz mudou | Repetir o processo do início — a entrada antiga deve ser apagada |
| Mac sob MDM | Confiar Sempre volta atrás sozinho ou o botão está inactivo | O perfil tem de trazer a CA — o trust manual é revertido na sincronização seguinte |
Vale a pena dizer o óbvio sobre o cliente Windows da mesma VPN: usa o repositório do Windows, não o keychain, e resolve-se em certlm.msc → Autoridades de Certificação de Raiz Fidedignas. O mesmo certificado, outro sítio.
Os erros que aparecem sempre
- Confiarem o certificado do portal. Dá a impressão de resolver e desfaz-se na renovação anual. A raiz é a única escolha estável.
- Cancelarem a folha de autenticação. O comando devolve ao prompt sem erro e sem efeito. Verificar sempre com
verify-cert. - Assumirem que o browser fica limpo. Com CN sem SAN, o Safari avisa para sempre — o GlobalProtect é que passa a ligar.
- Esquecerem o Firefox. Store próprio, importação própria, aviso próprio.
- Instalarem no utilizador e testarem com outro. O segundo utilizador do mesmo Mac não herda nada.
Artigos relacionados
- GlobalProtect no macOS: instalação, certificado e ligação — o irmão deste guia: o cliente
- TLS 1.0 no Browser: Aceder a Firewalls e Equipamentos Antigos
- lsof: Ficheiros Abertos, Portas e Diagnóstico no Linux — confirmar o portal a ouvir
Referências
- Apple — Acesso às Keychains: alterar as definições de confiança de um certificado
- Referência do comando
security(add-trusted-cert, verify-cert, delete-certificate) - Palo Alto Networks — GlobalProtect Administrator’s Guide
- Apple — Requisitos de certificados confiáveis no iOS 13 e macOS 10.15
Nota: os comandos e as particularidades (caminho do keychain no macOS 26, comportamento do dump-trust-settings) vêm de um teste real em macOS 26 com o cliente GlobalProtect 6.3, sobre um portal servido em :4443 com CA privada do equipamento. Os endereços e nomes dos exemplos são ilustrativos.